How fgouin2014/dukenukem3d-dnksb works
This repository combines a Duke Nukem soundboard app with a substantial asset-preparation toolkit. The user-facing flow is opening the Android app and browsing or viewing animation assets; the sampled app excerpt confirms that it loads animation metadata and supports settings-based overrides. Separate Python workflows assemble sprite sheets and collections from extracted tiles. There is no README, and the excerpts do not establish how audio playback is wired or how generated assets are delivered to the app, so those connections are omitted.
Main entry points: MainActivity.kt Soundboard UI · engine_brutes_rebuild.py Brute animations · auto_build.py Mapped animations · build_penthouse_assets.py Penthouse assets
Components 18
Android soundboard
- Soundboard UI
DukeSoundboard/app/src/main/java/com/lastchance/dukesoundboard/MainActivity.kt - Animation metadata
DukeSoundboard/app/src/main/java/com/lastchance/dukesoundboard/MainActivity.kt - Settings overrides
DukeSoundboard/app/src/main/java/com/lastchance/dukesoundboard/MainActivity.kt
Asset generation
- Sprite sheets
make_spritesheet.py - Mapped animations
auto_build.py - Monster animations
build_monster_assets.py - Brute animations
engine_brutes_rebuild.py - Duke3D monster sheets
build_all_duke3d_monsters.py - Penthouse assets
build_penthouse_assets.py
Asset collections
- Master collection
build_master_phase3.py - Audio organization
organize_audio.py - Audio assets
- Extracted sprite tiles
- Sound mapping
Asset inspection
- Animation audit
audit_engine_brutes.py - Metadata repair
fix_engine_brutes.py - Game definition audit
mega_audit.py
Other components
- Soundboard user
Connections 16
- Soundboard user → Soundboard UI: browses
- Soundboard UI → Animation metadata: loads metadata
DukeSoundboard/app/src/main/java/com/lastchance/dukesoundboard/MainActivity.kt - Soundboard UI → Settings overrides: checks overrides
DukeSoundboard/app/src/main/java/com/lastchance/dukesoundboard/MainActivity.kt - Extracted sprite tiles → Sprite sheets: provides frames
make_spritesheet.py - Extracted sprite tiles → Mapped animations: provides tiles
auto_build.py - Extracted sprite tiles → Monster animations: provides tiles
build_monster_assets.py - Extracted sprite tiles → Brute animations: provides tiles
engine_brutes_rebuild.py - Extracted sprite tiles → Duke3D monster sheets: provides tiles
build_all_duke3d_monsters.py - Mapped animations → Sound mapping: writes mapping
auto_build.py - Audio assets → Audio organization: organizes files
organize_audio.py - Extracted sprite tiles → Penthouse assets: provides tiles
build_penthouse_assets.py - Penthouse assets → Audio assets: converts audio
build_penthouse_assets.py - Master collection → Audio assets: copies audio
build_master_phase3.py - Brute animations → Animation audit: checks metadata
- Metadata repair → Brute animations: repairs metadata
- Game definition audit → Master collection: documents definitions