visual

assets/README_ASSETS_DARK_FACTORY.md

@@ -0,0 +1,19 @@
+# Assets organization (prepared, not yet wired into the game)
+
+This patch adds a **dark factory** art set without changing runtime references yet.
+
+## Folder guide
+- `assets/dark_factory/facilities/` : new factory equipment sprites
+- `assets/dark_factory/previews/` : visual overview sheet
+- `assets/ui/` : future UI asset buckets (buttons / panels / icons / debug)
+- `assets/chicks/` : reserved for user-supplied chick sprites
+- `assets/poop/` : reserved for user-supplied poop sprites
+- `assets/_legacy/` : copied backup of older loose files
+- `assets/images/` : left untouched for compatibility with the current build
+
+## Notes
+- Grid base unit: **16x16**
+- Non-grid UI object base unit: **32x32**
+- Color count intentionally limited for a coarse pixel-art look
+- Sprites are supplied as individual PNG files with transparency
+- This patch **does not yet hook the new art into the live game**

assets/_legacy/images/README.md

@@ -0,0 +1,3 @@
+# Image assets
+
+`poop.png` is bundled and loaded by default. Other equipment/chick art is optional and currently falls back to canvas drawing unless external art loading is enabled in `src/render/draw.js`.

assets/chicks/README.md

@@ -0,0 +1 @@
+Reserved for user-supplied chick sprites. Recommended base: 16x16 world sprites / 32x32 UI icons.\n

assets/dark_factory/facilities/README.md

@@ -0,0 +1 @@
+Dark factory facility sprites. See ../manifest.json for file roles and dimensions.\n

assets/dark_factory/manifest.json

@@ -0,0 +1,103 @@
+{
+  "theme": "dark_factory",
+  "grid_unit_px": 16,
+  "ui_unit_px": 32,
+  "palette_note": "restricted palette / coarse pixel art",
+  "facilities": [
+    {
+      "id": "conveyor",
+      "files": [
+        "conveyor_straight_h_16.png",
+        "conveyor_straight_v_16.png",
+        "conveyor_turn_ne_16.png",
+        "conveyor_turn_nw_16.png",
+        "conveyor_turn_se_16.png",
+        "conveyor_turn_sw_16.png"
+      ],
+      "size": "16x16",
+      "folder": "facilities/conveyor"
+    },
+    {
+      "id": "boost_conveyor",
+      "files": [
+        "boost_conveyor_straight_h_16.png",
+        "boost_conveyor_straight_v_16.png",
+        "boost_conveyor_turn_ne_16.png",
+        "boost_conveyor_turn_nw_16.png",
+        "boost_conveyor_turn_se_16.png",
+        "boost_conveyor_turn_sw_16.png"
+      ],
+      "size": "16x16",
+      "folder": "facilities/conveyor"
+    },
+    {
+      "id": "egg_farm",
+      "files": [
+        "egg_farm_16.png"
+      ],
+      "size": "16x16",
+      "folder": "facilities/machines"
+    },
+    {
+      "id": "manual_scanner",
+      "files": [
+        "manual_scanner_32x48.png"
+      ],
+      "size": "32x48",
+      "footprint": "2x3 tiles",
+      "folder": "facilities/machines"
+    },
+    {
+      "id": "auto_scanner",
+      "files": [
+        "auto_scanner_32x48.png"
+      ],
+      "size": "32x48",
+      "footprint": "2x3 tiles",
+      "folder": "facilities/machines"
+    },
+    {
+      "id": "mixer",
+      "files": [
+        "mixer_32.png",
+        "mixer_compact_16.png"
+      ],
+      "size": "32x32 + 16x16 compact",
+      "folder": "facilities/machines"
+    },
+    {
+      "id": "shredder",
+      "files": [
+        "shredder_32.png",
+        "shredder_compact_16.png"
+      ],
+      "size": "32x32 + 16x16 compact",
+      "folder": "facilities/machines"
+    },
+    {
+      "id": "truck",
+      "files": [
+        "truck_32.png",
+        "truck_compact_16.png"
+      ],
+      "size": "32x32 + 16x16 compact",
+      "folder": "facilities/vehicles"
+    },
+    {
+      "id": "repairman",
+      "files": [
+        "repairman_16.png"
+      ],
+      "size": "16x16",
+      "folder": "facilities/utility"
+    },
+    {
+      "id": "obstacle_crate",
+      "files": [
+        "obstacle_crate_16.png"
+      ],
+      "size": "16x16",
+      "folder": "facilities/utility"
+    }
+  ]
+}

assets/dark_factory/previews/README.md

@@ -0,0 +1 @@
+Preview sheet(s) for quick inspection. These are reference only, not runtime assets.\n

assets/poop/README.md

@@ -0,0 +1 @@
+Reserved for user-supplied poop sprites. Recommended base: 16x16 world sprites / 32x32 UI icons.\n

assets/ui/README.md

@@ -0,0 +1 @@
+Future UI asset buckets. Nothing is wired yet. Use 32x32 as the base size for non-grid UI objects.\n