FreeMinecraftModels 命令

使用 /freeminecraftmodels 或 /fmm。

设置与内容管理

命令	用途
/fmm	为玩家打开可制作物品菜单（参见下方的 可制作物品菜单）
/fmm admin	打开管理员内容浏览器 —— 浏览已安装的包、文件夹、模型和自定义物品（权限：freeminecraftmodels.admin）
/fmm initialize	打开仅玩家可用的首次设置流程
/fmm setup	打开仅玩家可用的内容管理菜单
/fmm downloadall	下载当前所有可访问的官方内容
/fmm updatecontent	下载已过期官方内容的更新
/fmm reload	重新导入内容并重新生成资源包输出
/fmm version	显示插件版本（无需任何权限 —— 所有人都可执行）
/fmm stats	显示已加载模型的统计信息

模型生成与放置

命令	用途
/fmm spawn static <id>	生成静态模型
/fmm spawn dynamic <id>	生成动态模型
/fmm spawn prop <id>	创建持久化道具条目并生成它
/fmm itemify <id> <material>	创建一个可放置物品，使用时将所选模型作为道具生成
/fmm mount <id>	使用伪装的马生成实验性可乘骑坐骑
/fmm giveitem <item>	向玩家给予自定义 FMM 物品（权限：freeminecraftmodels.admin）
/fmm craftify <id>	打开交互式配方编辑器 —— 在 3×3 格子中放置材料，然后点击产物即可保存该道具的合成配方

玩家伪装

命令	用途
/fmm disguise <modelID> [player]	将玩家伪装为已加载的模型。不带目标参数时，伪装发送者。带目标时，需要 freeminecraftmodels.disguise.others 权限，可从控制台执行
/fmm undisguise [player]	解除伪装。不带目标时解除发送者的伪装。带目标时需要 freeminecraftmodels.disguise.others 权限，可从控制台执行
/fmm disguiselist	列出当前所有处于伪装中的玩家及其对应的模型（权限：freeminecraftmodels.disguise.others）

伪装行为：

• 对已伪装的玩家再次执行伪装时，会干净地替换之前的伪装。
• 伪装的玩家对其他玩家保持不可见，因此只能看到模型。此不可见效果在喝牛奶以及其他清除药水效果的交互后仍会持续。
• 第三方插件可以通过公共的 DisguiseAPI 来驱动伪装（参见 API 与开发者指南）。

家具商店

命令	用途
/fmm shop	打开可选的、基于 Vault 的家具商店，玩家可以用游戏内货币购买可合成的道具（权限：freeminecraftmodels.shop，默认：true）

商店默认禁用，仅在以下条件都满足时才会注册：

• shop_config.yml 中 enabled: true
• 已安装 Vault
• 已注册兼容 Vault 的经济提供方

只要缺少其中任何一项，/fmm shop 就不会注册（如果在运行时被强制禁用，则会显示可配置的"商店已禁用"消息）。商店配置键和每条配方的 shopEnabled / shopPrice 字段请参阅 配置。

实用工具

命令	用途
/fmm hitbox visualize [duration]	用粒子可视化碰撞箱，便于调试
/fmm location	诊断命令 —— 报告已通过 LocationAPI 注册的地下城探测器和保护区提供者数量，并针对你当前的位置测试两个谓词（权限：freeminecraftmodels.*）
/fmm debug bedrock [on|off]	用于诊断 Bedrock 显示管线的 [FMM-BedrockDebug] 日志流的运行时开关。省略状态参数时会报告日志当前是否开启。在插件重载时始终重置为 OFF —— 故意不做成配置项，避免被遗忘开启。同时接受玩家与控制台执行（权限：freeminecraftmodels.*）
/fmm deleteall	移除当前所有已加载的模型化实体

道具放置行为

当玩家右键点击纸质道具物品（由 /fmm itemify 创建或通过 /fmm craftify 配方合成）时：

• 物品消耗： 道具放置后纸质物品会被消耗，除非玩家处于创造模式。
• 旋转： 道具会朝向玩家的视线方向放置，旋转角度按 10 度为单位对齐。这让玩家只需调整放置前的视线方向，就能精细控制道具朝向。

可制作物品菜单

不带参数地运行 /fmm 会为玩家打开一个物品栏菜单，展示所有已配置配方的可合成物品。

• 菜单中的每个物品都代表一个可合成的 FMM 物品。
• 点击物品会打开详情子菜单，显示 3×3 合成格、箭头和产物 —— 直观地告诉玩家如何在工作台中合成它。
• 需要 freeminecraftmodels.menu 权限（默认：true，所有玩家可用）。

管理员内容浏览器

运行 /fmm admin 会为服务器管理员打开一个物品栏菜单，可用于浏览：

• 已安装的内容包
• 文件夹与单个模型
• 自定义物品（在 YML 中设置了 material: 的模型）

需要 freeminecraftmodels.admin 权限（默认：op）。

配方编辑器

/fmm craftify 命令可以为任意道具模型创建原版工作台配方。

1. 运行 /fmm craftify <model_id> 打开配方编辑器界面。
2. 一个自定义物品栏会打开，内含 3×3 合成格和预先填充好的产物物品。
3. 按你想要的样式从背包中将材料放入合成格。
4. 点击产物物品（道具的纸质物品）保存配方。
5. 粒子与音效会确认保存成功。
6. 配方将保存到 plugins/FreeMinecraftModels/recipes/<model_id>.yml 并立即注册。
7. 玩家现在可以在任意工作台中合成该道具物品。
8. 按 Esc 取消保存 —— 材料会归还到背包。
9. 对同一模型再次执行 craftify 会覆盖之前的配方。
10. 配方在服务器重启和重载后仍会保留。

保存的配方文件包含 shopEnabled（默认 true）和 shopPrice（默认值来自 shop_config.yml）字段，用于控制该配方在 /fmm shop 中的暴露方式。

权限

在 plugin.yml 中注册

权限	默认	描述
freeminecraftmodels.*	OP	通配符，授予 freeminecraftmodels.admin、freeminecraftmodels.disguise.self 和 freeminecraftmodels.disguise.others。这个通配符字符串同时也是 /fmm reload、/fmm stats、/fmm spawn、/fmm itemify、/fmm craftify、/fmm mount、/fmm hitbox visualize、/fmm debug bedrock、/fmm location、/fmm setup、/fmm initialize、/fmm downloadall 和 /fmm updatecontent 字面意义上所要求的权限
freeminecraftmodels.admin	OP	可访问 /fmm admin（管理员内容浏览器）与 /fmm giveitem
freeminecraftmodels.disguise.self	OP	允许 /fmm disguise 与 /fmm undisguise，但只能针对发送者本人
freeminecraftmodels.disguise.others	OP	允许 /fmm disguise <model> <player>、/fmm undisguise <player> 与 /fmm disguiselist
freeminecraftmodels.menu	true	允许使用 /fmm 可制作物品菜单（所有玩家可用）
freeminecraftmodels.shop	true	允许使用 /fmm shop（商店启用时所有玩家可用）

由命令在运行时强制执行

权限	默认	描述
freeminecraftmodels.deleteall	OP	可访问 /fmm deleteall（在运行时检查，未在 plugin.yml 中注册）

• initialize、setup、spawn、itemify、mount、giveitem、craftify、hitbox visualize、location 和 shop 仅限玩家执行。
• disguise 与 undisguise 接受目标玩家参数，只要提供目标即可从控制台执行。
• version 无任何权限限制，任何人（玩家或控制台）都可执行。