Skip to content

SPIGOTMC_PAGE.md

Latest commit

 

History

History
319 lines (238 loc) · 12.6 KB

SPIGOTMC_PAGE.md

File metadata and controls

319 lines (238 loc) · 12.6 KB

Medieval Factions - SpigotMC Page Content

This document contains the formatted content for the Medieval Factions SpigotMC page. The content below can be copied and pasted directly to SpigotMC with minimal formatting adjustments.

📜 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

Wiki Resources

Developer Resources

🎮 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?

For Developers

🌐 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

⭐ 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!