ESMP - Essential Tools for SMPs v1.1.45

ESMP Plugin – Complete Feature Overview​

ESMP (Essentials SMP Plugin) is a comprehensive all-in-one plugin for Paper/Spigot Minecraft servers. It handles player data management, PvP controls, moderation tools, inventory management, custom recipes, dimension access, and advanced staff utilities—all designed for SMP (Survival Multiplayer) communities.

---

Core Features​

Player Statistics & Leaderboards

• Track player kill/death counts with persistent data storage
• View player stats with /stats [player] command
• Automated leaderboards ranked by kills or deaths with /leaderboard
• Kill/death ratio calculations (displayed as infinity when deaths = 0)

PvP Management

• Global PvP toggle via /pvp command (ops only)
• Blocks PvP damage when either player has PvP disabled
• Prevents harmful splash potions from affecting PvP-disabled players
• Blocks placement of fire/lava near PvP-disabled players
• Simple on/off system—no per-player restrictions

Happy Ghast Speed Buff

• Applies configurable speed boost when players mount happy ghasts
• Adjustable multiplier in config (default 1.5x speed)
• Automatically removes buff on dismount

Moderation Tools

• Ban/unban players (temporary or permanent) via /ban, /permban, /unban
• Ban by IP address via /ban-ip, /tempban-ip
• Mute/unmute players (temporary or permanent) via /mute, /permmute, /unmute
• Mute by IP via /mute-ip, /tempmute-ip
• Freeze/unfreeze players (persists offline) via /freeze (aliases: /f, /ss, /screenshare)
• Ban offline players via /oban
• Kick players via /kick
• Clear chat for all players or specific players via /clearchat

Word Filter & Auto-Mute

• Automatic blacklist detection with configurable word list
• Levenshtein distance matching for misspelling detection
• Auto-mute with configurable duration

Inventory & Ender Chest Management

• View and edit online player inventories via /invsee <player>
• View and edit online player ender chests via /esee <player>
• View offline player saved inventories (read-only) via /oinvsee <player>
• View offline player saved ender chests (read-only) via /oesee <player>
• Live two-way sync for online inventory edits
• Tab-completion for both online and offline player names

Item Limits & Cooldowns

• Enchantment level caps per item (set to 0 to forbid)
• Item stack count limits (players cannot exceed)
• Item use cooldowns (applies to any item type)
• Mace wind-burst ground-slam cooldown (separate control)
• Potion effect strength and duration limits
• Configuration-based (no code editing required)

Custom Recipes

• Define custom shaped and shapeless crafting recipes
• Browse all custom recipes in an interactive GUI via /ezrecipes
• Navigate recipes with Previous/Next buttons
• Persistent across server resets

Dimension Access Control

• Toggle player access to the Nether and The End per dimension
• Default-unlocked dimensions configuration (server-wide or per-player tracking planned)
• Command: /dimensiontoggle [nether|end]

Staff Utilities

• Gamemode switching: /gmc, /gms, /gma, /gmsp
• Complete vanish (invisible, no tab list, no join/quit messages) via /vanish
• Teleport to offline player's last known location via /otp <player>
• Send centered title announcements to all players via /announce <color> "message"
• Admin reload config without restart via /esmp reload

---

Placeholders (PlaceholderAPI)

• %esmp_kills% – player kill count
• %esmp_deaths% – player death count
• %esmp_kd% – kill/death ratio (2 decimal places)
• %esmp_frozen% – frozen status
• %esmp_vanished% – vanish status
• %esmp_pvp% – global PvP enabled
• %esmp_op% – operator status

Technical Highlights​

• Data Persistence: All player data (stats, inventory snapshots, ender chest contents, location) saved to YAML files
• Performance Optimized: Efficient caching, lazy loading, minimal database overhead
• Soft Dependencies: Gracefully supports PlaceholderAPI and ProtocolLib when installed
• Configuration-Driven: Limits, cooldowns, and settings configurable via YAML without code changes
• Color Code Support: Full legacy color code (§) support in all messages
• UTF-8 Encoding: Proper international character support
• Google Java Style Compliance: Static analysis (Checkstyle, SpotBugs) enforced
• Tab Completion: Smart auto-completion for player names and command arguments

Permissions​

All commands use the base permission esmp.* with granular sub-permissions for each feature. Most default to operator level; player commands like /stats and /leaderboard are public by default.