Skip to content

Dans-Plugins/Medieval-Factions

Repository files navigation

Medieval Factions

Description

Medieval 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.

A list of features can be found here.

Fifth Major Version - MF 5

Medieval Factions 5 reimagines and reworks everything about the plugin. The development of the fifth major version of MF was led by alyphen (creator of RPKit). Huge thanks to her!

What's changed

This is a complete rewrite of Medieval Factions so everything has received a fresh coat of paint since 4.6.x/4.7.x. Commands, permissions, placeholders, etc should mostly be compatible, though some things have changed, such as locks, roles, and force commands.

Installation

First Time Installation

  1. You can download the plugin from this page.
  2. Once downloaded, place the jar in the plugins folder of your server files.
  3. Restart your server.

Upgrading from Medieval Factions 4

  1. If you have a Medieval Factions 4 install, replace the Medieval Factions 4 jar with Medieval Factions 5.

  2. On the next start, Medieval Factions 5 will detect the Medieval Factions 4 config and make a backup of all of the data in mf4_backup in the data folder. It will then proceed to generate the new config file, and shut down the server.

  3. At this point, you should configure your database, if you have one.

If you have MySQL or MariaDB database, this should look something like:

database:
url: 'jdbc:mysql://127.0.0.1/database'
dialect: 'MYSQL'
username: 'username'
password: 'password'

If you do not have a MySQL database, you can ignore this, as the plugin will create an h2 file-based database in your server's working directory.

  1. Start the server one more time, and the configuration and data from the Medieval Factions 4 backup will be migrated to your new Medieval Factions 5 install.

Dynmap Integration

Dynmap 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.

Expansions

  1. Fiefs
  2. Currencies

Usage

Support

You can find the support discord server here.

Experiencing a bug?

Please fill out a bug report here.

Contributing

Looking to create an add-on plugin?

I recommend using FactionsBridge by Retrix_Solutions. It would make your add-on plugin usable across a number of factions implementations.

Alternatively, you can use the External API, the documentation for which can be found here.

Authors and acknowledgement

Developers

Name Main Contributions
Daniel Stephenson Original creator
Ren Binden Created Medieval Faction 5
Pasarus Overhauled the Storage Manager to use UUIDs and JSON and made other improvements to the plugin
Caibinus Implemented Duels, Gates and Dynmap Integration
Callum Created event classes, overhauled the Command System, implemented PlaceholderAPI integration and made many other improvements to the plugin
Richardhyy Fixed some encoding issues
Mitras2 Implemented ActionBar territory alerts
Kaonami Fixed a typo in the README
GoodLucky777 Fixed a bug and a few typos in the code
Elafir Made it possible to control gates with redstone
Deej Added checks to several commands
VoChiDanh Refactored parts the PersistentData class in an attempt to resolve java compatibility issues
Kyrenic Implemented contiguous claims config option
Tems Fixed claim protection issues
MestreWilll Contributed Brazilian Portueguese translation

Translators

Name Language(s)
Khanter Spanish
Neh Spanish
Johnny Spanish
lilhamoood Spanish
1barab1 Russian
2kManfridi Russian
Kaonami Portuguese Brazilian
graffity_X German
JustGllenn Dutch
TDL Dutch
n0virus Dutch
MestreWilll Brazilian Portuguese

I created this plugin because I wanted to use the original Factions 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.

The first release version, v1.7, was released on SpigotMC in June 2020 and looked much different than the plugin does today.

I 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.

License

GPL3

Project Status

This project is in active development.

bStats

You can view the bStats page for the plugin here.