Folkhold

A single-player Minecraft world that changes without the player.

NPC factions trade, defend their villages and hold territory. Caravans travel between the villages. The reputation of the player decides how each village receives them.

Download · Release notes · Design · Getting started · Contributing · Roadmap

---

Features

• A world that lives on its own. An abstract simulation runs the factions, the stocks and the caravans, also in the chunks that are not loaded. The world around the player changes with no visit.
• Factions and territories. Each village claims the territory around it. The claim grows with the level of the village, from a hamlet to a city.
• Fortified villages. A walled compound with towers and a village heart. Guards patrol, archers hold the towers and a captain leads the garrison. Healers treat the wounded units, riders patrol outside the walls, and faction golems guard the gates of the large villages. The garrison grows with the level of the village. Kill the captain and destroy the heart: the village becomes ruins.
• Simulated economy. Each village produces and consumes goods with the jobs of its inhabitants. Its prices follow its stock and its needs, and its merchants sell its stock.
• Caravans and traveling merchants. Trade between two villages sends a caravan on the road, by land or by boat.
• Reputation and quests. Each faction and each village remembers the actions of the player. The quest board of a village gives deliveries and escorts from the state of the world.
• Two languages. All text in the game exists in English and in French.

Installation

The modpack is the simple way to play. It contains the Folkhold mods and a selection of mods for performance, nature, terrain, maps and inventory comfort.

1. Download folkhold-<version>.mrpack from the latest release.
2. Import the file in a launcher that reads Modrinth packs, for example Prism Launcher or the Modrinth App.
3. Start the game and create a new world.
4. Optional: pre-generate the area around the spawn with Chunky. The game then generates fewer chunks during the play, for example with an elytra or a boat on ice. Use the commands /chunky spawn, /chunky radius 2000 and /chunky start (cheats must be on). A radius of 2000 blocks is about 62,500 chunks: the generation takes time, and the world uses more disk space. Chunky continues after a restart of the game.

To use the mods without the modpack, put folkhold_core, folkhold_blocks and folkhold_world from the release in the mods folder of a Minecraft 1.21.1 instance with NeoForge 21.1.259 or later and GeckoLib 4.9.3 or later.

Modules

The project has two libraries and three mods. All mods share one version.

Module	Mod ID	Content
core	folkhold_core	Shared library: abstract simulation, regions, scheduler, UI framework
blocks	folkhold_blocks	Library of the Folkhold blocks. The blocks act as similar vanilla blocks. The other mods add the game logic.
world	folkhold_world	Factions, villages, economy, caravans, quests
balance	folkhold_balance	Planned: farm limits, villager budgets, chunk loading. The mod is empty.
events	folkhold_events	Planned: earthquakes, collapses. The mod is empty.

The packwiz modpack (modpack/) adds existing mods for performance, nature and terrain.

Documentation

Document	Content
Design document	Vision, rules of the simulation, what is implemented and what is planned
Getting started	Prerequisites, first build, daily workflow, CI and releases
UI framework	The shared widgets and the look of the screens
Contributing	Branches, commit titles and versions, pull requests, translations

Status

Early development. The milestones give the roadmap, and the issues give the work in progress. Each merge of develop into main makes a release.

License

The code is under the MIT License. The assets (textures, models, animations, structures) are under CC BY 4.0.