This is an event handling function that will allow you to switch player into a predefined group upon their death. Furthermore, a command can be executed once the player dies to accommodate extended actions (like announcing the death, setting new spawn location etc).
Death Group functionality require a permission plugin to be installed on your server (such as PermissionsEX), as the built-in Bukkit permission system does not support permission groups.
Since there are many permission plugins, it would be inefficient for CommandsEX to try and implement them all, as there already is a plugin that does exactly that. This plugin is called Vault and you will need to have it installed on your server for Death Group feature to work.
There are 2 config options added to accommodate death player's group changing functionality:
Configuration example:
deathGroupChanges: citizen: toGroup: default command: say &eAw, snap! &f$p &ehas just left the world of mortals and became a nameless wanderer again.
... this configuration will move each player of group citizen to group default upon their death. Furthermore, a /say command will be executed, announcing this player's death.
If you set up multiple group transitions, let's say one will be knight -> translucent and another one will be citizen -> default, the plugin will honor both group changes. First, it will remove knight and citizen groups for that player, then it will add translucent and default groups.
If a player is not part of any of these groups, simply nothing will happen for him.
Same principle works with /greset command, which is used to reset player's group back to what it was before they died. When used, this player will loose his translucent and default groups and will be assigned knight and citizen groups again.
There was 1 special permission introduced to CommandsEX to accommodate Death Group functionality:
Should there be a need to manually remove this feature from the JAR file, the following files must be removed:
com/github/zathrus_writer/commandsex/handlers/Handler_deathgroup.class
com/github/zathrus_writer/commandsex/commands/Command_cex_greset.class