Nations, diplomacy, and political strategy for TF-Minecraft.
SimpleFactions turns groups of players into nations with territory, rulers, economies, and relationships. Its name comes from an early, simpler nation system; the project has grown into a broad political simulation inspired by Paradox Interactive's strategy games.
Players shape a world of provinces and titles, organise settlements and guilds, and navigate alliances, subjects, taxation, and war. Their nations also appear on the connected web map, making changes to the political landscape visible beyond the game.
- Provinces and titles — govern territories with natural-shaped borders and titles such as duchies and kingdoms.
- Layered diplomacy — form alliances, establish subject and overlord relationships, negotiate treaties, and impose trade embargoes.
- National economies — manage wealth and taxation, including income moving through relationships between members, nations, and overlords.
- Settlements and guilds — establish named cities and capitals and organise groups within a nation.
- Military infrastructure — construct forts, ports, airports, and train stations; transport networks extend guild trade and production.
- Espionage — appoint a Spymaster, keep regiments and vehicles secret, and obtain shared daily intelligence estimates.
- Campaign warfare — pursue war goals through scheduled battles, player voting, warband participation, and campaign progression.
ProvinceSystem presents the world map, borders, settlements, and military activity on the website.
Created by Drefvelin, with inspiration from Paradox Interactive. The original project notes credit ChatGPT for troubleshooting, some code assistance, and README editing.
Technical documentation is maintained in TF-Minecraft/Docs.
Espionage and special positions
Run mvn clean verify with Java 21, as CI does. The build needs the private
dependency jars and shared TF-Minecraft plugins described in the project
documentation.
The suite in src/test uses JUnit 5 and Mockito, mocking the Paper and plugin
APIs rather than starting a server. It checks plugin logic, not behaviour on a
live Paper server. Surefire writes reports to target/surefire-reports/. JaCoCo
writes HTML and XML reports to target/site/jacoco/; verify requires 100%
production line coverage with no class or package exclusions. Branch coverage
is reported separately. CI uploads both test and coverage reports.
Copyright (c) 2026 TF-Minecraft contributors.
TF-Minecraft-authored material in this repository is licensed under the Artistic License 2.0. Third-party dependencies and bundled material retain their own licenses.