TACZ: Advanced Skin System (NEOFORGE)

TACZ：高级皮肤系统（MCPSkins）

TACZ 的武器储藏库。解锁皮肤，并将其应用到任意枪械上。

功能介绍

MCPSkins 在 TACZ-1.21.1 上添加了一层皮肤。皮肤会改变武器的呈现效果（纹理、物品栏图标、HUD 图标、远距离模型或整个 3D 模型），但绝不会改变武器本身。没有重复物品，不会丢失配件，也不耍 NBT 把戏。适用于任何已注册的 GunId，包括官方枪械包和第三方枪械包。

• 可以重新绘制纹理，也可以替换整个几何模型，同时沿用基础武器的动画
• 可选自定义物品栏图标、HUD 图标（包括空弹匣状态）和低细节 LOD 模型
• 可选稀有度、收藏系列、描述、解锁提示和 NEW 标记，方便浏览和筛选
• 将皮肤标记为初始皮肤后，每位玩家首次加入时都会自动获得，无需命令
• 也能为 TACZ 配件添加皮肤：瞄准镜、握把和枪口配件同样支持纹理、图标和模型替换
• 使用普通的 .png.mcmeta 为任意皮肤纹理或图标添加动画，文件格式与资源包使用的相同
• 可提供 LabPBR 法线贴图和高光贴图，供光影用户使用；客户端仍然无需安装任何东西
• 可在整合包内提供任意语言的皮肤名称、描述和稀有度，客户端无需安装任何东西

皮肤包

将文件夹或 .zip 放入运行世界的设备上的 mcpskins/，然后 /reload。无需 pack.mcmeta、资源包或数据包，也适用于已经开始游玩的世界。

玩家无需安装任何东西。需要渲染时，资源会从服务器传输到各个客户端。

不想从零开始制作，只想先看看效果？画廊里有现成的皮肤包等你体验：在此获取示例皮肤包（仅适用于 IMMERSIVE/CREATE:ARMORY GUNPACK）。放进去，/reload，然后点击 K。

两种浏览方式

皮肤军械库。全屏三栏目录：左侧是你的军械库，中间是可拖动旋转的真实武器 3D 预览，右侧则是皮肤图块、详细信息和装备按钮。搜索会同时检索所有武器；还提供已拥有/已锁定、是否有 3D 模型筛选，以及排序功能。按下 K（可重新绑定）或 /mcpskins armory 即可打开，空手时也能使用。

改装轮播栏。嵌入 TACZ 自带改装界面的紧凑皮肤栏，可为手中武器更换皮肤。支持拖动调整位置。

在两个界面中，已锁定皮肤都会在真实模型上实时预览，完全在客户端运行。

两个界面都使用普通纹理绘制，而非硬编码颜色，因此普通资源包也能重新绘制整个界面。如果你想在现有基础上修改，而不是从零开始，默认界面所用的生成器也随源代码一并提供。

所有权

已解锁的皮肤保存在服务器端：死亡后仍会保留，登录和重生时会同步，也无法伪造。你可以通过命令发放，也可以发放实体解锁道具；这些道具可以交易、丢弃，工具提示还会准确显示其中包含的内容。对一叠重复道具按住 Shift 并右键点击，即可将它们合成为高一阶的道具，并优先生成玩家尚未拥有的皮肤。

皮肤还可以附带自由文本解锁提示，例如“使用 AK-47 击杀 250 人”。皮肤锁定时，提示会显示在锁头旁边。这只是对你实际采用的进度系统的说明，不会单独构成解锁条件。

皮肤包也可以附带初始皮肤。将皮肤标记为 "unlocked": true 后，每位玩家从首次加入起就会拥有它，无需命令，也无需后台程序持续运行。

稀有度等级、合成路线、掉落权重和费用都由皮肤包定义，因此皮肤包自带进度系统，无需匹配的服务器配置。默认提供从普通到传奇的等级，你也可以自由添加、重命名或调整等级路线。

添加皮肤

my_skinpack/data/<namespace>/skins/m4a1.json

{
  "base_gun": "tacz:m4a1",
  "skins": [
    {
      "id": "m4a1_cobra",
      "name": "Cobra",
      "label_color": "0xFF5533",
      "rarity": "rare",
      "collection": "Snake Pack",
      "description": "Strike fast, strike quiet.",
      "locked_text": "Fuse three rare skins",
      "is_new": true
    }
  ]
}

my_skinpack/assets/mcpskins/textures/skins/tacz/m4a1/m4a1_cobra.png

name和label_color以下的所有内容均为可选项。皮肤 ID 是全局唯一的，因此请为它们命名为 <weapon>_<skin>.

完整文档与 Wiki涵盖整合包布局、完整架构、3D 模型与 LOD 美术、所有命令和配置选项、界面换肤以及故障排查。

命令

/mcpskins give skin <player> <skinId>    Unlock a skin
/mcpskins give item <player> <skinId>    Give a physical unlock item
/mcpskins give all  <player>             Unlock everything
/mcpskins take skin <player> <skinId>    Remove one skin
/mcpskins take skins <player>            Clear all skins
/mcpskins armory [skinId]                Open the Armory (no permission needed)

give/take需要管理员权限（等级可配置）。皮肤 ID 支持 Tab 自动补全，并会根据当前注册表进行验证。

要求

备注

• 本模组专为 MUKSC 的 NeoForge 移植版打造。完整 3D 模型替换功能依赖该分支的模型加载器；在其他版本上，这些功能会自动关闭，而不会导致崩溃。
• 替换模型必须与基础武器动画使用相同的骨骼名称。如果名称不匹配，将回退到基础几何模型；如果 LOD 损坏，则会回退到完整细节模型。
• 服务端托管美术资源，可避免皮肤被打包进整合包下载文件中。但这并非 DRM。客户端能渲染的内容，决心足够的客户端就能提取出来。
• 。错误日志会输出一条易读的信息，并以 [MCPSkins] 为前缀。提交错误报告时，请附上这条日志，以及 TACZ 和枪械包的版本号。

采用 MIT 许可证，可用于任何整合包，无论公开还是私有。