TACZ: Advanced Skin System

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 枪械包）。把它放进去，/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 美术、所有命令和配置选项、UI 换肤以及故障排除。

命令

/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 补全，并会根据实时注册表进行验证。

要求

| | |
|—|—|
| Minecraft | 1.21.1 |
| 加载器 | NeoForge 21.1.233+ |
| 必需 | TACZ（MUKSC 分支）、neoforge/1.21.1 分支、客户端 和 服务端 |
| 另外 | 至少一个 TACZ 枪械包（默认的 tacz 即可）。MCPSkins 本身不添加任何枪械。 |

备注

• 专为 MUKSC NeoForge 移植版构建。完整的 3D 模型替换钩子接入该分支的模型加载器；在其他构建上，这些功能会自动关闭而不是崩溃。
• 替换模型必须与基础武器的动画共享骨骼名称。不匹配时会回退到基础几何体；损坏的 LOD 会回退到全细节模型。
• 服务端美术托管可让皮肤不包含在整合包下载中。这不是 DRM。客户端渲染的任何内容，有决心的客户端都能恢复。
• 失败时会记录一行可读日志，前缀为 [MCPSkins]。请在错误报告中附上它，以及你的 TACZ 和枪械包版本。

MIT 许可，因此可在任何整合包中使用，无论公开或私有。