← all documents · raw markdown · 4 KB

Antigravity Plan — source & install KAIVERSE planet textures

> Codex v9.10.64 · Track 1 (asset prep) · Codex §Comprehensive Plans

> AI / low-credit: Download one texture set per session; on stop log Last worked / Next.

The KAIVERSE descent code (kaiverse.js) is ALREADY wired to load and use these files.

Anti's job is only to **download real, CC0/public-domain texture maps and drop them into

C:\KAI\textures\ with the exact names below.** No code changes — the loader picks them up

automatically (and falls back to procedural for anything missing, so partial delivery is fine).

Copy everything in the box to Antigravity.

---

TASK: Populate C:\KAI\textures\ with real, seamless, equirectangular planet maps so the KAIVERSE planets render as real-looking worlds (color + lit relief + clouds), not procedural noise.

1. Files to produce (per AI planet)

For each planet name below, provide up to THREE maps (color is the minimum; normal + clouds make it great):

| File | Purpose | Format |

|------|---------|--------|

| <name>.jpg | COLOR / albedo (the surface look) | equirectangular 2:1 JPG |

| <name>_normal.jpg | NORMAL map (relief — mountains/craters catch light) | equirectangular 2:1 JPG (RGB normal, or derive from a height map) |

| <name>_clouds.png | CLOUD layer (transparent — only clouds opaque) | equirectangular 2:1 PNG with alpha |

Planet names (lowercase, no spaces — these are exactly what the code requests):

kai, leo, gemini, claudey, x, groq, analyst, researcher, kaicoder

Plus a generic fallback set: default.jpg, default_normal.jpg, default_clouds.png.

Give each AI a distinct world type so the fleet feels varied — e.g. earth-like, rocky/Mars, gas-giant bands, icy, lava, ocean, exotic. (Mix it up; no two the same.)

2. Specs

Equirectangular, 2:1 aspect, ~2048×1024 (color/normal). Clouds can be 1024×512.
Seamless at the left/right wrap (no visible seam on a sphere). Poles should look sane.
Optimize: color/normal JPG quality ~82, each ideally ≤ 500 KB; clouds PNG ≤ ~400 KB.
Normal maps: if you only find a HEIGHT/bump map, convert it to a tangent-space normal map.

3. Sourcing (CC0 / public-domain / CC-BY only)

NASA / JPL / USGS Astrogeology planetary maps — public domain (Earth, Mars, Moon, Jupiter, etc.). Many have matching elevation maps → convert to normal.
Solar System Scope — https://www.solarsystemscope.com/textures/ — CC BY 4.0 (color + bump for the planets; keep attribution).
ambientCG — https://ambientcg.com/ — CC0 — great for rocky/ice/lava surface fills and ready-made normal maps.
For clouds: NASA "Blue Marble" cloud layer (public domain) or a CC0 cloud equirectangular.

If you use any CC-BY asset, write C:\KAI\textures\CREDITS.txt listing each file → source → license.

4. Install & verify

Create C:\KAI\textures\ if missing; place all files there.
With the Command Center running, verify the route serves them (200):

curl -s -o NUL -w "%{http_code}" http://localhost:3001/textures/leo.jpg

curl -s -o NUL -w "%{http_code}" http://localhost:3001/textures/leo_normal.jpg

curl -s -o NUL -w "%{http_code}" http://localhost:3001/textures/leo_clouds.png

(The dashboard must have been restarted once after this session's /textures/ route was added.)

In the KAIVERSE, fly down to that planet — the descent surface should now show the real color map, relief that catches light, and the cloud shell.

Deliverable: C:\KAI\textures\ populated with the named maps (+ CREDITS.txt for any CC-BY), each seamless 2:1 equirectangular, optimized. Do NOT edit kaiverse.js or the server — loading/serving is already done.

---

Reference (already wired — for Anti's awareness, no action)

kaiverse.js nsBuildBodies loads /textures/<name>.jpg (→ surface color, drops emissive so it's lit), /textures/<name>_normal.jpg (→ material.normalMap), /textures/<name>_clouds.png (→ used by the descent cloud shell). All optional, silent fallback to procedural.
The descent system (nsUpdatePlanetDescent) uses the downloaded color for the close-up terrain, the normal map for relief on both base + terrain layers, and the cloud PNG for the rotating cloud shell.
Server route /textures/* already serves from C:\KAI\textures\ (jpg/png/webp).