Skip to main content

Inspect and modify files in FromSoftware games.

Project description

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.

Project details


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.3.2.tar.gz (4.4 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.3.2-py3-none-any.whl (5.3 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: soulstruct-2.3.2.tar.gz
  • Upload date:
  • Size: 4.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for soulstruct-2.3.2.tar.gz
Algorithm Hash digest
SHA256 fce867076698c7af98fc8558745b35d8e45d0fa164c53d2aefcdc735cc0b8dab
MD5 3f8b74226bd79db7167e72d94cb4fa2f
BLAKE2b-256 9f77131b6993eb20cc630a76f0a69e3a486bc1de96d1c5d3169a958c5a33ee9b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: soulstruct-2.3.2-py3-none-any.whl
  • Upload date:
  • Size: 5.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for soulstruct-2.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3e51e7522ea43f482a9b587f616a8c3c283eee1ef664a26d2bc11aa9a8711efc
MD5 a310d3ca8405ae3aa151f441706b2bc9
BLAKE2b-256 241101d094b4ef675106ea5786890a802e5f7dcd2857fb37e3269e5480a9cb6e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page