Skip to content
Dans-PluginsPublic

About

An expansion for Medieval Factions that allows faction members to create fiefs. Fiefs function as sub-factions, essentially.

Topics

Resources

Contributing

Stars

0 stars

Watchers

2 watching

Forks

Repository files navigation

Fiefs

Creating and claiming the fief Millbrook inside the faction Riverhold, then /fi info and /fi checkclaim

Real in-game output from Fiefs 1.0.0 on a local throwaway Paper 1.21.11 test server: the commands were typed by a scripted bot client, and the chat it received is drawn as Minecraft-style chat (typed commands appear in the input bars; grey lines say what happened between commands).

Description

Fiefs is a Minecraft plugin that allows faction members to create fiefs (sub-factions) within Medieval Factions. Fiefs function as sub-factions, allowing for more granular organization within a faction.

Supported Minecraft Versions

This plugin is supported on the Minecraft versions listed in minecraft-versions.json: currently 1.19.4, 1.21.11, 26.2 and 26.3 (Spigot and its forks). Every stable release is booted on a real server of each of these versions before it is published, and every build checks that the plugin only uses Bukkit API that exists on all of them. Other versions from 1.19.4 onwards are expected to work but are not tested. To support another version, add it to the file: both checks pick it up.

Installation

First Time Installation

  1. Download the plugin from SpigotMC or the releases page.
  2. Place the jar in the plugins folder of your server.
  3. Restart your server.

Dependencies

This plugin depends on Medieval Factions in order to work.

Compatibility: Fiefs v0.12.1 was enabled against Medieval Factions 7.0.0 by the dependents gate before Medieval Factions 7.0.0 was published.

Other Medieval Factions expansions: Currencies (faction currencies), Democracy (elections), Bluemap_MedievalFactions (claims on a BlueMap web map). All of them are listed in the Medieval Factions README.

Usage

Documentation

Wiki & Additional Resources

Support

You can find the support Discord server here.

Experiencing a bug?

Please fill out a bug report here.

Contributing

Testing

Build Verification

Linux / macOS:

mvn clean package

Windows:

mvn clean package

If you see BUILD SUCCESS, the project has built successfully. mvn clean package also runs the JUnit test suite under src/test/.

Development

Building the Plugin

  1. Clone the repository: git clone https://github.com/Dans-Plugins/Fiefs.git
  2. Build the plugin: mvn clean package
  3. The compiled JAR will be in the target/ directory.

Manual Testing

  1. Build the plugin with mvn clean package.
  2. Copy the JAR from target/ into your test server's plugins/ folder.
  3. Start or restart the server.

Authors and Acknowledgement

Developers

Name Main Contributions
Daniel Stephenson Creator

This plugin was requested by Laughingspade.

License

This project 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.

See the LICENSE file for the full text of the GPL-3.0 license.

Project Status

This project is in active development.

bStats

You can view the bStats page for the plugin here.

Usage reporting

Usage reporting is on by default: each time the plugin is enabled, and each time one of its commands is run, it sends its name, its version and the command's name to the author's trace server at https://trace.danielstephenson.dev, so it is known which plugins are actually in use. Nothing about players, worlds or IP addresses is sent, and nothing typed after a command is.

Each event also carries a random server ID (the server-id line in plugins/trace/config.yml) so servers can be counted rather than events. It identifies no person, account or IP address; delete the line to get a new one.

To turn it off:

  • for this plugin: set usage-reporting.enabled: false in plugins/Fiefs/config.yml, or run /fi config set usage-reporting.enabled false
  • for every plugin on the server that reports to trace: set enabled: false in plugins/trace/config.yml (written on first start)
  • for the whole server process: set the environment variable TRACE_USAGE_REPORTING=off (or DO_NOT_TRACK=1)

The plugin says on every start whether reporting is on. Details: https://danielstephenson.dev/usage-reporting

About

An expansion for Medieval Factions that allows faction members to create fiefs. Fiefs function as sub-factions, essentially.

Topics

Resources

Contributing

Stars

0 stars

Watchers

2 watching

Forks

Releases

Used by

Contributors

Languages