{"id":35176932,"url":"https://github.com/dans-plugins/medieval-factions","last_synced_at":"2026-04-26T00:01:33.511Z","repository":{"id":37056457,"uuid":"268183537","full_name":"Dans-Plugins/Medieval-Factions","owner":"Dans-Plugins","description":"Allows players to organize themselves into feudal, diplomatic, lawful groups akin to nations.","archived":false,"fork":false,"pushed_at":"2026-04-21T03:12:56.000Z","size":24511,"stargazers_count":49,"open_issues_count":115,"forks_count":32,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-21T05:38:05.511Z","etag":null,"topics":["alliances","duels","dynmap-integration","gates","java","laws","localization","locks","minecraft","nations","plugin","ponder","spigot","territory","vassals","warfare"],"latest_commit_sha":null,"homepage":"https://www.spigotmc.org/resources/medieval-factions.79941/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Dans-Plugins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-05-31T00:35:40.000Z","updated_at":"2026-03-22T19:03:35.000Z","dependencies_parsed_at":"2024-01-06T19:38:30.383Z","dependency_job_id":"3003a221-1f7d-4708-b57f-b32cb5c3d9ee","html_url":"https://github.com/Dans-Plugins/Medieval-Factions","commit_stats":null,"previous_names":[],"tags_count":134,"template":false,"template_full_name":null,"purl":"pkg:github/Dans-Plugins/Medieval-Factions","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dans-Plugins%2FMedieval-Factions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dans-Plugins%2FMedieval-Factions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dans-Plugins%2FMedieval-Factions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dans-Plugins%2FMedieval-Factions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dans-Plugins","download_url":"https://codeload.github.com/Dans-Plugins/Medieval-Factions/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dans-Plugins%2FMedieval-Factions/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32280981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"ssl_error","status_checked_at":"2026-04-25T18:29:32.149Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alliances","duels","dynmap-integration","gates","java","laws","localization","locks","minecraft","nations","plugin","ponder","spigot","territory","vassals","warfare"],"created_at":"2025-12-28T22:57:59.835Z","updated_at":"2026-04-26T00:01:33.470Z","avatar_url":"https://github.com/Dans-Plugins.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Medieval Factions\n\n## Description \nMedieval Factions is a system of mechanics that allows for the simulation of sovereign nations in Minecraft. Players can create nations, claim territory, engage in warfare or politics, write laws or hold dueling tournaments, and generally are able to attempt to recreate society somewhat.\n\nA list of features can be found [here](https://github.com/Dans-Plugins/Medieval-Factions/wiki/Features).\n\nThe development of the fifth major version of MF was led by [alyphen](https://github.com/alyphen) (creator of [RPKit](https://github.com/RP-Kit/RPKit/wiki)). Huge thanks to her!\n\n## Installation\n### First Time Installation\n1) You can download the plugin from [this page](https://www.spigotmc.org/resources/medieval-factions-sovereign-nation-simulator.79941/updates).\n2) Once downloaded, place the jar in the plugins folder of your server files.\n3) Restart your server.\n\n### Dynmap Integration\nDynmap has been integrated with this plugin. In order to be able to view claimed land on a dynamic map, download and install the plugin [here](https://www.spigotmc.org/resources/dynmap.274/).\n\n### Expansions\n1) [Fiefs](https://github.com/Dans-Plugins/Fiefs)\n2) [Currencies](https://github.com/Dans-Plugins/Currencies)\n\n## Usage\n\n### Documentation\n- [User Guide](USER_GUIDE.md) - Getting started and common scenarios\n- [Commands Reference](COMMANDS.md) - Complete list of all commands\n- [Configuration Guide](CONFIG.md) - Detailed config options\n- [Faction Flags](FACTION_FLAGS.md) - Faction flag reference\n- [Database Querying Guide](DATABASE_QUERYING.md) - How to query the database directly\n\n### Wiki \u0026 Additional Resources\n- [Wiki Guide](https://github.com/Dans-Plugins/Medieval-Factions/wiki/Guide)\n- [FAQ](https://github.com/Dans-Plugins/Medieval-Factions/wiki/FAQ)\n- [List of Placeholders](https://github.com/Dans-Plugins/Medieval-Factions/wiki/Placeholders)\n\n## Support\nYou can find the support discord server [here](https://discord.gg/xXtuAQ2).\n\n### Experiencing a bug?\nPlease fill out a bug report [here](https://github.com/Dans-Plugins/Medieval-Factions/issues/new/choose).\n\n- [Known Bugs](https://github.com/Dans-Plugins/Medieval-Factions/issues?q=is%3Aopen+is%3Aissue+label%3Abug)\n\n## Contributing\n- [CONTRIBUTING.md](CONTRIBUTING.md)\n- [Notes for Developers](https://github.com/Dans-Plugins/Medieval-Factions/wiki/Developer-Notes)\n\n## Testing\n### Unit Tests\nTo run the unit tests, you can use the following command:\n\nLinux:\n```bash\n./gradlew clean test\n```\nWindows:\n```cmd\n.\\gradlew.bat clean test\n```\n\nIf you see BUILD SUCCESSFUL, then the tests have passed.\n\n### Looking to create an add-on plugin?\nI recommend using [FactionsBridge](https://www.spigotmc.org/resources/factionsbridge.89716/) by [Retrix_Solutions](https://www.spigotmc.org/resources/authors/retrix_solutions.491191/). It would make your add-on plugin usable across a number of factions implementations.\n\nAlternatively, you can use the External API, the documentation for which can be found [here](https://github.com/Dans-Plugins/Medieval-Factions/wiki/External-API-Documentation).\n\n## Development\n### Test Server with Plugin Hot-Reloading\nFor development purposes, a Docker-based test server is available with integrated plugin hot-reloading capabilities using ServerUtils (a modern Plugman alternative).\n\n#### Setup\n1. Copy `sample.env` to `.env` and configure as needed\n2. Build the plugin: `./gradlew build`\n3. Start the test server: `./up.sh`\n\n#### Plugin Hot-Reloading\nAfter making changes to the plugin code, you can quickly reload it without restarting the server:\n\n**Option 1: Using the reload script (recommended)**\n```bash\n./reload-plugin.sh\n```\n\n**Option 2: Manual reload**\n1. Build the plugin: `./gradlew build`\n2. Copy the new jar to the running container\n3. Use ServerUtils commands in-game or console:\n   - `/serverutils reload MedievalFactions` - Reload the plugin\n   - `/serverutils unload MedievalFactions` - Unload the plugin\n   - `/serverutils load MedievalFactions` - Load the plugin\n   - `/serverutils list` - List all plugins\n\nThis significantly speeds up the development cycle by eliminating the need for full server restarts during testing.\n\n#### Stopping the Test Server\n```bash\n./down.sh\n```\n\n## Authors and acknowledgement\n### Developers\n| Name                                                                          | Main Contributions                                                                                                                          |\n|-------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| Daniel Stephenson                                                             | Original creator                                                                                                                            |\n| [Ren Binden](https://github.com/alyphen)                                      | Created Medieval Faction 5                                                                                                                  |\n| [Pasarus](https://github.com/Pasarus)                                         | Overhauled the Storage Manager to use UUIDs and JSON and made other improvements to the plugin                                              |\n| Caibinus                                                                      | Implemented Duels, Gates and Dynmap Integration                                                                                             |\n| [Callum](https://www.spigotmc.org/resources/authors/retrix_solutions.491191/) | Created event classes, overhauled the Command System, implemented PlaceholderAPI integration and made many other improvements to the plugin |\n| Richardhyy                                                                    | Fixed some encoding issues                                                                                                                  |\n| Mitras2                                                                       | Implemented ActionBar territory alerts                                                                                                      |\n| [Kaonami](https://github.com/Daniels7k)                                       | Fixed a typo in the README                                                                                                                  |\n| GoodLucky777                                                                  | Fixed a bug and a few typos in the code                                                                                                     |\n| Elafir                                                                        | Made it possible to control gates with redstone                                                                                             |\n| [Deej](https://github.com/Mr-Deej)                                            | Added checks to several commands                                                                                                            |\n| VoChiDanh                                                                     | Refactored parts the PersistentData class in an attempt to resolve java compatibility issues                                                |\n| Kyrenic                                                                       | Implemented contiguous claims config option                                                                                                 |\n| [Tems](https://github.com/Tems-py)                                            | Fixed claim protection issues                                                                                                               |\n| MestreWilll                                                                   | Contributed Brazilian Portueguese translation                                                                                               |  \n\n### Translators\n| Name                                                             | Language(s)          |\n|------------------------------------------------------------------|----------------------|\n| Khanter                                                          | Spanish              |\n| Neh                                                              | Spanish              |\n| Johnny                                                           | Spanish              |\n| lilhamoood                                                       | Spanish              |\n| 1barab1                                                          | Russian              |\n| 2kManfridi                                                       | Russian              |\n| [Kaonami](https://github.com/Daniels7k)                          | Portuguese Brazilian |\n| [graffity_X](https://www.spigotmc.org/members/kicker765.946561/) | German               |\n| JustGllenn                                                       | Dutch                |\n| TDL                                                              | Dutch                |\n| [n0virus](https://www.youtube.com/c/n0virus)                     | Dutch                |\n| MestreWilll                                                      | Brazilian Portuguese |   \n\nI created this plugin because I wanted to use the original [Factions](https://www.spigotmc.org/resources/factions.1900/) plugin for an upcoming server of mine, but it wasn't updated for the version of minecraft I was going to be using. I decided to take inspiration from the concept of factions - groups of players that can claim land - and create my own factions plugin.\n\nThe first release version, [v1.7](https://github.com/Dans-Plugins/Medieval-Factions/releases/tag/v1.7), was released on SpigotMC in June 2020 and looked much different than the plugin does today.\n\nI am extremely grateful to those that have donated their time improving the project, one way or another. The plugin wouldn't be where it is today without the contributions of others.\n\n## License\n\nThis project is licensed under the [GNU General Public License v3.0](LICENSE) (GPL-3.0).\n\nYou are free to use, modify, and distribute this software, provided that:\n- Source code is made available under the same license when distributed.\n- Changes are documented and attributed.\n- No additional restrictions are applied.\n\nSee the [LICENSE](LICENSE) file for the full text of the GPL-3.0 license.\n\n## Project Status\nThis project is in active development.\n\n### bStats\nYou can view the bStats page for the plugin [here](https://bstats.org/plugin/bukkit/Medieval%20Factions/8929).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdans-plugins%2Fmedieval-factions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdans-plugins%2Fmedieval-factions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdans-plugins%2Fmedieval-factions/lists"}