changes

.env.example

@@ -23,3 +23,15 @@ TLS_KEY_PATH=./certs/key.pem
 CORS_ORIGIN=*
 # Base URL advertised in the OpenAPI document.
 PUBLIC_URL=https://localhost:3000
+
+# --- Icons -------------------------------------------------------------------
+# Directory containing the mod .jar files; scanned once on startup to extract
+# item / block textures into the icon cache.
+MODS_DIR=/mods
+# Optional path to the Minecraft client jar. Needed to extract vanilla
+# `minecraft:*` textures, since those live in the client jar and not in MODS_DIR.
+# Example: VANILLA_JAR=C:/Users/you/AppData/Roaming/.minecraft/versions/1.20.1/1.20.1.jar
+VANILLA_JAR=
+# Where the extracted PNGs are cached on disk. The cache survives restarts via
+# a manifest.json that tracks jar mtime+size.
+ICON_CACHE_DIR=/cache/icons