PAdventures Sprites
收藏资源简介：
PAdventures Sprites是一个经过精心策划、开放许可的精灵表集合，包含50,854个精灵表，涵盖PAdventures宇宙中的生物、物品、效果和导弹。每个精灵表以透明PNG格式提供，并配有机器可读的目录（index.json）和每个资源的几何元数据（metadata.json），支持程序化索引、切片和渲染。该数据集适用于非商业用途，如游戏、工具和原型开发，要求用户注明出处并保持非商业性。
PAdventures Sprites is a carefully curated, open-licensed collection of sprite sheets, consisting of 50,854 entries covering creatures, items, effects, and missiles from the PAdventures universe. Each sprite sheet is provided in transparent PNG format, paired with a machine-readable catalog (index.json) and geometric metadata for each individual resource (metadata.json), which supports programmatic indexing, cropping, and rendering. This dataset is intended for non-commercial uses including game development, tool creation, and prototyping, requiring users to provide proper attribution and comply with the non-commercial usage terms.
数据集概览
PAdventures Sprites 是一个面向 PAdventures 宇宙的开源精灵图库，包含 50,854 张 精灵图集，覆盖生物、物品、特效和导弹四大类别。所有图集均以透明 PNG 格式提供，并附带机器可读的索引和元数据，便于程序化使用。数据集采用 CC BY-NC-SA 4.0 许可证，仅限非商业用途，且需注明出处。
核心特性
- 规模：50,854 张精灵图集，均为透明 PNG 格式。
- 类别：分为
creature（生物）、item（物品）、effect（特效）、missile（导弹）四个清晰类别。 - 机器可读数据：
data/index.json：按类别分组，列出所有资产 ID。data/metadata.json：描述每张图集的几何结构（瓦片、层、图案、动画阶段、精灵数量）。data/names.json：可选的人类可读名称映射（初始为空，可社区扩展）。
- 命名规则：每个资产有全局唯一数字 ID，图集文件路径为
sprites/<category>/<id>.png。 - 许可证：CC BY-NC-SA 4.0，允许共享和改编，但必须署名、非商业使用，且衍生作品需采用相同许可证。
- 贡献流程：遵循内部开源工作流，使用 Conventional Commits，设有
main和develop保护分支。
内容详情
| 类别 | 数量 | 描述 |
|---|---|---|
item |
39,827 | 世界对象、地面瓦片、装饰、装备、道具 |
creature |
8,256 | 怪物、NPC 及其他动画生物 |
effect |
2,480 | 法术、碰撞和环境视觉效果 |
missile |
291 | 抛射物及投掷/发射物体 |
| 总计 | 50,854 | 所有资产均在 data/index.json 中编目 |
仓库结构
padventures-sprites/ ├── sprites/ # 精灵图集文件夹，每个资产一个 PNG │ ├── creature/ # 8,256 张图集 → <id>.png │ ├── effect/ # 2,480 张图集 → <id>.png │ ├── item/ # 39,827 张图集 → <id>.png │ └── missile/ # 291 张图集 → <id>.png ├── data/ # 机器可读目录和元数据 │ ├── index.json # 类别 → 资产 ID 列表 │ ├── metadata.json # 资产 ID → 精灵图集几何数据 │ └── names.json # 资产 ID → 人类可读名称（可选） ├── docs/ # 深度文档 │ ├── data-format.md # JSON 模式参考 │ ├── sprite-sheets.md # PNG 图集结构及切片说明 │ └── usage.md # 加载和渲染指南 ├── CONTRIBUTING.md # 分支模型和贡献指南 ├── CODE_OF_CONDUCT.md ├── SECURITY.md ├── CHANGELOG.md ├── CITATION.cff # 数据集引用格式 ├── NOTICE # 署名和知识产权声明 └── LICENSE # CC BY-NC-SA 4.0 许可证
快速开始
克隆仓库（无需 Git LFS）：
bash git clone https://github.com/DistTopic/padventures-sprites.git cd padventures-sprites
通过资产 ID 定位图集文件路径，结合 index.json 和 metadata.json 获取几何数据用于程序化切片。
使用须知
- 图集格式：32 位 RGBA PNG，支持透明度。
- 帧切片：一张图集可能包含多个帧（
nSprites），按动画阶段（phases）和图案（patterns）排列，需依据metadata.json中的几何数据进行切片。 - 文件定位：根据类别文件夹和资产 ID 即可确定文件路径：
sprites/<category>/<id>.png。
署名要求
使用本数据集时，需在游戏鸣谢、CREDITS.txt 或“关于”界面中提供以下形式的署名：
"PAdventures Sprites" by DistTopic, licensed under CC BY-NC-SA 4.0. Source: https://github.com/DistTopic/padventures-sprites
知识产权声明
PAdventures Sprites 是一个非官方的非商业粉丝项目。宝可梦及相关名称、角色、设计、精灵图等均为 Nintendo、GAME FREAK inc.、Creatures Inc. 和 The Pokémon Company 的财产。本项目未获得上述权利方的认可或赞助。项目许可证仅覆盖本仓库中的原创贡献，不授予任何宝可梦知识产权的使用权利。如有侵权内容，维护者将及时移除。
