Overview
Medieval Factions is a comprehensive 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, hold dueling tournaments, and generally attempt to recreate society in a medieval setting.

Key Features:

• Create and manage factions with customizable roles and permissions
• Claim and protect territory using a power-based system
• Engage in diplomacy: form alliances, declare wars, establish vassalages
• Build gates that can be opened and closed on command
• Lock blocks to prevent theft and unauthorized access
• Comprehensive dueling system for honorable combat
• Faction laws and governance systems
• Full Dynmap integration for territory visualization
• PlaceholderAPI support for custom displays
• Multi-language support (English, Spanish, Russian, Portuguese, German, Dutch)

The development of the fifth major version of MF was led by alyphen (creator of RPKit). Huge thanks to her!

✨ Features
Core Faction System

• Create Factions: Establish your own nation with customizable names, descriptions, and colors
• Power System: Dynamic power-based land claiming where faction power equals the sum of all member power
• Territory Claims: Claim chunks to protect your land from other factions
• Roles & Permissions: Create custom roles with granular permission control
• Member Management: Invite, kick, and manage faction members with application system

Diplomacy & Warfare

• Alliances: Form strategic partnerships with other factions
• Wars: Declare war on rival factions with full combat mechanics
• Vassalage System: Establish feudal relationships as liege or vassal
• Power Contributions: Vassals contribute power to their lieges
• Independence: Vassals can declare independence, triggering automatic war

Territory Management

• Multiple Claim Modes:
  • Single chunk claiming
  • Radius claiming for large areas
  • Auto-claim mode for efficient expansion
  • Fill claim to complete bordered territories
• Faction Homes: Set and teleport to faction headquarters
• Territory Indicators: Visual alerts when entering new faction territory (action bar and title)
• Contiguous Claims: Optional requirement for connected territories

Advanced Features

• Gates: Create mechanical gates that faction members can toggle open/closed
• Block Locking: Lock chests, doors, and other blocks with access control lists
• Faction Laws: Write and enforce faction rules and regulations
• Chat Channels: Dedicated chat for faction, allies, and vassals
• Dueling System: Challenge players to timed honorable combat
• Faction Flags: Per-faction settings for customizing behavior

Integrations

• Dynmap: View faction territories on dynamic web maps
• PlaceholderAPI: Display faction information in other plugins
• FactionsBridge: Compatibility layer for cross-faction-plugin addons

Protection & Security

• Territory Protection: Prevent outsiders from building, breaking, or interacting
• Mob Protection: Optional protection from hostile mob damage by non-members
• Villager Trade Protection: Protect villager trading halls
• Configurable PVP: War-based PVP, friendly fire control, and more

Installation
First Time Installation

1. Download the latest version from the Updates tab
2. Place the .jar file in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/MedievalFactions/config.yml (optional)

Requirements

• Minecraft Version: 1.16.5+ (check specific version compatibility)
• Server Software: Spigot, Paper, or any Spigot-based server
• Java Version: Java 8 or higher

Optional Integrations
Dynmap Integration To view claimed land on a dynamic map, download and install Dynmap. Medieval Factions will automatically detect and integrate with Dynmap.

PlaceholderAPI For displaying faction information in other plugins, install PlaceholderAPI. See the Placeholders Wiki for available placeholders.

Expansions

• Fiefs - Additional faction features
• Currencies - Economy system for factions

Documentation
Medieval Factions has comprehensive documentation available on GitHub:

Quick Start Guides

• User Guide - Getting started, common scenarios, and step-by-step tutorials
• Commands Reference - Complete list of all commands with descriptions and permissions
• Configuration Guide - Detailed server configuration options
• Faction Flags Reference - Per-faction settings and customization

Wiki Resources

• Wiki Guide - Comprehensive wiki documentation
• FAQ - Frequently asked questions
• Features List - Complete feature list
• Placeholders - PlaceholderAPI integration

Developer Resources

• External API Documentation - For creating add-ons
• Developer Notes - Technical documentation
• Contributing Guide - How to contribute to the project

Quick Start
For Players
1. Create Your First Faction

/f create YourFactionName


2. Claim Your Territory

/f claim


Stand in a chunk and run this command to claim it. You can also use:

• /f claim 2 - Claim in a 2-chunk radius (5x5 area)
• /f claim auto - Toggle auto-claiming as you walk

3. Set Your Faction Home

/f sethome


Must be used in your claimed territory. Teleport back anytime with /f home

4. Invite Members

/f invite PlayerName


Grow your faction by inviting trusted players

5. Customize Your Faction

/f flag set color #FF0000
/f set description "Your faction description"
/f law add "Your faction rules"


For Server Owners
Basic Configuration: Edit plugins/MedievalFactions/config.yml to customize:

• Power system (initial power, max power, power loss/gain)
• PVP settings (war requirements, friendly fire, etc.)
• Territory settings (claim limits, contiguous claims)
• Faction limits (max members, max name length)
• Dynmap integration settings
• Language settings

Recommended Settings for Different Server Types:

Peaceful RP Server (config.yml):

# PVP Settings
pvp:
warRequiredForPlayersOfDifferentFactions: true
friendlyFire: false

# Faction Settings
factions:
allowNeutrality: true

Hardcore PVP Server (config.yml):

# PVP Settings
pvp:
warRequiredForPlayersOfDifferentFactions: false
enableWartimeBlockDestruction: true

# Player Power Settings
players:
powerLostOnDeath: 2

# Faction Settings
factions:
zeroPowerFactionsGetDisbanded: true

See the Configuration Guide for complete configuration documentation.

Use Cases
Medieval Factions is perfect for:

• Survival Servers: Protect bases and create player nations
• Roleplay Servers: Simulate medieval kingdoms and politics
• PVP Servers: Strategic faction warfare with territory control
• Towny-Style Servers: Alternative to Towny with unique features
• Nation RP: Create complex political systems with vassalage
• Community Servers: Foster cooperation and community building

️ Support
Need Help?

• Discord Server: Join our Discord for support and discussion
• Bug Reports: Submit issues on GitHub
• Known Issues: View known bugs

For Developers

• Creating Add-ons: Use FactionsBridge for cross-plugin compatibility
• External API: API Documentation
• Contributing: Contribution Guidelines

Multi-Language Support
Medieval Factions is available in multiple languages:

• English (en-US)
• Spanish (es-ES)
• Russian (ru-RU)
• Brazilian Portuguese (pt-BR)
• German (de-DE)
• Dutch (nl-NL)

Change the language in config.yml:

language: en-US

Statistics
View server statistics and usage on bStats

Credits
Lead Developers

• Daniel Stephenson - Original creator
• Ren Binden (alyphen) - Created Medieval Factions 5
• Pasarus - Storage system overhaul
• Caibinus - Duels, gates, and Dynmap integration
• Callum - Command system overhaul, events, PlaceholderAPI

Contributors
Special thanks to all contributors including: Richardhyy, Mitras2, Kaonami, GoodLucky777, Elafir, Deej, VoChiDanh, Kyrenic, Tems, MestreWilll, and many others.

Translators

• Spanish: Khanter, Neh, Johnny, lilhamoood
• Russian: 1barab1, 2kManfridi
• Portuguese: Kaonami, MestreWilll
• German: graffity_X
• Dutch: JustGllenn, TDL, n0virus

See the README for the complete credits list.

License
Medieval Factions is licensed under the GNU General Public License v3.0 (GPL-3.0).

You are free to use, modify, and distribute this software, provided that:

• Source code is made available under the same license when distributed
• Changes are documented and attributed
• No additional restrictions are applied

Links

• GitHub Repository: https://github.com/Dans-Plugins/Medieval-Factions
• Discord Server: https://discord.gg/xXtuAQ2
• SpigotMC Resource: https://www.spigotmc.org/resources/medieval-factions.79941/
• bStats: https://bstats.org/plugin/bukkit/Medieval Factions/8929

⭐ Why Choose Medieval Factions?

• Active Development: Regularly updated with new features and bug fixes
• Comprehensive Features: Everything you need for faction gameplay
• Highly Configurable: Customize every aspect to fit your server
• Excellent Documentation: Extensive guides and API documentation
• Community Support: Active Discord community and developer support
• Open Source: GPL-3.0 licensed with public GitHub repository
• Multi-Language: Supports 6+ languages
• Integration Ready: Works with Dynmap, PlaceholderAPI, and more
• Proven Track Record: Used on hundreds of servers since 2020

Version History
For detailed version history and changelog, see the Updates tab.

The first release version (v1.7) was released in June 2020. The plugin has evolved significantly since then, with the current version featuring a complete rewrite for enhanced performance and functionality.

Medieval Factions - Build your empire, forge alliances, and create your own medieval story!

Screenshots