Skip to content

Commit 344fdfa

Browse files
Show publisher previews in the README and collapse long reference sections.
Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent 46aa4df commit 344fdfa

9 files changed

Lines changed: 80 additions & 6 deletions

File tree

‎README.md‎

Lines changed: 80 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,54 @@ This repository **indexes and documents** sources. It does **not** rehost third-
1515

1616
**[Browse 294 sources →](https://tmhsdigital.github.io/Free-Game-Dev-Assets/)**
1717

18-
---
18+
<table>
19+
<tr>
20+
<td align="center" width="25%">
21+
<a href="catalog/3d/kenney.md"><img src="docs/images/readme/kenney-3d.png" alt="Kenney modular low-poly city" width="220" /></a><br />
22+
<b><a href="catalog/3d/kenney.md">Kenney</a></b><br />
23+
<sub>CC0 · modular 3D</sub>
24+
</td>
25+
<td align="center" width="25%">
26+
<a href="catalog/3d/quaternius.md"><img src="docs/images/readme/quaternius-downtown.jpg" alt="Quaternius Downtown City MegaKit" width="220" /></a><br />
27+
<b><a href="catalog/3d/quaternius.md">Quaternius</a></b><br />
28+
<sub>CC0 · rigged kits</sub>
29+
</td>
30+
<td align="center" width="25%">
31+
<a href="catalog/3d/kaykit.md"><img src="docs/images/readme/kaykit-characters.png" alt="KayKit adventurer and robot characters" width="220" /></a><br />
32+
<b><a href="catalog/3d/kaykit.md">KayKit</a></b><br />
33+
<sub>CC0 · atlas characters</sub>
34+
</td>
35+
<td align="center" width="25%">
36+
<a href="catalog/environment/poly-haven.md"><img src="docs/images/readme/polyhaven-hdri.png" alt="Poly Haven HDRI with lighting spheres" width="220" /></a><br />
37+
<b><a href="catalog/environment/poly-haven.md">Poly Haven</a></b><br />
38+
<sub>CC0 · HDRI / PBR</sub>
39+
</td>
40+
</tr>
41+
<tr>
42+
<td align="center" width="25%">
43+
<a href="catalog/2d/kenney-ui-pack.md"><img src="docs/images/readme/kenney-ui.png" alt="Kenney UI pack panels and buttons" width="220" /></a><br />
44+
<b><a href="catalog/2d/kenney-ui-pack.md">Kenney UI</a></b><br />
45+
<sub>CC0 · HUD / menus</sub>
46+
</td>
47+
<td align="center" width="25%">
48+
<a href="catalog/2d/kenney-input-prompts.md"><img src="docs/images/readme/kenney-prompts.png" alt="Kenney Xbox Series input prompt icons" width="220" /></a><br />
49+
<b><a href="catalog/2d/kenney-input-prompts.md">Input prompts</a></b><br />
50+
<sub>CC0 · 64×64 glyphs</sub>
51+
</td>
52+
<td align="center" width="25%">
53+
<a href="catalog/3d/ambientcg.md"><img src="docs/images/readme/ambientcg.jpg" alt="ambientCG photogrammetry ground material sphere" width="220" /></a><br />
54+
<b><a href="catalog/3d/ambientcg.md">ambientCG</a></b><br />
55+
<sub>CC0 · seamless PBR</sub>
56+
</td>
57+
<td align="center" width="25%">
58+
<a href="catalog/fonts/departure-mono.md"><img src="docs/images/readme/departure-mono.png" alt="Departure Mono pixel type specimen" width="220" /></a><br />
59+
<b><a href="catalog/fonts/departure-mono.md">Departure Mono</a></b><br />
60+
<sub>SIL OFL · pixel type</sub>
61+
</td>
62+
</tr>
63+
</table>
64+
65+
<sub>Publisher promotional stills (CC0 / SIL OFL), used here as documentation only. Full packs stay on the source sites.</sub>
1966

2067
---
2168

@@ -41,14 +88,17 @@ This repository **indexes and documents** sources. It does **not** rehost third-
4188

4289
The site is generated from catalog frontmatter on every push (GitHub Actions → Pages). Add or edit one file under `catalog/<category>/<id>.md` and the browse UI, filters, and counts update automatically.
4390

44-
Local preview:
91+
<details>
92+
<summary>Local preview</summary>
4593

4694
```bash
4795
node site/validate.mjs
4896
node site/build.mjs
4997
npx --yes serve site/dist
5098
```
5199

100+
</details>
101+
52102
---
53103

54104
## Browse the catalog
@@ -85,6 +135,9 @@ If you’re prototyping under a tight deadline, start with the [safe starting po
85135

86136
Each source is one markdown file with YAML frontmatter plus short notes. Add new ones from [`catalog/TEMPLATE.md`](catalog/TEMPLATE.md). `id` must be unique across the whole catalog, not just the category folder.
87137

138+
<details>
139+
<summary>Frontmatter fields</summary>
140+
88141
| Field | Meaning |
89142
| --- | --- |
90143
| `license` | Short license name as stated by the source (`CC0`, `CC-BY-3.0`, `SIL OFL`, `custom`, `varies`) |
@@ -97,21 +150,29 @@ Each source is one markdown file with YAML frontmatter plus short notes. Add new
97150
| `attribution_string` | Optional copy-paste credit when `attribution_required` |
98151
| `publisher` | Optional rights-holding publisher when that publisher has more than one entry. Not a generic host. |
99152

100-
### Status legend
153+
</details>
154+
155+
<details>
156+
<summary>Status legend</summary>
101157

102158
| Status | Meaning |
103159
| --- | --- |
104160
| `active` | License spot-checked; suitable to evaluate for production use |
105161
| `needs-review` | Useful discovery — verify the live page before shipping |
106162
| `deprecated` | Kept for history; prefer alternatives |
107163

164+
</details>
165+
108166
Aggregators (OpenGameArt, itch collections, Poly Pizza, font indexes) are usually `license: varies` and `commercial: varies`. Treat each pack or file as its own review. The site Commercial OK filter still lists them, labeled **per-file review**.
109167

110168
---
111169

112170
## Safe starting points
113171

114-
High-signal CC0 / clearly permissive sources that cover most early production needs:
172+
High-signal CC0 / clearly permissive sources that cover most early production needs. Previews of several of these are in the gallery above.
173+
174+
<details>
175+
<summary>Full starter list</summary>
115176

116177
| Need | Source | Entry |
117178
| --- | --- | --- |
@@ -129,13 +190,18 @@ High-signal CC0 / clearly permissive sources that cover most early production ne
129190
| Attribution music | Incompetech | [`catalog/audio/incompetech.md`](catalog/audio/incompetech.md) |
130191
| No-attribution music loops | Abstraction Music Loop Bundle | [`catalog/audio/tallbeard-abstraction-music-loop-bundle.md`](catalog/audio/tallbeard-abstraction-music-loop-bundle.md) |
131192
| Pixel / terminal font | Departure Mono | [`catalog/fonts/departure-mono.md`](catalog/fonts/departure-mono.md) |
132-
| Localization fonts | Noto Sans | [`catalog/fonts/noto-sans.md`](catalog/fonts/noto-sans.md)
193+
| Localization fonts | Noto Sans | [`catalog/fonts/noto-sans.md`](catalog/fonts/noto-sans.md) |
194+
195+
</details>
133196

134197
---
135198

136199
## Licenses & provenance
137200

138-
Read [`docs/licenses.md`](docs/licenses.md), [`docs/provenance.md`](docs/provenance.md), [`docs/high-risk.md`](docs/high-risk.md), [`docs/fivem.md`](docs/fivem.md), [`docs/ai-assets.md`](docs/ai-assets.md), [`docs/trust-score.md`](docs/trust-score.md), and [`docs/game-vs-video-licensing.md`](docs/game-vs-video-licensing.md) before mixing packs into a commercial build. Research drafts: [`docs/research-index.md`](docs/research-index.md) (`R01`–`R06`). Short version:
201+
Read [`docs/licenses.md`](docs/licenses.md), [`docs/provenance.md`](docs/provenance.md), [`docs/high-risk.md`](docs/high-risk.md), [`docs/fivem.md`](docs/fivem.md), [`docs/ai-assets.md`](docs/ai-assets.md), [`docs/trust-score.md`](docs/trust-score.md), and [`docs/game-vs-video-licensing.md`](docs/game-vs-video-licensing.md) before mixing packs into a commercial build. Research drafts: [`docs/research-index.md`](docs/research-index.md) (`R01`–`R06`).
202+
203+
<details>
204+
<summary>Short version</summary>
139205

140206
- **CC0** — safest default for closed-source games; attribution not required
141207
- **CC-BY** — commercial OK; keep credits (BY-3.0 often wants the **author named**; BY-4.0 is usually satisfied by a credits-screen link)
@@ -146,6 +212,8 @@ Read [`docs/licenses.md`](docs/licenses.md), [`docs/provenance.md`](docs/provena
146212
- **Marketplace “free”** (Unity / Fab / Unreal) — often commercial in-engine, no redistribution, sometimes engine-locked
147213
- **Trust the supplier** — skip anonymous mega-dumps and known traps (MB-Lab, default Shadertoy, Maps scrapes, GTA/FiveM rips)
148214

215+
</details>
216+
149217
Catalog metadata in *this* repo is CC0. Linked assets remain under their own licenses.
150218

151219
## Godot-oriented stack
@@ -182,6 +250,9 @@ See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the entry checklist and verificatio
182250

183251
## Repository layout
184252

253+
<details>
254+
<summary>Directory tree</summary>
255+
185256
```text
186257
.
187258
├── README.md ← you are here
@@ -191,6 +262,7 @@ See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the entry checklist and verificatio
191262
│ ├── licenses.md / provenance.md / high-risk.md / fivem.md / ai-assets.md
192263
│ ├── trust-score.md / research-index.md / godot-budget-stack.md
193264
│ ├── game-vs-video-licensing.md
265+
│ └── images/readme/ ← publisher stills used in this README
194266
├── RESEARCH/README.md ← research archive index (drafts gitignored)
195267
├── site/ ← GitHub Pages source (build scans catalog/)
196268
│ ├── build.mjs / config.json / public/
@@ -201,6 +273,8 @@ See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the entry checklist and verificatio
201273
└── README.md
202274
```
203275

276+
</details>
277+
204278
---
205279

206280
## License

‎docs/images/readme/ambientcg.jpg‎

312 KB
Loading
9.29 KB
Loading
130 KB
Loading

‎docs/images/readme/kenney-3d.png‎

74.4 KB
Loading
26 KB
Loading

‎docs/images/readme/kenney-ui.png‎

29.9 KB
Loading
126 KB
Loading
167 KB
Loading

0 commit comments

Comments
 (0)