soulstruct

Python tools for inspecting and modding From Software games, including an "all-in-one" graphical interface.

YouTube channel with tutorials: https://youtube.com/grimrukh

Like my stuff? Consider supporting me on Patreon <3 https://patreon.com/Grimrukh

Game abbreviations used below and in package:

• DS1PTDE: Dark Souls: Prepare to Die Edition
• DS1R: Dark Souls Remastered
• DS2: Dark Souls II (either version)
• BB: Bloodborne
• DS3: Dark Souls III
• SEK: Sekiro: Shadows Die Twice
• ER: Elden Ring

Features

• Unified graphical application for modifying maps, events, parameters, text, AI, and talk scripts in Dark Souls (both versions) and Bloodborne. Game data is imported as a project, edited in the window (or in Python if you prefer), and exported back to game-ready files whenever you want. Keep track of map entities, quickly navigate between data types, and view custom syntax highlighting for event scripts and AI scripts.

  • Supported games: DS1PTDE, DS1R, BB

• Event scripts (EMEVD) and EzState state machines (ESD) can be translated to and from valid Python-based languages with high-level programming features.

  • Supported games: DS1PTDE, DS1R, DS2 (ESD only), BB, DS3

• Map data (MSB), game parameters (GameParam), lighting parameters (DrawParam), text data (FMG) can be loaded into Python structures, edited, and repacked.

  • Supported games: DS1PTDE, DS1R, BB (map, game parameters, and text only), DS3 (map and text only)

• AI scripts in can be decompiled, edited, and recompiled.

  • Supported games: DS1PTDE (no decompiling), DS1R

• Unpack/repack BND archives and automatically manage DCX compression.

  • Supported games: all

• Includes some of my ongoing documentation for vanilla game IDs in Dark Souls and Bloodborne.