Initial sanctuary sources

2026-07-04 20:27:08 +02:00
commit c796a20321
1582 changed files with 253264 additions and 0 deletions
@@ -0,0 +1,54 @@
+# Blocodex GUI Textures
+
+Editable PNG assets live in:
+
+`src/main/resources/assets/blocodex/textures/gui/`
+
+The UI uses these files directly. Edit the PNGs, restart or reload the client resources, and the Blocodex screen will pick up the new look.
+
+## Active Textures
+
+| File | Size | Slice | Used for |
+| --- | ---: | ---: | --- |
+| `device_panel.png` | 32x32 | 8 px | Main Blocodex body nine-slice |
+| `screen_frame.png` | 32x32 | 8 px | Left screen and right grid frame nine-slice |
+| `button_square.png` | 24x24 | 6 px | Menu button nine-slice |
+| `button_wide.png` | 34x24 | 6 px | Left/right button nine-slice |
+| `slider_well.png` | 20x32 | L/R 6 px, T/B 8 px | Vertical slider well nine-slice |
+| `slider_knob.png` | 18x12 | none | Slider handle |
+| `vent_slots.png` | 96x24 | none | Speaker/vent ornament |
+| `status_light.png` | 12x12 | none | Small top-left light |
+| `blocodex_wordmark.png` | 80x16 | none | Top wordmark |
+| `icon_menu.png` | 16x16 | none | Menu icon |
+| `icon_arrow_left.png` | 16x16 | none | Previous icon |
+| `icon_arrow_right.png` | 16x16 | none | Next icon |
+| `grid_overlay_9x9.png` | 144x144 | none | Thin 9x9 grid overlay |
+| `selection_frame.png` | 16x16 | none | Selected grid cell frame |
+| `bottom_panel.png` | 32x24 | 6 px | Hidden debug/nav panel, kept for later |
+
+`_gui_texture_preview.png` is only a contact sheet for quick visual checks.
+
+## Nine-Slice Rules
+
+For nine-slice textures, keep the corners intact. Paint borders freely, but avoid putting unique details in the center if they should not stretch.
+
+- `device_panel.png`: corners and borders are 8 px.
+- `screen_frame.png`: corners and borders are 8 px.
+- `button_square.png` and `button_wide.png`: corners and borders are 6 px.
+- `slider_well.png`: left/right borders are 6 px; top/bottom borders are 8 px.
+- `bottom_panel.png`: corners and borders are 6 px.
+
+## Regeneration
+
+The seed drawings come from:
+
+`tools/GenerateGuiTextures.java`
+
+Run this only when you want to overwrite the PNGs with the generated base set:
+
+```sh
+javac -d /tmp/blocodex-gui-tools tools/GenerateGuiTextures.java
+java -cp /tmp/blocodex-gui-tools GenerateGuiTextures
+```
+
+If you hand-paint the PNGs, do not run the generator afterward unless you want to reset them.