TACZ：高级皮肤系统

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 涵盖包结构、完整 schema、3D 模型和 LOD 美术、所有命令和配置选项、重绘 UI，以及故障排除。

命令

/mcpskins give skin <player> <skinId>    解锁皮肤
/mcpskins give item <player> <skinId>    给予实体解锁物品
/mcpskins give all  <player>             解锁全部
/mcpskins take skin <player> <skinId>    移除一个皮肤
/mcpskins take skins <player>            清除所有皮肤
/mcpskins armory [skinId]                打开军械库（无需权限）

give/take 需要 OP（等级可配置）。皮肤 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 许可，因此可在任何整合包中使用，无论公开或私有。