From fe34efea5c922dbea2cc19c98a8851724354dbff Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 13 Mar 2026 21:09:40 +0000 Subject: [PATCH] docs: document Blueprint asset build issue post Pterodactyl v1.12.1 Panel functional but yarn build:production fails with 16 webpack errors. css-loader conflict between Blueprint beta-2026-01 and Pterodactyl v1.12.1. PteroStats needs reinstall when resolved. Chronicler #29 --- .../README.md | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/tasks/pterodactyl-blueprint-asset-build/README.md diff --git a/docs/tasks/pterodactyl-blueprint-asset-build/README.md b/docs/tasks/pterodactyl-blueprint-asset-build/README.md new file mode 100644 index 0000000..29292f9 --- /dev/null +++ b/docs/tasks/pterodactyl-blueprint-asset-build/README.md @@ -0,0 +1,41 @@ +# Task: Pterodactyl Blueprint Asset Build Issue + +**Status:** ⚠️ KNOWN ISSUE — monitoring for Blueprint fix +**Discovered:** March 13, 2026 (Chronicler #29) +**Priority:** LOW — panel is fully functional + +## Summary + +After updating Pterodactyl Panel v1.12.0 → v1.12.1, Blueprint extensions +(modpackinstaller, subdomains) were reinstalled successfully but webpack +asset rebuild fails with 16 errors. + +## Root Cause + +Blueprint beta-2026-01 has a css-loader version conflict with Pterodactyl +v1.12.1 node dependencies. Extensions built for Blueprint beta-2025-04. + +Key errors: +- options.modules.exportLocalsConvention validation failure in css-loader +- xterm-addon-unicode11 module not found + +## Current State + +- Panel fully functional (serving cached pre-update assets) +- All servers manageable via panel +- Wings unaffected on TX1 and NC1 +- Blueprint extensions registered: modpackinstaller, subdomains +- yarn build:production fails with 16 webpack errors +- PteroStats wiped by update — needs reinstall from BuiltByBit + +## Resolution Path + +1. Wait for Blueprint beta-2026-02+ with css-loader fix +2. OR manually patch node_modules css-loader exportLocalsConvention +3. After build works, reinstall PteroStats (paid BuiltByBit resource) + +## Do NOT + +- Do not run yarn build:production until Blueprint is updated +- Do not run blueprint -install on new extensions until fixed +- Panel works fine as-is