Manas Cosmetics

Manas Cosmetics

为你的 Minecraft 网络提供由服务器权威控制的外观引擎。

Manas Cosmetics 让玩家可以装扮上翅膀、光环、帽子、宠物、武器皮肤等外观：所有内容都纯属视觉效果，玩家可在游戏内的衣橱中装备；与此同时，服务器会全面掌控每件物品的实际所有权，防止篡改。专为公共服务器和服务器网络打造，为你提供精致且可商业化的外观系统，无需在任何重要事项上信任客户端。

下载前请注意：Manas Cosmetics 开箱不附带任何外观内容。它提供的是引擎（衣橱、所有权系统、光环／宠物／武器皮肤渲染器、宝箱和套装），而你需要自行准备 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 种粒子纹理；所有内容都能通过光环编辑器在游戏内制作。光环在第一人称视角下也能正确渲染，玩家还可以使用专用快捷键隐藏自己的光环。

衣橱：按下 Enter 或运行 /manas_cosmetics wardrobe，即可浏览并装备已拥有的外观、隐藏外观下方的原版装备，还可保存最多 10 组命名预设，快速切换整套配置。

所有权与分发：

• 外观兑换券：可兑换的物品，右键即可解锁绑定的外观。
• 直接发放：通过命令立即为玩家解锁或装备外观。
• 礼包：可领取一次或带有冷却时间的奖励包，可由管理员或特定的 LuckPerms 等级领取，并提供游戏内礼包编辑器 GUI。
• 宝箱：类似战利品箱的随机解锁奖励，使用宝箱钥匙开启，可配置专属奖励池和槽位权重，并提供游戏内宝箱编辑器 GUI。
• unlockall 开关可让管理人员按需预览所有外观，而不会授予实际所有权（也适用于和朋友一起游玩的私人服务器）。

可靠的数据持久化：每当权益发生变化时，都会立即保存玩家数据（装备配置、预设、礼包冷却时间和所有权），因此即使服务器崩溃，玩家或付费用户也不会失去已经获得的外观。

兼容性

入门指南

1. 将服务器 JAR 安装到服务器上（同时安装 Architectury API、GeckoLib；如果使用 Fabric，还需安装 Fabric API），然后启动一次。这会生成 config/manas_cosmetics/，其中包含 settings.json 以及 cosmetics/、models/ 和 kits/ 文件夹。
2. 将 .bbmodel 文件放入 models/<slot>/，并在 cosmetics/ 中创建匹配的配套文件（或使用 /manas_cosmetics generate 生成），然后运行 /manas_cosmetics reload。
3. 使用 /manas_cosmetics unlock、give、giveitem 命令，或通过礼包/宝箱向玩家发放外观。
4. 玩家运行 /manas_cosmetics wardrobe（或按 Enter）即可装备已拥有的外观。
5. 将对应的客户端 JAR 提供给玩家，这样他们就能在客户端看到并装备外观。

支持

免费提供，按现状使用；可在 模组 Discord 获取尽力而为的社区支持。不提供服务等级协议（SLA），也不保证支持未来的 Minecraft 版本。

许可

许可类型：保留所有权利，自定义许可（Manas Cosmetics 许可）

Manas Cosmetics 可免费下载和使用，包括用于营利性服务器。以下行为不允许：

• 不得修改。不得反编译、逆向工程、编辑或重新打包该模组，也不得分发其修改版本。
• 不得制作衍生素材。本模组（或任何 ManasMods 模组）附带的模型、纹理、动画及其他创作素材均不属于你，你不得提取、重新绘制纹理、重新绑定或将其用于其他用途，包括将其制作成宠物、装饰品，或用于其他模组、服务器或项目。无论你是原样使用，还是将其作为创作新内容的“基础”，都受此限制。
• 不得重新分发。下载文件仅通过我们的官方渠道（CurseForge 和 Modrinth）分发。不得在其他任何地方重新托管、镜像或打包这些文件。
• 不得出售模组本身。不得出售该模组或我们的素材，也不得将其设为付费墙内容。

此保护适用于 ManasMods 发布的所有模组和素材，以及我们进行分发的所有平台，并不限于本项目。完整法律条款请参见随附的 LICENSE 文件。

Minecraft 最终用户许可协议

Manas Cosmetics 的设计遵循 Mojang 的《Minecraft 最终用户许可协议》和《Minecraft 使用指南》。它是一个独立的附加内容，不会重新分发任何 Minecraft 代码或素材，也不声称与 Mojang 或 Microsoft 有任何关联或获得其认可。它所启用的装饰内容纯粹是视觉效果：不会带来游戏优势，不会限制生存模式功能的使用，也不会影响平衡。这正符合 Mojang 指南所允许的服务器变现方式（外观和装饰物品），而非“付费取胜”机制或付费限制游戏访问。出售装饰品或等级时，服务器所有者仍需自行确保合规；我们建议直接查阅 Mojang 当前的《Minecraft 使用指南》，因为相关条款由 Mojang 制定，且可能独立于本文内容发生变化。

作者：ManasMods