Commands and Permissions - TDHunterrr/Farlands-Lifesteal GitHub Wiki

đŸ•šī¸ Commands & Permissions

Farlands Lifesteal provides full tab-completion and input validation for all commands.


📋 Command Matrix

Command Permission Default Description
/withdrawheart <amount> farlands.lifesteal.use All Players (true) Withdraws current max health into physical Heart items.
/removeheart <player> <amount> farlands.lifesteal.admin Operators (op) Removes max hearts from an online player.
/revive <player> [hearts] farlands.lifesteal.admin Operators (op) Unbans an eliminated player and assigns starting health.

🔍 Detailed Command Usage

1. /withdrawheart <amount>

Converts your active max health into physical Heart items that can be stored in chests or traded with other players.

  • Syntax: /withdrawheart <amount>
  • Arguments:
    • <amount>: Number of hearts to withdraw (integer â‰Ĩ 1).
  • Constraints:
    • You cannot withdraw down to 0 hearts. You must keep at least 1 heart (2.0 HP).
  • Examples:
    /withdrawheart 1
    /withdrawheart 5
    

2. /removeheart <player> <amount>

Administrative command to reduce the maximum health of an online player.

  • Syntax: /removeheart <player> <amount>
  • Arguments:
    • <player>: The online player name.
    • <amount>: Number of hearts to remove.
  • Constraints:
    • Deductions stop at 1 heart (2.0 HP) unless executed as a lethal command.
  • Examples:
    /removeheart Steve 2
    

3. /revive <player> [hearts]

Administrative command to unban an offline/eliminated player and configure their health upon rejoin.

  • Syntax: /revive <player> [hearts]
  • Arguments:
    • <player>: The username or UUID of the eliminated player.
    • [hearts] (Optional): Starting heart count. Must be between 1 and 20 (default: 10).
  • Examples:
    /revive TD_Hunterrr
    /revive TD_Hunterrr 15
    
  • Result:
    • The player is removed from banned-players.json.
    • Next time they log in, their health is set to the specified amount and they receive join protection.

đŸ›Ąī¸ Permission Nodes (LuckPerms Setup)

On servers using LuckPerms or equivalent permission managers:

Default Players Group

lp group default permission set farlands.lifesteal.use true

Admin / Staff Group

lp group admin permission set farlands.lifesteal.admin true
âš ī¸ **GitHub.com Fallback** âš ī¸