Skip to content

Doom on UnrealPy

Doom on UnrealPy is Cane Studios’ demo project. It implements the game mode, player, monsters, projectiles, HUD, and menus as Unreal classes written in Python. The levels use Unreal’s procedural meshes, and co-op and deathmatch use Unreal’s replication and RPCs.

View the demo on GitHub

Run the demo

The repository documents a Windows setup with Unreal Engine 5.9, UnrealPy, and ScriptCore. The plugin is distributed separately. Use the demo’s README for its engine and plugin requirements.

Download Freedoom Phase 1 and follow the README’s import and play steps with the freedoom1 data set. The importer turns the WAD into local Unreal assets for the demo to load. Demo setup and data import

Read the gameplay code

  • Gameplay and UI live in Python/doom. Start with mode.py for the game mode and simulation, or hud.py for the HUD and automap. Module guide
  • Multiplayer uses Python classes for game and player state. Read state.py alongside the replication guide to see how clients receive state and build their view of the level.
  • Testing includes Python unit tests outside Unreal and gameplay scenarios that run inside the engine. Testing the demo