SMPEssentialsV1 — 描述
一款全面且对服务器友好的 Essentials 插件,专为竞技或社区 SMP 服务器设计。它通过可配置的功能强制执行公平的游戏平衡、物品限制和世界限制——所有功能均可在 config.yml 中进行切换。每一条规则(从药水禁用到下界合金防升级)都可以单独开启或关闭,并支持实时重载和控制台反馈。该插件还引入了宽限期系统、PvP 开关、维度封锁、物品冷却时间和物品上限,所有这些功能都集成在一个统一的核心中。
SMPEssentialsV1 提供了强大的管理工具,用于控制合成、附魔和物品行为,无需依赖多个独立插件。每个模块都是自包含的、可重载的,并针对 Paper/Spigot 1.21 服务器进行了优化。
?️ 亮点
基于特性的系统
每个游戏规则或限制都是一个实现 Feature 接口的独立“特性”。特性会自动注册自己、处理重载,并将状态记录到控制台。
公平游戏与平衡控制
全局限制保护(Protection)和锋利(Sharpness)等附魔等级。
禁用过强的机制,如下界合金升级、药水或末影珍珠。
通过简单的管理员开关封锁特定维度(下界、末地)。
通过向加入的玩家发送模组禁用 tellraw 数据包来禁用 Xaero’s Minimap 雷达。
动态宽限期系统
使用 /graceperiod <seconds> 启动全服无 PvP 的宽限期。
显示带有颜色和进度更新的全球 Boss 条倒计时。
自动将重新加入的玩家添加到 Boss 条中。
在计时器期间取消饥饿损失和 PvP 伤害。
当时间结束时,所有玩家都会看到标题:“宽限期已结束 – PvP 现已启用!”
物品冷却
通过 /setcooldown 自定义武器、工具、图腾、三叉戟、弓、盾牌和消耗品的冷却时间。
冷却时间在 itemcooldowns.yml 中定义,并在重启后保存。
支持单独的命令来检查、重置或列出冷却时间。
物品上限执行
通过 /itemlimit <amount> 限制每个玩家持有的特定物品数量。
多余的物品会自动掉落至地面。
限制保存在 itemlimits.yml 中。
每 2 秒或在库存交互后自动重新检查。
完全可重载的配置
所有特性、冷却时间和设置均使用 /smpessentials reload 即时重载。
⚙️ 包含的特性(在 config.yml → features: 中切换)
特性 描述
BanNetheriteFeature 防止使用锻造台将钻石装备/工具升级为下界合金。禁用 NETHERITE_UPGRADE_SMITHING_TEMPLATE 配方。
BanPotionsFeature 阻止所有药水使用(饮用、投掷瓶、滞留瓶)。取消交互、投掷,并将药水恢复至背包。
BanTier2PotionsFeature 停止酿造二级(基于发光粉)药水。取消酿造事件并警告附近的玩家。
BanShieldsFeature 禁用盾牌的右键格挡,并移除其冷却行为。
DisableEnderPearlsFeature 防止玩家使用或投掷末影珍珠。取消珍珠发射并恢复物品。
ProtectionLimitFeature 全局限制保护附魔等级(最大等级可配置)。自动修正现有装备。
SharpnessLimitFeature 全局限制剑/斧/三叉戟上的锋利等级。自动降级过高附魔等级的物品。
XaeroMinimapDisableFeature 向所有加入的玩家发送 Xaero’s Minimap “禁用雷达” 的 tellraw 代码。
? 世界与 PvP 控制
命令 功能
/netherblock 切换所有玩家的传送门使用权限(下界)。
/endblock 切换所有玩家的传送门使用权限(末地)。
/pvp 全服切换 PvP(适用于活动)。
被封锁的传送门在使用时会发送可定制的“维度已封锁”消息。
⏳ 宽限期系统
命令 功能
/graceperiod <seconds> 启动全服计时器,禁用 PvP 和饥饿损失。显示全球 Boss 条。
/endgraceperiod 手动结束当前的宽限期。
宽限期倒计时以绿色 Boss 条显示。
重新加入的玩家会自动被添加回 Boss 条。
在整个持续期间,饥饿流失和 PvP 均被锁定。
到期时,所有人都会收到一个全屏标题,宣布 PvP 回归。
? 物品管理
命令 描述 权限
/itemlimit <amount> 设置持有物品的最大堆叠数量。自动丢弃多余物品。 smpessentials.admin
/resetlimit <item> 移除特定或当前持有物品的限制。 smpessentials.admin
/setcooldown <item> <seconds> 为材质添加冷却时间(存储在 itemcooldowns.yml 中)。 smpessentials.admin
/resetcooldown <item all> 移除一个或所有冷却设置。
/checkcooldown <item> 显示特定物品的冷却时间。 smpessentials.admin
? 权限
权限 描述 默认值
smpessentials.admin 需要所有管理命令(PvP、限制、冷却)。 OP
smpessentials.reload 允许使用 /smpessentials reload。 OP
? 关键配置部分
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
单独的文件:
itemlimits.yml → 存储按材质划分的限制。
itemcooldowns.yml → 存储冷却时间(以秒为单位)。
? 技术说明
完全模块化:每个特性都实现 Feature 接口,以实现干净的重载和日志记录。
宽限期和冷却任务在插件禁用时会被安全取消。
物品上限检查和冷却每几个刻异步运行,以最小化性能开销。
兼容 Paper/Spigot 1.21+。
✅ 测试环境
Paper/Spigot 1.21 (API 1.21)
兼容轻量级生存 SMP 和竞技 PvP 服务器。
简而言之:
SMPEssentialsV1 让你完全掌控游戏平衡、公平性和服务器流程——同时保持模块化、可配置和可重载。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧