【AI大活】红石科技---目前0.1版本

清澈淌漾

# Lim_RedstoneCore 插件说明文档

## 1. 插件简介
`Lim_RedstoneCore` 是一个为 RPG Maker MZ 设计的红石逻辑系统核心插件。它在游戏中模拟了类似《我的世界》的红石电路机制，允许开发者通过放置特定元件或在事件中编写简单的逻辑表达式，实现复杂的自动化机关、解谜要素及地图互动逻辑。

## 2. 核心机制
- **Tick 系统**：逻辑每 5 帧运行一次（1 秒约 12 次 Tick），以确保在复杂电路下依然保持 60 FPS 的流畅运行。
- **电力衰减**：电力信号在红石线中传输时会逐格递减（-1/格），最大强度为 15。
- **可视化调试**：在地图上按下 **[Tab]** 键，可实时切换红石信号的可视化层，查看每个格子的电力值 (POW)。

## 3. 元件列表
| 元件类型 | 代码标识 | 功能说明 |
| :--- | :--- | :--- |
| **红石线** | `wire` | 基础导线。传输电力，每格衰减 1 点强度。 |
| **红石块** | `block` | 恒定电源。持续向四周输出 15 级强信号。 |
| **红石火把** | `torch` | 逻辑非门。默认输出 15 级信号；若接收到任意强度的输入信号，则熄灭（输出 0）。 |
| **拉杆** | `lever` | 交互电源。玩家点击后切换开关状态，开启时输出 15 级信号。 |

## 4. 事件集成 (注释指令)
你可以直接在地图事件的“注释”列表中使用以下指令，使事件成为电路的一部分：

### A. 电力输出 (Output)
- `=>rs_src:数值`：设置事件的源电力（例如 `=>rs_src:15`）。
- `=>rs_con:方向`：设置连接方向。可用 `U`(上), `D`(下), `L`(左), `R`(右), `C`(四周)。
    - *示例：`=>rs_con:LR` 表示该事件仅与左右两边的电路导通。*

### B. 逻辑触发 (Condition)
在事件页注释中使用 `=>rs_cond:表达式`。只有当表达式为真时，该事件页才会激活。
- **变量支持**：
    - `U`, `D`, `L`, `R`：对应方向邻居的电力值。
    - `C`：四周邻居中的最大电力值。
- **示例**：
    - `=>rs_cond: C > 0`（只要周围有电就激活）
    - `=>rs_cond: U >= 10 && D >= 10`（上下两端同时输入强信号时激活）

## 5. 插件指令
- **放置红石元件**：在指定坐标（或玩家位置）生成红石元件。
- **移除红石元件**：清除指定位置的电路数据。
- **交互红石元件**：通过脚本或指令手动触发拉杆开关。

## 6. 更新计划 (Roadmap)
### [v0.2 预定更新]
1.  **中继器 (Repeater)**：
    - 信号中继：将电强重新提升至 15。
    - 延迟功能：提供可调节的 Tick 延迟（1-4档）。
    - 单向传输：防止信号回流。
2.  **比较器 (Comparator)**：
    - 比较模式：比较后端与侧端输入。
    - 减法模式：输出后端与侧端的电强差值。
    - 容器检测：通过指令检测特定变量或容器的状态并转化为电强。

---


现在已经可以做点超级解谜了
等出完功能在套皮