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。

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

CNPC Gecko Addon CE