Repository navigation
Full Changelog: https://github.com/faospark/Kupo-UI.PR/commits/2026
KupoUI.PR is structured as a suite of 6 Core Engines:
- 🎨 Texture & Theme Engine
5-Layer Priority Pipeline: Swap UI themes, frames, bg colors, cursors, & button prompts cleanly.
Prefabs & Addressables: Replace battle backgrounds & prefab assets without bundle editing.
Sidecar Metadata: Fine-tune 9-slice borders, UV wrap modes (auto-tiling), scale, & PPU per image.
Hot-Reload: Live texture updates on disk save without restarting the game. - 📐 GameObject & Layout Engine (ObjectConfig.json)
Runtime UI Manipulation: Move, rotate, scale, hide, or recolor any UI element in the game.
Targeted Hierarchy Pathing: Disambiguate duplicate UI elements via paths & sibling indexes.
Custom Image Insertion: Drop new UI images (NewImages) into existing screens without writing C#.
Layout Tweaks & Backgrounds: Scaled-down in-game menu (10% shrink), custom save slot highlight colors, & full-screen title/main menu background images (TitlescreenFullBG, MainMenuBg). - 💬 Dialogue & Portrait Engine
Dynamic Portrait Injection: Inject speaker portraits into speech boxes with custom padding & offsets.
Speaker Formatting: Auto-prepend speaker names, UPPERCASE mode, line breaks, & word wrapping.
Menu Portrait Remapper: Custom portraits for FF2, FF4, & FF6 with aspect ratio preservation. - 🔤 Font & Typography Engine (fontconfig.json)
Custom Font Swap: Use system-wide fonts (installed for all users) per language & UI role (Main, Title, Battle, Number).
Typography Tuning: Custom font scaling, line spacing, vertical offsets, & dialogue font size lock. - 📝 Text & Inline Icon Engine (TextConfig.json & IconsConfig.json)
Data-Driven Text Overrides: Swap text by key, exact string match, or Regex search-and-replace.
Rich Text Inline Icons: Inject custom icon tags (<IC_BAG>) into text & items across all languages.
Atlas Disk Caching & Full Color: Auto-packs icons into atlases, caches on disk, & option to disable item dimming. - 🛠️ Logging & Utility Engine
Utility Settings: Disable mouse cursor, force VSync, DDS textures, & texture hot-reload.
Mod Discovery & Conflict Detection: Scans active mods in 00-Mods/ & alerts on texture conflicts.
Developer Diagnostics: Dedicated loggers to trace textures, battle sprites, fonts, dialogue keys, inline icons, & UI logic.
Build