# amysouls/fromsoftware-rs architecture

> Architecture diagram of the GitHub repository amysouls/fromsoftware-rs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amysouls/fromsoftware-rs
- Repository: https://github.com/amysouls/fromsoftware-rs

## Overview

FromSoftware-rs is a Rust runtime-bindings library for creating mods for Dark Souls 3, Sekiro, Elden Ring, and Nightreign. A developer uses a game-specific crate to work with that game’s in-memory engine structures; parameter definitions and repositories provide a distinct data-access stage, while shared utilities support common runtime representations. The repository also includes debug-facing crates and tools. The graph emphasizes documented package boundaries and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled internals are represented only at supported directory paths.

Main entry points: [`crates/darksouls3/src`](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/darksouls3/src) (Dark Souls 3), [`crates/eldenring/src`](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/eldenring/src) (Elden Ring), [`crates/sekiro/src`](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/sekiro/src) (Sekiro), [`crates/nightreign/src`](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/nightreign/src) (Nightreign)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_games["Game bindings"]
  node_ds3["Dark Souls 3"]
  node_sekiro["Sekiro"]
  node_eldenring["Elden Ring"]
  node_nightreign["Nightreign"]
  node_ds3_engine["Engine structures"]
  node_er_engine["Engine systems"]
  node_er_session["Multiplayer session<br/>[session_manager.rs]"]
  node_er_bullets["Bullet manager<br/>[bullet_manager.rs]"]
  node_nr_bullets["Bullet manager<br/>[bullet_manager.rs]"]
end

subgraph group_params["Parameter access"]
  node_ds3_param_defs["Parameter definitions<br/>[generated.rs]"]
  node_ds3_param_access["Regulation parameters"]
  node_ds3_solo["Solo repository"]
  node_er_param_defs["Parameter definitions<br/>[generated.rs]"]
  node_er_param_repo["Parameter repository"]
  node_sekiro_param_defs["Parameter definitions<br/>[generated.rs]"]
  node_sekiro_param_repo["Solo repository"]
  node_nightreign_params["Parameter definitions<br/>[param.rs]"]
end

subgraph group_shared["Shared runtime"]
  node_shared_runtime["Shared utilities"]
  node_shared_stl["STL structures"]
end

subgraph group_debug["Debug inspection"]
  node_debug_core["Debug support"]
  node_ds3_debug["DS3 inspection"]
  node_er_debug["Elden Ring inspection"]
  node_sekiro_debug["Sekiro inspection"]
end

node_developer(("Mod developer"))

node_developer -->|"uses bindings"| node_ds3
node_developer -->|"uses bindings"| node_sekiro
node_developer -->|"uses bindings"| node_eldenring
node_developer -->|"uses bindings"| node_nightreign
node_ds3 -->|"exposes structures"| node_ds3_engine
node_eldenring -->|"exposes systems"| node_er_engine
node_er_engine -->|"exports manager"| node_er_session
node_er_engine -->|"exports manager"| node_er_bullets
node_nightreign -.->|"exports manager"| node_nr_bullets
node_ds3 -->|"provides parameters"| node_ds3_param_defs
node_ds3 -->|"provides access"| node_ds3_param_access
node_ds3 -->|"provides repository"| node_ds3_solo
node_ds3_param_access -->|"uses definitions"| node_ds3_param_defs
node_eldenring -->|"provides parameters"| node_er_param_defs
node_eldenring -.->|"provides repository"| node_er_param_repo
node_er_param_repo -->|"uses definitions"| node_er_param_defs
node_sekiro -->|"provides parameters"| node_sekiro_param_defs
node_sekiro -->|"provides repository"| node_sekiro_param_repo
node_sekiro_param_repo -->|"uses definitions"| node_sekiro_param_defs
node_nightreign -.->|"provides parameters"| node_nightreign_params
node_ds3 -->|"uses utilities"| node_shared_runtime
node_eldenring -->|"uses utilities"| node_shared_runtime
node_developer -.->|"inspects runtime"| node_ds3_debug
node_developer -.->|"inspects runtime"| node_er_debug
node_developer -.->|"inspects runtime"| node_sekiro_debug
node_ds3_debug -.->|"uses support"| node_debug_core
node_er_debug -.->|"uses support"| node_debug_core
node_sekiro_debug -.->|"uses support"| node_debug_core

click node_ds3 "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/darksouls3/src"
click node_sekiro "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/sekiro/src"
click node_eldenring "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/eldenring/src"
click node_nightreign "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/nightreign/src"
click node_ds3_engine "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/darksouls3/src/sprj"
click node_er_engine "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/eldenring/src/cs"
click node_er_session "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/eldenring/src/cs/session_manager.rs"
click node_er_bullets "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/eldenring/src/cs/bullet_manager.rs"
click node_nr_bullets "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/nightreign/src/cs/bullet_manager.rs"
click node_ds3_param_defs "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/darksouls3/src/param/generated.rs"
click node_ds3_param_access "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/darksouls3/src/sprj/regulation_manager.rs"
click node_ds3_solo "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/darksouls3/src/sprj/solo_param_repository.rs"
click node_er_param_defs "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/eldenring/src/param/generated.rs"
click node_er_param_repo "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/eldenring/src/fd4/param_repository.rs"
click node_sekiro_param_defs "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/sekiro/src/param/generated.rs"
click node_sekiro_param_repo "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/sekiro/src/sprj/solo_param_repository.rs"
click node_nightreign_params "https://github.com/amysouls/fromsoftware-rs/blob/main/crates/nightreign/src/param.rs"
click node_shared_runtime "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/shared/src"
click node_shared_stl "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/shared/stl/src"
click node_debug_core "https://github.com/amysouls/fromsoftware-rs/tree/main/crates/debug/src"
click node_ds3_debug "https://github.com/amysouls/fromsoftware-rs/tree/main/tools/debug-darksouls3/src"
click node_er_debug "https://github.com/amysouls/fromsoftware-rs/tree/main/tools/debug-eldenring/src"
click node_sekiro_debug "https://github.com/amysouls/fromsoftware-rs/tree/main/tools/debug-sekiro/src"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ds3,node_sekiro,node_eldenring,node_nightreign,node_ds3_engine,node_er_engine,node_er_session,node_er_bullets,node_nr_bullets toneBlue
class node_ds3_param_defs,node_ds3_param_access,node_ds3_solo,node_er_param_defs,node_er_param_repo,node_sekiro_param_defs,node_sekiro_param_repo,node_nightreign_params toneAmber
class node_shared_runtime,node_shared_stl toneMint
class node_debug_core,node_ds3_debug,node_er_debug,node_sekiro_debug toneRose
class node_developer toneIndigo
```

## Components

### Game bindings

- [Dark Souls 3](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/darksouls3/src): `crates/darksouls3/src`
- [Sekiro](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/sekiro/src): `crates/sekiro/src`
- [Elden Ring](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/eldenring/src): `crates/eldenring/src`
- [Nightreign](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/nightreign/src): `crates/nightreign/src`
- [Engine structures](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/darksouls3/src/sprj): `crates/darksouls3/src/sprj`
- [Engine systems](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/eldenring/src/cs): `crates/eldenring/src/cs`
- [Multiplayer session](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/eldenring/src/cs/session_manager.rs): `crates/eldenring/src/cs/session_manager.rs`
- [Bullet manager](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/eldenring/src/cs/bullet_manager.rs): `crates/eldenring/src/cs/bullet_manager.rs`
- [Bullet manager](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/nightreign/src/cs/bullet_manager.rs): `crates/nightreign/src/cs/bullet_manager.rs`

### Parameter access

- [Parameter definitions](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/darksouls3/src/param/generated.rs): `crates/darksouls3/src/param/generated.rs`
- [Regulation parameters](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/darksouls3/src/sprj/regulation_manager.rs): `crates/darksouls3/src/sprj/regulation_manager.rs`
- [Solo repository](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/darksouls3/src/sprj/solo_param_repository.rs): `crates/darksouls3/src/sprj/solo_param_repository.rs`
- [Parameter definitions](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/eldenring/src/param/generated.rs): `crates/eldenring/src/param/generated.rs`
- [Parameter repository](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/eldenring/src/fd4/param_repository.rs): `crates/eldenring/src/fd4/param_repository.rs`
- [Parameter definitions](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/sekiro/src/param/generated.rs): `crates/sekiro/src/param/generated.rs`
- [Solo repository](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/sekiro/src/sprj/solo_param_repository.rs): `crates/sekiro/src/sprj/solo_param_repository.rs`
- [Parameter definitions](https://github.com/amysouls/fromsoftware-rs/blob/main/crates/nightreign/src/param.rs): `crates/nightreign/src/param.rs`

### Shared runtime

- [Shared utilities](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/shared/src): `crates/shared/src`
- [STL structures](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/shared/stl/src): `crates/shared/stl/src`

### Debug inspection

- [Debug support](https://github.com/amysouls/fromsoftware-rs/tree/main/crates/debug/src): `crates/debug/src`
- [DS3 inspection](https://github.com/amysouls/fromsoftware-rs/tree/main/tools/debug-darksouls3/src): `tools/debug-darksouls3/src`
- [Elden Ring inspection](https://github.com/amysouls/fromsoftware-rs/tree/main/tools/debug-eldenring/src): `tools/debug-eldenring/src`
- [Sekiro inspection](https://github.com/amysouls/fromsoftware-rs/tree/main/tools/debug-sekiro/src): `tools/debug-sekiro/src`

### Other components

- **Mod developer**

## Connections

- Mod developer → Dark Souls 3: uses bindings (evidence: `README.md`)
- Mod developer → Sekiro: uses bindings (evidence: `README.md`)
- Mod developer → Elden Ring: uses bindings (evidence: `README.md`)
- Mod developer → Nightreign: uses bindings (evidence: `README.md`)
- Dark Souls 3 → Engine structures: exposes structures (evidence: `crates/darksouls3/src/sprj.rs`)
- Elden Ring → Engine systems: exposes systems (evidence: `crates/eldenring/src/cs.rs`)
- Engine systems → Multiplayer session: exports manager
- Engine systems → Bullet manager: exports manager (evidence: `crates/eldenring/src/cs.rs`)
- Nightreign → Bullet manager: exports manager (evidence: `crates/nightreign/src/cs/bullet_manager.rs`)
- Dark Souls 3 → Parameter definitions: provides parameters (evidence: `crates/darksouls3/src/param.rs`)
- Dark Souls 3 → Regulation parameters: provides access (evidence: `crates/darksouls3/src/sprj.rs`)
- Dark Souls 3 → Solo repository: provides repository (evidence: `crates/darksouls3/src/sprj.rs`)
- Regulation parameters → Parameter definitions: uses definitions (evidence: `crates/darksouls3/src/sprj/regulation_manager.rs`)
- Elden Ring → Parameter definitions: provides parameters (evidence: `crates/eldenring/src/param.rs`)
- Elden Ring → Parameter repository: provides repository (evidence: `crates/eldenring/src/fd4.rs`)
- Parameter repository → Parameter definitions: uses definitions (evidence: `crates/eldenring/src/fd4/param_repository.rs`)
- Sekiro → Parameter definitions: provides parameters (evidence: `crates/sekiro/src/param.rs`)
- Sekiro → Solo repository: provides repository (evidence: `crates/sekiro/src/sprj/solo_param_repository.rs`)
- Solo repository → Parameter definitions: uses definitions (evidence: `crates/sekiro/src/sprj/solo_param_repository.rs`)
- Nightreign → Parameter definitions: provides parameters (evidence: `crates/nightreign/src/fd4/param_repository.rs`)
- Dark Souls 3 → Shared utilities: uses utilities (evidence: `crates/darksouls3/src/sprj/regulation_manager.rs`)
- Elden Ring → Shared utilities: uses utilities (evidence: `crates/eldenring/src/fd4/param_repository.rs`)
- Mod developer → DS3 inspection: inspects runtime
- Mod developer → Elden Ring inspection: inspects runtime
- Mod developer → Sekiro inspection: inspects runtime
- DS3 inspection → Debug support: uses support
- Elden Ring inspection → Debug support: uses support
- Sekiro inspection → Debug support: uses support
