Ponderer - 思索者 - Ponderer - 思索者

Ponderer 模组介绍

Ponderer 是一款面向玩家与整合包作者的「游戏内 Ponder 创作工具」。

你无需离开游戏，也无需预先编写脚本，即可直接在 Minecraft 中构建、编辑和迭代教程场景。

你可以用它做什么

• 在游戏内创建场景：从手持物品或指定物品快速创建 Ponder 条目（支持不同 NBT 对应不同场景，例如不同作者签名的成书）。
• 可视化编辑步骤：点击本模组创建的场景左下角的编辑图标，即可打开 GUI 编辑器，编辑文本、镜头、方块更改、实体生成、音效等。所有坐标字段均支持直接从场景中选取（左键点击选择方块坐标，右键点击选择相邻方块坐标）。
• 复制/粘贴与撤销/重做：支持复制/粘贴步骤、在任何位置插入、使用 Ctrl+Z 撤销和 Ctrl+Y 重做。
• 蓝图选区与结构保存：使用蓝图工具（默认：纸）选择区域并保存结构，以便复用和迭代演示内容。
• 开箱即用：内置引导场景；手持 writable_book 即可直接查看演示场景。
• 本地热重载：即时重载更改以快速查看结果，无需反复重启。
• 多人协作同步：从服务器拉取和推送场景数据，便于团队协作维护教程，或让玩家快速访问他人创建的场景。
• 格式转换：与 PonderJS 相互转换，实现跨工作流兼容。
• 场景包导出/导入：将所有场景和结构导出为 ZIP 文件，便于社区分享或备份。
• JEI 集成：所有 ID 输入字段支持从 JEI 物品列表中点击或拖放（需安装 JEI）。支持方块、物品和实体模式，并自动过滤类型。
• 方块状态属性：放置或替换方块时可指定 BlockState 属性（朝向、半边等），使用动态键值对列表编辑器。
• 扩展实体解析：船、矿车、盔甲架等基于物品的实体可通过 JEI 拖入实体 ID 字段。

指令参考（用途 + 用法）

• /ponderer reload：重载本地场景文件并刷新 Ponder 索引。
• /ponderer pull：以冲突检查模式拉取服务器更改。
• /ponderer pull force：强制用服务器版本覆盖本地数据。
• /ponderer pull keep_local：拉取时优先保留本地更改。
• /ponderer push：以冲突检查模式将本地场景推送到服务器。
• /ponderer push force：强制覆盖服务器上的场景。
• /ponderer push ：仅推送指定的场景 ID。
• /ponderer push force ：强制推送并覆盖指定的场景 ID。
• /ponderer download ：将指定结构导入到 Ponderer 结构目录。
• /ponderer new hand：从主手物品创建新场景。
• /ponderer new hand useheldnbt：从主手物品及其当前持有的 NBT 创建场景。
• /ponderer new hand ：从主手物品及指定 NBT 创建场景。
• /ponderer new ：为指定物品创建新场景。
• /ponderer new ：为指定物品及指定 NBT 创建新场景。
• /ponderer copy ：复制场景并将其重新绑定到另一物品。
• /ponderer delete ：删除指定的场景。
• /ponderer delete item ：删除某一物品下的所有场景。
• /ponderer list：打开 Ponder 物品列表 UI。
• /ponderer convert to_ponderjs all：将所有场景转换为 PonderJS。
• /ponderer convert to_ponderjs ：将一个场景转换为 PonderJS。
• /ponderer convert from_ponderjs all：将所有场景从 PonderJS 导回。
• /ponderer convert from_ponderjs ：将一个场景从 PonderJS 导回。
• /ponderer export [filename]：将所有脚本和结构导出为 ZIP 文件到 config/ponderer/。
• /ponderer import ：从 config/ponderer/ 中的 ZIP 文件导入脚本和结构。

适合人群

• 希望提供游戏内入门教程的整合包作者
• 希望为玩家提供友好引导内容的服务器管理员
• 偏好可视化场景编辑而非先写脚本工作流的玩家

核心体验

Ponderer 围绕一个目标构建：

将“编写教程”转变为“在游戏内直接构建教程”。

从创建、编辑到预览和同步，工作流程尽可能保持在 Minecraft 内，使 Ponder 内容创作更快、更直观。

问答：为什么不直接使用 PonderJS？

PonderJS 在此工作流中不提供热重载，这导致迭代反馈较慢。此外，直接传输 JS 脚本会引入额外的安全风险。

Ponderer 采用更安全的数据传输方式，并仍提供与 PonderJS 的双向转换，因此你可以在需要时切换工作流（部分 API 为 PonderJS 原生暂不支持）。