YuanX1a0/nailong-gtasa-mod

奶蛙 / Nailong — GTA:SA 皮肤模组（.dff + .txd）

把 Blender 版「奶蛙 / 奶龙 Nailoong」模型转换成 GTA:SA 可用的 ped 皮肤， 同时提供 服务器版（open.mp / SA-MP 0.3.DL 自定义皮肤）和 本地版（替换原生皮肤 280）。

---

一、下载

详细中文说明：docs/server-install.txt、docs/local-install.txt 皮肤 ID → 模型名对照表（全部 312 个）：docs/skin_id_model_map.txt

---

二、服务器版（3 步）

1. 把 nailong.dff、nailong.txd 放进服务端 models/ 目录
2. 在 models/artconfig.txt 加一行：

   AddCharModel(280, 20362, "nailong.dff", "nailong.txd");
   

3. 重启服务端，脚本里 SetPlayerSkin(playerid, 20362);

• 皮肤 ID：20362（未占用区间，可自行改成 20000–29999 内其他未占用 ID）
• 基础皮肤 280（lapd1），决定动画骨架；改成 0 即用 CJ 骨架
• artconfig.txt 需 LF 换行、无 BOM
• 客户端首次进服会从 artwork 端口自动下载 models（记得放通 7777/TCP 或对应端口）

---

三、本地版（替换皮肤 280）

包内文件已按皮肤 280 的真实模型名命名：lapd1.dff / lapd1.txd。

• 方法 A（推荐）：装 modloader.asi，把 lapd1.dff、lapd1.txd 丢进游戏根目录 modloader/
• 方法 B：用 Alci's IMG Editor / IMG Tool 打开 models/gta3.img，替换同名条目（先备份）

换成任意角色 ID：查 docs/skin_id_model_map.txt 得到该 ID 的模型名，把奶蛙的 dff/txd 重命名成该名字即可，可同时放多份。

本地替换只影响自己客户端；20000 以上的服务器自定义皮肤无法本地替换。

---

四、技术说明

• 32 根标准 ped 骨骼（名称带前导空格，如 " Head"、" L UpperArm"），与 WM1.dff 骨架一致
• 网格：10,800 面，单材质，1024×1024 烘焙贴图（纹理名 nailong）
• 腹部中线裂缝用体素重构（voxel remesh）+ 封孔处理；眼睛/嘴单独拆分保留后刚性绑定 Head 骨
• 已移除全部顶点色层，避免 SA 把黑色顶点色当作 prelight 导致模型发暗
• 构建脚本：source/build_nailong.py（Blender 5.0 + DragonFF），产出工程 source/nailong_ped.blend

---

五、许可（开源 · 禁止商用）

• 本项目（转换后的 dff/txd、脚本、文档）以 CC BY-NC 4.0 发布：可自由使用、修改、转载，禁止商业用途，转载需署名并保留本仓库链接。
• 原始 Blender 模型作者：WeDai — bigdiu/naiwa-nailoong-blender-model（该仓库同样声明：仅供学习练习、禁止商用、转载保留署名）。
• 角色「奶龙 / Nailoong」的形象版权归其原作者 / 版权方所有，本仓库不声称拥有该角色版权。
• 完整条款见 LICENSE，第三方署名见 NOTICE.md。

---

六、免责声明

本项目仅供学习与个人 / 非商业服务器使用。使用者需自行确认所在服务器与游戏的使用条款； 作者不对因使用本资源导致的任何账号、服务器或版权问题负责。