overhaul

.env.example

@@ -23,7 +23,12 @@ OWNER_DISCORD_ID=
 DEV_AUTH_BYPASS=false
 
 # --- Reforger Workshop API (backend-only, never called from the browser) ---
+# The panel uses the v2 API. Responses are cached in-process with
+# stale-while-revalidate, so the Mods page does not wait on the network.
 REFORGER_WORKSHOP_API_BASE_URL=https://api.reforgermods.net
+# Optional. The free public tier needs no credentials; set a key only if you
+# have a paid reforgermods.net plan and want its higher rate limits.
+REFORGER_WORKSHOP_API_KEY=
 
 # --- Pterodactyl (Client API, not Application API) ---
 # Leave USE_MOCK_PTERODACTYL=true to run everything locally with mock data.
@@ -33,14 +38,22 @@ PTERODACTYL_CLIENT_API_KEY=
 # The short server identifier from the Pterodactyl server URL, e.g. "1a2b3c4d".
 PTERODACTYL_SERVER_ID=
 USE_MOCK_PTERODACTYL=true
+# Proxy Pterodactyl's Wings websocket for the live console and real-time
+# resource metrics. This is what makes install, update and mod-download output
+# visible in the panel; without it you only see the game's own log file, which
+# does not exist until the game has already started. Set to false to fall back
+# to REST polling.
+PTERODACTYL_WEBSOCKET_ENABLED=true
 
-# --- Reforger config import ---
-# Path of the server's config.json in the Pterodactyl file manager. Imported
-# read-only to populate the Configuration pages, server name, and max players.
+# --- Reforger config ---
+# Path of the server's config.json in the Pterodactyl file manager. Read live
+# on every request and written in place by the Configuration and Mods pages
+# (the previous file is always kept as config.json.bak).
 REFORGER_CONFIG_PATH=/config.json
-REFORGER_CONFIG_SYNC_INTERVAL_SECONDS=300
 
 # --- Reforger log ingestion ---
+# Powers player sessions and the killfeed, which are parsed out of the game's
+# own log file. The live console does not depend on this.
 # Recommended: set REFORGER_LOG_DIRECTORY (e.g. /profile/logs) and the panel
 # follows the newest logs_* dated subfolder automatically on every sync.
 # REFORGER_ADMIN_LOG_PATH pins one exact file and overrides discovery.