build: automatically add p2ce overlay to addon thumbnails

Author: craftablescience

_build/assets/thumb_overlay.png

@@ -2,9 +2,18 @@
 import shutil
 import sys
 
+from PIL import Image
 from sourcepp import vpkpp
 
 
+def add_overlay_to_image(base_path: str, overlay_path: str, out_path: str) -> None:
+    base = Image.open(base_path).convert("RGBA")
+    overlay = Image.open(overlay_path).convert("RGBA")
+    base = base.resize(overlay.size, Image.Resampling.BICUBIC)
+    base.paste(overlay, None, overlay)
+    base.convert("RGB").save(out_path)
+
+
 def build_addon(addon_dir: str, output_dir_parent: str) -> None:
     output_dir = os.path.join(output_dir_parent, "p2ce_" + os.path.basename(addon_dir))
     os.makedirs(output_dir, exist_ok=True)
@@ -34,6 +43,13 @@ def build_addon(addon_dir: str, output_dir_parent: str) -> None:
                 vpk.add_entry_from_file(os.path.basename(entry), entry)
         vpk.bake()
 
+    if (
+        os.path.exists(thumb_path := os.path.join(output_dir, ".assets", "thumb.png")) or
+        os.path.exists(thumb_path := os.path.join(output_dir, ".assets", "thumb.jpg")) or
+        os.path.exists(thumb_path := os.path.join(output_dir, ".assets", "thumb.jpeg"))
+    ):
+        add_overlay_to_image(thumb_path, os.path.join(os.path.dirname(__file__), "assets", "thumb_overlay.png"), thumb_path)
+
 
 def zip_addons(parent_dir: str, stem: str) -> None:
     print(f"Zipping contents of {parent_dir} into {stem}.zip")

_build/build.py

@@ -1 +1,2 @@
+pillow==11.3.0
 sourcepp==2025.9.12