How anchorxv/xv2-build-forge works
DBXV2 Build Forge is a desktop roster and moveset planner for Xenoverse 2 modders. Users build and validate preset entries in the editor, organize them into roster sheets, review or reload entries, and export selected sheets to CSV or Excel. The app controller initializes the shared in-memory store and persistence before opening the UI; views use Qt table models, searchable views, and undo commands. README capabilities include live language switching and crash-safe backups; locale files are not present in the supplied tree, and several runtime connections are supported only by documentation or the source index.
Main entry points: data_store.py Shared Data Store · editor_tab.py Preset Editor · database_tab.py Catalog Tabs · app_controller.py App Coordinator
Components 25
Application
- App Entry
main.py - App Coordinator
controllers/app_controller.py - Main Window
views/main_window.py - Tab Manager
views/tab_manager.py - Theme Manager
styles/theme_manager.py - Settings Controller
controllers/settings_controller.py
Preset Authoring
- Preset Editor
views/editor_tab.py - Editor Logic
controllers/editor_controller.py - Input Validation
models/validators.py - Skill Normalizer
models/skill_parser.py
Roster Management
- Roster Preview
views/roster_tab.py - Sheet Details
views/dialogs/sheet_detail_dialog.py - Roster Export
views/dialogs/export_dialog.py - Export Logic
controllers/export_controller.py
Reference Catalogs
- Catalog Tabs
views/database_tab.py - Catalog Editor
views/dialogs/db_entry_dialog.py
Data and Presentation
- Domain Schemas
models/schemas.py - Shared Data Store
models/data_store.py - JSON Persistence
models/persistence.py - Qt Table Models
models/table_models.py - Searchable Tables
views/widgets/searchable_table_view.py - Undo Commands
controllers/undo_commands.py - Signal Bus
controllers/signal_bus.py
Other components
- Modder
- External Mod Tools
Connections 33
- Modder → App Entry: launches
README.md - App Entry → App Coordinator: starts
main.py - App Coordinator → Shared Data Store: initializes
controllers/app_controller.py - App Coordinator → JSON Persistence: loads and backs up
controllers/app_controller.py - App Coordinator → Theme Manager: applies theme
controllers/app_controller.py - App Coordinator → Main Window: creates
controllers/app_controller.py - Main Window → Tab Manager: hosts
views/main_window.py - Tab Manager → Preset Editor: creates
views/tab_manager.py - Tab Manager → Roster Preview: creates
views/tab_manager.py - Tab Manager → Catalog Tabs: creates
views/tab_manager.py - Preset Editor → Editor Logic: delegates to
views/editor_tab.py - Preset Editor → Input Validation: validates with
views/editor_tab.py - Preset Editor → Skill Normalizer: normalizes skills
- Preset Editor → Shared Data Store: reads and updates
views/editor_tab.py - Preset Editor → Domain Schemas: builds entries
views/editor_tab.py - Roster Preview → Shared Data Store: reads sheets
views/roster_tab.py - Roster Preview → Sheet Details: opens details
views/roster_tab.py - Sheet Details → Shared Data Store: reads entries
views/dialogs/sheet_detail_dialog.py - Sheet Details → Signal Bus: requests editor load
- Roster Preview → Roster Export: opens export
views/roster_tab.py - Export Logic → Roster Export: uses dialog
controllers/export_controller.py - Roster Export → External Mod Tools: exports files for
README.md - Catalog Tabs → Catalog Editor: edits catalog entries
views/database_tab.py - Catalog Tabs → Shared Data Store: updates catalog
views/database_tab.py - Catalog Tabs → Undo Commands: pushes commands
views/database_tab.py - Catalog Tabs → Qt Table Models: displays data
views/database_tab.py - Catalog Tabs → Searchable Tables: uses table view
views/database_tab.py - Roster Preview → Qt Table Models: displays summaries
views/roster_tab.py - Shared Data Store → JSON Persistence: saves state
models/data_store.py - Undo Commands → Shared Data Store: mutates state
controllers/undo_commands.py - Undo Commands → Signal Bus: notifies changes
controllers/undo_commands.py - Settings Controller → Theme Manager: applies preferences
controllers/settings_controller.py - Main Window → Settings Controller: opens settings
views/main_window.py