A Rust‑powered CLI for managing fantasy organisations across time
Go to file
Dandaedre f121f12eb1 More on show 2025-12-02 20:31:57 +01:00
bin_efo More on show 2025-12-02 20:31:57 +01:00
lib_efo More on show 2025-12-02 20:31:57 +01:00
.gitignore some bad git hgappened 2025-11-26 18:40:38 +01:00
Cargo.lock Adds rng/naming 2025-11-30 17:12:46 +01:00
Cargo.toml Mostly doc & Tags & Summary 2025-11-30 17:12:46 +01:00
Jenkinsfile Adds CI 2025-11-15 20:45:05 +01:00
LICENSE Deslop 2025-11-30 18:26:06 +01:00
README.md Deslop 2025-11-30 18:26:06 +01:00
naming.json More on show 2025-12-02 20:31:57 +01:00

README.md

📦 Epoch Forge (epoch_forge)

A Rust-powered CLI for managing fantasy organisations across time.
Think of it as a living, breathing world-state engine that lets you “rewind”, “fast-forward”, and alter the history of guilds, towns, wars, and characters.

🚀 Fast, type-safe, and fully testable.

✨ Quick start

# clone the repo
git clone https://github.com/yourname/epoch_forge.git
cd epoch_forge

# install the binary
cargo install --path .

# initialise an empty world (epoch 0)
efo epoch --init

# add a guild
efo org add --name "The Iron Horde" --leader "Gorun"

# add a town
efo town add --name "Durn" --population 350

# create an alliance
efo link add --type alliance --org "Iron Horde" --town "Durn"

# advance the timeline
efo epoch --advance 3

# inspect the world
cat world.json

🏆 Project Highlights

Feature What it gives you Where it lives
Epoch management Switch, advance, or rewind the timeline core::epoch
Event handling Add/remove world-shaping events (storms, festivals, wars) core::event
Organisation CRUD Guilds, factions, corporations core::org
Character CRUD Heroes, villains, NPCs core::character
Town CRUD Villages, cities, trade hubs core::town
Link network Alliances, wars, roads, trade routes core::link
Persistence JSON/YAML stores, pluggable back-ends core::storage
CLI efo binary with sub-commands efo crate
Tests Unit & integration coverage tests/

📃 Quick reference table

Sub-command Usage What it changes
epoch efo epoch --init
efo epoch --advance N
efo epoch --target ID
Creates a world; moves time forward or back.
event efo event add ...
efo event remove ...
Adds or removes an event.
org efo org add ...
efo org remove ...
Manages guilds/factions.
chr efo chr add ...
efo chr remove ...
Handles characters.
town efo town add ...
efo town remove ...
Town CRUD.
link efo link add ...
efo link remove ...
Relations: alliances, wars, roads, trade.

Happy forging! 🔨✨