FreeMinecraftModels 内容包
FMM 的官方内容现在以 Nightbreak 托管包的形式提供。
当前官方包
当前插件定义了五个预制的官方包，包括道具和物品内容：
| 包 | 类型 | 配置文件名 | 文件夹名 | Nightbreak 标识 |
|---|---|---|---|---|
Basic Furniture Pack | 道具 | basic_furniture_pack | Basic Furniture Pack | basic-furniture-pack |
BetterStructures Prop Pack | 道具 | betterstructures_prop_pack | bs prop pack | betterstructures-prop-pack |
EliteMobs Prop Pack | 道具 | elitemobs_prop_pack | em_dungeon_prop_pack | elitemobs-prop-pack |
Craftenmine's Weapons Item Pack | 自定义物品 | craftenmines_weapons_item_pack | fmm_craftenmine_weapons_items_pack | craftenmines-weapons-item-pack |
Craftenmine Tools Item Pack | 自定义物品 | craftenmine_tools_item_pack | fmm_craftenmine_tools_items_pack | craftenmine-tools-item-pack |
配置文件名指的是 plugins/FreeMinecraftModels/content_packages/ 下的 .yml 条目名。文件夹名则是该包的模型实际位于 models/ 或 models_disabled/ 内的目录名，同时也是默认的内容/脚本文件前缀。
每个包都有本地文件夹名、Nightbreak 标识、版本字段以及在 content_packages 中的启用/禁用状态。两个 Craftenmine 物品包提供的是自定义物品（在 YML 中设置了 material: 的模型），可以使用完整的 Lua 物品脚本接口。
设置菜单管理什么
/fmm setup 是当前包状态的权威来源。该菜单可以区分：
- 已安装的包
- 已下载但当前禁用的包
- 过期的包
- 需要 Nightbreak 访问权限的包
设置菜单还会触发后台刷新以获取包版本和访问权限，因此该菜单是验证当前包状态的最佳位置。
文件夹行为
插件通过移动文件夹来管理启用和禁用的包内容：
- 启用的模型文件夹位于
models/<folderName> - 禁用的模型文件夹位于
models_disabled/<folderName> - 启用的脚本文件位于
scripts/ - 禁用的脚本文件位于
scripts_disabled/
这意味着一个包可以完全下载到磁盘上而不在运行时模型列表中处于激活状态。当包被安装或卸载时，它的模型文件夹和匹配的脚本文件会一起被移动。
文件前缀
每个内容包配置都有 contentFilePrefixes 字段和 scriptFilePrefixes 字段（两者均默认为包的 folderName）。名称以 contentFilePrefixes 中任一前缀开头的内容文件，以及 scripts/ 文件夹中名称以 scriptFilePrefixes 中任一前缀开头的脚本文件，都被视为该包的一部分，会在安装/卸载时随之移动。
下载与安装生命周期
分为两个明确的步骤：
- 下载包内容。
下载会进入
plugins/FreeMinecraftModels/imports然后触发一次重载/导入。 - 保持包启用或禁用。
设置菜单通过在
models与models_disabled之间移动文件夹来安装和卸载包。
批量操作遵循相同模式：
/fmm downloadall下载所有可访问但缺失或过期的包/fmm updatecontent仅更新已过期的包
两条批量命令在成功下载后都会自动重载 FreeMinecraftModels，以便新下载的内容立即可用。
管理员内容浏览器
/fmm admin 打开一个游戏内物品栏 GUI，让管理员一目了然地浏览所有已安装内容。浏览器会显示：
- 所有已安装的包（分别统计道具与物品数量）
- 未打包的模型文件夹（分别统计道具与物品数量）
- 各个道具（YML 配置中未设置
material:的模型） - 自定义物品（YML 配置中设置了
material:的模型）
道具与物品的显示有明显区分：道具使用黄色样式与纸张图标，自定义物品使用紫色样式并显示其所配置的材质。一个在 YML 中设置了 material: 的模型只会作为自定义物品出现，不会同时作为道具和物品出现。
点击管理员浏览器中的任何条目都会将该物品的副本给予玩家。对于自定义物品，给出的物品会包含已配置的材质、附魔、Lore 以及 fmm_item_id PDC 标签。这是测试与建造时获取道具、自定义物品或模型物品最快的方式，无需记住精确的模型 ID 或命令语法。