/HardcoreDeathBan

This bukkit plugin allows you to control how a player is banned after dieing on a hardcore-style server.

Primary LanguageJavaOtherNOASSERTION

Features

This is a plugin designed for hardcore-style servers, where players are temporarily banned upon death. You can grant players revival credits, which allow them to join the server before their ban time is up.

Commands

/deathban Lists all available commands for the plugin
/deathban enable Enable the plugin server-wide (always enabled on server start).
/deathban disable Disable the plugin server-wide.
/deathban ban <player> [time] Manually ban a player. If no time is specified, they will be banned for their default time period.
/deathban unban <player> Manually unban a player.
/deathban status <player> Display the status of a player.
/credits [player] Check the amount of revival credits you or another player possess.
/credits send <player> <amount> Send another player some of your own revival credits.
/credits give <player> <amount> Give a player a certain amount of revival credits.
/credits take <player> <amount> Take a certain amount of revival credits from a player.

Permissions

deathban.* Allow full access to all commands in the plugin.
deathban.display Allow use of /deathban to show all plugin commands.
deathban.enable Allow access to /deathban enable and /deathban disable commands.
deathban.ban Allow access to manually ban a player via the /deathban ban command.
deathban.ban.exempt Players with this permission can not be banned and will respawn as normal when killed.
deathban.unban Allow access to manually unban a player via the /deathban unban command.
deathban.status Allow access to check a player's ban status via the /deathban status command.
deathban.credits.check Allow access to check your own revival credits via the /credits command.
deathban.credits.check.others Allow access to check other players' revival credits via the /credits command.
deathban.credits.send Allow access to send revival credits to other players via the /credits send command.
deathban.credits.give Allow access to give revival credits to players via the /credits give command.
deathban.credits.take Allow access to take revival credits from players via the /credits take command.
deathban.class.<class name> Give player access to a death class as defined in the config.

Configuration

Enabled Boolean value to determine whether the plugin is enabled or not.
Ban-Time Default time a player should be banned in the format of #y#mo#w#d#h#m#s, replacing # with the number of years, months, days, hours, minutes, and seconds, respectively, to be banned. A value does not have to be specified for each time unit (i.e., 1h30m is still valid).
Death-Message String value shown to a player when kicked from the server for dieing.
Early-Message String value shown to a player when trying to log in to the server while still banned.
Tick-Delay Integer value that specifies the delay (in ticks) until the player is kicked after dieing. I recommend not changing this unless you know exactly what you are doing.
Starting-Credits Integer value that specifies the number of revival credits players are given when they join the server for the first time
Verbose Boolean value that enables/disables logging to the console. (Used for debug)
Death-Classes See the default config for an example on how to set up the death classes.

Variables

These variables can be used in the config messages, and will automatically be changed to their corresponding value when displayed to the player.

%server% Name of the server
%player% Name of the player
%currenttime% The current time of the server (ex. 11:21 PM EDT)
%currentdate% The current date of the server (ex. 11/29/2012)
%unbantime% The time the player will be unbanned
%unbandate% The date the player will be unbanned
%bantimeleft% The amount of time left on the player's ban (ex. 4 days 3 hours 45 minutes 1 second)

Update Checking

This plugin periodically checks BukkitDev for a new version, and will notify the console and players with the "deathban.receivealerts" permission of a new version. If you would like to disable this feature simply set "Check-for-Updates" to false in plugins/HardcoreDeathBan/config.yml.

Stats Collection

Anonymous statistics are collected automatically by this plugin and sent to MCStats. If you would like to view the data, you can do so here. If you would like to disable this feature, set "opt-out" to true in plugins/PluginMetrics/config.yml.

Support and Feature Requests

If you have found a bug with the plugin or would like to suggest a feature to be added, please create an issue on GitHub to make sure I see it. You can get to the issues page by clicking either the Tickets link at the top of the BukkitDev page or the Issues link on the GitHub repo. Click on New Issue and provide as much information as possible. The more information you provide, the better I can help you.

Links

BukkitDev Page

GitHub Repository

Twitter

Donations

Donations are by no means required, but would be much appreciated. If you feel that my plugins have been of great use to you and would like to give me a little something in return, this is the way to do it.

Donate

Legal

Licensed under the Common Development and Distribution License Version 1.0 (CDDL-1.0). For license information, see the LICENSE file, or on the web at http://opensource.org/licenses/CDDL-1.0.