@@ -4,6 +4,34 @@ Do not mix tile grids or camera projections without scaling/reprojection. Typica
 
 Optional frontmatter: `grid_dimensions`, `camera_perspective`, `hardware_tags`.
 
+## Choosing a pixel tileset
+
+Ten CC0 pixel tilesets, and from the outside they look like the same thing ten times.
+Grid size and projection are what actually decide it, because **mixing two projections
+in one map reads as a bug** and mixing two grids needs integer scaling. Pick the row
+that matches the game you are building, not the one with the most tiles.
+
+| If you are building | Take | Grid | View | Why this one |
+| --- | --- | ---: | --- | --- |
+| A whole RPG, one art style | [kenney-roguelike-rpg-pack](kenney-roguelike-rpg-pack.md) | 16x16 | 3/4 | 1700 tiles: overworld, town, interiors, items and matching UI. Gets a prototype furthest without a second source |
+| A small town or overworld | [kenney-tiny-town](kenney-tiny-town.md) | 16x16 | 3/4 | 130 tiles, exteriors only. Pairs exactly with Tiny Dungeon |
+| Dungeon interiors | [kenney-tiny-dungeon](kenney-tiny-dungeon.md) | 16x16 | 3/4 | The interior half of the Tiny pair, same grid and style |
+| A grittier dungeon | [ox72-dungeontileset-ii](ox72-dungeontileset-ii.md) | 16x16 | 3/4 | Darker palette with characters included; [vol. I](ox72-dungeon-tileset.md) is the older sibling |
+| A complete game in one download | [ninja-adventure](ninja-adventure.md) | 16x16 | 3/4 | Tiles **plus** 4-directional characters, UI, VFX, 100+ SFX and 37 music tracks |
+| An RPG without the Kenney look | [armm1998-zelda-like](armm1998-zelda-like.md) | 16x16 | 3/4 | Overworld, cave and indoor sets with a 4-directional sword character, single author |
+| A true overhead roguelike | [kenney-micro-roguelike](kenney-micro-roguelike.md) | **8x8** | **ortho** | Genuinely top-down, not 3/4. Half the grid of everything else here |
+| A turn-based strategy map | [kenney-tiny-battle](kenney-tiny-battle.md) | 16x16 | **ortho** | Roads, rivers, bridges and faction unit markers. Nothing else here covers wargames |
+| Enormous variety, one colour | [urizen-onebit](urizen-onebit.md) | **12x12** | 3/4 | 5500+ one-bit tiles across many genres. A third grid size, so commit early |
+| A monochrome prototype | [kenney-1-bit-pack](kenney-1-bit-pack.md) | 16x16 | either | 1078 1-bit tiles. Kenney ships both an overworld and a platformer sample, so it is the one set here that works in two projections |
+
+Three grids are in play (8x8, 12x12, 16x16) and they do not mix without scaling.
+Two of these are orthographic overhead and the rest are 3/4; the difference is whether
+walls show a front face. See `camera_perspective` on each entry, or filter by View on
+the site.
+
+**Characters:** only Ninja Adventure and ArMM1998 ship characters that turn.
+[kenney-roguelike-characters](kenney-roguelike-characters.md) is front-facing only.
+
 ## Choosing an icon set
 
 Eight icon sources are listed and seven of them are permissive UI sets that look
 
@@ -1,5 +1,30 @@
 # 3D — models, textures, environments
 
+## Choosing a PBR texture source
+
+Seven texture libraries are listed and all seven market themselves as free PBR.
+They are not equally free, and that is the first thing to sort by.
+
+| If you need | Take | Licence |
+| --- | --- | --- |
+| A default first stop | [ambientcg](ambientcg.md) — 1500+ seamless materials, no strings | **CC0** |
+| The other safe default | [poly-haven](../environment/poly-haven.md) — also HDRIs and models | **CC0** |
+| Photoscanned surfaces ambientCG lacks | [cgbookcase](cgbookcase.md) — 566 sets, 4K/8K, plus decals | **CC0** |
+| Parameters you can tweak | [texturecan](texturecan.md) — ships **SBSAR sources**, not just fixed maps | **CC0** |
+| Extra seamless coverage | [threedtextures-me](threedtextures-me.md) — aimed at Blender, Unreal, Unity and Godot | **CC0** |
+| Unique photo detail | [texture-ninja](texture-ninja.md) — you do the tiling cleanup; not seamless out of the box | **CC0** |
+| To read the terms first | [sharetextures](sharetextures.md) — a "Custom CC0" that **bans redistribution** on other sites, in plugins, or in collections | custom |
+| To read the terms first | [freepbr](freepbr.md) — free for games, but the About page is the grant, not the CC0 badge you might assume | custom |
+
+The split that matters: the first six are real CC0 and you can redistribute the maps
+inside an asset pack. The last two are custom grants that permit shipping a game but
+restrict passing the textures on. If you are assembling something others will
+redistribute, stay in the CC0 block.
+
+Two more caveats recorded on the entries themselves: texturecan's site footer still
+says "All rights reserved" while its terms page is the actual grant, and texture-ninja
+keeps its licence string inside a JS bundle rather than in static HTML.
+
 | ID | Name | License | Commercial | Status |
 | --- | --- | --- | --- | --- |
 | [kenney](kenney.md) | Kenney | CC0 | yes | active |
 
@@ -1,6 +1,29 @@
 # Fonts
 
-Prefer **SIL OFL** for embedding in commercial games. See [docs/licenses.md](../../docs/licenses.md).
+Prefer **SIL OFL** for embedding in commercial games. See [docs/licenses.md](../../docs/licenses.md)
+and [docs/fonts.md](../../docs/fonts.md) for what you still owe when `attribution_required` is false.
+
+## Choosing a pixel font
+
+Nine pixel faces, and the difference is what kind of retro you mean, plus whether you
+need CJK. All nine are safe to embed; only the last is CC0 rather than OFL.
+
+| You want | Take | Note |
+| --- | --- | --- |
+| A terminal or low-res HUD | [departure-mono](departure-mono.md) | Monospaced, the catalog's default pixel face. Site is MIT, the **font** is OFL |
+| A CRT or hacking UI | [vt323](vt323.md) | Soft-pixel terminal look, gentler than Press Start |
+| Hard 8-bit arcade | [press-start-2p](press-start-2p.md) | Title and score type. Reserved Font Name, so rename if you modify |
+| Chunky retro labels | [silkscreen](silkscreen.md) | The arcade weight without Press Start's blocky letterforms |
+| Readable pixel UI | [pixelify-sans](pixelify-sans.md) | Soft modern pixel sans; least crunchy of the set |
+| **Japanese** | [dotgothic16](dotgothic16.md) | Fontworks, on a 16px grid, covers what the Latin faces cannot |
+| **Pan-CJK, several sizes** | [ark-pixel-font](ark-pixel-font.md) | 10/12/16px, mono and proportional, language-specific glyphs. OFL on the font, MIT covers build tools only |
+| **CJK at 8x8** | [quanpixel](quanpixel.md) | The smallest CJK option. Download `QuanPixel.zip`; the itch slug still says galmuri-extended |
+| No licence file at all | [ggbotnet-fonts-cc0](ggbotnet-fonts-cc0.md) | 45 faces, **CC0**, so nothing to ship alongside. The same account's OFL collection is a different thing |
+
+Match the font's design grid to your tile grid where you can: DotGothic16 is drawn for
+16px, QuanPixel for 8px. A 16px face in an 8px UI needs scaling and will blur.
+
+
 
 | ID | Name | License | Commercial | Status |
 | --- | --- | --- | --- | --- |
 
@@ -259,17 +259,29 @@ export function checkTaxonomyValues(rel, meta) {
 export function checkCategoryReadmeRows(categoryName, readmeText, entries) {
   const errors = [];
   const lines = readmeText.split(/\r?\n/);
+
+  // Only the catalog listing table is checked. A category README may also carry
+  // comparison tables that link entries, and those have no license column to
+  // contradict. The listing is found by its header rather than by row shape,
+  // because a comparison table can legitimately lead with the entry link too.
+  const start = lines.findIndex((l) => /^\|\s*ID\s*\|/i.test(l.trim()));
+  if (start === -1) {
+    if (entries.length) {
+      errors.push(
+        `catalog/${categoryName}/README.md has no catalog table (expected a header row starting "| ID |")`
+      );
+    }
+    return errors;
+  }
+  const table = [];
+  for (let i = start + 1; i < lines.length; i += 1) {
+    if (!lines[i].trim().startsWith("|")) break;
+    table.push(lines[i]);
+  }
+
   for (const entry of entries) {
     const stem = entry.rel.split("/").pop().replace(/\.md$/, "");
-    // Only the catalog table is checked. A category README may also carry
-    // comparison tables that link entries from a prose cell; those are not
-    // listings and have no license column to contradict. A catalog row is the
-    // one whose FIRST cell is the entry link.
-    const row = lines.find((l) => {
-      if (!l.trim().startsWith("|") || !l.includes(`(${stem}.md)`)) return false;
-      const first = l.split("|").map((c) => c.trim()).filter(Boolean)[0] || "";
-      return first.includes(`(${stem}.md)`);
-    });
+    const row = table.find((l) => l.includes(`(${stem}.md)`));
     if (!row) continue; // validate.mjs already reports an entry missing from the README
     const cells = row
       .split("|")
 
@@ -302,6 +302,43 @@ const readme = [
   "| [kenney](kenney.md) | Kenney | CC0 | active |",
   "| [lpc](lpc.md) | LPC | varies (SA) | active |",
 ].join("\n");
+rejects(
+  "V11 reports a category README with entries but no catalog table",
+  checkCategoryReadmeRows("tools", "# Tools\n\nNo table here.\n", [
+    { rel: "catalog/tools/a.md", meta: { license: "MIT" } },
+  ]),
+  "has no catalog table"
+);
+accepts(
+  "V11 ignores a comparison table that leads with the entry link",
+  checkCategoryReadmeRows(
+    "3d",
+    [
+      "| If you need | Take | Licence |",
+      "| A default | [ambientcg](ambientcg.md) - seamless | **CC0** |",
+      "",
+      "| ID | Name | License | Commercial | Status |",
+      "| [ambientcg](ambientcg.md) | ambientCG | CC0 | yes | active |",
+    ].join("\n"),
+    [{ rel: "catalog/3d/ambientcg.md", meta: { license: "CC0" } }]
+  )
+);
+rejects(
+  "V11 still catches drift in the listing when a link-first comparison table exists",
+  checkCategoryReadmeRows(
+    "3d",
+    [
+      "| If you need | Take | Licence |",
+      "| A default | [ambientcg](ambientcg.md) - seamless | **CC0** |",
+      "",
+      "| ID | Name | License | Commercial | Status |",
+      "| [ambientcg](ambientcg.md) | ambientCG | MIT | yes | active |",
+    ].join("\n"),
+    [{ rel: "catalog/3d/ambientcg.md", meta: { license: "CC0" } }]
+  ),
+  'does not carry its license "CC0"'
+);
+
 rejects(
   "V11 rejects a README row whose license contradicts the frontmatter",
   checkCategoryReadmeRows("tools", readme, [
@@ -325,7 +362,11 @@ accepts(
   "V11 tolerates a trailing footnote marker",
   checkCategoryReadmeRows(
     "tools",
-    ["| [a](a.md) | A | CC0* | active |", "| [b](b.md) | B | CC-BY? | active |"].join("\n"),
+    [
+      "| ID | Name | License | Status |",
+      "| [a](a.md) | A | CC0* | active |",
+      "| [b](b.md) | B | CC-BY? | active |",
+    ].join("\n"),
     [
       { rel: "catalog/tools/a.md", meta: { license: "CC0" } },
       { rel: "catalog/tools/b.md", meta: { license: "CC-BY" } },
@@ -352,6 +393,8 @@ rejects(
     [
       "| If you want | Take | Over | Because |",
       "| A retro SFX fast | [jsfxr](jsfxr.md) | sfxr | Browser, no install |",
+      "",
+      "| ID | Name | License | Status |",
       "| [jsfxr](jsfxr.md) | jsfxr | public-domain | active |",
     ].join("\n"),
     [{ rel: "catalog/tools/jsfxr.md", meta: { license: "Unlicense" } }]