Lesson 230: Fab 8K Godot Import Throttle Receipt on BUILD_RECEIPT (2026)
Direct answer: Before you lock the April 2027 spring fest Godot scene, file fab_8k_throttle_receipt_v1.json proving no glTF URI references 8K ORM, 2K proxies exported from Blender, Godot first-open < 90 s on min-spec, and child texture_import_receipt_v1 GREEN—then set BUILD_RECEIPT fab_8k_throttle to verified. Run after Lesson 204 ORM metallic channel truth and distinct from 204 alone (dimensions vs swizzles).
Why this matters now (April 2027 Fab kit drops)
April 2027 teams merge new Fab environment kits the same week they promote Q1 capstone 229. Artists pass ORM channel verify but the fest .glb still embeds 8192×8192 paths—Godot 4.5 freezes while producers blame “engine bug.” Blender 8K throttle preflight owns proxy export; Godot 8K compress preflight owns Import dock settings—this lesson is the BUILD_RECEIPT milestone that wires both receipts before spring fest scene promotion (Help #11 8K hang fix, 7-day ORM challenge).
Beginner path (40-minute proof)
| Step | Action | Success check |
|---|---|---|
| 1 | Run Blender T1–T4 (proxy + glTF audit) | No 8k in exported .gltf |
| 2 | Import kit in Godot; start 90 s timer | Editor responsive |
| 3 | Open fest hero scene | No hang > 90 s on min-spec |
| 4 | Confirm texture_import_receipt_v1 GREEN |
Godot I6 pass |
| 5 | File fab_8k_throttle_receipt_v1.json |
throttle_pass: true |
| 6 | BUILD_RECEIPT row | fab_8k_throttle GREEN |
Time: ~70 minutes first kit; ~15 minutes when proxy naming is pinned.
Developer path (gates T1–T6)
| Gate | Check | Fail when |
|---|---|---|
| T1 | Texture manifest (8K logged) | Unknown dimensions in kit |
| T2 | Proxy ≤ 2048 on longest edge | Fest glTF still references 8K |
| T3 | glTF URI audit | grep finds 8192 or /8k/ paths |
| T4 | Godot first-open timer | > 90 s on min-spec laptop |
| T5 | Child texture_import_receipt_v1 |
Godot I-gates RED |
| T6 | fab_8k_throttle_receipt_v1 + BUILD_RECEIPT |
Scene lock without receipt |
Three-receipt stack (do not collapse)
| Receipt | Owner | Scope |
|---|---|---|
orm_metallic_flat_receipt_v1 |
Lesson 204 | Channel / metallic response |
fab_8k_throttle_receipt_v1 |
This lesson | Dimension throttle on BUILD_RECEIPT |
texture_import_receipt_v1 |
Godot 8K guide | VRAM Compressed import |
204 can be GREEN while T3 fails—metallic correct, paths still 8K.
fab_8k_throttle_receipt_v1.json
{
"schema": "fab_8k_throttle_receipt_v1",
"build_label": "spring-fest-2027-rc1",
"kit_id": "fab_env_pack_v4",
"manifest": {
"hero_orm_8k": { "w": 8192, "h": 8192, "linked_in_gltf": false },
"hero_orm_2k": { "w": 2048, "h": 2048, "linked_in_gltf": true }
},
"child_receipts": {
"texture_import": "release-evidence/art/TEXTURE_IMPORT_RECEIPT.json",
"orm_metallic_flat": "release-evidence/art/ORM_METALLIC_FLAT_RECEIPT.json"
},
"godot_open_seconds_min_spec": 72,
"gates": {
"T1_manifest": "pass",
"T2_proxy": "pass",
"T3_gltf_no_8k": "pass",
"T4_open_timer": "pass",
"T5_texture_import_child": "pass",
"T6_build_receipt": "pass"
},
"throttle_pass": true,
"fest_scene_open_allowed": true
}Pin under release-evidence/art/FAB_8K_THROTTLE_RECEIPT.json.
BUILD_RECEIPT row (T6)
| Column | Pass when |
|---|---|
fab_8k_throttle |
Receipt path + throttle_pass: true |
texture_import_receipt |
Child GREEN (Godot I6) |
orm_metallic_flat_receipt |
Lesson 204 when hero uses Fab ORM |
ALTER TABLE release_publish_gate ADD COLUMN IF NOT EXISTS
fab_8k_throttle_blocked BOOLEAN NOT NULL DEFAULT false;CI verify_fab_8k_throttle_v1 fails when fest scene path is in publish manifest and throttle_pass is false.
Key takeaways
- Throttle in Blender export—Godot Import cannot fix 8K baked into glTF.
fab_8k_throttle_receiptis separate fromorm_metallic_flat_receipt(204).- Child
texture_import_receiptproves VRAM Compressed after paths are 2K. - 90 s first-open on min-spec is the fest laptop gate—not lead artist GPU only.
- Blender T-gates + Godot I-gates are preflight; 230 is promotion.
- Q2 capstone 235 wires 230 with 231–234.
- Keep 8K in
art_src/only—never fest scene references. - Wednesday demo smoke should open fest scene after receipt GREEN.
Common mistakes
- Passing 204 ORM proof then shipping 8K glTF unchanged.
- Resizing only inside Godot—URI audit (T3) still fails.
- Skipping min-spec timer on RTX dev kit.
- One receipt for “textures” covering channel + size + import.
- Deleting 8K archives instead of delinking from export.
Troubleshooting
| Symptom | Lane |
|---|---|
| Hang > 90 s | T3 glTF audit + Blender throttle guide |
| Flat metallic | Lesson 204 + ORM verify guide |
| Import slow but opens | T5 Godot I-gates—VRAM Compressed |
| Validator 8k URI | Re-export glTF after T2 proxy |
| Help traceback on import | 8K ORM editor hang help |
Mini exercise (65 minutes)
- Export glTF with intentional 8K URI—confirm T3 fails.
- Run Blender proxy batch; pass T1–T3.
- Import in Godot; log open seconds; pass T4–T5.
- Attach 204 receipt path in
child_receipts. - Commit
fab_8k_throttle_receipt_v1.json; set BUILD_RECEIPT GREEN.
Continuity — Q2 2027 spring fest shipping (230–235)
| Lesson | Receipt focus |
|---|---|
| 230 (this) | Fab 8K Godot import throttle |
| 231 | FMOD bank strip |
| 232 | CJK short description |
| 233 | Spline fest landing LCP |
| 234 | Micro-trailer stereo embed |
| 235 | Q2 capstone |
Previous: Lesson 229 — Q1 post-fest capstone
Capstone: Lesson 235 — Q2 spring fest shipping — arc 230–235 closed.
FAQ
Same as Lesson 204?
204 = ORM channels; 230 = 8K dimension throttle on BUILD_RECEIPT.
Same as Godot 8K guide?
Guide = I-gates import; lesson = BUILD_RECEIPT + child crosswalk + fest scene gate.
Same as Blender throttle guide?
Guide = ninety-second T-gates; lesson = live-ops fab_8k_throttle promotion row.
Metallic can be right while the editor still freezes—proxy paths in glTF, 90 s open proof, then fab_8k_throttle_receipt.