Cryptfall — Python Dark Fantasy Combat & Loot Kit

Build and test your own dark fantasy combat systems

Cryptfall is a Python developer source kit for automated encounters, balance experiments and procedural equipment drops. Get editable source, JSON content exports, runnable demos, documentation and a regression test suite.

Developer kit: simulations select actions automatically. Python knowledge is required. There are no player controls, graphics or finished game included.

What you get

• 4 class archetypes: Barbarian, Sorceress, Necromancer and Rogue, with class resources and starting equipment.
• 50 enemy definitions, including 5 bosses; 4 encounter-zone definitions.
• 39 ability definitions, 68 item templates and 50 weighted loot tables.
• 16 prefixes and 13 suffixes for procedural equipment.
• 10 skill-tree data sets for your own progression implementation.
• Turn-based auto-combat, derived stats, cooldowns, critical strikes, armor, resistance, status effects and healing potions.
• Python source, 8 JSON exports, a single-encounter example, installation metadata, CLI entrypoint, sample results and buyer documentation.

Audited release 1.0.1

282 tests pass (239 original plus 43 regression cases), including reversed test-file order. Repairs address shared item-template corruption, final status ticks, stack refresh, equipment resistance, cooldown enforcement, resource validation, actual damage reporting and incorrect demo levels. Seven simulation seeds were checked; seed 42 wins all four class routes. Balance varies by seed.

Run in minutes

Extract the ZIP, open a terminal in its root folder and run:

python -m poedemo.demo --seed 42
python -m poedemo.demo --verbose
python examples/single_encounter.py

Optional installation: python -m pip install ., then cryptfall --seed 42. Direct execution requires only Python.

Clear integration limits

Skill trees and passive abilities are data definitions; skill-point allocation and passive application require your implementation. Summon flags do not spawn companions. Movement, range and behavior metadata do not provide navigation or advanced AI. Add your own controls, UI, art, saves, XP progression, shop and inventory transactions. No general resource regeneration or automatic mana-potion use is included.

The demo uses fresh characters at levels 10, 15, 20 and 25 after wins. Loot is reported but is not carried or equipped between zones. JSON files are exported snapshots; edit the Python definitions for runtime changes.

Requirements and license

Python 3.10+ intended compatibility; verified on Windows with Python 3.12.14. Zero runtime dependencies. Optional pytest for testing and setuptools for installation are not bundled. No separate RPG Foundation purchase is needed.

MIT license: use and modify the included code and data in commercial or personal projects; retain the copyright and license notice. AI-assisted code, definitions and documentation are disclosed. Legacy poedemo and Diablo* API names remain for compatibility. This is an independent kit with custom mechanics and no affiliation with commercial game publishers.

Includes quick start, API reference, mechanics, integration guide, known limits, changelog, audit report and third-party notices.