Releases: Obsidian-TTRPG-Community/Town-Forge
1.0.3 - Two improvements since 1.0.0: a new `size` property on exported place notes, and a meaningful rework of how roads and towns relate on river maps.
Town Forge 1.0.3
Two improvements since 1.0.0: a new size property on exported place notes, and a meaningful rework of how roads and towns relate on river maps.
What's new
- Settlement size in frontmatter — each exported place note now carries a
size:property set to the settlement's size (one ofhamlet,village,small_town,town,large_town,small_city,city,large_city,metropolis). A new{{size}}template token is also available, so a Templater body can readfm.sizeand pass it to a size-aware Randomness table (e.g. banded shop stock). - River-aware road approaches —
autoedges now guarantee approach roads on both banks for river maps. Bridge rate across river towns improved from ~60% to ~74%. - Town built on the arterial — the town centre is now placed on the road network by construction (snapped to the nearest arterial or the bridge centre), rather than computed independently. River towns now reliably gather around their road or bridge instead of drifting off into empty terrain. 100% of river towns now sit on the road network (median 0px, max ~1px).
Install
Manual: download main.js, manifest.json, and versions.json below into .obsidian/plugins/town-forge/, then enable under Settings → Community Plugins.
BRAT: add this repo as a beta plugin (or update if already added).
Notes
- No breaking changes; existing maps regenerate identically by seed for non-river terrains.
- For river terrains, regenerating an existing seed will produce a different-looking map (the road and town logic changed by design).
1.0.1 - Add settlement size to place-note frontmatter (v1.0.1)
Town Forge 1.0.1
Adds the settlement size to exported place notes, so templates and Randomness rolls can scale their content to the settlement.
What's new
- Settlement size in frontmatter — each exported place note now carries a
size:property set to the settlement's size (one ofhamlet,village,small_town,town,large_town,small_city,city,large_city,metropolis). {{size}}template token — use it in your place templates; a Templater body can readfm.sizeand pass it to a size-aware table (e.g. banded shop stock).
Notes
- Place notes are written during a TTRPG Tools: Maps export (full-mode maps).
- See docs/randomness-templater-setup.md for wiring
size(andsubtype) into Randomness + Templater.
Install
Download main.js, manifest.json, and versions.json below into .obsidian/plugins/town-forge/, then enable under Settings → Community Plugins.
1.0.0 - docs: prep first public release (v1.0.0), README acknowledgements, versions.json
Town Forge 1.0.0 — First Public Release
Procedurally generate fantasy landscape and settlement maps for tabletop RPGs — terrain, forests, mountains, roads, and settlements from a hamlet to a metropolis, with a live preview panel and optional pinned-map export.
Highlights
- Procedural maps — river, coastal, lake, mountain, and inland terrain; settlements from hamlet to metropolis with organic streets, walls, bridges, and landmarks (castle, temple, market, barracks, docks, mills, stables).
- Isolated tower — a rare wizard/necromancer's tower placed out by a forest or mountain edge, with its own path back to the road.
- Live preview panel — adjust terrain, size, roads, density, and landmarks and regenerate as you go.
- Optional TTRPG Tools: Maps export (off by default) — interactive pinned maps plus one note per place, generated from your own templates. Configurable pin types, names, subtypes, icons, and layers.
- Deterministic — the same seed always produces the same map.
Install
Manual: download main.js, manifest.json, and versions.json below into .obsidian/plugins/town-forge/, then enable under Settings → Community Plugins.
BRAT: add this repo as a beta plugin.
Thanks
- RedReaper21 — for extensive help testing and tuning the plugin.
- Jareika — for TTRPG Tools: Maps, the plugin Town Forge exports its interactive maps to.
- Randomness — drives correlated place names and note bodies from templates.