Map Painting 地图绘画 脚本 API

作者：mukiu 发布时间：2016年3月11日 原生版本：未知 测试支持：1.8,1.9

在地图上作画和玩耍是我的乐趣。

点此下载

插件详细介绍

MapPainting插件允许玩家在Minecraft中使用地图进行绘画和游戏，提供了丰富的指令和权限管理，让玩家可以创建、管理和分享他们的像素艺术作品。

🎉

MapPainting

📜 简介

很久以前，有一张不可思议的地图。当我拿起它时，它没有向我展示地形，只是让我在上面绘画！所以我做了一些艺术作品，并享受成为像素艺术家的乐趣。没有什么比这更快乐的了。

不可思议的地图不满足于仅仅是不可思议。它想成为终极的！所以它进化了。偶然地，它向我展示了它的新功能，游戏！我沉浸在玩像素游戏中，并成为一名像素游戏玩家！

我实际上不知道这张地图会变成什么样。但是当你拥有这张地图时，你就会知道！只需点击右上角的下载，你就可以获得这张地图的副本。试一试，如果你喜欢这张地图，请给我评分

GitHub: https://github.com/aegistudio/MapPainting

📚 教程

虽然本插件的教程非常简单，但它们占用了一些空间。所以我将教程放在Wiki页面中。教程实际上是作为超链接嵌入在Map-Painting标题下的带有文本的地图中。如果你没有注意到，你可以点击这些链接：

🔑 指令与权限

玩家必须拥有 "mpp.command" 权限才能执行任何指令。

指令列表

  • /mpp: 列出MapPainting的所有子指令。(mpp=MaP Painting)
  • /mpp create <type> <name> [<parameters>]: 创建指定类型和名称的画布。
  • /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>]: 转移指定画布的所有权。如果要转移所有权，你必须是画布的管理者或所有者。(chown=Change Owner)
  • /mpp chmod <+/-painter>... [<name>]: 添加(+)或移除(-)指定画布的绘画者。如果要管理绘画者团队，你必须是画布的管理者或所有者。
  • /mpp destroy [<name>]: 销毁指定的画布。
  • /mpp pigment <r> <g> <b>: 直接获取具有指定RGB值的颜料。
  • /mpp list: 显示你拥有的画布。
  • /mpp undo [<name>]: 撤销你后悔的意外操作。
  • /mpp redo [<name>]: 重新执行最近撤销的操作。
  • /mpp confirm: 确认执行危险指令（红色指令）。

注意：

  • 红色指令是危险指令。
  • 斜体指令是在不需要指定画布名称 (<name>) 的情况下可以执行的指令，只需手持画布即可。

权限列表

权限格式为 "权限名称: 拥有此权限可以做什么"。

权限分为两种类型。显式权限是可以在 permission.yml 或权限插件中配置的权限。隐式权限嵌入在配置文件中，无法在外部配置。

显式权限

  • mpp.paint: 在自己拥有的画布上绘画。
  • mpp.interact: 与任何画布互动。
  • mpp.command: 执行 /mpp 指令。
  • mpp.create.*: 创建任何类型的画布。
  • mpp.create.normal: 创建 "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。此选择器将允许管理员。
  • 支持选择器 #perm:<permission>。此选择器将允许拥有指定权限的人员。

1.5.7-beta (重命名更新)

展开查看详情
  • 右键单击画布将打开一个重命名GUI，你可以在此GUI中直接重命名你的画布，而无需键入命令。
  • 添加自动更新程序。不用担心，自动更新程序只是在每次加载此插件时检查更新，并通知你下载是否有较新版本的此插件。此工作是异步完成的，不会影响你的服务器性能。

1.5.6-beta (Map-Away 更新)

展开查看详情
  • 使用绘画物品代替地图物品，这意味着你无需关心制作地图和物品展示框，只需使用绘画即可完成所有操作。
  • 将API更新到1.5.6版本，支持在放置和移除画布时发出通知。

1.5.4-beta

展开查看详情
  • 添加重命名命令，你现在可以重命名你拥有的画布。
  • 添加信息命令，允许玩家查看画布的详细信息。
  • 将API更新到1.5.4b，更改了一些API方法的参数。

1.5.3-beta (修复油漆桶)

展开查看详情
  • 修复了在1.9.x中制作油漆桶时失败的问题，其中成分和产品都将丢失。
  • 添加了tab complete功能。你可以tab-complete命令和画布。

1.5.2-beta (修复刷新率)

展开查看详情
  • 修复了由于Minecraft服务器机制，当未将地图握在玩家手中时，刷新率会降低的缺陷。现在，在这种情况下，刷新率不会降低。

1.5-beta (API 更新)

展开查看详情
  • 为脚本画布和其他插件创建画布提供图形算法，以便调用。包括划线、区域填充、字符绘制和文本绘制算法。
  • 提供插件画布服务。你可以创建自己的插件画布并将其注册到MapPainting。MapPainting将帮助你创建、持久化、销毁你的画布，并让玩家与你的画布互动！
  • 提供插件命令服务。你可以创建自己的命令，例如创建你的画布和控制你的画布，就像它们是 /mpp 命令的一部分一样。（你可以在插件中创建自己的命令，但将其注册到mpp可能更容易）
  • 提供资产管理器。资产管理器向你的脚本或插件提供资产，例如图形算法、字体/位图（正在开发中）和图像。

1.4-beta (脚本更新)

展开查看详情
  • 添加脚本类型的画布。脚本类型是一个嵌入脚本的画布，允许用户加载外部嵌入的游戏。
  • 完成了画布脚本编程的主要API。脚本可以通过与画布图形、回调表和磁带交互来工作。
  • 添加控制子命令。玩家可以发出命令来操作指定的画布。（如绘画、填充等）
  • 添加包装类型的画布。它是一个画布容器，其内部画布可以通过控制命令wrap切换。
  • 使用颜色表达式代替rgb参数。
  • 支持专家颜色表达式。你现在可以通过名称指定颜色，例如红色(#ff0000)、青色(#00ffff)等。
  • 支持rgb颜色表达式。你现在可以通过十六进制值指定颜色。例如#f00表示红色，#0f0表示绿色等。

1.3-beta (操作更新)

展开查看详情
  • 添加子命令 undo 和 redo。你现在可以还原修改，或重新执行还原的更改。
  • 你现在可以还原画布上的笔画。在特定情况下，还原填充存在错误。将在下一个版本中修复。
  • 添加子命令 clone。你现在可以克隆现有艺术作品的副本，并且对克隆的修改不会影响原始作品。
  • 更改了 .mpp 的格式。使其可以单独复制、备份和传输。（我很抱歉，由于 .mpp 格式的更改，1.3b与以前的版本不兼容。希望这将是最后一次更改 .mpp 格式。如果你有重要的艺术作品，请将 .mpp 文件通过电子邮件发送至 [email protected]，标题为“1.3-beta mpp update”。）
  • 你现在可以创建画布而无需手持使用过的地图。（在这种情况下需要确认）
  • 为“normal”类型的画布添加可选参数。你可以指定一个从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的白色背景画布。
  • 可以使用染料作为铅笔，这是一种在点击时绘制像素的工具。

⚙️ 示例配置


#
# MapPainting's Configuration
#
command:
  script:
    promptEngine: nashorn # nashorn or graaljs