玛纳斯化妆品

Manas 装饰品

一个为你的 Minecraft 服务器打造的、以服务器为权威的装饰品引擎。

Manas 装饰品能让你的玩家随心所欲地装扮自己，包括翅膀、光环、帽子、宠物、武器皮肤等等：所有内容均为纯视觉效果，且全部通过游戏内的衣柜进行装备，同时你的服务器对谁真正拥有什么物品拥有完全且防篡改的控制权。它专为公共服务器和网络而构建，旨在提供一个精致、可盈利的装饰品系统，而无需在关键事项上信任客户端。

下载前须知： Manas 装饰品本身不附带任何装饰品。它是一个引擎（包括衣柜、所有权系统、光环/宠物/武器皮肤渲染器、箱子和礼包），你需要自行准备 Blockbench（.bbmodel）内容。如果你想要一个现成的翅膀和帽子包直接扔到服务器上，那这不是你要找的；但如果你（或你的美术人员）想要一个坚如磐石、防作弊的基础来构建装饰品经济，请继续阅读。

功能特性

装饰品槽位（共14个）： helmet（头盔）、above_head（头顶）、chestplate（胸甲）、back（背部）、front（胸前）、legs（腿部）、boots（靴子）、armor_set（全身套装，与四个盔甲部件槽位互斥）、ears（耳朵）、orbit（环绕）、pet（宠物）、weapon（武器）、aura（光环）、ground（地面）。

武器皮肤： 可将 weapon（武器）装饰品绑定至16种武器类型中的任意一种：剑、长剑、武士刀、小太刀、矛、锤、斧、镰刀、弓、苦无、盾牌、魔法书、法杖、镐、拳套、巨剑，外加一个通配的 any（任意）作为后备。系统采用基于标签的检测，因此皮肤可以自动适配模组武器和未列出的武器。

Blockbench 驱动的装饰品： 每个装饰品由一个 .bbmodel 文件和一个用于位置、缩放和旋转的 JSON 附属文件组成。游戏内提供实时变换编辑器（/manas_cosmetics edit），并附带一个个人 editmine（编辑我的）模式，玩家可在不影响其他人共享装饰品的情况下微调贴合度。

宠物： 可以放大原版生物，或携带一个完全自定义的 .bbmodel 伙伴。自定义宠物会根据其自身的动作（空闲、行走、奔跑、飞行、游泳，以及环境特效）进行动画表现，可以漂浮和飞行跟随主人，并显示一个友好名称。宠物无敌，免疫击杀指令，并在玩家登录时从玩家数据中重建，因此不会在世界中留下孤立实体。

光环： 一个程序化、基于粒子的光环系统，拥有数十种命名的渲染样式（上升微粒、光环、漩涡罩、符文圆环、环绕球体、火焰、五角星、召唤阵等等），跨越10种粒子纹理，完全可以在游戏内使用光环编辑器进行创作。光环在第一人称视角下也能正确渲染，并为想要隐藏自身光环的玩家提供了专用热键。

衣柜： 按下回车键或运行 /manas_cosmetics wardrobe 命令即可浏览和装备已拥有的装饰品，隐藏其下的原版装备，并保存多达10个命名预设，以便即时切换配装。

所有权与分发：

• 装饰品门票： 可兑换物品，右键点击即可解锁绑定的装饰品。
• 直接授予： 通过命令立即为玩家解锁或装备一件装饰品。
• 礼包： 一次性领取或带有冷却时间的捆绑包，可由管理员或特定的 LuckPerms 权限组领取，附带游戏内置的礼包构建器 GUI。
• 箱子： 类似战利品箱的随机解锁系统，使用钥匙开启，可配置预留池和槽位权重，附带游戏内置的箱子构建器 GUI。
• 一个 unlockall（全部解锁）开关允许工作人员按需预览每个装饰品，而不会授予真实所有权（也适用于与朋友的私人服务器）。

值得信赖的持久化： 每个玩家的数据（配装、预设、礼包冷却时间和所有权）会在任何权益变更时立即保存，因此崩溃不会让玩家或付费客户失去他们已获得的装饰品。

兼容性

Minecraft	1.21.1
加载器	Fabric & NeoForge
Java	21+
端侧	服务器权威：在你的服务器上安装服务器端 JAR，在你的玩家机器上安装客户端 JAR
需要	Architectury API (≥ 13.0.8), GeckoLib · Fabric 还需要 Fabric API
可选	包含额外武器类型（长剑、巨剑等）的模组 · LuckPerms（用于按权限组领取礼包）

快速上手

1. 在你的服务器上安装服务器端 JAR（同时安装 Architectury API、GeckoLib，如果你用的是 Fabric 还需要 Fabric API），并启动一次。这将生成包含 settings.json 以及 cosmetics/、models/ 和 kits/ 文件夹的 config/manas_cosmetics/ 目录。
2. 将你的 .bbmodel 文件放入 models/<槽位>/ 目录，并在 cosmetics/ 中定义匹配的附属文件（或使用 /manas_cosmetics generate 命令生成它们），然后运行 /manas_cosmetics reload 命令。
3. 通过 /manas_cosmetics unlock、give、giveitem 命令或礼包/箱子向玩家授予装饰品。
4. 玩家运行 /manas_cosmetics wardrobe 命令（或按回车键）来装备他们拥有的物品。
5. 将匹配的客户端 JAR 提供给玩家，以便他们在客户端看到并装备装饰品。

支持

免费提供，按“现状”提供，并在 Mod Discord 上提供尽力而为的社区支持。无服务等级协议，不保证支持未来的 Minecraft 版本。

许可证

许可证类型： 保留所有权利，自定义许可证（Manas 装饰品许可证）

Manas 装饰品可免费下载和使用，包括在营利性服务器上。但你不能：

• 不得修改。 不得反编译、逆向工程、编辑或重新打包本模组，或分发其修改版本。
• 不得使用衍生资产。 本模组（或任何 ManasMods 模组）附带包含的模型、纹理、动画和其他创意资产，不得提取、重制纹理、重新绑定或重新利用，包括将它们变成宠物、装饰品或其他模组、服务器或项目的内容。无论你将其按原样使用还是作为新内容的“基础”，此规定均适用。
• 不得再分发。 下载仅通过我们的官方渠道（CurseForge 和 Modrinth）分发。请勿在其他任何地方重新托管、镜像或捆绑这些文件。
• 不得出售模组本身。 出售或付费墙阻拦本模组或其资产是不被允许的。

此保护涵盖 ManasMods 发布的每个模组和资产，以及我们分发的每个平台，而不仅仅是本项目。完整的法律条款包含在随附的 LICENSE 文件中。

Minecraft EULA

Manas 装饰品旨在 Mojang 的 Minecraft 最终用户许可协议和 Minecraft 使用准则范围内运行。它是一个独立的附加组件，不重新分发任何 Minecraft 代码或资产，也不声称与 Mojang 或 Microsoft 有关联或获得其认可。它启用的装饰品严格属于视觉效果：不提供游戏玩法优势，不限制生存模式功能的访问，也不影响游戏平衡，这正是 Mojang 准则所允许的服务器盈利方式（外观和装饰物品），而非氪金变强机制或付费访问游戏。服务器所有者在销售装饰品或权限组时，仍需自行确保合规性；我们建议直接查阅 Mojang 当前的 Minecraft 使用准则，因为这些条款由 Mojang 制定，并且可能独立于此处的任何陈述而发生变化。

作者： ManasMods