FreeMinecraftModels

FreeMinecraftModels 既是一个自定义模型运行时，也是一个面向开发者的 API。

当前插件不再仅仅是"imports 文件夹加 /fmm reload"的工作流程。当前代码库新增了：

• 首次设置流程和加入时的提醒，直到设置标记为完成
• 基于 Nightbreak 的设置菜单，用于安装和更新官方模型包
• 在 plugins/FreeMinecraftModels/output/FreeMinecraftModels 生成资源包文件夹
• 在 plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip 生成压缩包
• 更广泛的命令支持，涵盖设置、内容更新、生成、伪装、道具和调试

从这里开始

• 安装设置
• 内容包
• 命令
• 资源包输出
• API 与开发者指南
• 常见问题

Lua 道具脚本

FreeMinecraftModels 包含对道具的 Lua 脚本支持，由 MagmaCore 2.0 脚本引擎驱动。道具脚本存放在 plugins/FreeMinecraftModels/scripts/ 中，可以响应 on_spawn、on_game_tick、on_zone_enter、on_zone_leave、on_destroy、on_left_click、on_right_click 和 on_projectile_hit 等钩子。脚本接收一个 context.prop 表，包含 model_id 和 current_location 等字段，以及 play_animation(name) 和 stop_animation() 等方法。

当前说明

• 当前内置在插件中的 Nightbreak 官方托管包为 BetterStructures Prop Pack 和 EliteMobs Prop Pack。
• FreeMinecraftModels 在启动时和执行 /fmm reload 时重新构建其资源包输出。
• ResourcePackManager 仍然是向客户端自动分发生成的资源包的推荐方式。