Landens-Essentials

# Landen's Essentials **AI Disclosure:** A substantial portion of this plugin's code was generated with AI assistance. Review and test the plugin before using it on a production server. A bloat-free PaperMC plugin providing teleport requests, endermen grief prevention, and other QOL features for Minecraft servers. ## Features - Teleportation Request System - Endermen Grief Prevention - Can be disabled in config.yml - Message of the Day System - Supports variables - `{username}` / `{player}` – Player's username - `{playtime}` – Player's formatted playtime (e.g. `3h 15m`) - `{online}` – Online player count - `{max_online}` – Server maximum player capacity - `{world}` – Player's current world name - Supports color formatting with standard `&` codes (`&e`, `&a`, `&b`, etc.). - Teleport to spawn command - AFK (Away From Keyboard) - Toggle AFK manually via `/afk` - Automatic AFK after inactivity (configurable, default: 5 minutes) - Ping Checker - View your own ping or another player's ping via `/ping` ## Commands & Permissions | Command | Usage | Description | Permission | Default | | :--- | :--- | :--- | :--- | :--- | | `/tpa` | `/tpa [username]` | Print help menu or send TPA request | `landensessentials.tpa` | `true` | | `/tpaccept` | `/tpaccept` | Accept pending teleport request | `landensessentials.tpaccept` | `true` | | `/tpadeny` | `/tpadeny` | Deny pending teleport request | `landensessentials.tpadeny` | `true` | | `/tpacancel` | `/tpacancel` | Cancel your own outgoing teleport request | `landensessentials.tpacancel` | `true` | | `/tpahere` | `/tpahere ` | Send TPAHere request | `landensessentials.tpahere` | `true` | | `/motd` | `/motd` | Display MOTD in player's chat | `landensessentials.motd` | `true` | | `/spawn` | `/spawn` | Teleport to the overworld spawn point | `landensessentials.spawn` | `true` | | `/afk` | `/afk` | Toggle your AFK status | `landensessentials.afk` | `true` | | `/ping` | `/ping [username]` | View your own ping or another player's ping | `landensessentials.ping` | `true` | *I recommend [LuckPerms](https://modrinth.com/plugin/luckperms) for controlling user permissions* --- ## Configuration (`config.yml`) ```yaml endermen: # When set to true, Endermen cannot pick up or place blocks. prevent-griefing: true teleport: # Number of seconds before a teleport request expires. request-timeout-seconds: 60 # Horizontal and vertical block radius to search for a safe landing location. safe-search-radius: 4 # Delay before teleporting to spawn in seconds. 0 = no delay. spawn-teleport-delay-seconds: 5 motd: # Enable MOTD display on player join. enabled: true # Available placeholders: # {username} - Player's username # {playtime} - Formatted player playtime (e.g. "12h 45m") # {online} - Current online player count # {max_online} - Maximum player limit # {world} - Player's current world name message: - "&e==========================================" - "&bWelcome to the server, &f{username}&b!" - "&7Playtime: &a{playtime} &7World: &a{world}" - "&7Online Players: &a{online}&7/&a{max_online}" - "&e==========================================" afk: # Number of seconds of inactivity before a player is automatically marked as AFK. # Default is 300 seconds (5 minutes). Set to 0 or negative to disable auto-AFK. auto-afk-seconds: 300 # Format for player name shown in TAB when marked as AFK. # Available placeholders: {username} tab-format: "&7AFK-&f{username}" # Broadcast AFK status changes to the server. broadcast: true ```