feat: setup automated showcase graphic generator

Author: mfishma

.github/images/inv_slot.png

@@ -0,0 +1,166 @@
+import os
+import json
+import urllib.request
+from io import BytesIO
+from PIL import Image, ImageDraw, ImageFont, ImageFilter
+
+CONFIG_PATH = "../showcase_config.json"
+INV_SLOT_PATH = "../images/inv_slot.png"
+OUTPUT_PATH = "../images/showcase_output.png"
+CUSTOM_ASSETS_DIR = "../images/showcase_assets"
+
+MC_ASSETS_BASE = "https://raw.githubusercontent.com/Owen1212055/mc-assets/master/assets/minecraft/textures/"
+
+GRID_COLS = 9
+GRID_ROWS = 3
+SLOT_SIZE = 162
+ITEM_SIZE = 144
+GAP = 54
+SIDEBAR_WIDTH = 250
+
+def download_image(url):
+    try:
+        req = urllib.request.Request(url, headers={'User-Agent': 'Mozilla/5.0'})
+        with urllib.request.urlopen(req) as response:
+            return Image.open(BytesIO(response.read())).convert("RGBA")
+    except Exception as e:
+        print(f"Failed to download {url}: {e}")
+        # Return a transparent dummy image
+        return Image.new("RGBA", (256, 256), (0, 0, 0, 0))
+
+def get_texture(path, is_block):
+    # Try local first
+    local_path = os.path.join(CUSTOM_ASSETS_DIR, f"{path}.png")
+    if os.path.exists(local_path):
+        img = Image.open(local_path).convert("RGBA")
+    else:
+        url = f"{MC_ASSETS_BASE}{path}.png"
+        img = download_image(url)
+        
+    # Scale from 256x256 to 144x144
+    if is_block:
+        # Blocks use Lanczos for smooth 3D edges
+        img = img.resize((ITEM_SIZE, ITEM_SIZE), Image.Resampling.LANCZOS)
+    else:
+        # Items are downscaled to 16x16 nearest neighbor, then upscaled to 144x144 nearest neighbor
+        img = img.resize((16, 16), Image.Resampling.NEAREST)
+        img = img.resize((ITEM_SIZE, ITEM_SIZE), Image.Resampling.NEAREST)
+        
+    return img
+
+def create_background(width, height, override_path):
+    if override_path and os.path.exists(override_path):
+        bg = Image.open(override_path).convert("RGBA")
+        # Resize to fill, center crop
+        ratio = max(width / bg.width, height / bg.height)
+        new_size = (int(bg.width * ratio), int(bg.height * ratio))
+        bg = bg.resize(new_size, Image.Resampling.LANCZOS)
+        left = (bg.width - width) / 2
+        top = (bg.height - height) / 2
+        bg = bg.crop((left, top, left + width, top + height))
+        bg = bg.filter(ImageFilter.GaussianBlur(radius=5))
+        return bg
+    else:
+        # Default gradient (solid color as a fallback if no dynamic gen is wanted)
+        bg = Image.new("RGBA", (width, height), (211, 140, 83, 255))
+        return bg
+
+def main():
+    # Resolve paths relative to script
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    os.chdir(script_dir)
+    
+    if not os.path.exists(CONFIG_PATH):
+        print(f"Config not found at {CONFIG_PATH}")
+        return
+
+    with open(CONFIG_PATH, "r") as f:
+        config = json.load(f)
+        
+    grid_width = GRID_COLS * SLOT_SIZE
+    grid_height = GRID_ROWS * SLOT_SIZE
+    
+    canvas_width = SIDEBAR_WIDTH + grid_width + 50
+    canvas_height = 50 + grid_height + GAP + grid_height + 50
+    
+    bg = create_background(canvas_width, canvas_height, config.get("background_override"))
+    
+    try:
+        inv_slot = Image.open(INV_SLOT_PATH).convert("RGBA")
+    except Exception:
+        # fallback if inv_slot doesn't exist yet
+        inv_slot = Image.new("RGBA", (SLOT_SIZE, SLOT_SIZE), (255, 0, 0, 100))
+        
+    off_grid = Image.new("RGBA", (grid_width, grid_height), (0,0,0,0))
+    on_grid = Image.new("RGBA", (grid_width, grid_height), (0,0,0,0))
+    
+    # Draw empty slots
+    for r in range(GRID_ROWS):
+        for c in range(GRID_COLS):
+            x = c * SLOT_SIZE
+            y = r * SLOT_SIZE
+            off_grid.paste(inv_slot, (x, y), inv_slot)
+            on_grid.paste(inv_slot, (x, y), inv_slot)
+            
+    # Draw items
+    for item in config.get("items", []):
+        slot = item.get("slot", 0)
+        r = slot // GRID_COLS
+        c = slot % GRID_COLS
+        if r >= GRID_ROWS:
+            continue
+            
+        x = c * SLOT_SIZE + (SLOT_SIZE - ITEM_SIZE) // 2
+        y = r * SLOT_SIZE + (SLOT_SIZE - ITEM_SIZE) // 2
+        
+        is_block = (item.get("type") == "block")
+        
+        if "off_texture" in item:
+            off_img = get_texture(item["off_texture"], is_block)
+            off_grid.paste(off_img, (x, y), off_img)
+            
+        if "on_texture" in item:
+            on_img = get_texture(item["on_texture"], is_block)
+            on_grid.paste(on_img, (x, y), on_img)
+        
+    # Paste grids to bg
+    grid_x = SIDEBAR_WIDTH
+    top_y = 50
+    bottom_y = top_y + grid_height + GAP
+    
+    bg.paste(off_grid, (grid_x, top_y), off_grid)
+    bg.paste(on_grid, (grid_x, bottom_y), on_grid)
+    
+    # Draw sidebar
+    draw = ImageDraw.Draw(bg)
+    try:
+        # Try to get a system font or download one
+        url = "https://github.com/googlefonts/opensans/raw/main/fonts/ttf/OpenSans-Bold.ttf"
+        req = urllib.request.Request(url, headers={'User-Agent': 'Mozilla/5.0'})
+        font_bytes = BytesIO(urllib.request.urlopen(req).read())
+        font = ImageFont.truetype(font_bytes, 100)
+    except Exception:
+        font = ImageFont.load_default()
+        
+    # Draw rotated text
+    def draw_rotated_text(text, x, y):
+        txt_img = Image.new('RGBA', (300, 120), (0, 0, 0, 0))
+        txt_draw = ImageDraw.Draw(txt_img)
+        txt_draw.text((0, 0), text, font=font, fill=(255, 255, 255, 255))
+        txt_img = txt_img.rotate(90, expand=1)
+        bg.paste(txt_img, (x, y), txt_img)
+        
+    draw_rotated_text("OFF", 80, top_y + 100)
+    draw_rotated_text("ON", 80, bottom_y + 150)
+    
+    # Draw arrows down
+    arrow_y = top_y + grid_height + (GAP // 2) - 30
+    draw.polygon([(100, arrow_y), (150, arrow_y), (125, arrow_y + 40)], fill=(255, 255, 255, 255))
+    draw.polygon([(100, arrow_y+20), (150, arrow_y+20), (125, arrow_y + 60)], fill=(255, 255, 255, 255))
+    
+    os.makedirs(os.path.dirname(OUTPUT_PATH), exist_ok=True)
+    bg.save(OUTPUT_PATH)
+    print(f"Saved to {os.path.abspath(OUTPUT_PATH)}")
+
+if __name__ == "__main__":
+    main()

.github/scripts/generate_showcase.py

@@ -0,0 +1,18 @@
+{
+  "title": "ViaBackwards-Plus Showcase",
+  "background_override": "",
+  "items": [
+    {
+      "slot": 0,
+      "type": "block",
+      "off_texture": "block/oak_log",
+      "on_texture": "block/acacia_log"
+    },
+    {
+      "slot": 1,
+      "type": "item",
+      "off_texture": "item/diamond_sword",
+      "on_texture": "item/netherite_sword"
+    }
+  ]
+}

.github/showcase_config.json

@@ -0,0 +1,36 @@
+name: Generate Showcase Graphic
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - '.github/showcase_config.json'
+
+jobs:
+  build-showcase:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install Pillow requests
+          
+      - name: Run Generator Script
+        run: python .github/scripts/generate_showcase.py
+        
+      - name: Commit and push changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "chore: auto-generate showcase graphic"
+          file_pattern: '.github/images/showcase_output.png'