# 📦 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 ```bash # 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! 🔨✨