sanctuary/Gameplay/blocodex/docs/gui-textures.md

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:

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.