Source | Change Log | Feature Request | Bug Report | Donate
Latest Version: v1.0 for Bukkit 1.7+
FactionsDB, also known as FactionsDeathBans, is designed to add extra importance to player deaths and power loss on servers using the Factions plugin. Players whose deaths cause them to fall below a desired power level will be temporarily banned (DeathBanned) from joining the server. This is also effective at preventing continued abuse such as players being repeatedly killed at their spawn location or players repeatedly killing each other for rewards (e.g. skill levels in McMMO).
Note: This plugin requires Factions v2.0 or later.
plugins folder.FactionsDB has the following permission nodes:
factionsdb.admin - Adminstrator permissions. Default: op. Implies:
factionsdb.command.factionsdb: true (allows use of /factionsdb)factionsdb.ban.exempt: true (prevents user from being DeathBanned)factionsdb.defaults - Default user permissions. Default: true. Implies:
factionsdb.ban.exempt: false (allows user to be DeathBanned)FactionsDB has only one command, /factionsdb (Alias: /fdb)
/factionsdb - Show plugin usage information
/factionsdb list - Show a list of existing DeathBans /factionsdb pardon <name|*>... - Pardon DeathBans for one or more players
/factionsdb reload - Reload configuration from disk
Configuration files are located in the plugin's folder, plugins/FactionsDB
The following configuration options are included and documented in config.yml:
uuid-mode: (boolean, use UUIDs to track bans instead of names)
persistence: (boolean, periodically save bans & reload at startup)
(should only be modified while the server is off!)
power:
threshold: (number, power level where DeathBans can be given)
boost: (number, power boost given to players returning from bans)
ban:
broadcast: (boolean, should bans be broadcast server-wide)
duration: (String, length of bans in format "<#[.#]><s|m|h|d>")
send-to-spawn: (boolean, send to spawn before DeathBanning)
spawn-world: (String, name of the world to respawn players into)
(If blank, players respawned to their current world)
strings:
kick: (String, message to send to player as they get DeathBanned)
login: (String, message when DeathBan prevents joining server)
broadcast: (String, message to broadcast server-wide upon DeathBan)
return: (String, message sent to players returning from DeathBans)
The above strings accept '&' style color codes, and also replace the following tags:
{0} --> Player name
{1} --> Ban duration
{2} --> Power threshold
{3} --> Time left
{4} --> Power boost
With persistence enabled, DeathBans are saved as bans.yml. It is ill-advised to manually edit this file, especially while a server is running.
This template is continually tested to ensure that it is correct, but sometimes bugs can sneak in. If you have found a bug within the project, or if you have a feature request, please create an issue on Github.
Donating is a great way to thank the developer if you find the project useful for your server, and encourages work on more 100% free and open-source plugins. If you would like to donate (any amount), there is an easily accessible link in the top right corner of this page. Thank you!
This project template utilizes Hidendra's Plugin-Metrics system. Users may opt out of this service by editing their configuration located in plugins/Plugin Metrics. The following anonymous data is collected and sent to mcstats.org:
This template is released as a free and open-source project under the GNU General Public License version 3 (GPLv3). To learn more about what this means, click that link or read about it on Wikipedia.
