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 .

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 .

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 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 Sets max stackable count for held item. Drops extras automatically. smpessentials.admin
/resetlimit Removes a specific or held item’s limit. smpessentials.admin
/setcooldown Adds cooldown for a material (stored in itemcooldowns.yml). smpessentials.admin
/resetcooldown <item all> Removes one or all cooldown settings.
/checkcooldown 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.