soulstruct

Python tools for inspecting and modding FromSoftware games.

YouTube channel with some 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:

Related libraries:

soulstruct-havok: Havok classes and tools for Soulstruct, supporting map collision, character collision, animation, ragdolls, and more.
soulstruct-vanilla: Vanilla event scripts (.evs.py) and other vanilla dumps from Soulstruct.
soulstruct-gui: Graphical interface for Soulstruct-based modding projects, including tabs for Maps, Events, Params, Lighting, Text, AI, and Talk scripts (plus some Runtime utilities for supported games).
Firelink: My FromSoftware modding framework written in C++, which is MUCH faster than Soulstruct for core classes such as FLVERs and Binders. Also includes memory-hooking implementations for supported games and an Elden Ring MSB class (Python is generally too slow for these).

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

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

soulstruct-2.4.2.tar.gz (8.2 MB view details)

Uploaded Sep 8, 2026 Source

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

Uploaded Sep 8, 2026 Python 3

Details for the file soulstruct-2.4.2.tar.gz.

The following attestation bundles were made for soulstruct-2.4.2.tar.gz:

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Details for the file soulstruct-2.4.2-py3-none-any.whl.

The following attestation bundles were made for soulstruct-2.4.2-py3-none-any.whl:

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.