SMP Essentials V1

SMPEssentialsV1 — Description

A comprehensive, server-friendly essentials plugin designed for competitive or community SMP servers. It enforces fair gameplay balance, item limitations, and world restrictions through configurable features — all toggleable in config.yml. Every rule (from potion bans to netherite prevention) can be turned on or off individually, with real-time reloading and console feedback. The plugin also introduces a grace period system, PvP toggle, dimension blocking, item cooldowns, and item limits, all integrated into one unified core.

SMPEssentialsV1 provides powerful administrative tools for controlling crafting, enchanting, and item behavior without needing multiple standalone plugins. Each module is self-contained, reloadable, and optimized for Paper/Spigot 1.21 servers.

🛡️ Highlights

Feature-based System Each game rule or restriction is an independent "Feature" implementing the Feature interface. Features automatically register themselves, handle reloads, and log their state to the console.

Fair Gameplay & Balance Controls

Limit enchantments like Protection and Sharpness globally.

Disable overpowered mechanics such as Netherite upgrades, potions, or ender pearls.

Block specific dimensions (Nether, End) with simple admin toggles.

Disable Xaero’s Minimap radar by sending its mod-disable tellraw packet to joining players.

Dynamic Grace Period System Start server-wide no-PvP grace periods with /graceperiod <seconds>.

Displays a global boss bar countdown with color and progress updates.

Automatically re-adds joining players to the boss bar.

Cancels hunger loss and PvP damage during the timer.

When it ends, all players see a title: “Grace Period is now over – PvP is now enabled!”

Item Cooldowns Customize cooldowns for weapons, tools, totems, tridents, bows, shields, and consumables via /setcooldown. Cooldowns are defined in itemcooldowns.yml and saved across restarts. Supports separate commands to check, reset, or list cooldowns.

Item Limit Enforcement Limit how many of a specific item each player can hold via /itemlimit <amount>.

Excess items automatically drop to the ground.

Limits persist in itemlimits.yml.

Automatically rechecked every 2 seconds or after inventory interactions.

Fully Reloadable Configuration All features, cooldowns, and settings reload instantly using /smpessentials reload.

⚙️ Included Features (Toggle in config.yml → features:) Feature Description BanNetheriteFeature Prevents upgrading diamond gear/tools to netherite using the smithing table. Disables NETHERITE_UPGRADE_SMITHING_TEMPLATE recipes. BanPotionsFeature Blocks all potion usage (drinking, splash, lingering). Cancels interactions, throws, and restores the potion to inventory. BanTier2PotionsFeature Stops brewing Tier II (glowstone-based) potions. Cancels the brew event and warns nearby players. BanShieldsFeature Disables right-click blocking with shields and removes their cooldown behavior. DisableEnderPearlsFeature Prevents players from using or throwing ender pearls. Cancels pearl launch and restores the item. ProtectionLimitFeature Limits Protection enchantment level globally (max level configurable). Auto-corrects existing gear. SharpnessLimitFeature Limits Sharpness level on swords/axes/tridents globally. Automatically downgrades over-leveled items. XaeroMinimapDisableFeature Sends the Xaero’s Minimap “disable radar” tellraw code to all joining players. 🧭 World & PvP Controls Command Function /netherblock Toggles Nether portal usage for all players. /endblock Toggles End portal usage for all players. /pvp Toggles PvP server-wide (useful for events).

Blocked portals send customizable “dimension blocked” messages when used.

⏳ Grace Period System Command Function /graceperiod <seconds> Starts a server-wide timer disabling PvP and hunger loss. Displays global boss bar. /endgraceperiod Ends an active grace period manually.

Grace period countdown appears as a green boss bar.

Rejoining players are automatically added back to the bar.

Hunger drain and PvP are locked for the entire duration.

On expiration, everyone gets a full-screen title announcing PvP return.

💬 Item Management Command Description Permission /itemlimit <amount> Sets max stackable count for held item. Drops extras automatically. smpessentials.admin /resetlimit <item> Removes a specific or held item’s limit. smpessentials.admin /setcooldown <item> <seconds> Adds cooldown for a material (stored in itemcooldowns.yml). smpessentials.admin /resetcooldown <item all> Removes one or all cooldown settings. /checkcooldown <item> Displays the cooldown time for a specific item. smpessentials.admin 🔑 Permissions Permission Description Default smpessentials.admin Required for all administrative commands (PvP, limits, cooldowns). OP smpessentials.reload Allows use of /smpessentials reload. OP 📂 Key Config Sections features: BAN_NETHERITE: true BAN_POTIONS: true BAN_TIER_2_POTIONS: true BAN_SHIELDS: true DISABLE_ENDER_PEARLS: true PROT_LIMIT: 3 SHARPNESS_LIMIT: 4 XAERO_MINIMAP_DISABLE: true

dimension-blocking: nether-blocked: false end-blocked: false

pvp: disabled: false

Separate files:

itemlimits.yml → Stores per-material limits.

itemcooldowns.yml → Stores cooldowns (in seconds).

🧩 Technical Notes

Fully modular: Each feature implements Feature for clean reloading and logging.

Grace period & cooldown tasks are safely cancelled on plugin disable.

Item limit checks and cooldowns run asynchronously every few ticks for minimal performance cost.

Paper/Spigot 1.21+ compatible.

✅ Tested On

Paper/Spigot 1.21 (API 1.21) Compatible with lightweight survival SMP and competitive PvP servers.

In short: SMPEssentialsV1 gives you complete control over gameplay balance, fairness, and server flow — all while staying modular, configurable, and reloadable.