[Fabric] 道奇 RPG Maker

Dochi RPG Maker

Dochi RPG Maker 是一个用于 Minecraft Fabric 1.21.1 的游戏内 RPG 创建工具包。它为整合包作者、服务器创建者和冒险地图制作者设计，旨在帮助他们在 Minecraft 内部直接构建 RPG 内容。

该模组专注于实用的 RPG 系统：对话、自定义 GUI 布局、NPC 商店、基于物品的货币、HUD 覆盖层、NPC 基础编辑和世界消息工具。大多数工作流程都可以通过游戏内编辑器界面创建并保存为 JSON，因此基本设置无需编写脚本。

高级创作者仍然可以将生成的 JSON 数据与指令、CustomNPCs 行为、可选的 FTB Quests 检查与动作、进度、标签、CobbleDollars 商店支付以及通过 DRM API 暴露的附加组件集成结合起来使用。

主要特性

编辑器中心

• 从游戏内的编辑器选择器中打开内置及附加组件注册的 RPG 工具。
• 在支持的情况下创建、加载、保存和管理服务端 JSON 数据。
• 使用内置的默认模板来创建对话、GUI 布局、商店、货币、HUD 和消息工具。
• 包含辅助界面、预览、选择器和快捷操作按钮，以加快游戏内编辑速度。

对话编辑器

• 在游戏内创建和编辑对话集合。
• 构建对话节点、路线、选项、条件和动作。
• 将对话 JSON 绑定到 CustomNPCs 的 NPC 上。
• 使用可见选项逻辑，确保只有有效的玩家选项才会显示。
• 基于标签、物品、阵营分数、进度以及可选的 FTB 任务/子任务检查添加条件。
• 添加动作，如跳转到另一个节点、运行指令、打开商店、更改标签、关闭对话、给予或拿走物品、更改阵营分数、授予进度或更新可选的 FTB 任务/子任务进度。
• 搜索同步的物品、CustomNPCs 阵营、进度以及可选的 FTB 任务/子任务 ID，而不仅仅依赖手动输入。
• 将对话数据存储为服务端 JSON，适用于多人游戏整合包和服务器。

GUI 制作器

• 直接在游戏内构建可复用的 GUI 布局。
• 在画布上或实时 Minecraft 背景上编辑布局。
• 为对话界面、NPC 商店、货币 HUD、Remnant Msg 视图以及附加组件驱动的界面创建布局。
• 添加面板、图像、裁剪的资源图像、实体预览、物品展示、对话文本、选项、分页器、商店行、玩家物品栏面板、货币显示、交易预览、搜索栏、页面选择器、HUD 占位符和消息组件。
• 将 GUI 布局保存为 DRM GUI 文件夹下的共享 JSON 文件，以便多个系统可以复用它们。
• 使用预览和应用工作流程在编辑时测试布局。

NPC 商店工具

• 为 CustomNPCs 的 NPC 创建购买商店、出售商店或买卖结合的商店。
• 选择每个商店使用的商店 GUI 布局。
• 使用普通物品货币、Dochi RPG Maker 货币定义或可选的 CobbleDollars 集成。
• 注册带有物品数量、价格、NBT 数据和库存设置的商店物品。
• 支持无限库存或有限库存。
• 出售模式的商店可以匹配玩家物品，包括支持 NBT 识别的条目。
• 在编辑商店条目时，可通过本地化名称、命名空间或物品 ID 搜索实时物品注册表。
• 商店界面可以渲染玩家物品栏、物品描述、货币显示、搜索控制、页面控制和交易预览。
• 运行时交易在服务端处理，以确保货币支付、退款、库存更新和物品栏检查在多人游戏中保持一致。

货币编辑器

• 定义基于物品的货币，例如绿宝石货币或自定义物品货币。
• 配置货币名称、显示格式、图标物品、匹配物品数据和拾取行为。
• 当启用拾取转换时，自动将匹配的货币物品吸收到玩家余额中。
• 控制余额是否在物品栏和 HUD 系统中显示。
• 配置死亡损失行为，包括保留货币或在死亡时损失一定百分比。
• 在 NPC 商店中使用 DRM 货币余额，而不是仅依赖物理物品堆叠。
• DRM 货币余额存储在服务端，在玩家重生时复制，并同步到客户端。

HUD 制作器与货币 HUD

• 在游戏内构建自定义 HUD 定义和货币 HUD 布局。
• 编辑 HUD 位置、可见性、文本显示、图标显示、数量显示、拾取闪烁和变化标签。
• 为货币、玩家生命值、饱食度、护甲、空气和 XP 等级创建 HUD 元素。
• 在应用 HUD 布局之前进行预览。
• 为生命值、护甲、饱食度、空气、XP、快捷栏、准星和 Boss 血条等元素配置原版 HUD 覆盖行为。
• 使用基于 JSON 的 HUD 定义，以便在整合包和服务器中可复用设置。

NPC 基础编辑器

• 从游戏内界面编辑选定的 CustomNPCs NPC。
• 管理显示设置，如名称、头衔、皮肤、披风、覆盖层、可见性、名称渲染、大小、色调、Boss 血条、碰撞箱和视觉层。
• 编辑阵营分配、阵营行为、敌对阵营目标选择、阵营防御行为和死亡阵营分数规则。
• 调整战斗数值、生命值、仇恨范围、再生、重生行为、生物类型、免疫、近战设置和远程设置。
• 配置 AI 选项、移动行为、战术行为、物品栏、装备和掉落表数据。
• 包括 NPC 删除、克隆保存、克隆列表、NPC 召唤和克隆召唤工作流程。
• 专为基于 CustomNPCs 的 RPG 整合包设计，无需离开世界即可更快地设置 NPC。

Remnant Msg 工具

• 通过 Remnant Msg 系统放置和管理世界消息标记。
• 使用文本、样式、条件和查看动作创建消息 JSON 数据。
• 配置交互规则、权限、标记行为、生命周期和消息限制的策略 JSON。
• 搜索消息和策略 JSON 文件，并配置每个标记的缩放、广告牌模式和物品显示变换。
• 使用专用的消息 GUI 布局在游戏内查看消息。
• 通过游戏内工具管理已放置的世界消息，包括列表、编辑、传送和删除等可用工作流程。

服务端 JSON 工作流程

• 多人游戏服务器从服务端配置文件夹读取和写入 DRM 数据。
• 编辑操作受权限保护，通常需要 OP 或相应的服务器权限。
• JSON 数据可以被加载、保存、删除、刷新，并在支持的情况下被多个 NPC 或系统复用。
• 内置默认值会被复制到数据文件夹中，以便新整合包有可用的示例作为起点。

数据文件夹

运行时数据存储在以下位置：

config/dochi_rpg_maker/

常见的数据区域包括：

config/dochi_rpg_maker/dialogue_sets/
config/dochi_rpg_maker/gui/
config/dochi_rpg_maker/npc_shops/
config/dochi_rpg_maker/currency/definitions/
config/dochi_rpg_maker/hud/sets/
config/dochi_rpg_maker/hud/active_set.json
config/dochi_rpg_maker/hud/definitions/vanilla/
config/dochi_rpg_maker/hud/definitions/custom/
config/dochi_rpg_maker/remnant_msg/messages/
config/dochi_rpg_maker/remnant_msg/policies/
config/dochi_rpg_maker/settings/

旧版本可能使用了不同的内部名称或布局，例如 currency/hud_layouts/。Fabric 版本保留了一些旧的读取器和迁移路径以兼容，但当前面向用户的运行时数据组织在 config/dochi_rpg_maker/ 下，活动的 HUD 集合存储在 hud/sets/ 下。

需求

• Minecraft Java 版 1.21.1
• Java 21 或更新版本
• Fabric Loader 0.18.0 或更新版本
• Fabric API 0.116.11+1.21.1 或兼容 1.21.1 的更新构建
• 在客户端和服务器端都安装 Dochi RPG Maker 及其所需的 Fabric 依赖项，以支持多人游戏工作流程。
• CustomNPCs 对整个模组是可选的，但对于 CustomNPCs NPC 对话绑定、NPC 商店和 NPC 基础工作流程是必需的。
• FTB Quests 是可选的，仅在需要 FTB 任务/子任务条件、动作和搜索时需要。
• Mod Menu 和 CobbleDollars 是可选集成。
• 多人游戏编辑需要正确的服务端权限，通常是管理员权限。

当前状态

当前的 Fabric 版本是适用于 Minecraft 1.21.1 的 Dochi RPG Maker 0.1.6。它包括编辑器选择器、对话编辑器、GUI 制作器、NPC 商店工具、货币编辑器、HUD 制作器、NPC 基础编辑器、服务端 JSON 工作流程、Remnant Msg 工具以及供附加组件使用的公共兼容 API。

Dochi RPG Maker 仍处于早期的 RPG 制作器核心版本。一些编辑器界面、JSON 格式和高级工具可能会在版本之间持续变化，因此在更新重要的整合包或服务器之前，请备份 config/dochi_rpg_maker/。

适用人群

Dochi RPG Maker 适用于：

• 构建以故事驱动的 RPG 整合包的整合包作者。
• 需要 NPC 对话、商店、货币和 HUD 工具的服务器所有者。
• 使用模组化 Minecraft 的冒险地图制作者。
• 希望更快地在游戏内设置 NPC 的 CustomNPCs 用户。
• 更倾向于使用 GUI 工具编辑 RPG 内容而不是手动编写每个 JSON 文件的创作者。