HardcoreDeathBan
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.
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.
Please update, getting large responce times from this plugin.
@LeGoomboss
Yes, if you have OP it gives you the deathban.ban.exempt permission automatically. That would be why they weren't getting banned.
@mstiles92:
Why it doesn't work? I set everything, but it doesn't ban anyone... People can normaly respawn. What it could be?
EDIT: it doesn't ban admins... There culd be something that block it, like Essentials or other plug-ins? Or the guilty is from OP status? Normal players get their ban well, instead.
@MrMime22
If you are using the latest version of the plugin (v1.2), you should be able to change the config while the server is running without it overwriting your changes on restart. Right now it does not parse those color codes, but I should be able to add this in the next update.
@mstiles92
Nevermind "change the config while the server is not running for now" But can I do this? &4You have been deadbanned.... Does it support color codes?
@MrMime22
Which version of the plugin are you using?
does not save the new config, still used detaulf config after restart
@rorybrownbeard
I would recommend using another plugin to do this via command, something along the lines of http://dev.bukkit.org/server-mods/timedcommands/ would work. I might make this a built-in option in the future, but I wouldn't expect it any time soon.
@alexander_gq
No, it handles the bans on its own. To use this plugin, you need to have hardcore=false in server.properties.
@botskonet
Could you set "Verbose: true" in the config.yml, then send me a pastebin with your server log? That would help me figure out what isn't working right.
It doesn't seem to work at all. I didn't set my server to hardcore mode. Using this plugin, the server bans me permanently and this plugin doesn't do anything. Enabled is set to true.
Does this tie into the existing hardcore system?
Any way that we can give more credits to users based on time? Say every 48h they get a revival credit?
@iTiamo
Thank you! I really appreciate it and I'm glad you like the plugin.
@Honest_Routuan
I will look into it, but no guarantees that I will support offline mode with this plugin. I would recommend only running with online mode enabled.
I send a little amount of money your way. Thank you for making this plugin, it's EXACTLY what I was looking for. Definately the best deathban plugin out there. Continue being awesome!
please update
my server running in offline mode
when player die
he still can relogin
and i set server to online mode
is work good
@coletam
@AStrangeEnigma
That is correct, change the config while the server is not running for now. I have fixed this in the next version of the plugin which I will upload soon.
@coletam
Try changing the setting while the server is offline. I think the config is saved into memory.
For some reason, everytime I configure the config.yml and change it to my settings like 6h instead of 12h...it deletes what I wrote and puts it back to the default setting everytime I restart my server. Is there a way to fix this?
@UltraMC
I can't replicate this. Make sure that the player doesn't have any revival credits. Change your config so Verbose: true and see what it says in the console when they die and when they are able to login before their time is up. If you can't figure it out, post a link to a pastebin here with your server log while Verbose: true in the config and I will take a look at it.
It kicks players but they still can join in when bantime is 1 or 2m - why?
@iTiamo
That is exactly what I plan on adding in the next update - that is what I meant by death classes in the Planned section above.
EDIT: This feature is now included in v1.1 (when it gets approved).
@alexk252
Glad I could help! I fully plan on keeping up with this plugin.
@Aurulent
You're welcome! Glad to hear you like it.
@Taznuma
Right now, no. I will look into adding this in a future update for sure.