Skip to main content

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.

Download files

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

Source Distribution

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

Uploaded Source

Built Distribution

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

soulstruct-2.4.0-py3-none-any.whl (8.7 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: soulstruct-2.4.0.tar.gz
  • Upload date:
  • Size: 8.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for soulstruct-2.4.0.tar.gz
Algorithm Hash digest
SHA256 d7e5a18d1052d69846de8d90cebdc106f502f887edd7a82bed2fa9d7f4d3c946
MD5 16e50cf070c4dac130f9a941fa4bb5d4
BLAKE2b-256 615f0e4a7d8f267a9e9bfe5a8f471f7989a1bed9a4c7ce882cc74f5909a316a1

See more details on using hashes here.

Provenance

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

Publisher: publish.yml on Grimrukh/soulstruct

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

File details

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

File metadata

  • Download URL: soulstruct-2.4.0-py3-none-any.whl
  • Upload date:
  • Size: 8.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for soulstruct-2.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cbb82b9b154fded5c9f198f6031a27818989226d1293989452e5c718a5a0d5e4
MD5 a6098fd7acbd8b79f4bec93e441bc5ef
BLAKE2b-256 51b566cc57a9fd0e1834f5aca083e42736abef5b408bd6e6bae2b6402d58ce82

See more details on using hashes here.

Provenance

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

Publisher: publish.yml on Grimrukh/soulstruct

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

Release history Release notifications | RSS feed

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

This release

2.4.0 This release

2 files

2.3.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page