{"id":31756545,"url":"https://github.com/jieice/proceduralnpc","last_synced_at":"2025-10-26T20:53:10.239Z","repository":{"id":318645839,"uuid":"1072157097","full_name":"Jieice/ProceduralNPC","owner":"Jieice","description":"Complete procedural horror NPC system for Godot 4.x","archived":false,"fork":false,"pushed_at":"2025-10-08T10:42:52.000Z","size":2984,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-08T12:30:31.706Z","etag":null,"topics":["game-assets","game-development","gdscript","godot","godot-engine","godot4","horror-game","indie-game","jumpscare","npc","open-source","procedural-generation"],"latest_commit_sha":null,"homepage":"https://jiedimension.itch.io/proceduralnpc","language":"GDScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jieice.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-08T10:38:11.000Z","updated_at":"2025-10-08T11:53:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"ba290d04-2a86-49c3-9a83-de67869e3b1d","html_url":"https://github.com/Jieice/ProceduralNPC","commit_stats":null,"previous_names":["jieice/proceduralnpc"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Jieice/ProceduralNPC","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jieice%2FProceduralNPC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jieice%2FProceduralNPC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jieice%2FProceduralNPC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jieice%2FProceduralNPC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jieice","download_url":"https://codeload.github.com/Jieice/ProceduralNPC/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jieice%2FProceduralNPC/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281171878,"owners_count":26455537,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-26T02:00:06.575Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game-assets","game-development","gdscript","godot","godot-engine","godot4","horror-game","indie-game","jumpscare","npc","open-source","procedural-generation"],"created_at":"2025-10-09T19:19:11.664Z","updated_at":"2025-10-26T20:53:10.195Z","avatar_url":"https://github.com/Jieice.png","language":"GDScript","funding_links":["https://ko-fi.com/yourusername"],"categories":[],"sub_categories":[],"readme":"# ProceduralNPC v4.0 🎮👻\n\n[![Godot Engine](https://img.shields.io/badge/Godot-4.x-blue.svg)](https://godotengine.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Version](https://img.shields.io/badge/Version-4.0-green.svg)](CHANGELOG.md)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/yourusername/ProceduralNPC/pulls)\n\n**完全程序化的恐怖NPC生成系统 | Complete Procedural Horror NPC System**\n\n一个为Godot 4.x设计的商业级程序化NPC生成器，无需任何3D建模软件，纯代码生成！\n\n*A commercial-quality procedural NPC generator for Godot 4.x - No 3D modeling software required, pure code!*\n\n---\n\n## 📸 截图展示 | Screenshots\n\n![Cover](Screenshots/cover.png)\n*封面展示 | Cover Image*\n\n![Jumpscare Demo](Screenshots/jumpscare_demo.png)\n*跳脸效果演示 | Jumpscare Effect Demo*\n\n![Editor Preview](Screenshots/editor_preview.png)\n*编辑器实时预览 | Real-time Editor Preview*\n\n---\n\n## ✨ 核心特性 | Core Features\n\n| 功能 | 说明 |\n|------|------|\n| 🎨 **100%程序化** | 无需Blender，纯代码生成3D模型 |\n| 👔 **服装系统** | 夹克、裤子、鞋子，实时调色 |\n| 😱 **真跳脸模式** | 无视方向，直接瞬移到摄像机前 |\n| 🎛️ **实时编辑器预览** | 所见即所得，Inspector改参数立即生效 |\n| 🔧 **防倾斜系统** | 自动旋转矫正，不再歪脖子 |\n| 🔴 **红光聚光灯** | 可调节位置/旋转，恐怖氛围拉满 |\n| 🔊 **内置音频系统** | 拖拽式AudioStream，无需AudioManager |\n| 📦 **零依赖** | 完全独立，复制即用 |\n| 💼 **商用友好** | MIT License，免费商用 |\n\n---\n\n## 🚀 5分钟快速开始 | Quick Start\n\n### 📥 安装 | Installation\n\n**方法1：下载Release**\n```bash\n# 1. 下载最新Release ZIP\n# 2. 解压到你的Godot项目\n# 3. 复制 Scripts/ProceduralNPC.gd 到你的项目\n```\n\n**方法2：Git Clone**\n```bash\ngit clone https://github.com/yourusername/ProceduralNPC.git\n```\n\n详细安装步骤见 → [INSTALL.md](INSTALL.md)\n\n---\n\n### 💻 使用示例 | Usage Example\n\n```gdscript\n# 1️⃣ 创建NPC节点\nvar npc = preload(\"res://Scripts/ProceduralNPC.gd\").new()\nadd_child(npc)\n\n# 2️⃣ 自定义外观（可选）\nnpc.npc_style = ProceduralNPC.NPCStyle.HORROR\nnpc.enable_clothing = true\nnpc.jacket_color = Color(0.1, 0.1, 0.2)  # 深蓝色夹克\n\n# 3️⃣ 触发跳脸！\nnpc.trigger_jumpscare(player)  # 就这么简单！\n\n# 4️⃣ 高级用法：风格转换\nnpc.switch_to_horror_style(2.0)  # 2秒渐变为恐怖风格\n```\n\n**完整文档：**\n- 📖 [English Documentation](Documentation/README.md)\n- 📖 [中文文档](Documentation/README_CN.md)\n\n---\n\n## 📦 包含内容 | What's Included\n\n```\nProceduralNPC_Release/\n├── Scripts/\n│   └── ProceduralNPC.gd       # 主脚本 (1900+行)\n├── Documentation/\n│   ├── README.md              # 英文完整文档\n│   └── README_CN.md           # 中文完整文档\n├── Assets/\n│   ├── jumpscare_scream.mp3   # 示例尖叫音效\n│   └── jumpscare_hit.mp3      # 示例撞击音效\n├── Examples/                  # 示例场景（即将添加）\n├── INSTALL.md                 # 安装指南\n├── CHANGELOG.md               # 更新日志\n└── LICENSE                    # MIT许可证\n```\n\n---\n\n## 🎯 适用场景 | Perfect For\n\n✅ 恐怖游戏开发  \n✅ 独立游戏项目  \n✅ 快速原型设计  \n✅ 学习程序化生成  \n✅ Game Jam开发  \n✅ 叙事型游戏  \n✅ 追逐序列场景  \n\n---\n\n## 🔧 技术规格 | Technical Specs\n\n- **代码量：** 1900+ 行优化的GDScript\n- **参数数量：** 60+ 可调参数\n- **视觉风格：** NORMAL | HORROR | LOW_POLY\n- **Godot版本：** 4.0+\n- **依赖：** 无\n- **Linter错误：** 0\n- **许可证：** MIT\n\n---\n\n## 📖 完整功能清单 | Full Feature List\n\n\u003cdetails\u003e\n\u003csummary\u003e点击展开 60+ 功能列表\u003c/summary\u003e\n\n### 程序化生成\n- ✅ 头部、躯干、四肢完全程序化\n- ✅ 精细面部特征（眼睛、鼻子、嘴巴、耳朵）\n- ✅ 手指和关节细节\n- ✅ 多风格支持\n\n### 服装系统 ⭐\n- ✅ 夹克（可调颜色）\n- ✅ 裤子（可调颜色）\n- ✅ 鞋子（可调颜色）\n- ✅ 单独开关\n- ✅ 实时编辑器预览\n\n### 跳脸系统 ⭐\n- ✅ 真跳脸 - 无视方向瞬移到摄像机前\n- ✅ 头部精准对齐摄像机\n- ✅ 90度手部抓取动画\n- ✅ 尖叫动画（逼真张嘴）\n- ✅ 红色聚光灯（从脖子发出）\n- ✅ 可调节聚光灯位置/旋转\n- ✅ 实时聚光灯预览\n- ✅ 内置音频系统（AudioStreamPlayer3D）\n- ✅ 拖拽式AudioStream文件\n- ✅ 音频开关\n\n### 旋转锁定系统 ⭐\n- ✅ 防止前后倾斜（锁定X轴）\n- ✅ 防止左右倾斜（锁定Z轴）\n- ✅ 手动调试模式\n- ✅ 编辑器+运行时生效\n- ✅ 修复动画冲突\n\n### 编辑器增强\n- ✅ 所有参数实时预览\n- ✅ 服装颜色即时更新\n- ✅ 可视化聚光灯调整\n- ✅ `@tool` 脚本支持\n\n### 恐怖效果\n- ✅ 高级Shader（可选）\n- ✅ 漂浮效果\n- ✅ 抽搐效果\n- ✅ 身体扭曲\n- ✅ 眼睛闪烁\n- ✅ 幽灵透明\n\n### 其他特性\n- ✅ 自动碰撞生成\n- ✅ 边缘光照\n- ✅ 呼吸动画\n- ✅ 微妙抖动\n- ✅ 完整文档\n\n\u003c/details\u003e\n\n---\n\n## 💡 常见问题 | FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eQ: NPC会倾斜怎么办？\u003c/strong\u003e\u003c/summary\u003e\n\n确保 `Lock Rotation X` 和 `Lock Rotation Z` 被勾选（默认开启），NPC会自动矫正。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eQ: 跳脸只转身不瞬移？\u003c/strong\u003e\u003c/summary\u003e\n\n确保 `Jumpscare Always Teleport = true`（默认开启），这样无论距离都会瞬移。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eQ: 看不到聚光灯？\u003c/strong\u003e\u003c/summary\u003e\n\n勾选 `Jumpscare Spotlight Preview`，在编辑器中立即看到红光。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eQ: 服装颜色改了不更新？\u003c/strong\u003e\u003c/summary\u003e\n\nv4.0已修复，现在即时更新。如仍有问题，取消勾选后重新勾选 `Enable Clothing`。\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eQ: 可以用于商业游戏吗？\u003c/strong\u003e\u003c/summary\u003e\n\n可以！MIT License，免费商用，无需署名（但我们会很感激！）。\n\u003c/details\u003e\n\n---\n\n## 🤝 贡献指南 | Contributing\n\n欢迎贡献！🎉\n\n1. Fork 本仓库\n2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交你的更改 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 开启一个Pull Request\n\n**贡献方向：**\n- 🐛 Bug修复\n- ✨ 新功能\n- 📖 文档改进\n- 🌍 多语言翻译\n- 🎨 示例场景\n\n---\n\n## 📜 许可证 | License\n\n本项目采用 **MIT License** - 查看 [LICENSE](LICENSE) 文件了解详情。\n\n**简单来说：**\n- ✅ 商业使用\n- ✅ 修改\n- ✅ 分发\n- ✅ 私人使用\n- ❌ 责任\n- ❌ 保证\n\n---\n\n## 💖 支持项目 | Support\n\n如果这个项目对你有帮助：\n\n- ⭐ **Star** 本仓库\n- 🍴 **Fork** 并分享给朋友\n- 💬 在 [Discussions](../../discussions) 分享你的使用心得\n- 🐛 在 [Issues](../../issues) 报告Bug\n- 💰 [itch.io打赏](https://yourusername.itch.io/proceduralnpc)\n- ☕ [Ko-fi赞助](https://ko-fi.com/yourusername)\n\n---\n\n## 🔗 相关链接 | Links\n\n- 🎮 [itch.io下载页面](https://yourusername.itch.io/proceduralnpc)\n- 📖 [完整文档](Documentation/README.md)\n- 📝 [更新日志](CHANGELOG.md)\n- 🛠️ [安装指南](INSTALL.md)\n- 💬 [讨论区](../../discussions)\n- 🐛 [问题追踪](../../issues)\n\n---\n\n## 🙏 致谢 | Credits\n\n**作者：** [Jieice](https://github.com/yourusername)\n\n**特别感谢：**\n- Godot Engine 开发者\n- 恐怖游戏开发社区\n- 所有用户和贡献者\n\n---\n\n## 📊 版本历史 | Version History\n\n详见 [CHANGELOG.md](CHANGELOG.md)\n\n**当前版本：v4.0 (2025-10-08)** - 完整版 ⭐\n\n---\n\n## 🆘 获取帮助 | Get Help\n\n- 📖 查看 [Documentation](Documentation/README.md)\n- 💬 在 [Discussions](../../discussions) 提问\n- 🐛 在 [Issues](../../issues) 报告Bug\n- 📧 邮件：your-email@example.com\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**准备好创作你的恐怖游戏了吗？**\n\n**Ready to create your horror game?**\n\n[⬇️ 下载 Download](../../releases) | [📖 文档 Docs](Documentation/README.md) | [💬 讨论 Discuss](../../discussions)\n\n---\n\nMade with ❤️ by [Jieice](https://github.com/yourusername) for the Godot community\n\n**如果这个项目帮助了你，请给个⭐Star！**\n\n**If this project helps you, please give it a ⭐Star!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjieice%2Fproceduralnpc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjieice%2Fproceduralnpc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjieice%2Fproceduralnpc/lists"}