How momusdigital/f3_decomp works
This repository is a function-by-function C++ decompilation of Fallout 3 for research, modding, and preservation—not a playable game or replacement executable. The principal workflow is for a modder or researcher to consult the source to understand game behavior. Its major domains include gameplay, interface/audio, rendering, animation, physics, and shared engine services. The README documents the repository’s purpose; sampled source confirms selected internal behavior, but most game subsystems are not runtime-connected here because their source was not sampled.
Main entry points: imagespacemanager.cpp Image-space effects · memorymanager.cpp Memory manager · hkpstorageextendedmeshshape.cpp Stored mesh shapes · main.cpp Game startup
Components 22
Gameplay systems
- Game startup
src/fallout/misc/main.cpp - Combat AI
src/fallout/ai/combatcontroller.cpp - Script runtime
src/fallout_shared/tesscriptrunmanager.cpp
Presentation systems
- Interface manager
src/fallout/interface/interfacemanager.cpp - Audio manager
src/bsaudio/bsaudiomanager.cpp - Shader manager
src/bsshader/bsshadermanager.cpp - Image-space effects
src/bsshader/imagespacemanager.cpp - Decal manager
src/fallout_shared/bgsdecalmanager.cpp - Face generation
src/fallout_shared/facegen/bsfacegenmanager_o2_variant.cpp - SpeedTree manager
src/fallout_shared/speedtree/bstreemanager_o2_variant.cpp
Engine services
- Controller sequences
src/gamebryo2.2/corelibs/nianimation/nicontrollersequence.cpp - Time controller
src/gamebryo2.2/corelibs/nimain/nitimecontroller.cpp - Memory manager
src/bscore/memorymanager.cpp - Memory pools
include/MemoryPool.h - Archive handling
src/bssystem/archive.cpp - Engine type layouts
include/layout_support.h
Havok physics
- Stored mesh shapes
src/havok/physics/collide/shape/compound/collection/storageextendedmesh/hkpstorageextendedmeshshape.cpp - World broad phase
src/havok/physics/dynamics/world/util/aabbtree/hkpaabbtreeworldmanager.cpp - Character state machine
src/havok/physics/utilities/charactercontrol/statemachine/hkpcharacterstatemanager.cpp - Havok base types
include/havok/hkBase.h
Other components
- Modder / researcher
- Fallout 3 source reference
Connections 21
- Modder / researcher → Fallout 3 source reference: consults
README.md - Fallout 3 source reference → Game startup: documents behavior
README.md - Fallout 3 source reference → Combat AI: documents behavior
README.md - Fallout 3 source reference → Interface manager: documents behavior
README.md - Fallout 3 source reference → Audio manager: documents behavior
README.md - Fallout 3 source reference → Shader manager: documents behavior
README.md - Fallout 3 source reference → Image-space effects: documents behavior
README.md - Fallout 3 source reference → Decal manager: documents behavior
README.md - Fallout 3 source reference → Controller sequences: documents behavior
README.md - Fallout 3 source reference → Time controller: documents behavior
README.md - Fallout 3 source reference → Memory manager: documents behavior
README.md - Fallout 3 source reference → Archive handling: documents behavior
README.md - Fallout 3 source reference → Script runtime: documents behavior
README.md - Fallout 3 source reference → Face generation: documents behavior
README.md - Fallout 3 source reference → SpeedTree manager: documents behavior
README.md - Fallout 3 source reference → Stored mesh shapes: documents behavior
README.md - Fallout 3 source reference → World broad phase: documents behavior
README.md - Fallout 3 source reference → Character state machine: documents behavior
README.md - Image-space effects → Image-space effects: sets up effects
src/bsshader/imagespacemanager.cpp - Memory manager → Memory pools: creates pools
src/bscore/memorymanager.cpp - Stored mesh shapes → Havok base types: uses base types