+ ReanimateMC provides a comprehensive API for developers to integrate the KO system into their plugins.
+ You can listen to events, access the KO manager, and programmatically control the KO state of players.
+
+
+
+
+
Getting Started
+
+
+
Adding ReanimateMC as a Dependency
+
+
plugin.yml
+
name: YourPlugin
+version: 1.0.0
+depend: [ReanimateMC]
+# or for optional dependency
+# softdepend: [ReanimateMC]
@EventHandler
+public void onPlayerKO(PlayerKOEvent event) {
+ Player player = event.getPlayer();
+ int duration = event.getDuration();
+
+ // Custom logic when player enters KO
+ if (player.hasPermission("server.vip")) {
+ // VIP players get longer KO duration
+ // Note: Cannot modify duration directly
+ getLogger().info(player.getName() + " is VIP, extending KO");
+ }
+
+ // Cancel KO for staff members
+ if (player.hasPermission("server.staff")) {
+ event.setCancelled(true);
+ player.sendMessage("Staff bypass: KO cancelled");
+ }
+
+ // Notify team members
+ notifyTeam(player, duration);
+}
+
+
+
+
PlayerReanimatedEvent
+
Fired when a player is revived from KO state.
+
+
Methods:
+
+
+
+
Method
+
Return Type
+
Description
+
+
+
+
+
getPlayer()
+
Player
+
The player being revived
+
+
+
getReanimator()
+
Player
+
Player performing revival (can be null)
+
+
+
isSuccessful()
+
boolean
+
Whether revival was successful
+
+
+
getTimestamp()
+
long
+
Timestamp of revival attempt
+
+
+
getPlayerName()
+
String
+
Name of revived player
+
+
+
getReanimatorName()
+
String
+
Name of reanimator (or "Unknown")
+
+
+
+
+
Example Usage:
+
@EventHandler
+public void onPlayerRevived(PlayerReanimatedEvent event) {
+ Player patient = event.getPlayer();
+ Player medic = event.getReanimator();
+ boolean successful = event.isSuccessful();
+
+ if (!successful) return;
+
+ // Reward the medic
+ if (medic != null) {
+ // Give XP
+ medic.giveExp(50);
+
+ // Economy reward (if you have Vault)
+ economy.depositPlayer(medic, 100.0);
+
+ // Send message
+ medic.sendMessage(ChatColor.GREEN +
+ "You saved " + patient.getName() + "!");
+
+ // Add to statistics
+ addToStats(medic, "revivals_performed");
+ }
+
+ // Log the revival
+ logRevival(patient, medic, event.getTimestamp());
+}
+
+
+
+
+
KOManager API
+
+
+
Manager Methods
+
The KOManager provides methods to interact with the KO system programmatically.
+
+
+
+
+
Method
+
Description
+
+
+
+
+
isKO(Player player)
+
Check if player is currently in KO state
+
+
+
getKOData(Player player)
+
Get KOData object for player (can be null)
+
+
+
setKO(Player player)
+
Set player to KO state (default duration)
+
+
+
setKO(Player player, int seconds)
+
Set player to KO for specific duration
+
+
+
revive(Player target, Player reviver)
+
Revive a KO'd player
+
+
+
execute(Player player)
+
Execute a KO'd player (permanent death)
+
+
+
toggleCrawl(Player player)
+
Toggle crawling mode for KO'd player
+
+
+
sendDistress(Player player)
+
Send distress signal for KO'd player
+
+
+
handleLogout(Player player)
+
Handle player logout while KO'd
+
+
+
pullOfflineKO(UUID uuid)
+
Get remaining KO time for offline player
+
+
+
+
+
+
+
Example Usage:
+
// Check if player is KO'd
+if (koManager.isKO(player)) {
+ player.sendMessage("You are currently KO'd!");
+}
+
+// Force KO a player
+koManager.setKO(player, 30); // 30 seconds
+
+// Revive a player
+if (koManager.isKO(target)) {
+ koManager.revive(target, reviverPlayer);
+}
+
+// Execute a KO'd player
+if (koManager.isKO(target)) {
+ koManager.execute(target);
+}
+
+// Get KO data
+KOData koData = koManager.getKOData(player);
+if (koData != null && koData.isKo()) {
+ // Player is KO'd, access KO-specific data
+ long endTime = koData.getEndTimestamp();
+ boolean crawling = koData.isCrawling();
+}
+
+
+
+
+
Integration Examples
+
+
+
+
Economy Integration
+
@EventHandler
+public void onRevive(PlayerReanimatedEvent e) {
+ if (e.isSuccessful() && e.getReanimator() != null) {
+ Player medic = e.getReanimator();
+ economy.depositPlayer(medic, 100.0);
+ medic.sendMessage("§a+$100 for revival!");
+ }
+}
+ Complete list of all available commands in ReanimateMC
+
+
+
+
Command Overview
+
+ All ReanimateMC commands start with /reanimatemc or the shorter alias /rmc.
+ Befehle are organized by category: Administrative, Player Management, NPC-System, and Utility commands.
+
+
+
+
+
Administrative Befehle
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc reload
+
Reload plugin configuration and language files
+
reanimatemc.admin
+
/reanimatemc reload
+
+
+
/reanimatemc config
+
Open GUI configuration interface
+
reanimatemc.admin
+
/reanimatemc config
+
+
+
/reanimatemc setup
+
Mark initial setup as complete
+
reanimatemc.admin
+
/reanimatemc setup
+
+
+
+
+
+
Administrative Befehle Details
+
+
/reanimatemc reload
+
Purpose: Reloads all configuration files and language files without restarting the server.
+
When to use: After making changes to config.yml or language files.
+
Example:
+
/reanimatemc reload
+
Output: "Konfiguration and language reloaded!"
+
+
/reanimatemc config
+
Purpose: Opens an interactive GUI where you can configure all plugin settings.
+ Un plugin Minecraft révolutionnaire qui introduit un état KO (Knockout) au lieu de la mort instantanée.
+ Les joueurs peuvent être réanimés par leurs coéquipiers ou exécutés par leurs ennemis, créant un gameplay dynamique et stratégique.
+
+ Complete list of all permissions for ReanimateMC
+
+
+
+
Permission Overview
+
+ ReanimateMC uses a comprehensive permission system to control access to features and commands.
+ Berechtigungen are organized into categories: Core Berechtigungen, Feature Berechtigungen, NPC Berechtigungen, and Command Berechtigungen.
+
+
+ Permission Plugin Required: You need a permission plugin like LuckPerms, BerechtigungenEx, or GroupManager to manage these permissions.
+
+
+
+
+
Core Berechtigungen
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.admin
+
OP
+
Grants access to all administrative commands and GUI config
+
+
+
reanimatemc.revive
+
TRUE
+
Ability to revive KO'd players manually
+
+
+
reanimatemc.execute
+
TRUE
+
Ability to execute KO'd players permanently
+
+
+
reanimatemc.bypass
+
OP
+
Bypass the KO system entirely - die instantly instead of entering KO
+
+
+
+
+
+
Core Berechtigungen Details
+
+
reanimatemc.admin
+
Default: OP only
+
Grants access to:
+
+
/reanimatemc reload - Reload configuration
+
/reanimatemc config - Open GUI configuration
+
/reanimatemc setup - Complete initial setup
+
/reanimatemc revive - Force revive players
+
/reanimatemc knockout - Force KO players
+
All configuration changes via GUI
+
+
+
reanimatemc.revive
+
Default: All players (TRUE)
+
Allows: Players to revive KO'd teammates by crouching near them with the required item.
+
Note: This is a core gameplay mechanic and should typically be available to all players.
+
+
reanimatemc.execute
+
Default: All players (TRUE)
+
Allows: Players to execute KO'd players by holding left-click on them.
+
Note: Essential for PvP gameplay. Can be restricted on non-PvP servers.
+
+
reanimatemc.bypass
+
Default: OP only
+
Effect: Players with this permission die instantly when health reaches zero, completely bypassing the KO system.
+
Use case: Staff members who need to respawn quickly, or VIP players who don't want to use the KO system.
+
+
+
+
+
Feature Berechtigungen
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.knockout
+
OP
+
Force players into KO state via command
+
+
+
reanimatemc.status
+
TRUE
+
Check player KO status via command
+
+
+
reanimatemc.crawl
+
TRUE
+
Toggle crawling mode when KO'd
+
+
+
reanimatemc.loot
+
OP
+
Access KO'd player inventories (looting)
+
+
+
reanimatemc.removeGlowingEffect
+
OP
+
Remove glowing effects from players
+
+
+
+
+
+
Feature Berechtigungen Details
+
+
reanimatemc.loot
+
Default: OP only
+
Allows: Opening and accessing the inventory of KO'd players.
+
Important: This is a powerful permission. Consider carefully before granting to regular players.
+
Konfiguration: Looting can be completely disabled in config.yml with looting.enabled: false
+
+
reanimatemc.crawl
+
Default: All players (TRUE)
+
Allows: KO'd players to toggle between immobilized and crawling states using /reanimatemc crawl
+
Konfiguration: Crawling must be enabled in config: prone.allow_crawl: true
+
+
+
+
+
NPC-System Berechtigungen
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.summon
+
FALSE
+
Base permission to summon any NPC
+
+
+
reanimatemc.summon.use.golem
+
FALSE
+
Permission to summon Iron Golem reanimators
+
+
+
reanimatemc.summon.use.healer
+
FALSE
+
Permission to summon Healing Golem reanimators
+
+
+
reanimatemc.summon.use.protector
+
FALSE
+
Permission to summon Protective Golem reanimators
+
+
+
reanimatemc.summon.overridecost
+
OP
+
Bypass summon costs and cooldowns
+
+
+
reanimatemc.summon.admin
+
OP
+
Admin control over all NPCs (dismiss any NPC)
+
+
+
+
+
+
NPC Berechtigungen Details
+
+
reanimatemc.summon
+
Default: No one (FALSE)
+
Purpose: Base permission required for any summon commands. Players need this AND a specific type permission.
+
+
Type-Specific Berechtigungen
+
How it works: Players must have BOTH reanimatemc.summon AND the specific type permission.
+
Example setup:
+
# VIP Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+
+# Premium Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+
+# Elite Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+reanimatemc.summon.use.protector: true
+
+
NPC Type Comparison
+
+
Golem - Basic reanimator, follows owner and revives KO'd players
+
Healer - Specialized in revival, faster revive times (potential future feature)
+
Protector - Can revive AND attacks hostile mobs, has more health
+
+
+
reanimatemc.summon.overridecost
+
Default: OP only
+
Bypasses:
+
+
Cooldown timers (default: 5 minutes between summons)
+
Item costs (if configured to require items)
+
Max summons per player limit
+
+
+
reanimatemc.summon.admin
+
Default: OP only
+
Allows: Dismissing any player's NPCs, viewing all active NPCs, and full control over the NPC system.
reanimatemc.*: true
+(Full access to all features)
+
+
+
+
+
+
LuckPerms Konfiguration Examples
+
+
+
Basic Setup
+
Using LuckPerms commands to set up permissions:
+
+
Default Group
+
/lp group default permission set reanimatemc.revive true
+/lp group default permission set reanimatemc.execute true
+/lp group default permission set reanimatemc.status true
+/lp group default permission set reanimatemc.crawl true
+
+
VIP Group
+
/lp creategroup vip
+/lp group vip parent add default
+/lp group vip permission set reanimatemc.summon true
+/lp group vip permission set reanimatemc.summon.use.golem true
+
+
Premium Group
+
/lp creategroup premium
+/lp group premium parent add vip
+/lp group premium permission set reanimatemc.summon.use.healer true
+
+
Elite Group
+
/lp creategroup elite
+/lp group elite parent add premium
+/lp group elite permission set reanimatemc.summon.use.protector true
+/lp group elite permission set reanimatemc.summon.overridecost true
+
+
Moderator Group
+
/lp creategroup moderator
+/lp group moderator parent add default
+/lp group moderator permission set reanimatemc.knockout true
+/lp group moderator permission set reanimatemc.loot true
+/lp group moderator permission set reanimatemc.removeGlowingEffect true
+
+
Admin Group
+
/lp creategroup admin
+/lp group admin permission set reanimatemc.* true
+
+
+
+
+
Permission Wildcards
+
+
+
Using Wildcards
+
You can use wildcards to grant multiple permissions at once:
+
+
+
+
+
Wildcard
+
Effect
+
+
+
+
+
reanimatemc.*
+
Grants ALL ReanimateMC permissions
+
+
+
reanimatemc.summon.*
+
Grants all summon-related permissions
+
+
+
reanimatemc.summon.use.*
+
Grants permission to summon all NPC types
+
+
+
+
+
Wildcard Examples
+
# Give all summon permissions
+/lp group vip permission set reanimatemc.summon.* true
+
+# Give all permissions except admin
+/lp group moderator permission set reanimatemc.* true
+/lp group moderator permission set reanimatemc.admin false
+/lp group moderator permission set reanimatemc.bypass false
+
+
+
+
+
Best Practices
+
+
+
+
+
+
+
Default Berechtigungen
+
Keep revive and execute available to all players for core gameplay. Restrict loot to prevent abuse.
+
+
+
+
+
+
+
Monetization
+
NPC summon permissions work great as donor perks. Create tiers: Golem (VIP) → Healer (Premium) → Protector (Elite).
+
+
+
+
+
+
+
Admin Access
+
Reserve admin, bypass, and summon.admin for trusted staff only to maintain server balance.
+
+
+
+
+
+
+
Balance
+
Consider your server type: PvP servers may restrict execute, RP servers may disable it entirely via config.
+ ReanimateMC provides a comprehensive API for developers to integrate the KO system into their plugins.
+ You can listen to events, access the KO manager, and programmatically control the KO state of players.
+
+
+
+
+
Getting Started
+
+
+
Adding ReanimateMC as a Dependency
+
+
plugin.yml
+
name: YourPlugin
+version: 1.0.0
+depend: [ReanimateMC]
+# or for optional dependency
+# softdepend: [ReanimateMC]
@EventHandler
+public void onPlayerKO(PlayerKOEvent event) {
+ Player player = event.getPlayer();
+ int duration = event.getDuration();
+
+ // Custom logic when player enters KO
+ if (player.hasPermission("server.vip")) {
+ // VIP players get longer KO duration
+ // Note: Cannot modify duration directly
+ getLogger().info(player.getName() + " is VIP, extending KO");
+ }
+
+ // Cancel KO for staff members
+ if (player.hasPermission("server.staff")) {
+ event.setCancelled(true);
+ player.sendMessage("Staff bypass: KO cancelled");
+ }
+
+ // Notify team members
+ notifyTeam(player, duration);
+}
+
+
+
+
PlayerReanimatedEvent
+
Fired when a player is revived from KO state.
+
+
Methods:
+
+
+
+
Method
+
Return Type
+
Description
+
+
+
+
+
getPlayer()
+
Player
+
The player being revived
+
+
+
getReanimator()
+
Player
+
Player performing revival (can be null)
+
+
+
isSuccessful()
+
boolean
+
Whether revival was successful
+
+
+
getTimestamp()
+
long
+
Timestamp of revival attempt
+
+
+
getPlayerName()
+
String
+
Name of revived player
+
+
+
getReanimatorName()
+
String
+
Name of reanimator (or "Unknown")
+
+
+
+
+
Example Usage:
+
@EventHandler
+public void onPlayerRevived(PlayerReanimatedEvent event) {
+ Player patient = event.getPlayer();
+ Player medic = event.getReanimator();
+ boolean successful = event.isSuccessful();
+
+ if (!successful) return;
+
+ // Reward the medic
+ if (medic != null) {
+ // Give XP
+ medic.giveExp(50);
+
+ // Economy reward (if you have Vault)
+ economy.depositPlayer(medic, 100.0);
+
+ // Send message
+ medic.sendMessage(ChatColor.GREEN +
+ "You saved " + patient.getName() + "!");
+
+ // Add to statistics
+ addToStats(medic, "revivals_performed");
+ }
+
+ // Log the revival
+ logRevival(patient, medic, event.getTimestamp());
+}
+
+
+
+
+
KOManager API
+
+
+
Manager Methods
+
The KOManager provides methods to interact with the KO system programmatically.
+
+
+
+
+
Method
+
Description
+
+
+
+
+
isKO(Player player)
+
Check if player is currently in KO state
+
+
+
getKOData(Player player)
+
Get KOData object for player (can be null)
+
+
+
setKO(Player player)
+
Set player to KO state (default duration)
+
+
+
setKO(Player player, int seconds)
+
Set player to KO for specific duration
+
+
+
revive(Player target, Player reviver)
+
Revive a KO'd player
+
+
+
execute(Player player)
+
Execute a KO'd player (permanent death)
+
+
+
toggleCrawl(Player player)
+
Toggle crawling mode for KO'd player
+
+
+
sendDistress(Player player)
+
Send distress signal for KO'd player
+
+
+
handleLogout(Player player)
+
Handle player logout while KO'd
+
+
+
pullOfflineKO(UUID uuid)
+
Get remaining KO time for offline player
+
+
+
+
+
+
+
Example Usage:
+
// Check if player is KO'd
+if (koManager.isKO(player)) {
+ player.sendMessage("You are currently KO'd!");
+}
+
+// Force KO a player
+koManager.setKO(player, 30); // 30 seconds
+
+// Revive a player
+if (koManager.isKO(target)) {
+ koManager.revive(target, reviverPlayer);
+}
+
+// Execute a KO'd player
+if (koManager.isKO(target)) {
+ koManager.execute(target);
+}
+
+// Get KO data
+KOData koData = koManager.getKOData(player);
+if (koData != null && koData.isKo()) {
+ // Player is KO'd, access KO-specific data
+ long endTime = koData.getEndTimestamp();
+ boolean crawling = koData.isCrawling();
+}
+
+
+
+
+
Integration Examples
+
+
+
+
Economy Integration
+
@EventHandler
+public void onRevive(PlayerReanimatedEvent e) {
+ if (e.isSuccessful() && e.getReanimator() != null) {
+ Player medic = e.getReanimator();
+ economy.depositPlayer(medic, 100.0);
+ medic.sendMessage("§a+$100 for revival!");
+ }
+}
+ Complete list of all available commands in ReanimateMC
+
+
+
+
Command Overview
+
+ All ReanimateMC commands start with /reanimatemc or the shorter alias /rmc.
+ Comandos are organized by category: Administrative, Player Management, Sistema NPC, and Utility commands.
+
+
+
+
+
Administrative Comandos
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc reload
+
Reload plugin configuration and language files
+
reanimatemc.admin
+
/reanimatemc reload
+
+
+
/reanimatemc config
+
Open GUI configuration interface
+
reanimatemc.admin
+
/reanimatemc config
+
+
+
/reanimatemc setup
+
Mark initial setup as complete
+
reanimatemc.admin
+
/reanimatemc setup
+
+
+
+
+
+
Administrative Comandos Details
+
+
/reanimatemc reload
+
Purpose: Reloads all configuration files and language files without restarting the server.
+
When to use: After making changes to config.yml or language files.
+
Example:
+
/reanimatemc reload
+
Output: "Configuración and language reloaded!"
+
+
/reanimatemc config
+
Purpose: Opens an interactive GUI where you can configure all plugin settings.
+ Un plugin Minecraft révolutionnaire qui introduit un état KO (Knockout) au lieu de la mort instantanée.
+ Les joueurs peuvent être réanimés par leurs coéquipiers ou exécutés par leurs ennemis, créant un gameplay dynamique et stratégique.
+
+ Complete list of all permissions for ReanimateMC
+
+
+
+
Permission Overview
+
+ ReanimateMC uses a comprehensive permission system to control access to features and commands.
+ Permisos are organized into categories: Core Permisos, Feature Permisos, NPC Permisos, and Command Permisos.
+
+
+ Permission Plugin Required: You need a permission plugin like LuckPerms, PermisosEx, or GroupManager to manage these permissions.
+
+
+
+
+
Core Permisos
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.admin
+
OP
+
Grants access to all administrative commands and GUI config
+
+
+
reanimatemc.revive
+
TRUE
+
Ability to revive KO'd players manually
+
+
+
reanimatemc.execute
+
TRUE
+
Ability to execute KO'd players permanently
+
+
+
reanimatemc.bypass
+
OP
+
Bypass the KO system entirely - die instantly instead of entering KO
+
+
+
+
+
+
Core Permisos Details
+
+
reanimatemc.admin
+
Default: OP only
+
Grants access to:
+
+
/reanimatemc reload - Reload configuration
+
/reanimatemc config - Open GUI configuration
+
/reanimatemc setup - Complete initial setup
+
/reanimatemc revive - Force revive players
+
/reanimatemc knockout - Force KO players
+
All configuration changes via GUI
+
+
+
reanimatemc.revive
+
Default: All players (TRUE)
+
Allows: Players to revive KO'd teammates by crouching near them with the required item.
+
Note: This is a core gameplay mechanic and should typically be available to all players.
+
+
reanimatemc.execute
+
Default: All players (TRUE)
+
Allows: Players to execute KO'd players by holding left-click on them.
+
Note: Essential for PvP gameplay. Can be restricted on non-PvP servers.
+
+
reanimatemc.bypass
+
Default: OP only
+
Effect: Players with this permission die instantly when health reaches zero, completely bypassing the KO system.
+
Use case: Staff members who need to respawn quickly, or VIP players who don't want to use the KO system.
+
+
+
+
+
Feature Permisos
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.knockout
+
OP
+
Force players into KO state via command
+
+
+
reanimatemc.status
+
TRUE
+
Check player KO status via command
+
+
+
reanimatemc.crawl
+
TRUE
+
Toggle crawling mode when KO'd
+
+
+
reanimatemc.loot
+
OP
+
Access KO'd player inventories (looting)
+
+
+
reanimatemc.removeGlowingEffect
+
OP
+
Remove glowing effects from players
+
+
+
+
+
+
Feature Permisos Details
+
+
reanimatemc.loot
+
Default: OP only
+
Allows: Opening and accessing the inventory of KO'd players.
+
Important: This is a powerful permission. Consider carefully before granting to regular players.
+
Configuración: Looting can be completely disabled in config.yml with looting.enabled: false
+
+
reanimatemc.crawl
+
Default: All players (TRUE)
+
Allows: KO'd players to toggle between immobilized and crawling states using /reanimatemc crawl
+
Configuración: Crawling must be enabled in config: prone.allow_crawl: true
+
+
+
+
+
Sistema NPC Permisos
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.summon
+
FALSE
+
Base permission to summon any NPC
+
+
+
reanimatemc.summon.use.golem
+
FALSE
+
Permission to summon Iron Golem reanimators
+
+
+
reanimatemc.summon.use.healer
+
FALSE
+
Permission to summon Healing Golem reanimators
+
+
+
reanimatemc.summon.use.protector
+
FALSE
+
Permission to summon Protective Golem reanimators
+
+
+
reanimatemc.summon.overridecost
+
OP
+
Bypass summon costs and cooldowns
+
+
+
reanimatemc.summon.admin
+
OP
+
Admin control over all NPCs (dismiss any NPC)
+
+
+
+
+
+
NPC Permisos Details
+
+
reanimatemc.summon
+
Default: No one (FALSE)
+
Purpose: Base permission required for any summon commands. Players need this AND a specific type permission.
+
+
Type-Specific Permisos
+
How it works: Players must have BOTH reanimatemc.summon AND the specific type permission.
+
Example setup:
+
# VIP Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+
+# Premium Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+
+# Elite Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+reanimatemc.summon.use.protector: true
+
+
NPC Type Comparison
+
+
Golem - Basic reanimator, follows owner and revives KO'd players
+
Healer - Specialized in revival, faster revive times (potential future feature)
+
Protector - Can revive AND attacks hostile mobs, has more health
+
+
+
reanimatemc.summon.overridecost
+
Default: OP only
+
Bypasses:
+
+
Cooldown timers (default: 5 minutes between summons)
+
Item costs (if configured to require items)
+
Max summons per player limit
+
+
+
reanimatemc.summon.admin
+
Default: OP only
+
Allows: Dismissing any player's NPCs, viewing all active NPCs, and full control over the NPC system.
reanimatemc.*: true
+(Full access to all features)
+
+
+
+
+
+
LuckPerms Configuración Examples
+
+
+
Basic Setup
+
Using LuckPerms commands to set up permissions:
+
+
Default Group
+
/lp group default permission set reanimatemc.revive true
+/lp group default permission set reanimatemc.execute true
+/lp group default permission set reanimatemc.status true
+/lp group default permission set reanimatemc.crawl true
+
+
VIP Group
+
/lp creategroup vip
+/lp group vip parent add default
+/lp group vip permission set reanimatemc.summon true
+/lp group vip permission set reanimatemc.summon.use.golem true
+
+
Premium Group
+
/lp creategroup premium
+/lp group premium parent add vip
+/lp group premium permission set reanimatemc.summon.use.healer true
+
+
Elite Group
+
/lp creategroup elite
+/lp group elite parent add premium
+/lp group elite permission set reanimatemc.summon.use.protector true
+/lp group elite permission set reanimatemc.summon.overridecost true
+
+
Moderator Group
+
/lp creategroup moderator
+/lp group moderator parent add default
+/lp group moderator permission set reanimatemc.knockout true
+/lp group moderator permission set reanimatemc.loot true
+/lp group moderator permission set reanimatemc.removeGlowingEffect true
+
+
Admin Group
+
/lp creategroup admin
+/lp group admin permission set reanimatemc.* true
+
+
+
+
+
Permission Wildcards
+
+
+
Using Wildcards
+
You can use wildcards to grant multiple permissions at once:
+
+
+
+
+
Wildcard
+
Effect
+
+
+
+
+
reanimatemc.*
+
Grants ALL ReanimateMC permissions
+
+
+
reanimatemc.summon.*
+
Grants all summon-related permissions
+
+
+
reanimatemc.summon.use.*
+
Grants permission to summon all NPC types
+
+
+
+
+
Wildcard Examples
+
# Give all summon permissions
+/lp group vip permission set reanimatemc.summon.* true
+
+# Give all permissions except admin
+/lp group moderator permission set reanimatemc.* true
+/lp group moderator permission set reanimatemc.admin false
+/lp group moderator permission set reanimatemc.bypass false
+
+
+
+
+
Best Practices
+
+
+
+
+
+
+
Default Permisos
+
Keep revive and execute available to all players for core gameplay. Restrict loot to prevent abuse.
+
+
+
+
+
+
+
Monetization
+
NPC summon permissions work great as donor perks. Create tiers: Golem (VIP) → Healer (Premium) → Protector (Elite).
+
+
+
+
+
+
+
Admin Access
+
Reserve admin, bypass, and summon.admin for trusted staff only to maintain server balance.
+
+
+
+
+
+
+
Balance
+
Consider your server type: PvP servers may restrict execute, RP servers may disable it entirely via config.
+ ReanimateMC provides a comprehensive API for developers to integrate the KO system into their plugins.
+ You can listen to events, access the KO manager, and programmatically control the KO state of players.
+
+
+
+
+
Getting Started
+
+
+
Adding ReanimateMC as a Dependency
+
+
plugin.yml
+
name: YourPlugin
+version: 1.0.0
+depend: [ReanimateMC]
+# or for optional dependency
+# softdepend: [ReanimateMC]
@EventHandler
+public void onPlayerKO(PlayerKOEvent event) {
+ Player player = event.getPlayer();
+ int duration = event.getDuration();
+
+ // Custom logic when player enters KO
+ if (player.hasPermission("server.vip")) {
+ // VIP players get longer KO duration
+ // Note: Cannot modify duration directly
+ getLogger().info(player.getName() + " is VIP, extending KO");
+ }
+
+ // Cancel KO for staff members
+ if (player.hasPermission("server.staff")) {
+ event.setCancelled(true);
+ player.sendMessage("Staff bypass: KO cancelled");
+ }
+
+ // Notify team members
+ notifyTeam(player, duration);
+}
+
+
+
+
PlayerReanimatedEvent
+
Fired when a player is revived from KO state.
+
+
Methods:
+
+
+
+
Method
+
Return Type
+
Description
+
+
+
+
+
getPlayer()
+
Player
+
The player being revived
+
+
+
getReanimator()
+
Player
+
Player performing revival (can be null)
+
+
+
isSuccessful()
+
boolean
+
Whether revival was successful
+
+
+
getTimestamp()
+
long
+
Timestamp of revival attempt
+
+
+
getPlayerName()
+
String
+
Name of revived player
+
+
+
getReanimatorName()
+
String
+
Name of reanimator (or "Unknown")
+
+
+
+
+
Example Usage:
+
@EventHandler
+public void onPlayerRevived(PlayerReanimatedEvent event) {
+ Player patient = event.getPlayer();
+ Player medic = event.getReanimator();
+ boolean successful = event.isSuccessful();
+
+ if (!successful) return;
+
+ // Reward the medic
+ if (medic != null) {
+ // Give XP
+ medic.giveExp(50);
+
+ // Economy reward (if you have Vault)
+ economy.depositPlayer(medic, 100.0);
+
+ // Send message
+ medic.sendMessage(ChatColor.GREEN +
+ "You saved " + patient.getName() + "!");
+
+ // Add to statistics
+ addToStats(medic, "revivals_performed");
+ }
+
+ // Log the revival
+ logRevival(patient, medic, event.getTimestamp());
+}
+
+
+
+
+
KOManager API
+
+
+
Manager Methods
+
The KOManager provides methods to interact with the KO system programmatically.
+
+
+
+
+
Method
+
Description
+
+
+
+
+
isKO(Player player)
+
Check if player is currently in KO state
+
+
+
getKOData(Player player)
+
Get KOData object for player (can be null)
+
+
+
setKO(Player player)
+
Set player to KO state (default duration)
+
+
+
setKO(Player player, int seconds)
+
Set player to KO for specific duration
+
+
+
revive(Player target, Player reviver)
+
Revive a KO'd player
+
+
+
execute(Player player)
+
Execute a KO'd player (permanent death)
+
+
+
toggleCrawl(Player player)
+
Toggle crawling mode for KO'd player
+
+
+
sendDistress(Player player)
+
Send distress signal for KO'd player
+
+
+
handleLogout(Player player)
+
Handle player logout while KO'd
+
+
+
pullOfflineKO(UUID uuid)
+
Get remaining KO time for offline player
+
+
+
+
+
+
+
Example Usage:
+
// Check if player is KO'd
+if (koManager.isKO(player)) {
+ player.sendMessage("You are currently KO'd!");
+}
+
+// Force KO a player
+koManager.setKO(player, 30); // 30 seconds
+
+// Revive a player
+if (koManager.isKO(target)) {
+ koManager.revive(target, reviverPlayer);
+}
+
+// Execute a KO'd player
+if (koManager.isKO(target)) {
+ koManager.execute(target);
+}
+
+// Get KO data
+KOData koData = koManager.getKOData(player);
+if (koData != null && koData.isKo()) {
+ // Player is KO'd, access KO-specific data
+ long endTime = koData.getEndTimestamp();
+ boolean crawling = koData.isCrawling();
+}
+
+
+
+
+
Integration Examples
+
+
+
+
Economy Integration
+
@EventHandler
+public void onRevive(PlayerReanimatedEvent e) {
+ if (e.isSuccessful() && e.getReanimator() != null) {
+ Player medic = e.getReanimator();
+ economy.depositPlayer(medic, 100.0);
+ medic.sendMessage("§a+$100 for revival!");
+ }
+}
+ Liste complète de toutes les commandes disponibles dans ReanimateMC
+
+
+
+
Aperçu des Commandes
+
+ Toutes les commandes ReanimateMC commencent par /reanimatemc ou l'alias plus court /rmc.
+ Les commandes sont organisées par catégorie : Administratives, Gestion des Joueurs, Système NPC et Commandes Utilitaires.
+
+
+
+
+
Commandes Administratives
+
+
+
+
+
Commande
+
Description
+
Permission
+
Utilisation
+
+
+
+
+
/reanimatemc reload
+
Recharger la configuration et les fichiers de langue
+
reanimatemc.admin
+
/reanimatemc reload
+
+
+
/reanimatemc config
+
Ouvrir l'interface de configuration GUI
+
reanimatemc.admin
+
/reanimatemc config
+
+
+
/reanimatemc setup
+
Marquer la configuration initiale comme terminée
+
reanimatemc.admin
+
/reanimatemc setup
+
+
+
+
+
+
Détails des Commandes Administratives
+
+
/reanimatemc reload
+
Objectif : Recharge tous les fichiers de configuration et de langue sans redémarrer le serveur.
+
Quand l'utiliser : Après avoir modifié config.yml ou les fichiers de langue.
+
Exemple :
+
/reanimatemc reload
+
Sortie : "Configuration et langue rechargées !"
+
+
/reanimatemc config
+
Objectif : Ouvre une interface GUI interactive où vous pouvez configurer tous les paramètres du plugin.
+
Fonctionnalités :
+
+
Activer/désactiver les fonctionnalités
+
Modifier les valeurs numériques (durées, temps de recharge, etc.)
+
Changer les objets requis
+
Aperçu de configuration en temps réel
+
Fonctionnalité Sauvegarder/Réinitialiser
+
+
Exemple :
+
/reanimatemc config
+
+
+
+
+
Commandes de Gestion des Joueurs
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc revive
+
Forcefully revive a KO'd player
+
reanimatemc.admin
+
/reanimatemc revive <player>
+
+
+
/reanimatemc knockout
+
Force a player into KO state
+
reanimatemc.admin
+
/reanimatemc knockout <player> [duration]
+
+
+
/reanimatemc status
+
Check a player's current state
+
reanimatemc.status
+
/reanimatemc status <player>
+
+
+
/reanimatemc crawl
+
Toggle crawling mode (KO'd players only)
+
reanimatemc.crawl
+
/reanimatemc crawl
+
+
+
+
+
+
Player Management Commandes Details
+
+
/reanimatemc revive <player>
+
Purpose: Instantly revives a knocked-out player without requiring items or time.
+
Parameters:
+
+
<player> - The name of the KO'd player to revive (required)
+
+
Examples:
+
/reanimatemc revive Steve
+/rmc revive PlayerName
+
+
/reanimatemc knockout <player> [duration]
+
Purpose: Forces a player into KO state, useful for testing or punishment.
+
Parameters:
+
+
<player> - The name of the player to KO (required)
+
[duration] - KO duration in seconds (optional, defaults to config value)
+
+
Examples:
+
/reanimatemc knockout Steve
+/reanimatemc knockout Steve 60
+/rmc knockout PlayerName 45
+
+
/reanimatemc status <player>
+
Purpose: Displays whether a player is currently in KO state or alive.
+
Parameters:
+
+
<player> - The name of the player to check (required)
+
+
Examples:
+
/reanimatemc status Steve
+/rmc status PlayerName
+
Output: "Steve is K.O." or "Steve is Alive/Normal"
+
+
/reanimatemc crawl
+
Purpose: Allows KO'd players to toggle between immobilized and crawling states.
+
Note: Can only be used by players who are currently KO'd.
+
Examples:
+
/reanimatemc crawl
+/rmc crawl
+
Output: "Crawl mode enabled" or "Crawl mode disabled"
+
+
+
+
+
Système NPC Commandes
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc summon
+
Summon an NPC reanimator
+
reanimatemc.summon
+
/reanimatemc summon <type> [player]
+
+
+
/reanimatemc dismiss
+
Dismiss your NPCs
+
reanimatemc.summon
+
/reanimatemc dismiss all
+
+
+
/reanimatemc npcs
+
List your active NPCs
+
reanimatemc.summon
+
/reanimatemc npcs
+
+
+
+
+
+
Système NPC Commandes Details
+
+
/reanimatemc summon <type> [player]
+
Purpose: Summons an AI-controlled NPC that can revive KO'd players.
+
Parameters:
+
+
<type> - NPC type: golem, healer, or protector (required)
+
[player] - Target player to revive (optional)
+
+
NPC Types:
+
+
golem - Standard reanimator, follows owner and revives KO'd players
+
healer - Specialized reanimator with healing focus
+
protector - Reanimator that also attacks hostile mobs
+ Complete list of all permissions for ReanimateMC
+
+
+
+
Permission Overview
+
+ ReanimateMC uses a comprehensive permission system to control access to features and commands.
+ Permissions are organized into categories: Core Permissions, Feature Permissions, NPC Permissions, and Command Permissions.
+
+
+ Permission Plugin Required: You need a permission plugin like LuckPerms, PermissionsEx, or GroupManager to manage these permissions.
+
+
+
+
+
Core Permissions
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.admin
+
OP
+
Grants access to all administrative commands and GUI config
+
+
+
reanimatemc.revive
+
TRUE
+
Ability to revive KO'd players manually
+
+
+
reanimatemc.execute
+
TRUE
+
Ability to execute KO'd players permanently
+
+
+
reanimatemc.bypass
+
OP
+
Bypass the KO system entirely - die instantly instead of entering KO
+
+
+
+
+
+
Core Permissions Details
+
+
reanimatemc.admin
+
Default: OP only
+
Grants access to:
+
+
/reanimatemc reload - Reload configuration
+
/reanimatemc config - Open GUI configuration
+
/reanimatemc setup - Complete initial setup
+
/reanimatemc revive - Force revive players
+
/reanimatemc knockout - Force KO players
+
All configuration changes via GUI
+
+
+
reanimatemc.revive
+
Default: All players (TRUE)
+
Allows: Players to revive KO'd teammates by crouching near them with the required item.
+
Note: This is a core gameplay mechanic and should typically be available to all players.
+
+
reanimatemc.execute
+
Default: All players (TRUE)
+
Allows: Players to execute KO'd players by holding left-click on them.
+
Note: Essential for PvP gameplay. Can be restricted on non-PvP servers.
+
+
reanimatemc.bypass
+
Default: OP only
+
Effect: Players with this permission die instantly when health reaches zero, completely bypassing the KO system.
+
Use case: Staff members who need to respawn quickly, or VIP players who don't want to use the KO system.
+
+
+
+
+
Feature Permissions
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.knockout
+
OP
+
Force players into KO state via command
+
+
+
reanimatemc.status
+
TRUE
+
Check player KO status via command
+
+
+
reanimatemc.crawl
+
TRUE
+
Toggle crawling mode when KO'd
+
+
+
reanimatemc.loot
+
OP
+
Access KO'd player inventories (looting)
+
+
+
reanimatemc.removeGlowingEffect
+
OP
+
Remove glowing effects from players
+
+
+
+
+
+
Feature Permissions Details
+
+
reanimatemc.loot
+
Default: OP only
+
Allows: Opening and accessing the inventory of KO'd players.
+
Important: This is a powerful permission. Consider carefully before granting to regular players.
+
Configuration: Looting can be completely disabled in config.yml with looting.enabled: false
+
+
reanimatemc.crawl
+
Default: All players (TRUE)
+
Allows: KO'd players to toggle between immobilized and crawling states using /reanimatemc crawl
+
Configuration: Crawling must be enabled in config: prone.allow_crawl: true
+
+
+
+
+
Système NPC Permissions
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.summon
+
FALSE
+
Base permission to summon any NPC
+
+
+
reanimatemc.summon.use.golem
+
FALSE
+
Permission to summon Iron Golem reanimators
+
+
+
reanimatemc.summon.use.healer
+
FALSE
+
Permission to summon Healing Golem reanimators
+
+
+
reanimatemc.summon.use.protector
+
FALSE
+
Permission to summon Protective Golem reanimators
+
+
+
reanimatemc.summon.overridecost
+
OP
+
Bypass summon costs and cooldowns
+
+
+
reanimatemc.summon.admin
+
OP
+
Admin control over all NPCs (dismiss any NPC)
+
+
+
+
+
+
NPC Permissions Details
+
+
reanimatemc.summon
+
Default: No one (FALSE)
+
Purpose: Base permission required for any summon commands. Players need this AND a specific type permission.
+
+
Type-Specific Permissions
+
How it works: Players must have BOTH reanimatemc.summon AND the specific type permission.
+
Example setup:
+
# VIP Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+
+# Premium Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+
+# Elite Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+reanimatemc.summon.use.protector: true
+
+
NPC Type Comparison
+
+
Golem - Basic reanimator, follows owner and revives KO'd players
+
Healer - Specialized in revival, faster revive times (potential future feature)
+
Protector - Can revive AND attacks hostile mobs, has more health
+
+
+
reanimatemc.summon.overridecost
+
Default: OP only
+
Bypasses:
+
+
Cooldown timers (default: 5 minutes between summons)
+
Item costs (if configured to require items)
+
Max summons per player limit
+
+
+
reanimatemc.summon.admin
+
Default: OP only
+
Allows: Dismissing any player's NPCs, viewing all active NPCs, and full control over the NPC system.
reanimatemc.*: true
+(Full access to all features)
+
+
+
+
+
+
LuckPerms Configuration Examples
+
+
+
Basic Setup
+
Using LuckPerms commands to set up permissions:
+
+
Default Group
+
/lp group default permission set reanimatemc.revive true
+/lp group default permission set reanimatemc.execute true
+/lp group default permission set reanimatemc.status true
+/lp group default permission set reanimatemc.crawl true
+
+
VIP Group
+
/lp creategroup vip
+/lp group vip parent add default
+/lp group vip permission set reanimatemc.summon true
+/lp group vip permission set reanimatemc.summon.use.golem true
+
+
Premium Group
+
/lp creategroup premium
+/lp group premium parent add vip
+/lp group premium permission set reanimatemc.summon.use.healer true
+
+
Elite Group
+
/lp creategroup elite
+/lp group elite parent add premium
+/lp group elite permission set reanimatemc.summon.use.protector true
+/lp group elite permission set reanimatemc.summon.overridecost true
+
+
Moderator Group
+
/lp creategroup moderator
+/lp group moderator parent add default
+/lp group moderator permission set reanimatemc.knockout true
+/lp group moderator permission set reanimatemc.loot true
+/lp group moderator permission set reanimatemc.removeGlowingEffect true
+
+
Admin Group
+
/lp creategroup admin
+/lp group admin permission set reanimatemc.* true
+
+
+
+
+
Permission Wildcards
+
+
+
Using Wildcards
+
You can use wildcards to grant multiple permissions at once:
+
+
+
+
+
Wildcard
+
Effect
+
+
+
+
+
reanimatemc.*
+
Grants ALL ReanimateMC permissions
+
+
+
reanimatemc.summon.*
+
Grants all summon-related permissions
+
+
+
reanimatemc.summon.use.*
+
Grants permission to summon all NPC types
+
+
+
+
+
Wildcard Examples
+
# Give all summon permissions
+/lp group vip permission set reanimatemc.summon.* true
+
+# Give all permissions except admin
+/lp group moderator permission set reanimatemc.* true
+/lp group moderator permission set reanimatemc.admin false
+/lp group moderator permission set reanimatemc.bypass false
+
+
+
+
+
Best Practices
+
+
+
+
+
+
+
Default Permissions
+
Keep revive and execute available to all players for core gameplay. Restrict loot to prevent abuse.
+
+
+
+
+
+
+
Monetization
+
NPC summon permissions work great as donor perks. Create tiers: Golem (VIP) → Healer (Premium) → Protector (Elite).
+
+
+
+
+
+
+
Admin Access
+
Reserve admin, bypass, and summon.admin for trusted staff only to maintain server balance.
+
+
+
+
+
+
+
Balance
+
Consider your server type: PvP servers may restrict execute, RP servers may disable it entirely via config.
+ ReanimateMC provides a comprehensive API for developers to integrate the KO system into their plugins.
+ You can listen to events, access the KO manager, and programmatically control the KO state of players.
+
+
+
+
+
Getting Started
+
+
+
Adding ReanimateMC as a Dependency
+
+
plugin.yml
+
name: YourPlugin
+version: 1.0.0
+depend: [ReanimateMC]
+# or for optional dependency
+# softdepend: [ReanimateMC]
@EventHandler
+public void onPlayerKO(PlayerKOEvent event) {
+ Player player = event.getPlayer();
+ int duration = event.getDuration();
+
+ // Custom logic when player enters KO
+ if (player.hasPermission("server.vip")) {
+ // VIP players get longer KO duration
+ // Note: Cannot modify duration directly
+ getLogger().info(player.getName() + " is VIP, extending KO");
+ }
+
+ // Cancel KO for staff members
+ if (player.hasPermission("server.staff")) {
+ event.setCancelled(true);
+ player.sendMessage("Staff bypass: KO cancelled");
+ }
+
+ // Notify team members
+ notifyTeam(player, duration);
+}
+
+
+
+
PlayerReanimatedEvent
+
Fired when a player is revived from KO state.
+
+
Methods:
+
+
+
+
Method
+
Return Type
+
Description
+
+
+
+
+
getPlayer()
+
Player
+
The player being revived
+
+
+
getReanimator()
+
Player
+
Player performing revival (can be null)
+
+
+
isSuccessful()
+
boolean
+
Whether revival was successful
+
+
+
getTimestamp()
+
long
+
Timestamp of revival attempt
+
+
+
getPlayerName()
+
String
+
Name of revived player
+
+
+
getReanimatorName()
+
String
+
Name of reanimator (or "Unknown")
+
+
+
+
+
Example Usage:
+
@EventHandler
+public void onPlayerRevived(PlayerReanimatedEvent event) {
+ Player patient = event.getPlayer();
+ Player medic = event.getReanimator();
+ boolean successful = event.isSuccessful();
+
+ if (!successful) return;
+
+ // Reward the medic
+ if (medic != null) {
+ // Give XP
+ medic.giveExp(50);
+
+ // Economy reward (if you have Vault)
+ economy.depositPlayer(medic, 100.0);
+
+ // Send message
+ medic.sendMessage(ChatColor.GREEN +
+ "You saved " + patient.getName() + "!");
+
+ // Add to statistics
+ addToStats(medic, "revivals_performed");
+ }
+
+ // Log the revival
+ logRevival(patient, medic, event.getTimestamp());
+}
+
+
+
+
+
KOManager API
+
+
+
Manager Methods
+
The KOManager provides methods to interact with the KO system programmatically.
+
+
+
+
+
Method
+
Description
+
+
+
+
+
isKO(Player player)
+
Check if player is currently in KO state
+
+
+
getKOData(Player player)
+
Get KOData object for player (can be null)
+
+
+
setKO(Player player)
+
Set player to KO state (default duration)
+
+
+
setKO(Player player, int seconds)
+
Set player to KO for specific duration
+
+
+
revive(Player target, Player reviver)
+
Revive a KO'd player
+
+
+
execute(Player player)
+
Execute a KO'd player (permanent death)
+
+
+
toggleCrawl(Player player)
+
Toggle crawling mode for KO'd player
+
+
+
sendDistress(Player player)
+
Send distress signal for KO'd player
+
+
+
handleLogout(Player player)
+
Handle player logout while KO'd
+
+
+
pullOfflineKO(UUID uuid)
+
Get remaining KO time for offline player
+
+
+
+
+
+
+
Example Usage:
+
// Check if player is KO'd
+if (koManager.isKO(player)) {
+ player.sendMessage("You are currently KO'd!");
+}
+
+// Force KO a player
+koManager.setKO(player, 30); // 30 seconds
+
+// Revive a player
+if (koManager.isKO(target)) {
+ koManager.revive(target, reviverPlayer);
+}
+
+// Execute a KO'd player
+if (koManager.isKO(target)) {
+ koManager.execute(target);
+}
+
+// Get KO data
+KOData koData = koManager.getKOData(player);
+if (koData != null && koData.isKo()) {
+ // Player is KO'd, access KO-specific data
+ long endTime = koData.getEndTimestamp();
+ boolean crawling = koData.isCrawling();
+}
+
+
+
+
+
Integration Examples
+
+
+
+
Economy Integration
+
@EventHandler
+public void onRevive(PlayerReanimatedEvent e) {
+ if (e.isSuccessful() && e.getReanimator() != null) {
+ Player medic = e.getReanimator();
+ economy.depositPlayer(medic, 100.0);
+ medic.sendMessage("§a+$100 for revival!");
+ }
+}
+ Complete list of all available commands in ReanimateMC
+
+
+
+
Command Overview
+
+ All ReanimateMC commands start with /reanimatemc or the shorter alias /rmc.
+ Comandi are organized by category: Administrative, Player Management, Sistema NPC, and Utility commands.
+
+
+
+
+
Administrative Comandi
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc reload
+
Reload plugin configuration and language files
+
reanimatemc.admin
+
/reanimatemc reload
+
+
+
/reanimatemc config
+
Open GUI configuration interface
+
reanimatemc.admin
+
/reanimatemc config
+
+
+
/reanimatemc setup
+
Mark initial setup as complete
+
reanimatemc.admin
+
/reanimatemc setup
+
+
+
+
+
+
Administrative Comandi Details
+
+
/reanimatemc reload
+
Purpose: Reloads all configuration files and language files without restarting the server.
+
When to use: After making changes to config.yml or language files.
+
Example:
+
/reanimatemc reload
+
Output: "Configurazione and language reloaded!"
+
+
/reanimatemc config
+
Purpose: Opens an interactive GUI where you can configure all plugin settings.
+ Un plugin Minecraft révolutionnaire qui introduit un état KO (Knockout) au lieu de la mort instantanée.
+ Les joueurs peuvent être réanimés par leurs coéquipiers ou exécutés par leurs ennemis, créant un gameplay dynamique et stratégique.
+
+ Complete list of all permissions for ReanimateMC
+
+
+
+
Permission Overview
+
+ ReanimateMC uses a comprehensive permission system to control access to features and commands.
+ Permessi are organized into categories: Core Permessi, Feature Permessi, NPC Permessi, and Command Permessi.
+
+
+ Permission Plugin Required: You need a permission plugin like LuckPerms, PermessiEx, or GroupManager to manage these permissions.
+
+
+
+
+
Core Permessi
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.admin
+
OP
+
Grants access to all administrative commands and GUI config
+
+
+
reanimatemc.revive
+
TRUE
+
Ability to revive KO'd players manually
+
+
+
reanimatemc.execute
+
TRUE
+
Ability to execute KO'd players permanently
+
+
+
reanimatemc.bypass
+
OP
+
Bypass the KO system entirely - die instantly instead of entering KO
+
+
+
+
+
+
Core Permessi Details
+
+
reanimatemc.admin
+
Default: OP only
+
Grants access to:
+
+
/reanimatemc reload - Reload configuration
+
/reanimatemc config - Open GUI configuration
+
/reanimatemc setup - Complete initial setup
+
/reanimatemc revive - Force revive players
+
/reanimatemc knockout - Force KO players
+
All configuration changes via GUI
+
+
+
reanimatemc.revive
+
Default: All players (TRUE)
+
Allows: Players to revive KO'd teammates by crouching near them with the required item.
+
Note: This is a core gameplay mechanic and should typically be available to all players.
+
+
reanimatemc.execute
+
Default: All players (TRUE)
+
Allows: Players to execute KO'd players by holding left-click on them.
+
Note: Essential for PvP gameplay. Can be restricted on non-PvP servers.
+
+
reanimatemc.bypass
+
Default: OP only
+
Effect: Players with this permission die instantly when health reaches zero, completely bypassing the KO system.
+
Use case: Staff members who need to respawn quickly, or VIP players who don't want to use the KO system.
+
+
+
+
+
Feature Permessi
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.knockout
+
OP
+
Force players into KO state via command
+
+
+
reanimatemc.status
+
TRUE
+
Check player KO status via command
+
+
+
reanimatemc.crawl
+
TRUE
+
Toggle crawling mode when KO'd
+
+
+
reanimatemc.loot
+
OP
+
Access KO'd player inventories (looting)
+
+
+
reanimatemc.removeGlowingEffect
+
OP
+
Remove glowing effects from players
+
+
+
+
+
+
Feature Permessi Details
+
+
reanimatemc.loot
+
Default: OP only
+
Allows: Opening and accessing the inventory of KO'd players.
+
Important: This is a powerful permission. Consider carefully before granting to regular players.
+
Configurazione: Looting can be completely disabled in config.yml with looting.enabled: false
+
+
reanimatemc.crawl
+
Default: All players (TRUE)
+
Allows: KO'd players to toggle between immobilized and crawling states using /reanimatemc crawl
+
Configurazione: Crawling must be enabled in config: prone.allow_crawl: true
+
+
+
+
+
Sistema NPC Permessi
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.summon
+
FALSE
+
Base permission to summon any NPC
+
+
+
reanimatemc.summon.use.golem
+
FALSE
+
Permission to summon Iron Golem reanimators
+
+
+
reanimatemc.summon.use.healer
+
FALSE
+
Permission to summon Healing Golem reanimators
+
+
+
reanimatemc.summon.use.protector
+
FALSE
+
Permission to summon Protective Golem reanimators
+
+
+
reanimatemc.summon.overridecost
+
OP
+
Bypass summon costs and cooldowns
+
+
+
reanimatemc.summon.admin
+
OP
+
Admin control over all NPCs (dismiss any NPC)
+
+
+
+
+
+
NPC Permessi Details
+
+
reanimatemc.summon
+
Default: No one (FALSE)
+
Purpose: Base permission required for any summon commands. Players need this AND a specific type permission.
+
+
Type-Specific Permessi
+
How it works: Players must have BOTH reanimatemc.summon AND the specific type permission.
+
Example setup:
+
# VIP Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+
+# Premium Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+
+# Elite Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+reanimatemc.summon.use.protector: true
+
+
NPC Type Comparison
+
+
Golem - Basic reanimator, follows owner and revives KO'd players
+
Healer - Specialized in revival, faster revive times (potential future feature)
+
Protector - Can revive AND attacks hostile mobs, has more health
+
+
+
reanimatemc.summon.overridecost
+
Default: OP only
+
Bypasses:
+
+
Cooldown timers (default: 5 minutes between summons)
+
Item costs (if configured to require items)
+
Max summons per player limit
+
+
+
reanimatemc.summon.admin
+
Default: OP only
+
Allows: Dismissing any player's NPCs, viewing all active NPCs, and full control over the NPC system.
reanimatemc.*: true
+(Full access to all features)
+
+
+
+
+
+
LuckPerms Configurazione Examples
+
+
+
Basic Setup
+
Using LuckPerms commands to set up permissions:
+
+
Default Group
+
/lp group default permission set reanimatemc.revive true
+/lp group default permission set reanimatemc.execute true
+/lp group default permission set reanimatemc.status true
+/lp group default permission set reanimatemc.crawl true
+
+
VIP Group
+
/lp creategroup vip
+/lp group vip parent add default
+/lp group vip permission set reanimatemc.summon true
+/lp group vip permission set reanimatemc.summon.use.golem true
+
+
Premium Group
+
/lp creategroup premium
+/lp group premium parent add vip
+/lp group premium permission set reanimatemc.summon.use.healer true
+
+
Elite Group
+
/lp creategroup elite
+/lp group elite parent add premium
+/lp group elite permission set reanimatemc.summon.use.protector true
+/lp group elite permission set reanimatemc.summon.overridecost true
+
+
Moderator Group
+
/lp creategroup moderator
+/lp group moderator parent add default
+/lp group moderator permission set reanimatemc.knockout true
+/lp group moderator permission set reanimatemc.loot true
+/lp group moderator permission set reanimatemc.removeGlowingEffect true
+
+
Admin Group
+
/lp creategroup admin
+/lp group admin permission set reanimatemc.* true
+
+
+
+
+
Permission Wildcards
+
+
+
Using Wildcards
+
You can use wildcards to grant multiple permissions at once:
+
+
+
+
+
Wildcard
+
Effect
+
+
+
+
+
reanimatemc.*
+
Grants ALL ReanimateMC permissions
+
+
+
reanimatemc.summon.*
+
Grants all summon-related permissions
+
+
+
reanimatemc.summon.use.*
+
Grants permission to summon all NPC types
+
+
+
+
+
Wildcard Examples
+
# Give all summon permissions
+/lp group vip permission set reanimatemc.summon.* true
+
+# Give all permissions except admin
+/lp group moderator permission set reanimatemc.* true
+/lp group moderator permission set reanimatemc.admin false
+/lp group moderator permission set reanimatemc.bypass false
+
+
+
+
+
Best Practices
+
+
+
+
+
+
+
Default Permessi
+
Keep revive and execute available to all players for core gameplay. Restrict loot to prevent abuse.
+
+
+
+
+
+
+
Monetization
+
NPC summon permissions work great as donor perks. Create tiers: Golem (VIP) → Healer (Premium) → Protector (Elite).
+
+
+
+
+
+
+
Admin Access
+
Reserve admin, bypass, and summon.admin for trusted staff only to maintain server balance.
+
+
+
+
+
+
+
Balance
+
Consider your server type: PvP servers may restrict execute, RP servers may disable it entirely via config.
+ ReanimateMC provides a comprehensive API for developers to integrate the KO system into their plugins.
+ You can listen to events, access the KO manager, and programmatically control the KO state of players.
+
+
+
+
+
Getting Started
+
+
+
Adding ReanimateMC as a Dependency
+
+
plugin.yml
+
name: YourPlugin
+version: 1.0.0
+depend: [ReanimateMC]
+# or for optional dependency
+# softdepend: [ReanimateMC]
@EventHandler
+public void onPlayerKO(PlayerKOEvent event) {
+ Player player = event.getPlayer();
+ int duration = event.getDuration();
+
+ // Custom logic when player enters KO
+ if (player.hasPermission("server.vip")) {
+ // VIP players get longer KO duration
+ // Note: Cannot modify duration directly
+ getLogger().info(player.getName() + " is VIP, extending KO");
+ }
+
+ // Cancel KO for staff members
+ if (player.hasPermission("server.staff")) {
+ event.setCancelled(true);
+ player.sendMessage("Staff bypass: KO cancelled");
+ }
+
+ // Notify team members
+ notifyTeam(player, duration);
+}
+
+
+
+
PlayerReanimatedEvent
+
Fired when a player is revived from KO state.
+
+
Methods:
+
+
+
+
Method
+
Return Type
+
Description
+
+
+
+
+
getPlayer()
+
Player
+
The player being revived
+
+
+
getReanimator()
+
Player
+
Player performing revival (can be null)
+
+
+
isSuccessful()
+
boolean
+
Whether revival was successful
+
+
+
getTimestamp()
+
long
+
Timestamp of revival attempt
+
+
+
getPlayerName()
+
String
+
Name of revived player
+
+
+
getReanimatorName()
+
String
+
Name of reanimator (or "Unknown")
+
+
+
+
+
Example Usage:
+
@EventHandler
+public void onPlayerRevived(PlayerReanimatedEvent event) {
+ Player patient = event.getPlayer();
+ Player medic = event.getReanimator();
+ boolean successful = event.isSuccessful();
+
+ if (!successful) return;
+
+ // Reward the medic
+ if (medic != null) {
+ // Give XP
+ medic.giveExp(50);
+
+ // Economy reward (if you have Vault)
+ economy.depositPlayer(medic, 100.0);
+
+ // Send message
+ medic.sendMessage(ChatColor.GREEN +
+ "You saved " + patient.getName() + "!");
+
+ // Add to statistics
+ addToStats(medic, "revivals_performed");
+ }
+
+ // Log the revival
+ logRevival(patient, medic, event.getTimestamp());
+}
+
+
+
+
+
KOManager API
+
+
+
Manager Methods
+
The KOManager provides methods to interact with the KO system programmatically.
+
+
+
+
+
Method
+
Description
+
+
+
+
+
isKO(Player player)
+
Check if player is currently in KO state
+
+
+
getKOData(Player player)
+
Get KOData object for player (can be null)
+
+
+
setKO(Player player)
+
Set player to KO state (default duration)
+
+
+
setKO(Player player, int seconds)
+
Set player to KO for specific duration
+
+
+
revive(Player target, Player reviver)
+
Revive a KO'd player
+
+
+
execute(Player player)
+
Execute a KO'd player (permanent death)
+
+
+
toggleCrawl(Player player)
+
Toggle crawling mode for KO'd player
+
+
+
sendDistress(Player player)
+
Send distress signal for KO'd player
+
+
+
handleLogout(Player player)
+
Handle player logout while KO'd
+
+
+
pullOfflineKO(UUID uuid)
+
Get remaining KO time for offline player
+
+
+
+
+
+
+
Example Usage:
+
// Check if player is KO'd
+if (koManager.isKO(player)) {
+ player.sendMessage("You are currently KO'd!");
+}
+
+// Force KO a player
+koManager.setKO(player, 30); // 30 seconds
+
+// Revive a player
+if (koManager.isKO(target)) {
+ koManager.revive(target, reviverPlayer);
+}
+
+// Execute a KO'd player
+if (koManager.isKO(target)) {
+ koManager.execute(target);
+}
+
+// Get KO data
+KOData koData = koManager.getKOData(player);
+if (koData != null && koData.isKo()) {
+ // Player is KO'd, access KO-specific data
+ long endTime = koData.getEndTimestamp();
+ boolean crawling = koData.isCrawling();
+}
+
+
+
+
+
Integration Examples
+
+
+
+
Economy Integration
+
@EventHandler
+public void onRevive(PlayerReanimatedEvent e) {
+ if (e.isSuccessful() && e.getReanimator() != null) {
+ Player medic = e.getReanimator();
+ economy.depositPlayer(medic, 100.0);
+ medic.sendMessage("§a+$100 for revival!");
+ }
+}
+ Complete list of all available commands in ReanimateMC
+
+
+
+
Command Overview
+
+ All ReanimateMC commands start with /reanimatemc or the shorter alias /rmc.
+ 명령어 are organized by category: Administrative, Player Management, NPC 시스템, and Utility commands.
+
+
+
+
+
Administrative 명령어
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc reload
+
Reload plugin configuration and language files
+
reanimatemc.admin
+
/reanimatemc reload
+
+
+
/reanimatemc config
+
Open GUI configuration interface
+
reanimatemc.admin
+
/reanimatemc config
+
+
+
/reanimatemc setup
+
Mark initial setup as complete
+
reanimatemc.admin
+
/reanimatemc setup
+
+
+
+
+
+
Administrative 명령어 Details
+
+
/reanimatemc reload
+
Purpose: Reloads all configuration files and language files without restarting the server.
+
When to use: After making changes to config.yml or language files.
+
Example:
+
/reanimatemc reload
+
Output: "설정 and language reloaded!"
+
+
/reanimatemc config
+
Purpose: Opens an interactive GUI where you can configure all plugin settings.
+ Un plugin Minecraft révolutionnaire qui introduit un état KO (Knockout) au lieu de la mort instantanée.
+ Les joueurs peuvent être réanimés par leurs coéquipiers ou exécutés par leurs ennemis, créant un gameplay dynamique et stratégique.
+
+ Complete list of all permissions for ReanimateMC
+
+
+
+
Permission Overview
+
+ ReanimateMC uses a comprehensive permission system to control access to features and commands.
+ 권한 are organized into categories: Core 권한, Feature 권한, NPC 권한, and Command 권한.
+
+
+ Permission Plugin Required: You need a permission plugin like LuckPerms, 권한Ex, or GroupManager to manage these permissions.
+
+
+
+
+
Core 권한
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.admin
+
OP
+
Grants access to all administrative commands and GUI config
+
+
+
reanimatemc.revive
+
TRUE
+
Ability to revive KO'd players manually
+
+
+
reanimatemc.execute
+
TRUE
+
Ability to execute KO'd players permanently
+
+
+
reanimatemc.bypass
+
OP
+
Bypass the KO system entirely - die instantly instead of entering KO
+
+
+
+
+
+
Core 권한 Details
+
+
reanimatemc.admin
+
Default: OP only
+
Grants access to:
+
+
/reanimatemc reload - Reload configuration
+
/reanimatemc config - Open GUI configuration
+
/reanimatemc setup - Complete initial setup
+
/reanimatemc revive - Force revive players
+
/reanimatemc knockout - Force KO players
+
All configuration changes via GUI
+
+
+
reanimatemc.revive
+
Default: All players (TRUE)
+
Allows: Players to revive KO'd teammates by crouching near them with the required item.
+
Note: This is a core gameplay mechanic and should typically be available to all players.
+
+
reanimatemc.execute
+
Default: All players (TRUE)
+
Allows: Players to execute KO'd players by holding left-click on them.
+
Note: Essential for PvP gameplay. Can be restricted on non-PvP servers.
+
+
reanimatemc.bypass
+
Default: OP only
+
Effect: Players with this permission die instantly when health reaches zero, completely bypassing the KO system.
+
Use case: Staff members who need to respawn quickly, or VIP players who don't want to use the KO system.
+
+
+
+
+
Feature 권한
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.knockout
+
OP
+
Force players into KO state via command
+
+
+
reanimatemc.status
+
TRUE
+
Check player KO status via command
+
+
+
reanimatemc.crawl
+
TRUE
+
Toggle crawling mode when KO'd
+
+
+
reanimatemc.loot
+
OP
+
Access KO'd player inventories (looting)
+
+
+
reanimatemc.removeGlowingEffect
+
OP
+
Remove glowing effects from players
+
+
+
+
+
+
Feature 권한 Details
+
+
reanimatemc.loot
+
Default: OP only
+
Allows: Opening and accessing the inventory of KO'd players.
+
Important: This is a powerful permission. Consider carefully before granting to regular players.
+
설정: Looting can be completely disabled in config.yml with looting.enabled: false
+
+
reanimatemc.crawl
+
Default: All players (TRUE)
+
Allows: KO'd players to toggle between immobilized and crawling states using /reanimatemc crawl
+
설정: Crawling must be enabled in config: prone.allow_crawl: true
+
+
+
+
+
NPC 시스템 권한
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.summon
+
FALSE
+
Base permission to summon any NPC
+
+
+
reanimatemc.summon.use.golem
+
FALSE
+
Permission to summon Iron Golem reanimators
+
+
+
reanimatemc.summon.use.healer
+
FALSE
+
Permission to summon Healing Golem reanimators
+
+
+
reanimatemc.summon.use.protector
+
FALSE
+
Permission to summon Protective Golem reanimators
+
+
+
reanimatemc.summon.overridecost
+
OP
+
Bypass summon costs and cooldowns
+
+
+
reanimatemc.summon.admin
+
OP
+
Admin control over all NPCs (dismiss any NPC)
+
+
+
+
+
+
NPC 권한 Details
+
+
reanimatemc.summon
+
Default: No one (FALSE)
+
Purpose: Base permission required for any summon commands. Players need this AND a specific type permission.
+
+
Type-Specific 권한
+
How it works: Players must have BOTH reanimatemc.summon AND the specific type permission.
+
Example setup:
+
# VIP Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+
+# Premium Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+
+# Elite Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+reanimatemc.summon.use.protector: true
+
+
NPC Type Comparison
+
+
Golem - Basic reanimator, follows owner and revives KO'd players
+
Healer - Specialized in revival, faster revive times (potential future feature)
+
Protector - Can revive AND attacks hostile mobs, has more health
+
+
+
reanimatemc.summon.overridecost
+
Default: OP only
+
Bypasses:
+
+
Cooldown timers (default: 5 minutes between summons)
+
Item costs (if configured to require items)
+
Max summons per player limit
+
+
+
reanimatemc.summon.admin
+
Default: OP only
+
Allows: Dismissing any player's NPCs, viewing all active NPCs, and full control over the NPC system.
reanimatemc.*: true
+(Full access to all features)
+
+
+
+
+
+
LuckPerms 설정 Examples
+
+
+
Basic Setup
+
Using LuckPerms commands to set up permissions:
+
+
Default Group
+
/lp group default permission set reanimatemc.revive true
+/lp group default permission set reanimatemc.execute true
+/lp group default permission set reanimatemc.status true
+/lp group default permission set reanimatemc.crawl true
+
+
VIP Group
+
/lp creategroup vip
+/lp group vip parent add default
+/lp group vip permission set reanimatemc.summon true
+/lp group vip permission set reanimatemc.summon.use.golem true
+
+
Premium Group
+
/lp creategroup premium
+/lp group premium parent add vip
+/lp group premium permission set reanimatemc.summon.use.healer true
+
+
Elite Group
+
/lp creategroup elite
+/lp group elite parent add premium
+/lp group elite permission set reanimatemc.summon.use.protector true
+/lp group elite permission set reanimatemc.summon.overridecost true
+
+
Moderator Group
+
/lp creategroup moderator
+/lp group moderator parent add default
+/lp group moderator permission set reanimatemc.knockout true
+/lp group moderator permission set reanimatemc.loot true
+/lp group moderator permission set reanimatemc.removeGlowingEffect true
+
+
Admin Group
+
/lp creategroup admin
+/lp group admin permission set reanimatemc.* true
+
+
+
+
+
Permission Wildcards
+
+
+
Using Wildcards
+
You can use wildcards to grant multiple permissions at once:
+
+
+
+
+
Wildcard
+
Effect
+
+
+
+
+
reanimatemc.*
+
Grants ALL ReanimateMC permissions
+
+
+
reanimatemc.summon.*
+
Grants all summon-related permissions
+
+
+
reanimatemc.summon.use.*
+
Grants permission to summon all NPC types
+
+
+
+
+
Wildcard Examples
+
# Give all summon permissions
+/lp group vip permission set reanimatemc.summon.* true
+
+# Give all permissions except admin
+/lp group moderator permission set reanimatemc.* true
+/lp group moderator permission set reanimatemc.admin false
+/lp group moderator permission set reanimatemc.bypass false
+
+
+
+
+
Best Practices
+
+
+
+
+
+
+
Default 권한
+
Keep revive and execute available to all players for core gameplay. Restrict loot to prevent abuse.
+
+
+
+
+
+
+
Monetization
+
NPC summon permissions work great as donor perks. Create tiers: Golem (VIP) → Healer (Premium) → Protector (Elite).
+
+
+
+
+
+
+
Admin Access
+
Reserve admin, bypass, and summon.admin for trusted staff only to maintain server balance.
+
+
+
+
+
+
+
Balance
+
Consider your server type: PvP servers may restrict execute, RP servers may disable it entirely via config.
+ ReanimateMC provides a comprehensive API for developers to integrate the KO system into their plugins.
+ You can listen to events, access the KO manager, and programmatically control the KO state of players.
+
+
+
+
+
Getting Started
+
+
+
Adding ReanimateMC as a Dependency
+
+
plugin.yml
+
name: YourPlugin
+version: 1.0.0
+depend: [ReanimateMC]
+# or for optional dependency
+# softdepend: [ReanimateMC]
@EventHandler
+public void onPlayerKO(PlayerKOEvent event) {
+ Player player = event.getPlayer();
+ int duration = event.getDuration();
+
+ // Custom logic when player enters KO
+ if (player.hasPermission("server.vip")) {
+ // VIP players get longer KO duration
+ // Note: Cannot modify duration directly
+ getLogger().info(player.getName() + " is VIP, extending KO");
+ }
+
+ // Cancel KO for staff members
+ if (player.hasPermission("server.staff")) {
+ event.setCancelled(true);
+ player.sendMessage("Staff bypass: KO cancelled");
+ }
+
+ // Notify team members
+ notifyTeam(player, duration);
+}
+
+
+
+
PlayerReanimatedEvent
+
Fired when a player is revived from KO state.
+
+
Methods:
+
+
+
+
Method
+
Return Type
+
Description
+
+
+
+
+
getPlayer()
+
Player
+
The player being revived
+
+
+
getReanimator()
+
Player
+
Player performing revival (can be null)
+
+
+
isSuccessful()
+
boolean
+
Whether revival was successful
+
+
+
getTimestamp()
+
long
+
Timestamp of revival attempt
+
+
+
getPlayerName()
+
String
+
Name of revived player
+
+
+
getReanimatorName()
+
String
+
Name of reanimator (or "Unknown")
+
+
+
+
+
Example Usage:
+
@EventHandler
+public void onPlayerRevived(PlayerReanimatedEvent event) {
+ Player patient = event.getPlayer();
+ Player medic = event.getReanimator();
+ boolean successful = event.isSuccessful();
+
+ if (!successful) return;
+
+ // Reward the medic
+ if (medic != null) {
+ // Give XP
+ medic.giveExp(50);
+
+ // Economy reward (if you have Vault)
+ economy.depositPlayer(medic, 100.0);
+
+ // Send message
+ medic.sendMessage(ChatColor.GREEN +
+ "You saved " + patient.getName() + "!");
+
+ // Add to statistics
+ addToStats(medic, "revivals_performed");
+ }
+
+ // Log the revival
+ logRevival(patient, medic, event.getTimestamp());
+}
+
+
+
+
+
KOManager API
+
+
+
Manager Methods
+
The KOManager provides methods to interact with the KO system programmatically.
+
+
+
+
+
Method
+
Description
+
+
+
+
+
isKO(Player player)
+
Check if player is currently in KO state
+
+
+
getKOData(Player player)
+
Get KOData object for player (can be null)
+
+
+
setKO(Player player)
+
Set player to KO state (default duration)
+
+
+
setKO(Player player, int seconds)
+
Set player to KO for specific duration
+
+
+
revive(Player target, Player reviver)
+
Revive a KO'd player
+
+
+
execute(Player player)
+
Execute a KO'd player (permanent death)
+
+
+
toggleCrawl(Player player)
+
Toggle crawling mode for KO'd player
+
+
+
sendDistress(Player player)
+
Send distress signal for KO'd player
+
+
+
handleLogout(Player player)
+
Handle player logout while KO'd
+
+
+
pullOfflineKO(UUID uuid)
+
Get remaining KO time for offline player
+
+
+
+
+
+
+
Example Usage:
+
// Check if player is KO'd
+if (koManager.isKO(player)) {
+ player.sendMessage("You are currently KO'd!");
+}
+
+// Force KO a player
+koManager.setKO(player, 30); // 30 seconds
+
+// Revive a player
+if (koManager.isKO(target)) {
+ koManager.revive(target, reviverPlayer);
+}
+
+// Execute a KO'd player
+if (koManager.isKO(target)) {
+ koManager.execute(target);
+}
+
+// Get KO data
+KOData koData = koManager.getKOData(player);
+if (koData != null && koData.isKo()) {
+ // Player is KO'd, access KO-specific data
+ long endTime = koData.getEndTimestamp();
+ boolean crawling = koData.isCrawling();
+}
+
+
+
+
+
Integration Examples
+
+
+
+
Economy Integration
+
@EventHandler
+public void onRevive(PlayerReanimatedEvent e) {
+ if (e.isSuccessful() && e.getReanimator() != null) {
+ Player medic = e.getReanimator();
+ economy.depositPlayer(medic, 100.0);
+ medic.sendMessage("§a+$100 for revival!");
+ }
+}
+ Complete list of all available commands in ReanimateMC
+
+
+
+
Command Overview
+
+ All ReanimateMC commands start with /reanimatemc or the shorter alias /rmc.
+ Comandos are organized by category: Administrative, Player Management, Sistema NPC, and Utility commands.
+
+
+
+
+
Administrative Comandos
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc reload
+
Reload plugin configuration and language files
+
reanimatemc.admin
+
/reanimatemc reload
+
+
+
/reanimatemc config
+
Open GUI configuration interface
+
reanimatemc.admin
+
/reanimatemc config
+
+
+
/reanimatemc setup
+
Mark initial setup as complete
+
reanimatemc.admin
+
/reanimatemc setup
+
+
+
+
+
+
Administrative Comandos Details
+
+
/reanimatemc reload
+
Purpose: Reloads all configuration files and language files without restarting the server.
+
When to use: After making changes to config.yml or language files.
+
Example:
+
/reanimatemc reload
+
Output: "Configuração and language reloaded!"
+
+
/reanimatemc config
+
Purpose: Opens an interactive GUI where you can configure all plugin settings.
+ Un plugin Minecraft révolutionnaire qui introduit un état KO (Knockout) au lieu de la mort instantanée.
+ Les joueurs peuvent être réanimés par leurs coéquipiers ou exécutés par leurs ennemis, créant un gameplay dynamique et stratégique.
+
+ Complete list of all permissions for ReanimateMC
+
+
+
+
Permission Overview
+
+ ReanimateMC uses a comprehensive permission system to control access to features and commands.
+ Permissões are organized into categories: Core Permissões, Feature Permissões, NPC Permissões, and Command Permissões.
+
+
+ Permission Plugin Required: You need a permission plugin like LuckPerms, PermissõesEx, or GroupManager to manage these permissions.
+
+
+
+
+
Core Permissões
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.admin
+
OP
+
Grants access to all administrative commands and GUI config
+
+
+
reanimatemc.revive
+
TRUE
+
Ability to revive KO'd players manually
+
+
+
reanimatemc.execute
+
TRUE
+
Ability to execute KO'd players permanently
+
+
+
reanimatemc.bypass
+
OP
+
Bypass the KO system entirely - die instantly instead of entering KO
+
+
+
+
+
+
Core Permissões Details
+
+
reanimatemc.admin
+
Default: OP only
+
Grants access to:
+
+
/reanimatemc reload - Reload configuration
+
/reanimatemc config - Open GUI configuration
+
/reanimatemc setup - Complete initial setup
+
/reanimatemc revive - Force revive players
+
/reanimatemc knockout - Force KO players
+
All configuration changes via GUI
+
+
+
reanimatemc.revive
+
Default: All players (TRUE)
+
Allows: Players to revive KO'd teammates by crouching near them with the required item.
+
Note: This is a core gameplay mechanic and should typically be available to all players.
+
+
reanimatemc.execute
+
Default: All players (TRUE)
+
Allows: Players to execute KO'd players by holding left-click on them.
+
Note: Essential for PvP gameplay. Can be restricted on non-PvP servers.
+
+
reanimatemc.bypass
+
Default: OP only
+
Effect: Players with this permission die instantly when health reaches zero, completely bypassing the KO system.
+
Use case: Staff members who need to respawn quickly, or VIP players who don't want to use the KO system.
+
+
+
+
+
Feature Permissões
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.knockout
+
OP
+
Force players into KO state via command
+
+
+
reanimatemc.status
+
TRUE
+
Check player KO status via command
+
+
+
reanimatemc.crawl
+
TRUE
+
Toggle crawling mode when KO'd
+
+
+
reanimatemc.loot
+
OP
+
Access KO'd player inventories (looting)
+
+
+
reanimatemc.removeGlowingEffect
+
OP
+
Remove glowing effects from players
+
+
+
+
+
+
Feature Permissões Details
+
+
reanimatemc.loot
+
Default: OP only
+
Allows: Opening and accessing the inventory of KO'd players.
+
Important: This is a powerful permission. Consider carefully before granting to regular players.
+
Configuração: Looting can be completely disabled in config.yml with looting.enabled: false
+
+
reanimatemc.crawl
+
Default: All players (TRUE)
+
Allows: KO'd players to toggle between immobilized and crawling states using /reanimatemc crawl
+
Configuração: Crawling must be enabled in config: prone.allow_crawl: true
+
+
+
+
+
Sistema NPC Permissões
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.summon
+
FALSE
+
Base permission to summon any NPC
+
+
+
reanimatemc.summon.use.golem
+
FALSE
+
Permission to summon Iron Golem reanimators
+
+
+
reanimatemc.summon.use.healer
+
FALSE
+
Permission to summon Healing Golem reanimators
+
+
+
reanimatemc.summon.use.protector
+
FALSE
+
Permission to summon Protective Golem reanimators
+
+
+
reanimatemc.summon.overridecost
+
OP
+
Bypass summon costs and cooldowns
+
+
+
reanimatemc.summon.admin
+
OP
+
Admin control over all NPCs (dismiss any NPC)
+
+
+
+
+
+
NPC Permissões Details
+
+
reanimatemc.summon
+
Default: No one (FALSE)
+
Purpose: Base permission required for any summon commands. Players need this AND a specific type permission.
+
+
Type-Specific Permissões
+
How it works: Players must have BOTH reanimatemc.summon AND the specific type permission.
+
Example setup:
+
# VIP Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+
+# Premium Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+
+# Elite Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+reanimatemc.summon.use.protector: true
+
+
NPC Type Comparison
+
+
Golem - Basic reanimator, follows owner and revives KO'd players
+
Healer - Specialized in revival, faster revive times (potential future feature)
+
Protector - Can revive AND attacks hostile mobs, has more health
+
+
+
reanimatemc.summon.overridecost
+
Default: OP only
+
Bypasses:
+
+
Cooldown timers (default: 5 minutes between summons)
+
Item costs (if configured to require items)
+
Max summons per player limit
+
+
+
reanimatemc.summon.admin
+
Default: OP only
+
Allows: Dismissing any player's NPCs, viewing all active NPCs, and full control over the NPC system.
reanimatemc.*: true
+(Full access to all features)
+
+
+
+
+
+
LuckPerms Configuração Examples
+
+
+
Basic Setup
+
Using LuckPerms commands to set up permissions:
+
+
Default Group
+
/lp group default permission set reanimatemc.revive true
+/lp group default permission set reanimatemc.execute true
+/lp group default permission set reanimatemc.status true
+/lp group default permission set reanimatemc.crawl true
+
+
VIP Group
+
/lp creategroup vip
+/lp group vip parent add default
+/lp group vip permission set reanimatemc.summon true
+/lp group vip permission set reanimatemc.summon.use.golem true
+
+
Premium Group
+
/lp creategroup premium
+/lp group premium parent add vip
+/lp group premium permission set reanimatemc.summon.use.healer true
+
+
Elite Group
+
/lp creategroup elite
+/lp group elite parent add premium
+/lp group elite permission set reanimatemc.summon.use.protector true
+/lp group elite permission set reanimatemc.summon.overridecost true
+
+
Moderator Group
+
/lp creategroup moderator
+/lp group moderator parent add default
+/lp group moderator permission set reanimatemc.knockout true
+/lp group moderator permission set reanimatemc.loot true
+/lp group moderator permission set reanimatemc.removeGlowingEffect true
+
+
Admin Group
+
/lp creategroup admin
+/lp group admin permission set reanimatemc.* true
+
+
+
+
+
Permission Wildcards
+
+
+
Using Wildcards
+
You can use wildcards to grant multiple permissions at once:
+
+
+
+
+
Wildcard
+
Effect
+
+
+
+
+
reanimatemc.*
+
Grants ALL ReanimateMC permissions
+
+
+
reanimatemc.summon.*
+
Grants all summon-related permissions
+
+
+
reanimatemc.summon.use.*
+
Grants permission to summon all NPC types
+
+
+
+
+
Wildcard Examples
+
# Give all summon permissions
+/lp group vip permission set reanimatemc.summon.* true
+
+# Give all permissions except admin
+/lp group moderator permission set reanimatemc.* true
+/lp group moderator permission set reanimatemc.admin false
+/lp group moderator permission set reanimatemc.bypass false
+
+
+
+
+
Best Practices
+
+
+
+
+
+
+
Default Permissões
+
Keep revive and execute available to all players for core gameplay. Restrict loot to prevent abuse.
+
+
+
+
+
+
+
Monetization
+
NPC summon permissions work great as donor perks. Create tiers: Golem (VIP) → Healer (Premium) → Protector (Elite).
+
+
+
+
+
+
+
Admin Access
+
Reserve admin, bypass, and summon.admin for trusted staff only to maintain server balance.
+
+
+
+
+
+
+
Balance
+
Consider your server type: PvP servers may restrict execute, RP servers may disable it entirely via config.
+ ReanimateMC provides a comprehensive API for developers to integrate the KO system into their plugins.
+ You can listen to events, access the KO manager, and programmatically control the KO state of players.
+
+
+
+
+
Getting Started
+
+
+
Adding ReanimateMC as a Dependency
+
+
plugin.yml
+
name: YourPlugin
+version: 1.0.0
+depend: [ReanimateMC]
+# or for optional dependency
+# softdepend: [ReanimateMC]
@EventHandler
+public void onPlayerKO(PlayerKOEvent event) {
+ Player player = event.getPlayer();
+ int duration = event.getDuration();
+
+ // Custom logic when player enters KO
+ if (player.hasPermission("server.vip")) {
+ // VIP players get longer KO duration
+ // Note: Cannot modify duration directly
+ getLogger().info(player.getName() + " is VIP, extending KO");
+ }
+
+ // Cancel KO for staff members
+ if (player.hasPermission("server.staff")) {
+ event.setCancelled(true);
+ player.sendMessage("Staff bypass: KO cancelled");
+ }
+
+ // Notify team members
+ notifyTeam(player, duration);
+}
+
+
+
+
PlayerReanimatedEvent
+
Fired when a player is revived from KO state.
+
+
Methods:
+
+
+
+
Method
+
Return Type
+
Description
+
+
+
+
+
getPlayer()
+
Player
+
The player being revived
+
+
+
getReanimator()
+
Player
+
Player performing revival (can be null)
+
+
+
isSuccessful()
+
boolean
+
Whether revival was successful
+
+
+
getTimestamp()
+
long
+
Timestamp of revival attempt
+
+
+
getPlayerName()
+
String
+
Name of revived player
+
+
+
getReanimatorName()
+
String
+
Name of reanimator (or "Unknown")
+
+
+
+
+
Example Usage:
+
@EventHandler
+public void onPlayerRevived(PlayerReanimatedEvent event) {
+ Player patient = event.getPlayer();
+ Player medic = event.getReanimator();
+ boolean successful = event.isSuccessful();
+
+ if (!successful) return;
+
+ // Reward the medic
+ if (medic != null) {
+ // Give XP
+ medic.giveExp(50);
+
+ // Economy reward (if you have Vault)
+ economy.depositPlayer(medic, 100.0);
+
+ // Send message
+ medic.sendMessage(ChatColor.GREEN +
+ "You saved " + patient.getName() + "!");
+
+ // Add to statistics
+ addToStats(medic, "revivals_performed");
+ }
+
+ // Log the revival
+ logRevival(patient, medic, event.getTimestamp());
+}
+
+
+
+
+
KOManager API
+
+
+
Manager Methods
+
The KOManager provides methods to interact with the KO system programmatically.
+
+
+
+
+
Method
+
Description
+
+
+
+
+
isKO(Player player)
+
Check if player is currently in KO state
+
+
+
getKOData(Player player)
+
Get KOData object for player (can be null)
+
+
+
setKO(Player player)
+
Set player to KO state (default duration)
+
+
+
setKO(Player player, int seconds)
+
Set player to KO for specific duration
+
+
+
revive(Player target, Player reviver)
+
Revive a KO'd player
+
+
+
execute(Player player)
+
Execute a KO'd player (permanent death)
+
+
+
toggleCrawl(Player player)
+
Toggle crawling mode for KO'd player
+
+
+
sendDistress(Player player)
+
Send distress signal for KO'd player
+
+
+
handleLogout(Player player)
+
Handle player logout while KO'd
+
+
+
pullOfflineKO(UUID uuid)
+
Get remaining KO time for offline player
+
+
+
+
+
+
+
Example Usage:
+
// Check if player is KO'd
+if (koManager.isKO(player)) {
+ player.sendMessage("You are currently KO'd!");
+}
+
+// Force KO a player
+koManager.setKO(player, 30); // 30 seconds
+
+// Revive a player
+if (koManager.isKO(target)) {
+ koManager.revive(target, reviverPlayer);
+}
+
+// Execute a KO'd player
+if (koManager.isKO(target)) {
+ koManager.execute(target);
+}
+
+// Get KO data
+KOData koData = koManager.getKOData(player);
+if (koData != null && koData.isKo()) {
+ // Player is KO'd, access KO-specific data
+ long endTime = koData.getEndTimestamp();
+ boolean crawling = koData.isCrawling();
+}
+
+
+
+
+
Integration Examples
+
+
+
+
Economy Integration
+
@EventHandler
+public void onRevive(PlayerReanimatedEvent e) {
+ if (e.isSuccessful() && e.getReanimator() != null) {
+ Player medic = e.getReanimator();
+ economy.depositPlayer(medic, 100.0);
+ medic.sendMessage("§a+$100 for revival!");
+ }
+}
+ Complete list of all available commands in ReanimateMC
+
+
+
+
Command Overview
+
+ All ReanimateMC commands start with /reanimatemc or the shorter alias /rmc.
+ Команды are organized by category: Administrative, Player Management, Система NPC, and Utility commands.
+
+
+
+
+
Administrative Команды
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc reload
+
Reload plugin configuration and language files
+
reanimatemc.admin
+
/reanimatemc reload
+
+
+
/reanimatemc config
+
Open GUI configuration interface
+
reanimatemc.admin
+
/reanimatemc config
+
+
+
/reanimatemc setup
+
Mark initial setup as complete
+
reanimatemc.admin
+
/reanimatemc setup
+
+
+
+
+
+
Administrative Команды Details
+
+
/reanimatemc reload
+
Purpose: Reloads all configuration files and language files without restarting the server.
+
When to use: After making changes to config.yml or language files.
+
Example:
+
/reanimatemc reload
+
Output: "Конфигурация and language reloaded!"
+
+
/reanimatemc config
+
Purpose: Opens an interactive GUI where you can configure all plugin settings.
+ Un plugin Minecraft révolutionnaire qui introduit un état KO (Knockout) au lieu de la mort instantanée.
+ Les joueurs peuvent être réanimés par leurs coéquipiers ou exécutés par leurs ennemis, créant un gameplay dynamique et stratégique.
+
+ Complete list of all permissions for ReanimateMC
+
+
+
+
Permission Overview
+
+ ReanimateMC uses a comprehensive permission system to control access to features and commands.
+ Разрешения are organized into categories: Core Разрешения, Feature Разрешения, NPC Разрешения, and Command Разрешения.
+
+
+ Permission Plugin Required: You need a permission plugin like LuckPerms, РазрешенияEx, or GroupManager to manage these permissions.
+
+
+
+
+
Core Разрешения
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.admin
+
OP
+
Grants access to all administrative commands and GUI config
+
+
+
reanimatemc.revive
+
TRUE
+
Ability to revive KO'd players manually
+
+
+
reanimatemc.execute
+
TRUE
+
Ability to execute KO'd players permanently
+
+
+
reanimatemc.bypass
+
OP
+
Bypass the KO system entirely - die instantly instead of entering KO
+
+
+
+
+
+
Core Разрешения Details
+
+
reanimatemc.admin
+
Default: OP only
+
Grants access to:
+
+
/reanimatemc reload - Reload configuration
+
/reanimatemc config - Open GUI configuration
+
/reanimatemc setup - Complete initial setup
+
/reanimatemc revive - Force revive players
+
/reanimatemc knockout - Force KO players
+
All configuration changes via GUI
+
+
+
reanimatemc.revive
+
Default: All players (TRUE)
+
Allows: Players to revive KO'd teammates by crouching near them with the required item.
+
Note: This is a core gameplay mechanic and should typically be available to all players.
+
+
reanimatemc.execute
+
Default: All players (TRUE)
+
Allows: Players to execute KO'd players by holding left-click on them.
+
Note: Essential for PvP gameplay. Can be restricted on non-PvP servers.
+
+
reanimatemc.bypass
+
Default: OP only
+
Effect: Players with this permission die instantly when health reaches zero, completely bypassing the KO system.
+
Use case: Staff members who need to respawn quickly, or VIP players who don't want to use the KO system.
+
+
+
+
+
Feature Разрешения
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.knockout
+
OP
+
Force players into KO state via command
+
+
+
reanimatemc.status
+
TRUE
+
Check player KO status via command
+
+
+
reanimatemc.crawl
+
TRUE
+
Toggle crawling mode when KO'd
+
+
+
reanimatemc.loot
+
OP
+
Access KO'd player inventories (looting)
+
+
+
reanimatemc.removeGlowingEffect
+
OP
+
Remove glowing effects from players
+
+
+
+
+
+
Feature Разрешения Details
+
+
reanimatemc.loot
+
Default: OP only
+
Allows: Opening and accessing the inventory of KO'd players.
+
Important: This is a powerful permission. Consider carefully before granting to regular players.
+
Конфигурация: Looting can be completely disabled in config.yml with looting.enabled: false
+
+
reanimatemc.crawl
+
Default: All players (TRUE)
+
Allows: KO'd players to toggle between immobilized and crawling states using /reanimatemc crawl
+
Конфигурация: Crawling must be enabled in config: prone.allow_crawl: true
+
+
+
+
+
Система NPC Разрешения
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.summon
+
FALSE
+
Base permission to summon any NPC
+
+
+
reanimatemc.summon.use.golem
+
FALSE
+
Permission to summon Iron Golem reanimators
+
+
+
reanimatemc.summon.use.healer
+
FALSE
+
Permission to summon Healing Golem reanimators
+
+
+
reanimatemc.summon.use.protector
+
FALSE
+
Permission to summon Protective Golem reanimators
+
+
+
reanimatemc.summon.overridecost
+
OP
+
Bypass summon costs and cooldowns
+
+
+
reanimatemc.summon.admin
+
OP
+
Admin control over all NPCs (dismiss any NPC)
+
+
+
+
+
+
NPC Разрешения Details
+
+
reanimatemc.summon
+
Default: No one (FALSE)
+
Purpose: Base permission required for any summon commands. Players need this AND a specific type permission.
+
+
Type-Specific Разрешения
+
How it works: Players must have BOTH reanimatemc.summon AND the specific type permission.
+
Example setup:
+
# VIP Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+
+# Premium Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+
+# Elite Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+reanimatemc.summon.use.protector: true
+
+
NPC Type Comparison
+
+
Golem - Basic reanimator, follows owner and revives KO'd players
+
Healer - Specialized in revival, faster revive times (potential future feature)
+
Protector - Can revive AND attacks hostile mobs, has more health
+
+
+
reanimatemc.summon.overridecost
+
Default: OP only
+
Bypasses:
+
+
Cooldown timers (default: 5 minutes between summons)
+
Item costs (if configured to require items)
+
Max summons per player limit
+
+
+
reanimatemc.summon.admin
+
Default: OP only
+
Allows: Dismissing any player's NPCs, viewing all active NPCs, and full control over the NPC system.
reanimatemc.*: true
+(Full access to all features)
+
+
+
+
+
+
LuckPerms Конфигурация Examples
+
+
+
Basic Setup
+
Using LuckPerms commands to set up permissions:
+
+
Default Group
+
/lp group default permission set reanimatemc.revive true
+/lp group default permission set reanimatemc.execute true
+/lp group default permission set reanimatemc.status true
+/lp group default permission set reanimatemc.crawl true
+
+
VIP Group
+
/lp creategroup vip
+/lp group vip parent add default
+/lp group vip permission set reanimatemc.summon true
+/lp group vip permission set reanimatemc.summon.use.golem true
+
+
Premium Group
+
/lp creategroup premium
+/lp group premium parent add vip
+/lp group premium permission set reanimatemc.summon.use.healer true
+
+
Elite Group
+
/lp creategroup elite
+/lp group elite parent add premium
+/lp group elite permission set reanimatemc.summon.use.protector true
+/lp group elite permission set reanimatemc.summon.overridecost true
+
+
Moderator Group
+
/lp creategroup moderator
+/lp group moderator parent add default
+/lp group moderator permission set reanimatemc.knockout true
+/lp group moderator permission set reanimatemc.loot true
+/lp group moderator permission set reanimatemc.removeGlowingEffect true
+
+
Admin Group
+
/lp creategroup admin
+/lp group admin permission set reanimatemc.* true
+
+
+
+
+
Permission Wildcards
+
+
+
Using Wildcards
+
You can use wildcards to grant multiple permissions at once:
+
+
+
+
+
Wildcard
+
Effect
+
+
+
+
+
reanimatemc.*
+
Grants ALL ReanimateMC permissions
+
+
+
reanimatemc.summon.*
+
Grants all summon-related permissions
+
+
+
reanimatemc.summon.use.*
+
Grants permission to summon all NPC types
+
+
+
+
+
Wildcard Examples
+
# Give all summon permissions
+/lp group vip permission set reanimatemc.summon.* true
+
+# Give all permissions except admin
+/lp group moderator permission set reanimatemc.* true
+/lp group moderator permission set reanimatemc.admin false
+/lp group moderator permission set reanimatemc.bypass false
+
+
+
+
+
Best Practices
+
+
+
+
+
+
+
Default Разрешения
+
Keep revive and execute available to all players for core gameplay. Restrict loot to prevent abuse.
+
+
+
+
+
+
+
Monetization
+
NPC summon permissions work great as donor perks. Create tiers: Golem (VIP) → Healer (Premium) → Protector (Elite).
+
+
+
+
+
+
+
Admin Access
+
Reserve admin, bypass, and summon.admin for trusted staff only to maintain server balance.
+
+
+
+
+
+
+
Balance
+
Consider your server type: PvP servers may restrict execute, RP servers may disable it entirely via config.
+ ReanimateMC provides a comprehensive API for developers to integrate the KO system into their plugins.
+ You can listen to events, access the KO manager, and programmatically control the KO state of players.
+
+
+
+
+
Getting Started
+
+
+
Adding ReanimateMC as a Dependency
+
+
plugin.yml
+
name: YourPlugin
+version: 1.0.0
+depend: [ReanimateMC]
+# or for optional dependency
+# softdepend: [ReanimateMC]
@EventHandler
+public void onPlayerKO(PlayerKOEvent event) {
+ Player player = event.getPlayer();
+ int duration = event.getDuration();
+
+ // Custom logic when player enters KO
+ if (player.hasPermission("server.vip")) {
+ // VIP players get longer KO duration
+ // Note: Cannot modify duration directly
+ getLogger().info(player.getName() + " is VIP, extending KO");
+ }
+
+ // Cancel KO for staff members
+ if (player.hasPermission("server.staff")) {
+ event.setCancelled(true);
+ player.sendMessage("Staff bypass: KO cancelled");
+ }
+
+ // Notify team members
+ notifyTeam(player, duration);
+}
+
+
+
+
PlayerReanimatedEvent
+
Fired when a player is revived from KO state.
+
+
Methods:
+
+
+
+
Method
+
Return Type
+
Description
+
+
+
+
+
getPlayer()
+
Player
+
The player being revived
+
+
+
getReanimator()
+
Player
+
Player performing revival (can be null)
+
+
+
isSuccessful()
+
boolean
+
Whether revival was successful
+
+
+
getTimestamp()
+
long
+
Timestamp of revival attempt
+
+
+
getPlayerName()
+
String
+
Name of revived player
+
+
+
getReanimatorName()
+
String
+
Name of reanimator (or "Unknown")
+
+
+
+
+
Example Usage:
+
@EventHandler
+public void onPlayerRevived(PlayerReanimatedEvent event) {
+ Player patient = event.getPlayer();
+ Player medic = event.getReanimator();
+ boolean successful = event.isSuccessful();
+
+ if (!successful) return;
+
+ // Reward the medic
+ if (medic != null) {
+ // Give XP
+ medic.giveExp(50);
+
+ // Economy reward (if you have Vault)
+ economy.depositPlayer(medic, 100.0);
+
+ // Send message
+ medic.sendMessage(ChatColor.GREEN +
+ "You saved " + patient.getName() + "!");
+
+ // Add to statistics
+ addToStats(medic, "revivals_performed");
+ }
+
+ // Log the revival
+ logRevival(patient, medic, event.getTimestamp());
+}
+
+
+
+
+
KOManager API
+
+
+
Manager Methods
+
The KOManager provides methods to interact with the KO system programmatically.
+
+
+
+
+
Method
+
Description
+
+
+
+
+
isKO(Player player)
+
Check if player is currently in KO state
+
+
+
getKOData(Player player)
+
Get KOData object for player (can be null)
+
+
+
setKO(Player player)
+
Set player to KO state (default duration)
+
+
+
setKO(Player player, int seconds)
+
Set player to KO for specific duration
+
+
+
revive(Player target, Player reviver)
+
Revive a KO'd player
+
+
+
execute(Player player)
+
Execute a KO'd player (permanent death)
+
+
+
toggleCrawl(Player player)
+
Toggle crawling mode for KO'd player
+
+
+
sendDistress(Player player)
+
Send distress signal for KO'd player
+
+
+
handleLogout(Player player)
+
Handle player logout while KO'd
+
+
+
pullOfflineKO(UUID uuid)
+
Get remaining KO time for offline player
+
+
+
+
+
+
+
Example Usage:
+
// Check if player is KO'd
+if (koManager.isKO(player)) {
+ player.sendMessage("You are currently KO'd!");
+}
+
+// Force KO a player
+koManager.setKO(player, 30); // 30 seconds
+
+// Revive a player
+if (koManager.isKO(target)) {
+ koManager.revive(target, reviverPlayer);
+}
+
+// Execute a KO'd player
+if (koManager.isKO(target)) {
+ koManager.execute(target);
+}
+
+// Get KO data
+KOData koData = koManager.getKOData(player);
+if (koData != null && koData.isKo()) {
+ // Player is KO'd, access KO-specific data
+ long endTime = koData.getEndTimestamp();
+ boolean crawling = koData.isCrawling();
+}
+
+
+
+
+
Integration Examples
+
+
+
+
Economy Integration
+
@EventHandler
+public void onRevive(PlayerReanimatedEvent e) {
+ if (e.isSuccessful() && e.getReanimator() != null) {
+ Player medic = e.getReanimator();
+ economy.depositPlayer(medic, 100.0);
+ medic.sendMessage("§a+$100 for revival!");
+ }
+}
+ Complete list of all available commands in ReanimateMC
+
+
+
+
Command Overview
+
+ All ReanimateMC commands start with /reanimatemc or the shorter alias /rmc.
+ 命令 are organized by category: Administrative, Player Management, NPC系统, and Utility commands.
+
+
+
+
+
Administrative 命令
+
+
+
+
+
Command
+
Description
+
Permission
+
Usage
+
+
+
+
+
/reanimatemc reload
+
Reload plugin configuration and language files
+
reanimatemc.admin
+
/reanimatemc reload
+
+
+
/reanimatemc config
+
Open GUI configuration interface
+
reanimatemc.admin
+
/reanimatemc config
+
+
+
/reanimatemc setup
+
Mark initial setup as complete
+
reanimatemc.admin
+
/reanimatemc setup
+
+
+
+
+
+
Administrative 命令 Details
+
+
/reanimatemc reload
+
Purpose: Reloads all configuration files and language files without restarting the server.
+
When to use: After making changes to config.yml or language files.
+
Example:
+
/reanimatemc reload
+
Output: "配置 and language reloaded!"
+
+
/reanimatemc config
+
Purpose: Opens an interactive GUI where you can configure all plugin settings.
+ Un plugin Minecraft révolutionnaire qui introduit un état KO (Knockout) au lieu de la mort instantanée.
+ Les joueurs peuvent être réanimés par leurs coéquipiers ou exécutés par leurs ennemis, créant un gameplay dynamique et stratégique.
+
+ Complete list of all permissions for ReanimateMC
+
+
+
+
Permission Overview
+
+ ReanimateMC uses a comprehensive permission system to control access to features and commands.
+ 权限 are organized into categories: Core 权限, Feature 权限, NPC 权限, and Command 权限.
+
+
+ Permission Plugin Required: You need a permission plugin like LuckPerms, 权限Ex, or GroupManager to manage these permissions.
+
+
+
+
+
Core 权限
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.admin
+
OP
+
Grants access to all administrative commands and GUI config
+
+
+
reanimatemc.revive
+
TRUE
+
Ability to revive KO'd players manually
+
+
+
reanimatemc.execute
+
TRUE
+
Ability to execute KO'd players permanently
+
+
+
reanimatemc.bypass
+
OP
+
Bypass the KO system entirely - die instantly instead of entering KO
+
+
+
+
+
+
Core 权限 Details
+
+
reanimatemc.admin
+
Default: OP only
+
Grants access to:
+
+
/reanimatemc reload - Reload configuration
+
/reanimatemc config - Open GUI configuration
+
/reanimatemc setup - Complete initial setup
+
/reanimatemc revive - Force revive players
+
/reanimatemc knockout - Force KO players
+
All configuration changes via GUI
+
+
+
reanimatemc.revive
+
Default: All players (TRUE)
+
Allows: Players to revive KO'd teammates by crouching near them with the required item.
+
Note: This is a core gameplay mechanic and should typically be available to all players.
+
+
reanimatemc.execute
+
Default: All players (TRUE)
+
Allows: Players to execute KO'd players by holding left-click on them.
+
Note: Essential for PvP gameplay. Can be restricted on non-PvP servers.
+
+
reanimatemc.bypass
+
Default: OP only
+
Effect: Players with this permission die instantly when health reaches zero, completely bypassing the KO system.
+
Use case: Staff members who need to respawn quickly, or VIP players who don't want to use the KO system.
+
+
+
+
+
Feature 权限
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.knockout
+
OP
+
Force players into KO state via command
+
+
+
reanimatemc.status
+
TRUE
+
Check player KO status via command
+
+
+
reanimatemc.crawl
+
TRUE
+
Toggle crawling mode when KO'd
+
+
+
reanimatemc.loot
+
OP
+
Access KO'd player inventories (looting)
+
+
+
reanimatemc.removeGlowingEffect
+
OP
+
Remove glowing effects from players
+
+
+
+
+
+
Feature 权限 Details
+
+
reanimatemc.loot
+
Default: OP only
+
Allows: Opening and accessing the inventory of KO'd players.
+
Important: This is a powerful permission. Consider carefully before granting to regular players.
+
配置: Looting can be completely disabled in config.yml with looting.enabled: false
+
+
reanimatemc.crawl
+
Default: All players (TRUE)
+
Allows: KO'd players to toggle between immobilized and crawling states using /reanimatemc crawl
+
配置: Crawling must be enabled in config: prone.allow_crawl: true
+
+
+
+
+
NPC系统 权限
+
+
+
+
+
Permission
+
Default
+
Description
+
+
+
+
+
reanimatemc.summon
+
FALSE
+
Base permission to summon any NPC
+
+
+
reanimatemc.summon.use.golem
+
FALSE
+
Permission to summon Iron Golem reanimators
+
+
+
reanimatemc.summon.use.healer
+
FALSE
+
Permission to summon Healing Golem reanimators
+
+
+
reanimatemc.summon.use.protector
+
FALSE
+
Permission to summon Protective Golem reanimators
+
+
+
reanimatemc.summon.overridecost
+
OP
+
Bypass summon costs and cooldowns
+
+
+
reanimatemc.summon.admin
+
OP
+
Admin control over all NPCs (dismiss any NPC)
+
+
+
+
+
+
NPC 权限 Details
+
+
reanimatemc.summon
+
Default: No one (FALSE)
+
Purpose: Base permission required for any summon commands. Players need this AND a specific type permission.
+
+
Type-Specific 权限
+
How it works: Players must have BOTH reanimatemc.summon AND the specific type permission.
+
Example setup:
+
# VIP Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+
+# Premium Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+
+# Elite Group
+reanimatemc.summon: true
+reanimatemc.summon.use.golem: true
+reanimatemc.summon.use.healer: true
+reanimatemc.summon.use.protector: true
+
+
NPC Type Comparison
+
+
Golem - Basic reanimator, follows owner and revives KO'd players
+
Healer - Specialized in revival, faster revive times (potential future feature)
+
Protector - Can revive AND attacks hostile mobs, has more health
+
+
+
reanimatemc.summon.overridecost
+
Default: OP only
+
Bypasses:
+
+
Cooldown timers (default: 5 minutes between summons)
+
Item costs (if configured to require items)
+
Max summons per player limit
+
+
+
reanimatemc.summon.admin
+
Default: OP only
+
Allows: Dismissing any player's NPCs, viewing all active NPCs, and full control over the NPC system.
reanimatemc.*: true
+(Full access to all features)
+
+
+
+
+
+
LuckPerms 配置 Examples
+
+
+
Basic Setup
+
Using LuckPerms commands to set up permissions:
+
+
Default Group
+
/lp group default permission set reanimatemc.revive true
+/lp group default permission set reanimatemc.execute true
+/lp group default permission set reanimatemc.status true
+/lp group default permission set reanimatemc.crawl true
+
+
VIP Group
+
/lp creategroup vip
+/lp group vip parent add default
+/lp group vip permission set reanimatemc.summon true
+/lp group vip permission set reanimatemc.summon.use.golem true
+
+
Premium Group
+
/lp creategroup premium
+/lp group premium parent add vip
+/lp group premium permission set reanimatemc.summon.use.healer true
+
+
Elite Group
+
/lp creategroup elite
+/lp group elite parent add premium
+/lp group elite permission set reanimatemc.summon.use.protector true
+/lp group elite permission set reanimatemc.summon.overridecost true
+
+
Moderator Group
+
/lp creategroup moderator
+/lp group moderator parent add default
+/lp group moderator permission set reanimatemc.knockout true
+/lp group moderator permission set reanimatemc.loot true
+/lp group moderator permission set reanimatemc.removeGlowingEffect true
+
+
Admin Group
+
/lp creategroup admin
+/lp group admin permission set reanimatemc.* true
+
+
+
+
+
Permission Wildcards
+
+
+
Using Wildcards
+
You can use wildcards to grant multiple permissions at once:
+
+
+
+
+
Wildcard
+
Effect
+
+
+
+
+
reanimatemc.*
+
Grants ALL ReanimateMC permissions
+
+
+
reanimatemc.summon.*
+
Grants all summon-related permissions
+
+
+
reanimatemc.summon.use.*
+
Grants permission to summon all NPC types
+
+
+
+
+
Wildcard Examples
+
# Give all summon permissions
+/lp group vip permission set reanimatemc.summon.* true
+
+# Give all permissions except admin
+/lp group moderator permission set reanimatemc.* true
+/lp group moderator permission set reanimatemc.admin false
+/lp group moderator permission set reanimatemc.bypass false
+
+
+
+
+
Best Practices
+
+
+
+
+
+
+
Default 权限
+
Keep revive and execute available to all players for core gameplay. Restrict loot to prevent abuse.
+
+
+
+
+
+
+
Monetization
+
NPC summon permissions work great as donor perks. Create tiers: Golem (VIP) → Healer (Premium) → Protector (Elite).
+
+
+
+
+
+
+
Admin Access
+
Reserve admin, bypass, and summon.admin for trusted staff only to maintain server balance.
+
+
+
+
+
+
+
Balance
+
Consider your server type: PvP servers may restrict execute, RP servers may disable it entirely via config.