Map Painting - MapPainting

MapPainting 是一款将地图转变为数字画布的插件，让玩家可以在 Minecraft 中尽情挥洒创意，从简单的像素绘画到编写交互式脚本游戏，体验从画家到游戏开发者的乐趣。

💡重要须知

• 本插件为自由软件，采用 GPL v3 许可证。
• 不支持 Minecraft 1.8 以下的版本。

🎮获取与教程

• 下载：点击页面右上角的下载按钮即可获取插件。
• 源代码：可在 GitHub 查看：https://github.com/aegistudio/MapPainting
• 教程：详细教程已移至 Wiki 页面。您也可以在游戏内 MapPainting 横幅下的文字地图中找到超链接，或直接访问：

- [绘画教程](https://github.com/aegistudio/MapPainting/wiki/Painting)

- [脚本教程](https://github.com/aegistudio/MapPainting/wiki/Scripting)

- [库/API 文档](https://github.com/aegistudio/MapPainting/wiki/Library-API)

🔧命令与权限

玩家需要拥有 mpp.command 权限才能使用以下命令。

基础命令

• /mpp : 列出所有子命令。
• /mpp list : 列出你拥有的画布。
• /mpp undo [<name>] : 撤销一次操作。
• /mpp redo [<name>] : 重做最近撤销的操作。
• /mpp confirm : 确认执行危险命令（红色显示的命令）。

创建命令

• /mpp create normal <name> [<1~128>] : 创建一个覆盖整张地图的方形画布。1~128 为分辨率，默认为 128。
• /mpp create wrap <name> [<init>] : 创建一个画布包装器。init 为初始包装的画布。
• /mpp create script <name> <script> [<lang>] : 创建一个基于脚本的画布。script 为插件文件夹下的文件名，lang 为脚本语言，默认为 ECMAScript。
• /mpp create clone <name> <cloned> : 克隆一个已存在的画布。cloned 为被克隆的画布。

管理命令

• /mpp chown <receiver> [<name>] : 转移指定画布的所有权。你需要是该画布的管理员或所有者。
• /mpp chmod <+/-painter>... [<name>] : 添加(+)或移除(-)指定画布的画家。你需要是该画布的管理员或所有者。
• /mpp destroy [<name>] : 销毁指定画布。
• /mpp pigment <r> <g> <b> : 直接获取指定 RGB 值的颜料。

命令格式说明

• 红色命令：危险命令，执行前需要确认。
• 斜体命令：可以手持画布而不指定 <name> 参数来执行。

权限说明

权限分为显式和隐式两种。显式权限可在 permission.yml 或权限插件中配置；隐式权限内嵌于配置文件，无法外部配置。

显式权限

• mpp.paint : 在自己拥有的画布上绘画。
• mpp.interact : 与任何画布交互。
• mpp.command : 使用 /mpp 命令。
• mpp.create.* : 创建任何类型的画布。
• mpp.create.normal : 创建“普通”类型画布。
• mpp.create.clone : 克隆现有画布。
• mpp.chown : 转移自己画布的所有权。
• mpp.chmod : 管理自己画布的画家团队。
• mpp.destroy : 销毁自己拥有的画布。
• mpp.pigment : 直接通过 RGB 获取颜料。
• mpp.list : 列出自己拥有的画布。
• mpp.undo : 撤销对自己画布的操作。
• mpp.redo : 重做对自己画布的操作。
• mpp.manager : 管理画布（如销毁、转移所有权、增删画家）。

隐式权限

• mpp.owner : 管理自己拥有的画布（如转移所有权、增删画家）。
• mpp.painter : 在画布上绘画。

✨更新日志

1.5.8-beta (权限更新)

• 改进了判断玩家指向位置（尤其是边缘位置）的算法。
• 允许用户通过配置 command.script.promptEngine 选择脚本引擎。
• 新增与画布交互的权限控制。若未配置，任何玩家均可交互（与之前版本行为一致）。
• 新增交互者和画家的选择器。选择器以 # 开头，代表一组玩家：

- `#all` : 允许任何玩家。

- `#reject:<player_name>` 或 `#-<player_name>` : 在使用 `#all` 时，可用来拒绝特定玩家。

- `#op` : 允许管理员（OP）。

- `#perm:<permission>` : 允许拥有指定权限的玩家。

1.5.7-beta (重命名更新)

• 右键点击画布会打开重命名 GUI，可直接在界面中重命名，无需输入命令。
• 新增自动更新器。插件每次加载时会异步检查更新，并在有新版本时通知下载，不影响服务器性能。

1.5.6-beta (地图替代更新)

• 使用“画作”物品替代地图物品，无需合成地图和物品框，仅凭画作即可完成所有操作。
• 更新 API 至 1.5.6 版本，支持画布放置和移除时的通知事件。

1.5.4-beta

• 新增 rename 命令，可重命名自己拥有的画布。
• 新增 info 命令，允许玩家查看画布的详细信息。
• 更新 API 至 1.5.4b 版本，更改了部分 API 方法的参数。

1.5.3-beta (颜料桶修复)

• 修复了在 1.9.x 版本中合成颜料桶时，原料和产物都会消失的问题。
• 新增命令和画布名称的 Tab 补全功能。

1.5.2-beta (刷新率修复)

• 修复了因 Minecraft 服务器机制导致未手持地图时刷新率降低的缺陷。现在此类情况下的刷新率将保持正常。

1.5-beta (API 更新)

• 为脚本画布和其他插件创建的画布提供图形算法，包括画线、区域填充、字符绘制和文本绘制。
• 提供插件画布服务。您可以创建自己的插件画布并注册到 MapPainting。MapPainting 将帮助您创建、持久化、销毁画布，并让玩家与之交互！
• 提供插件命令服务。您可以创建自己的命令（如创建和控制画布），就像它们是 /mpp 命令的一部分一样。
• 提供资源管理器。资源管理器为脚本或插件提供图形算法、字体/位图（开发中）和图像等资源。

1.4-beta (脚本更新)

• 新增脚本类型画布。这是一种嵌入脚本的画布，允许用户加载外部嵌入式游戏。
• 完善了画布脚本编程的主要 API。脚本可通过与画布图形、回调表和“磁带”交互来工作。
• 新增控制子命令。玩家可对指定画布发出操作命令（如绘画、填充等）。
• 新增包装类型画布。它是一个画布容器，其内部画布可通过控制命令 wrap 切换。
• 使用颜色表达式替代 RGB 参数。

- 支持专家颜色表达式：可通过颜色名称指定，如 `red` (#ff0000)、`cyan` (#00ffff) 等。

- 支持 RGB 颜色表达式：可通过十六进制值指定，如 `#f00` 代表红色，`#0f0` 代表绿色等。

1.3-beta (操作更新)

• 新增子命令 undo 和 redo。现在可以撤销修改或重做已撤销的更改。

- 可以撤销画布上的笔触。在特定情况下，撤销填充操作存在 bug，将在下个版本修复。

• 新增子命令 clone。现在可以克隆现有的艺术作品副本，对克隆体的修改不会影响原作。
• 更改了 .mpp 文件的格式，使其可以单独复制、备份和传输。

- **注意**：1.3b 版本因 `.mpp` 格式更改，与之前版本不兼容。如果您有重要的艺术作品文件，请将 `.mpp` 文件发送至 `[email protected]`，邮件标题为“1.3-beta mpp update”。

• 现在无需手持已使用的地图即可创建画布（此情况需要确认）。
• 为“普通”类型画布添加可选参数。可指定 1 到 128 的整数作为画布分辨率。

- **（与 1.2b 及更早版本不兼容）**

1.2-beta (颜料更新)

• 新增颜料物品。颜料是带有标签的特殊染料。
• 可通过混合颜料或染料来合成颜料。共有 2^24 种颜料，尽情尝试！
• 可以像使用染料一样用颜料绘画。
• 新增子命令 pigment。可通过此命令直接获取指定 RGB 颜色的颜料。
• 新增子命令 list。可列出你拥有的画布。
• 新增颜料桶物品。可通过颜料/染料和牛奶桶合成颜料桶。
• 可以用颜料桶填充形状！
• 颜料桶可食用，但后果自负。

1.1-beta (所有权更新)

• 修复了在旋转的物品框中绘画时笔触会反转的恼人缺陷。
• 修复了画作有时保存失败的缺陷。

- **注意**：与 1.0b 版本保存的画作不兼容。

• 新增子命令 confirm。执行如 destroy、chown 等危险命令时需要确认。
• 新增子命令 chown（更改所有者）。现在可以将所有权转移给其他玩家。
• 新增子命令 chmod（更改模式）。允许玩家添加/移除可以协作绘画的画家！
• 玩家现在可以手持画布直接执行删除、chown 和 chmod 命令，而无需指定画布名称。
• 将 unbind 重命名为 destroy。
• 权限设置更具体，允许更灵活地控制插件。

- **（与 1.0b 版本不兼容）**

1.0-beta

• 通过 /mpp 命令创建和解绑画布。
• 可以使用并保存普通画布，即一个 128x128 的白色背景画布。
• 可以使用染料作为铅笔，点击即可绘制一个像素点。