{"id":20120270,"url":"https://github.com/pingzidev/pindot","last_synced_at":"2026-03-06T03:31:41.835Z","repository":{"id":258535673,"uuid":"866267857","full_name":"PingziDev/Pindot","owner":"PingziDev","description":"基于Godot的轻量、易上手的游戏开发框架","archived":false,"fork":false,"pushed_at":"2024-10-17T09:41:26.000Z","size":6373,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-02T12:40:22.542Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/PingziDev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","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}},"created_at":"2024-10-02T00:04:27.000Z","updated_at":"2025-10-12T14:27:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"4a664e94-f8b8-4e77-b1c4-5036a174012a","html_url":"https://github.com/PingziDev/Pindot","commit_stats":null,"previous_names":["pingzidev/pindot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PingziDev/Pindot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PingziDev%2FPindot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PingziDev%2FPindot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PingziDev%2FPindot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PingziDev%2FPindot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PingziDev","download_url":"https://codeload.github.com/PingziDev/Pindot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PingziDev%2FPindot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30160852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T22:39:40.138Z","status":"online","status_checked_at":"2026-03-06T02:00:08.268Z","response_time":250,"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":[],"created_at":"2024-11-13T19:19:27.094Z","updated_at":"2026-03-06T03:31:41.779Z","avatar_url":"https://github.com/PingziDev.png","language":"GDScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pindot\n\u003e Pin your Dot : 锁定重点！\n\n![GitHub Release](https://img.shields.io/github/v/release/PingziDev/Pindot)\t![GitHub License](https://img.shields.io/github/license/PingziDev/Pindot)\t![GitHub contributors](https://img.shields.io/github/contributors/PingziDev/Pindot)\t![GitHub last commit](https://img.shields.io/github/last-commit/PingziDev/Pindot)\t![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/PingziDev/Pindot/total)\t\n\n\n欢迎来到 **Pindot**，一个 **轻量、易上手、可插拔组件化、持续维护、中文友好** 的游戏开发框架！基于 **Godot 4**，为开发者提供通用解决方案，帮助你跳过基础的繁琐功能，专注于游戏开发的核心！\n\n不积跬步，无以至千里。用 **Pindot** 开启你的游戏创作之旅！\n\n## 🌟 项目特点\n\n- **组件化开发**：基于Entity+Component模式，像搭积木一样构建游戏功能。\n- **轻量化设计**：简洁代码，减少冗余，实现高效开发。\n- **易上手**：封装常用功能，降低门槛，让开发者专注游戏逻辑。\n- **实用性强**：经过实际项目测试，解决开发中的常见痛点。\n- **持续更新**：与Godot保持同步，确保框架始终兼容最新版本。\n- **中文友好**：全面支持中文环境，文档和接口贴近中文开发者习惯。\n\n## 🚀 功能一览\n\n- **游戏管理（Game）**：全局控制游戏进度、速度、难度等。\n- **场景管理（Scene）**：随时加载、卸载和切换多个游戏场景。\n- **数据管理（Data）**：处理游戏的存档与读档，管理动态产生的游戏数据。\n- **资源管理（Resource）**：高效管理资源加载，支持同步与异步模式，优化内存使用。\n- **实体管理（Entity）**：动态创建、显示、隐藏、销毁游戏对象。\n- **输入处理（Input）**：统一管理键盘、鼠标、手柄等输入设备的控制。\n- **事件系统（Event）**：解耦事件与响应逻辑，提供事件管理和触发机制。\n- **界面管理（UI）**：处理游戏中的用户界面元素，提供流畅的交互体验。\n- **音效管理（Sound）**：控制背景音乐和音效，创造沉浸式体验。\n- **[调试工具](docs/LOG.md)（Debug）**：提供开发调试工具，便于问题排查与优化。 []\n\n## 📂 目录结构\n\n```bash\n.\n├── addons/\n│   └── pingdot/    # pingdot 框架根目录\n│       ├── game/       # 游戏控制\n│       ├── scene/      # 场景管理\n│       ├── data/       # 数据管理\n│       ├── resource/   # 资源管理\n│       ├── entity/     # 实体管理\n│       ├── input/      # 输入管理\n│       ├── event/      # 事件管理\n│       ├── ui/         # 界面管理\n│       ├── sound/      # 声音管理\n│       ├── debug/      # 调试工具\n│       ├── plugin.cfg  # 插件配置文件\n└── README.md       # 插件说明文档\n```\n### 💾 如何安装\n\n**资源库下载**\n\n1. 在 Godot 中打开 **资源库** 选项卡。\n2. 搜索并下载 “Pindot”。\n3. 在 **项目** \u003e **项目设置** \u003e **插件** 中启用插件。\n\n**GitHub Release下载**\n\n1. 下载发布版本。\n2. 解压缩 zip 文件，将 `addons/pindot` 目录移动到项目`addons/`下。\n3. 在 **项目** \u003e **项目设置** \u003e **插件** 中启用插件。\n\n## 🛤️ 开发路线图\n- ✅ 项目基础架构\n\t- [x]  确定项目目录结构\n\t- [x]  创建基本的配置文件\n\t- [x]  设置版本控制（如 Git）\n- **游戏管理**\n\t- [ ]  创建游戏进度管理类\n\t- [ ]  实现游戏速度调节功能\n\t- [ ]  设计游戏难度调整系统\n- **数据管理**\n\t- [ ]  设计存档结构\n\t- [ ]  实现存档功能\n\t- [ ]  实现读档功能\n- **场景管理**\n\t- [ ]  创建场景管理器\n\t- [ ]  实现场景加载与卸载\n\t- [ ]  设计场景切换效果\n- **资源管理**\n\t- [ ]  实现资源加载系统\n\t- [ ]  优化资源缓存机制\n\t- [ ]  设计异步资源加载功能\n- **实体管理**\n\t- [ ]  创建游戏对象类\n\t- [ ]  实现动态创建与销毁对象\n\t- [ ]  设计对象的显示与隐藏功能\n- **输入处理**\n\t- [ ]  设计输入管理器\n\t- [ ]  实现多种输入设备支持\n\t- [ ]  实现输入事件处理功能\n- **事件系统**\n\t- [ ]  创建事件管理系统\n\t- [ ]  设计事件触发机制\n\t- [ ]  实现事件与响应的解耦\n- **界面管理**\n\t- [ ]  设计用户界面框架\n\t- [ ]  实现界面动态更新\n\t- [ ]  设计用户交互功能\n- **音效管理**\n\t- [ ]  创建音效管理类\n\t- [ ]  实现背景音乐控制\n\t- [ ]  设计音效动态加载功能\n- **调试工具**\n\t- [ ]  开发调试工具\n\t- [ ]  实现问题排查功能\n\t- [ ]  提供性能监控工具\n\n## 📝 所需 Godot 版本\n- 本框架需要 **Godot 4.0 及以上版本** 才能正常运行。请确保你安装了正确的版本，以获得最佳体验。\n## 🤝 贡献指南\n想加入开发？欢迎啊！Fork 这个项目，做出你的修改，提交 Pull Request，我们来一起让这个框架更好玩！\n## 📜 协议\nMIT 协议，随便玩，别忘了给个 Star⭐！\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpingzidev%2Fpindot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpingzidev%2Fpindot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpingzidev%2Fpindot/lists"}