03 — Configuration, Essentials & AFK Protection

Beyond elevators and gates, Lift includes built-in lobby essentials, custom chat formatting, a Server Selector GUI, and AFK protection — all configured in plugins/Lift/config.yml.

---

1. Text Formatting & Placeholders

All text fields in config.yml support:

• Classic Minecraft Color Codes: &a, &c, &e, &l, etc.
• Hex Colors: &#72EED2, &#9AFAE5, &#FF5252
• MiniMessage Tags: <gold>, <gray>, <bold>, <br>
• PlaceholderAPI: Any PlaceholderAPI placeholder (such as %player_name%) when PlaceholderAPI is installed.

After editing plugins/Lift/config.yml, apply your changes immediately with:

/essentials reload

(or /lift reload)

---

2. AFK Protection (afk section)

Automatically detects players who stop moving/chatting, displays an on-screen countdown title with sound effects, and kicks them if they remain inactive:

afk:
  enabled: true
  kick_after_minutes: 2
  countdown_seconds: 5
  title: '<gold>%timer%'
  subtitle: '<gray>You are Being AFK!'
  kick_message: '<gold>You are detected AFK!<br><gray>Please Reconnect the server If this is an mistake'

---

3. Join, Leave & Welcome Messages (messages section)

Customize or disable join/leave broadcasts and the personal welcome banner shown to joining players:

messages:
  join: '&#72EED2%player_name% &#B0E5D9joined the network!'
  leave: '&#72EED2%player_name% &#B0E5D9quited the network!'
  welcome:
    - '&f______________________'
    - ' '
    - '&#9AFAE5Welcome to &lLift'
    - ' '
    - '&f______________________'

(Set join: '' or leave: '' to hide join/leave broadcasts completely.)

---

4. Chat Formatting & Private Messages (chat section)

Configures global chat formatting and /msg + /reply private messaging:

chat:
  global_format: '&#72EED2%player_name% &8» &f%message%'
  private_format_sender: '&7To %recipient_name% &8» &f%message%'
  private_format_receiver: '&7%sender_name% &8» &f%message%'
  player_not_found: '&cPlayer not found or offline.'
  no_reply_target: '&cYou have no one to reply to.'

Private Message Commands

• /msg <player> <message> (Aliases: /w, /m, /t, /tell, /whisper, /pm)
• /reply <message> (Alias: /r)

---

5. Spawn & Direct Join Server Selector GUI (spawn, join_items, gui)

Setting the Server Spawn

Stand where players should spawn when they join or type /spawn, and run:

/setspawn

(Requires permission krapple.admin)

Players can teleport to spawn anytime using:

/spawn

Hotbar Server Selector Item (join_items)

Gives players a hotbar item on join that opens the Direct Join GUI when right-clicked:

join_items:
  clock:
    enabled: true
    material: CLOCK
    name: '&#FCC430&lServer Selector'
    lore:
      - '&7ℹ Teleport to your desire server!'
    slot: 6 # Hotbar slot (1-9)

Direct Join GUI (gui.direct_join)

When a player right-clicks the Server Selector item, an inventory GUI opens. Clicking an item with command: 'server <name>' transfers the player to that BungeeCord/Velocity backend server:

gui:
  direct_join:
    title: '&7Direct Join (without Lift)'
    size: 27
    items:
      practice:
        material: IRON_SWORD
        slot: 11
        name: '&#98F6E1Practice'
        lore:
          - '&7ℹ Click to join the practice.'
        command: 'server practice'
      lifesteal:
        material: TURTLE_HELMET
        slot: 15
        name: '&#FF5252LifeSteal'
        lore:
          - '&7ℹ Click to join the LifeSteal.'
        command: 'server lifesteal'

---

6. Commands & Permissions Summary

Command	Permission	Description
/lift ...	krapple.lift.admin	Create, configure, reload, and purge elevators, gates, holograms, and regions.
/essentials reload	krapple.admin	Reloads config.yml.
/setspawn	krapple.admin	Sets the server spawn point at your current location.
/spawn	(None — all players)	Teleports the player to the server spawn point.
/msg <player> <msg>	(None — all players)	Sends a private message to <player>.
/reply <msg>	(None — all players)	Replies to the last player who messaged you.