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

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
• Fixed an issue where Gecko NPCs could become stuck in an incorrect animation state, causing abnormal model offsets and delayed idle/walk animation transitions.

• 修复 NPC 加载 Gecko 模型时的抽搐问题
• 修复多模组环境下肢体闪回问题
• 提升多模组环境动画同步稳定性
• 修复 Gecko NPC 动画状态偶尔卡死的问题，该问题会导致模型异常平移，并造成待机/移动动画切换异常或延迟恢复。

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:

• https://space.bilibili.com/353609880/dynamic

Discord is not actively monitored.

也可以通过 Bilibili 动态或社区渠道联系维护者：

• https://space.bilibili.com/353609880/dynamic

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。

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