How killa0132/calaplayupper works
CalaplayUpper is a desktop tool for turning user-supplied images and audio into installable CalaPlayer patch containers, with a second workflow for combining existing Mods. The main route is select assets and game paths → validate and build → install or roll back; the merge route discovers selected Mods, checks conflicts, creates one container, and can install it. The GUI is the primary interface, with a CLI alternative. Internal asset-processing stages are shown where the index or excerpts support them; some GUI wiring and merge internals were not sampled.
Main entry points: builder.py Single-package builder · app.py GUI backend · tasks.py Task workers · merger.py Merge engine
Components 22
User interfaces
- Desktop host
gui/desktop.py - GUI backend
gui/app.py - Vue interface
gui/frontend/src/App.vue - Frontend API
gui/frontend/src/api.js - Preferences
gui/prefs.py
Build and install
- Task workers
gui/tasks.py - Single-package builder
core/builder.py - Patch deployment
core/deploy.py - CLI entry
cli/build_srcm.py
Mod merging
- Mod discovery
gui/mods.py - Merge engine
core/merger.py
Asset engine
- Atlas processing
core/atlas.py - Atlas cell mapping
core/atlas_cells.py - Texture processing
core/texture.py - BC1 encoding
core/bc1.py - DataAsset editing
core/da.py - Audio utilities
core/wavutil.py
Tool integration
- Tool wrappers
core/kit.py - Shared runtime
core/common.py
Other components
- User
- Unreal asset tools
- Game files
Connections 26
- User → Desktop host: launches
README.md - Desktop host → GUI backend: hosts
gui/desktop.py - Vue interface → Frontend API: requests
gui/frontend/src/App.vue - Frontend API → GUI backend: calls
- GUI backend → Preferences: reads and writes
gui/app.py - GUI backend → Mod discovery: discovers Mods
gui/app.py - GUI backend → Task workers: starts tasks
gui/app.py - Task workers → Single-package builder: runs build
gui/tasks.py - Task workers → Merge engine: runs merge
gui/tasks.py - Task workers → Patch deployment: installs patch
gui/tasks.py - User → CLI entry: runs command
README.md - CLI entry → Single-package builder: builds package
cli/build_srcm.py - Single-package builder → Atlas processing: processes atlas
core/builder.py - Single-package builder → Atlas cell mapping: maps cells
core/builder.py - Single-package builder → Texture processing: builds textures
core/builder.py - Single-package builder → BC1 encoding: encodes images
core/builder.py - Single-package builder → DataAsset editing: appends rows
core/builder.py - Single-package builder → Audio utilities: processes audio
core/builder.py - Single-package builder → Tool wrappers: uses tools
core/builder.py - Single-package builder → Shared runtime: logs and validates
core/builder.py - Merge engine → DataAsset editing: edits tables
core/merger.py - Merge engine → Tool wrappers: runs tools
core/merger.py - Tool wrappers → Unreal asset tools: invokes
core/kit.py - Single-package builder → Game files: reads game data
README.md - Patch deployment → Game files: installs or restores
README.md - Merge engine → Game files: reads base files
README.md