自定义种族框架

自定义种族框架 是一款有趣且易于使用的模组，让你能创建并扮演自定义的 RPG 种族、变身为野兽、使用 3D 生物模型，以及施放主动技能或魔法！

无论你是想成为精灵弓箭手、火焰恶魔，还是能变成巨兽的狼人，这款模组都能让你完全掌控角色的属性、外观和能力。

---

✨ 主要特性

🧬 自定义种族与属性

• 创建任意种族：为种族赋予额外生命值、更快的奔跑速度、更高的跳跃能力、夜视、水下呼吸或免疫摔落伤害等特性。
• VIP 与锁定种族：通过服务器权限锁定特殊或赞助者种族。被锁定的种族会在种族选择菜单中显示 🔒 VIP 徽章。
• 首次加入菜单：新玩家首次加入你的世界或服务器时，会自动获得一个简洁的种族选择菜单。

---

🐺 自定义 3D 模型与变形

⚠️ 注意：自定义 GeckoLib 3D 模型目前仍在开发中（WIP），并将在后续更新中积极改进！这些应被视为路线图目标：

• 自定义 3D 生物模型：变身为 GeckoLib 3D 模型，例如狼人、龙、熊、骷髅或恶魔！
• 隐藏玩家模型：变形时会隐藏你正常的 Minecraft 人类皮肤，让模型看起来更干净、自然。
• 自定义纹理与皮肤：自定义模型可以使用自己的 PNG 纹理，或自动使用你的玩家皮肤。
• 直立行走与动画：模型会在地面上直立站立，并在你行走、奔跑和攻击时自然地摆动四肢。
• 黑暗粒子烟雾特效：变身后的野兽会在身体周围散发粒子烟雾云。

---

⚡ 主动技能与魔法咒语

• 按键绑定技能：使用简单的键盘快捷键，激活最多 5 个自定义种族技能。
• 支持 Iron's Spells：直接通过你的种族技能按键，施放来自 Iron's Spells 'n Spellbooks 的魔法咒语！
• 自定义身体部件：为任何种族添加 3D 耳朵、角、尾巴、翅膀、光环或额外的腿，并支持自定义颜色和位置。

---

📐 玩家尺寸与身高（Pehkui）

• 与 Pehkui 兼容，可让种族变得更高、更矮、更宽，或缩小以通过狭窄的隧道。

---

🛡️ 流畅的服务器与多人游戏性能

• 零卡顿：高度优化的渲染确保了高 FPS 下流畅、无卡顿的游戏体验。
• 多人游戏同步：服务器上的其他玩家将实时看到你的自定义 3D 模型、变形状态和技能。
• 服务器支持：可在 Fabric、Forge 及混合服务器（如 Mohist）上运行。

---

🖥️ 命令与游戏内菜单

• /custom_races select — 打开种族选择菜单，以选择或更换你的种族。
• /custom_races transform — 手动开启或关闭你的野兽/狼人形态变形。
• /custom_races codex — 打开种族法典，阅读种族传说并查看 3D 角色预览。
• /custom_races get — 在聊天框中显示你当前激活的种族。
• /custom_races admin editor — 管理员 GUI，可直接在游戏内设计新种族！
• /custom_races admin reload — 供服务器所有者使用的命令，用于重新加载种族配置。

---

🔌 需求与兼容性

Mod	是否需要？	作用
Architectury API	必需	Fabric 和 Forge 所需的核心框架。
GeckoLib 4	推荐	启用自定义 3D 动画模型（开发中）。
Pehkui	可选	允许改变玩家的高度、宽度和碰撞箱大小。
Iron's Spells 'n Spellbooks	可选	允许种族技能施放魔法咒语。

---

🛠️ 整合包与服务器许可

你可以自由地将自定义种族框架包含在任何整合包或公共服务器中！