CNPC-Gecko-Addon-CE

Community-maintained edition of CNPC Gecko Addon.

CNPC-Gecko-Addon-CE continues the original addon with improvements based on community feedback and real-world CustomNPCs production needs.

The goal of this project is not to replace the original addon, but to improve usability, stability, compatibility, and scripting flexibility while keeping existing CNPC workflows.

---

Supported Versions

Currently maintained versions:

• Minecraft 1.12.2 Forge
• Minecraft 1.20.1 Forge
• Minecraft 1.21.1 NeoForge

---

Features

Extended Animation System

Provides additional animation controls for Gecko-based CustomNPCs models.

Features:

• Attack animation menu (up to 20 animations)
• Hurt animation menu (up to 20 animations)
• Death animation menu (up to 20 animations)
• Weighted random animation selection

---

Script Model Controller

Allows scripted items to dynamically control Gecko models during gameplay.

Supported controls:

• Model switching
• Texture binding
• Animation file binding
• Idle animation control
• Runtime animation playback
• Model scale and rotation control
• Inventory display size and offset adjustment

This allows creators to build more dynamic NPC systems through CustomNPCs scripting.

---

Stability Improvements

CNPC-Gecko-Addon-CE includes various fixes for complex modded environments.

Improvements:

• Fixed Gecko model jitter during NPC loading.
• Fixed limb flickering issues.
• Improved animation synchronization stability.
• Fixed incorrect animation states that could cause abnormal model offsets.
• Improved idle and walking animation transition reliability.

---

For Creators

Designed for:

• CustomNPCs map creators.
• Adventure map developers.
• RPG server developers.
• Script creators.
• Modpack developers.

CNPC-Gecko-Addon-CE provides additional tools for creating animated NPCs and custom characters.

---

Community Project

CNPC-Gecko-Addon-CE is maintained by the community.

Development focuses on:

• Practical improvements requested by creators.
• Compatibility with existing CNPC workflows.
• Stability in large modded environments.

---

Feedback

For bug reports, feature requests, and suggestions:

Please use GitHub Issues as the primary feedback channel.

You may also contact the maintainer through community channels.

Discord is not actively monitored.

---

Credits

Original project: Goodbird

Maintained under MIT License.

Special thanks to the CNPC community for testing, feedback, and suggestions.

---

License

MIT License.

Please retain original copyright information when redistributing or modifying.

---

简体中文

CNPC-Gecko-Addon-CE

CNPC Gecko Addon 社区维护版本。

CNPC-Gecko-Addon-CE 是原 CNPC Gecko Addon 的社区维护延续版本。

本项目基于社区反馈以及实际 CustomNPCs 制作需求持续优化。

项目目标不是替代原版附属，而是在保持兼容性的基础上：

• 提升易用性。
• 增强稳定性。
• 改善兼容性。
• 扩展脚本控制能力。

---

支持版本

当前维护：

• Minecraft 1.12.2 Forge
• Minecraft 1.20.1 Forge
• Minecraft 1.21.1 NeoForge

---

功能特点

动画系统扩展

为 Gecko 模型 NPC 提供更多动画控制能力。

支持：

• 攻击动画菜单（最多 20 个）
• 受伤动画菜单（最多 20 个）
• 死亡动画菜单（最多 20 个）
• 权重随机动画播放

---

脚本模型控制系统

允许脚本载体在运行时动态控制 Gecko 模型。

支持：

• 模型切换。
• 贴图绑定。
• 动画文件绑定。
• 待机动画控制。
• 运行时动画播放。
• 模型缩放与旋转控制。
• 物品栏显示大小与偏移调整。

帮助地图作者通过 CustomNPCs 脚本制作更加复杂的 NPC 系统。

---

稳定性优化

针对大型模组环境进行了多项修复：

• 修复 Gecko 模型加载时抽搐问题。
• 修复肢体闪烁问题。
• 提升多模组环境动画同步稳定性。
• 修复动画状态异常导致的模型偏移问题。
• 改善待机与移动动画切换可靠性。

---

面向创作者

适用于：

• CustomNPCs 地图作者。
• 冒险地图制作者。
• RPG 服务器开发者。
• 脚本开发者。
• 整合包作者。

CNPC-Gecko-Addon-CE 为制作高质量动画 NPC 和自定义角色提供更多工具。

---

社区项目

CNPC-Gecko-Addon-CE 由社区维护。

主要方向：

• 根据创作者需求持续优化。
• 保持 CNPC 工作流兼容。
• 提升大型模组环境稳定性。

---

问题反馈

Bug、功能建议以及使用反馈：

请优先通过 GitHub Issues 提交。

也可以通过社区渠道联系维护者。

Discord 并非主要维护渠道。

---

致谢

原始项目：

Goodbird

本项目基于 MIT License 维护。

感谢 CNPC 社区所有参与测试、反馈和提出建议的成员。

---

许可证

MIT License。

二次分发或修改时请保留原始版权信息。