Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
CNPC-Gecko-Addon-CE
Community-maintained edition of CNPC Gecko Addon.
Driven by community feedback and real production needs for CNPC creators.
CNPC Gecko Addon 社区维护版本。
基于社区反馈与实际制作需求持续维护与扩展。
About | 关于
CNPC Gecko Addon CE is a community-maintained continuation of the original CNPC Gecko Addon.
The goal of this project is not to replace the original addon, but to improve usability, stability, and scripting flexibility based on community needs.
It focuses on:
- Production-oriented improvements
- Script system usability enhancements
- Stability fixes in modded environments
- Maintaining compatibility with existing CNPC workflows
CNPC Gecko Addon CE 是原 CNPC Gecko Addon 的社区维护延续版本。
本项目的目标并非替代原版附属,而是在保持兼容性的基础上:
- 根据社区需求优化实用性
- 提升脚本系统的易用性与扩展性
- 修复复杂模组环境下的稳定性问题
- 保持与现有 CNPC 工作流兼容
Features | 功能
Extended Animation System | 动画系统扩展
- Attack animation menu (up to 20 animations)
- Hurt animation menu (up to 20 animations)
- Death animation menu (up to 20 animations)
- Weighted animation selection system
- 攻击动画菜单(最多 20 个)
- 受伤动画菜单(最多 20 个)
- 死亡动画菜单(最多 20 个)
- 支持权重随机播放系统

Script Model Controller | 脚本模型控制系统
Scripted items can dynamically control Gecko models at runtime.
Supported features:
- Model switching
- Texture binding
- Animation file binding
- Idle animation control
- Runtime animation playback
- Scale / Rotation control
- Inventory display adjustment (size & offset)
脚本载体可在运行时动态控制 Gecko 模型。
支持功能:
- 模型切换
- 贴图绑定
- 动画文件绑定
- 待机动画控制
- 动画运行时播放
- 缩放 / 旋转控制
- 物品栏显示调整(大小与偏移)

Stability Improvements | 稳定性优化
- Fixed Gecko model jitter during NPC loading
- Fixed limb flickering in heavily modded environments
- Improved animation sync stability under multi-mod setups
- 修复 NPC 加载 Gecko 模型时的抽搐问题
- 修复多模组环境下肢体闪回问题
- 提升多模组环境动画同步稳定性
GitHub Issues | Issue / Feedback
Have an idea, found a bug, or want to suggest improvements?
Please use GitHub Issues as the primary feedback channel for:
- Bug reports
- Feature requests
- Usage feedback
- Improvement suggestions
GitHub Issues | 问题反馈
有想法、Bug 或优化建议?
请优先通过 GitHub Issues 提交,包括:
- Bug 反馈
- 功能需求
- 使用问题
- 改进建议
You may also contact the maintainer via Bilibili dynamic or community channels:
Discord is not actively monitored.
也可以通过 Bilibili 动态或社区渠道联系维护者:
Discord 并非主要维护渠道,回复较少。
Roadmap | 开发计划
This project currently prioritizes:
- Minecraft 1.20.1 Forge
- Minecraft 1.12.2 Forge
Future support for additional versions may be considered via community demand.
Planned features:
- Static OBJ model support (non-animated)
本项目当前优先支持:
- Minecraft 1.20.1 Forge
- Minecraft 1.12.2 Forge
未来是否支持更多版本将根据社区需求决定。
计划功能:
- OBJ 静态模型支持(非动画)
Credits | 致谢
Original project: Goodbird
Maintained under MIT License.
Special thanks to the CNPC community for feedback, testing, and suggestions.
原始项目:Goodbird
本项目基于 MIT License 维护。
感谢 CNPC 社区所有提供反馈、测试与建议的成员。
License | 许可证
MIT License.
Please retain original copyright notice when redistributing or modifying.
MIT License。
二次分发或修改时请保留原始版权信息。


