⚡ EnderPearlLogic — 高级末影珍珠控制系统
一款轻量级、功能强大且完全可配置的插件,让你对末影珍珠的行为拥有完全的控制权。
EnderPearlLogic 通过添加冷却时间、经济系统、特效、音效和安全改进来增强游戏体验——所有设计都旨在稳定、优化且易于配置。
✨ 核心特性
- 自定义冷却系统: 控制每个玩家的末影珍珠使用
- 防垃圾信息保护: 防止玩家在冷却期间发送消息刷屏
- 管理员绕过: 工作人员无视冷却和限制
- Vault 经济支持(可选): 每次使用末影珍珠时向玩家收费
- 末影螨控制系统: 启用或禁用生成,并自定义生成几率
- 传送特效: 完全可配置(类型、持续时间、增幅器)
- 自定义音效: 投掷与命中时的音量与音调控制
- 自定义伤害系统: 修改或禁用末影珍珠的伤害
? 高级系统
- PlaceholderAPI 支持(可选)
- 可配置的占位符输出
- 实时冷却追踪
- 更新检查系统
- 自动配置更新器(不会导致配置文件损坏)
- 安全且优化的核心:
- 尊重其他插件
- 防止重复执行
- 无内存泄漏
- 极小的性能影响
? PlaceholderAPI 集成
EnderPearlLogic 支持 PlaceholderAPI,用于在计分板、全息图、标签页列表等中显示动态数据。
可用占位符
| 占位符 |
描述 |
%enderpearllogic_cooldown_remaining% |
剩余冷却时间 |
%enderpearllogic_cooldown_status% |
冷却状态(就绪 / 冷却中) |
%enderpearllogic_cooldown_active% |
返回 true 或 false |
所有占位符值均可在 config.yml 中进行完全配置。
⚙️ 命令与权限
命令
| 命令 |
描述 |
权限 |
/enderpearllogic reload |
重新加载插件配置 |
enderpearllogic.reload |
权限
| 权限 |
描述 |
enderpearllogic.use |
使用末影珍珠 |
enderpearllogic.reload |
重新加载配置 |
enderpearllogic.command |
使用基础命令 |
enderpearllogic.bypass |
忽略冷却与限制 |
enderpearllogic.update |
接收更新通知 |
⚙️ 配置
EnderPearlLogic 提供完全可自定义的配置系统:
- 自动配置更新(安全地添加缺失选项)
- 向后兼容旧版配置
- 对所有值进行安全验证
- 消息、占位符、音效和特效均可完全配置
config.yml
# ============================================================
# EnderPearlLogic v1.5
# 默认配置,兼容公共 Spigot 布局。
#
# 支持与 & 符号一起使用的颜色代码。
# 将任何消息设置为 "none" 以停止发送该消息。
# 拥有 enderpearllogic.bypass 权限的玩家将忽略冷却时间和经济成本。
# 无效的值将作为警告记录,并被安全地替换或跳过。
#
# Bukkit 官方关于可配置 ID 的文档:
# 药水效果: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
# 音效: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
# 请使用你服务器版本上可用的 ID,例如 SPEED 或 ENTITY_PLAYER_TELEPORT。
# ============================================================
# ============================================================
# 权限参考
# 这些权限在 plugin.yml 中注册。
# 它们不在这里配置;请通过你的权限
# 插件(例如 LuckPerms)进行管理。
#
# enderpearllogic.use
# 允许玩家使用由本插件控制的末影珍珠。
# 默认:所有人。
#
# enderpearllogic.bypass
# 绕过冷却时间和经济成本。
# 默认:操作员。
#
# enderpearllogic.reload
# 允许使用 /enderpearllogic reload 和 /eplreload。
# 默认:操作员。
#
# enderpearllogic.command
# 允许不使用 reload 参数地使用 /enderpearllogic。
# 没有此权限的玩家将看不到命令用法提示。
# 默认:操作员。
#
# enderpearllogic.update
# 当启用 update-checker 时,允许接收更新通知。
# 操作员也会收到更新通知。
# 默认:操作员。
# ============================================================
# 使用末影珍珠的冷却时间(秒)。
# 除非玩家拥有 enderpearllogic.bypass 权限,否则需要 enderpearllogic.use。
# 设置为 0 以禁用冷却时间,同时保持插件的其他功能处于活动状态。
cooldown-time: 10
# 同一玩家冷却消息之间的最小延迟(秒)。
# 仅当玩家实际尝试在冷却期间使用末影珍珠时,插件才会检查此项。将此设置为 0 以在每次被阻止的尝试时显示消息。
cooldown-message-delay: 1
messages:
# 插件消息前添加的前缀。使用 "none" 以禁用它。
prefix: "&bEnderPearlLogic &8>> "
# 占位符: {time}, {seconds}, %time%, %seconds%.
cooldown: "&7你必须等待 &c{time} &7秒才能再次使用末影珍珠。"
# 成功投出珍珠时发送。
use: "&7你使用了末影珍珠!正在传送..."
# 末影珍珠传送成功后发送。
success: "&a传送成功!"
# 在 /enderpearllogic reload 之后发送。
reload: "&aEnderPearlLogic 配置已成功重新加载!"
# 当玩家无法使用末影珍珠时发送。
no-permission: "&c你没有权限使用末影珍珠。"
# 指令与安全提示。
reload-no-permission: "&c你没有权限重新加载此插件。"
reload-error: "&c配置文件无法重新加载。请检查控制台。"
config-error: "&c存在配置问题。将使用安全值。"
command-usage: "&e用法:&f/enderpearllogic reload"
command-no-permission: "&c你没有权限使用此命令。"
# 经济相关提示。占位符:{cost}, {balance}。
not-enough-money: "&c使用末影珍珠需要 &e{cost} &c。你的余额为:&e{balance}&c。"
cost-charged: "&7已扣除末影珍珠费用:&e{cost}&7。"
economy-error: "&c经济支付未能完成。请稍后重试。"
# 更新提示。占位符:{current}, {latest}, {url}。
update-available: "&e有新的 EnderPearlLogic 版本可用:&f{latest} &7(当前版本:&f{current}&7)。&b{url}"
# 末影珍珠击中生物或玩家时造成的自定义伤害。
enderpearl-damage:
enabled: true
amount: 5.0
# 传送后施加给玩家的药水效果。
# 有效效果 ID:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
teleport-effect:
enabled: true
type: "SPEED"
# 持续时间(秒)。
duration: 5
# 0 = I 级,1 = II 级。
amplifier: 1
# 投掷末影珍珠时播放的声音。
# 有效声音 ID:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
launch-sound:
enabled: true
type: "ENTITY_ENDER_PEARL_THROW"
volume: 1.0
pitch: 1.0
# 末影珍珠撞击时播放的声音。
# 有效声音 ID:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
hit-sound:
enabled: true
type: "ENTITY_ENDERMAN_TELEPORT"
volume: 1.0
pitch: 1.0
# 成功进行末影珍珠传送后控制末影螨的生成。
# 插件会取消原版末影珍珠生成末影螨的行为,并自行应用
# 此几率,从而在支持的各个版本中保持行为一致。
endermite:
# 设置为 false 以完全禁用末影珍珠生成末影螨。
enabled: true
# 生成几率,范围从 0.0 到 1.0。
# 0.0 = 从不,0.05 = 5%,1.0 = 总是。
chance: 0.05
# 可选的 Vault 经济支持。
# 需要安装 Vault 和经济类插件。默认禁用。
# 如果缺少 Vault 或经济提供商,仅禁用此功能。
# 拥有 enderpearllogic.bypass 权限的玩家不会被收费。
# 仅当末影珍珠投掷有效时才收取费用。
economy:
enabled: false
# 有效的末影珍珠投掷所收取的费用。
# 设置为 0.0 以避免收费,即使启用了经济功能。
cost: 0.0
# 支付成功后发送 cost-charged 消息。
send-cost-charged-message: true
# 可选的更新检测器。
# 默认启用。基于配置的资源 URL,使用轻量级的 Spigot 资源版本端点。
# 仅向 OP 或拥有 enderpearllogic.update 权限的玩家显示通知。
# 接受主资源 URL、/updates URL 或数字资源 ID。
# 这不会自动下载更新。
update-checker:
enabled: true
resource-url: "https://www.spigotmc.org/resources/enderpearllogic.120087/"
# 可选的 PlaceholderAPI 支持。
# 如果未安装 PlaceholderAPI,则此功能无效。
# 注册的占位符:
# - %enderpearllogic_cooldown_remaining%
# - %enderpearllogic_cooldown_status%
# - %enderpearllogic_cooldown_active%
placeholders:
enabled: true
# PlaceholderAPI 占位符返回的值。
# 这些值不使用 messages.prefix。
# 如果你的占位符目标支持颜色代码,则支持与颜色代码。
values:
# 当没有冷却时间时,由 %enderpearllogic_cooldown_remaining% 返回。
# 在冷却期间,该占位符返回剩余秒数作为数字。
cooldown-remaining-none: "0"
# 由 %enderpearllogic_cooldown_status% 返回。
cooldown-status-cooldown: "cooldown"
cooldown-status-ready: "ready"
# 由 %enderpearllogic_cooldown_active% 返回。
cooldown-active-true: "true"
cooldown-active-false: "false"
? 应用场景
- 生存服务器: 防止末影珍珠滥用
- PvP 服务器: 改善战斗平衡
- 小游戏服务器: 添加自定义传送机制
- 网络架构: 稳定且可扩展的解决方案
? 兼容性
- Minecraft: 1.20.x → 1.21.x
- Java: 17 或更高版本
- 平台: Paper, Spigot, Purpur
可选依赖项
- Vault (经济系统)
- PlaceholderAPI (占位符)
❤️ 专为性能设计
EnderPearlLogic 旨在打造轻量、安全且高效的体验。
它在确保不同服务器设置下行为稳定的同时,最大限度地减少资源占用。
安装简单,使用安全,随时准备为你的 Minecraft 服务器服务。 ⚔️
⚡ EnderPearlLogic — Advanced Ender Pearl Control System
A lightweight, powerful and fully configurable plugin that gives you complete control over Ender Pearl behavior.
EnderPearlLogic enhances gameplay by adding cooldowns, economy systems, effects, sounds and safety improvements — all designed to be stable, optimized and easy to configure.
✨ Core Features
- Custom cooldown system: Control Ender Pearl usage per player
- Anti-spam protection: Prevent message spam when players are on cooldown
- Admin bypass: Ignore cooldown and restrictions for staff
- Vault economy support (optional): Charge players per pearl usage
- Endermite control system: Enable or disable spawn and Customize spawn chance
- Teleport effects: Fully configurable (type, duration, amplifier)
- Custom sounds: Launch & impact with volume and pitch control
- Custom damage system: Modify or disable Ender Pearl damage
? Advanced Systems
- PlaceholderAPI support (optional)
- Configurable placeholder outputs
- Real-time cooldown tracking
- Update checker system
- Automatic config updater (no broken configs)
- Safe & optimized core:
- Respects other plugins
- Prevents double execution
- No memory leaks
- Minimal performance impact
? PlaceholderAPI Integration
EnderPearlLogic supports PlaceholderAPI for dynamic data in scoreboards, holograms, tablists and more.
Available Placeholders
| Placeholder |
Description |
%enderpearllogic_cooldown_remaining% |
Remaining cooldown time |
%enderpearllogic_cooldown_status% |
Cooldown status (ready / cooldown) |
%enderpearllogic_cooldown_active% |
Returns true or false |
All placeholder values are fully configurable in config.yml.
⚙️ Commands & Permissions
Commands
| Command |
Description |
Permission |
/enderpearllogic reload |
Reload plugin configuration |
enderpearllogic.reload |
Permissions
| Permission |
Description |
enderpearllogic.use |
Use Ender Pearls |
enderpearllogic.reload |
Reload configuration |
enderpearllogic.command |
Use base command |
enderpearllogic.bypass |
Ignore cooldown & restrictions |
enderpearllogic.update |
Receive update notifications |
⚙️ Configuration
EnderPearlLogic provides a fully customizable configuration system:
- Automatic config updates (adds missing options safely)
- Backwards compatibility with older configs
- Safe validation for all values
- Fully configurable messages, placeholders, sounds and effects
config.yml
# ============================================================
# EnderPearlLogic v1.5
# Default configuration compatible with the public Spigot layout.
#
# Color codes with & are supported.
# Set any message to "none" to stop sending that message.
# Players with enderpearllogic.bypass ignore cooldown and economy cost.
# Invalid values are logged as warnings and replaced or skipped safely.
#
# Official Bukkit documentation for configurable IDs:
# Potion effects: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
# Sounds: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
# Use IDs available on your server version, for example SPEED or ENTITY_PLAYER_TELEPORT.
# ============================================================
# ============================================================
# Permission reference
# These permissions are registered in plugin.yml.
# They are NOT configured here; manage them with your permissions
# plugin, for example LuckPerms.
#
# enderpearllogic.use
# Allows players to use Ender Pearls controlled by this plugin.
# Default: everyone.
#
# enderpearllogic.bypass
# Bypasses cooldown and economy cost.
# Default: operators.
#
# enderpearllogic.reload
# Allows /enderpearllogic reload and /eplreload.
# Default: operators.
#
# enderpearllogic.command
# Allows using /enderpearllogic without reload arguments.
# Players without this permission will not see command usage.
# Default: operators.
#
# enderpearllogic.update
# Allows receiving update notifications when update-checker is enabled.
# Operators also receive update notifications.
# Default: operators.
# ============================================================
# Cooldown in seconds for using Ender Pearls.
# Requires enderpearllogic.use unless the player has enderpearllogic.bypass.
# Set to 0 to disable the cooldown duration while keeping the rest
# of the plugin features active.
cooldown-time: 10
# Minimum delay, in seconds, between cooldown messages for the same player.
# The plugin checks this only when the player actually tries to use an
# Ender Pearl during cooldown. Set this to 0 to show a message on every
# blocked attempt.
cooldown-message-delay: 1
messages:
# Prefix added before plugin messages. Use "none" to disable it.
prefix: "&bEnderPearlLogic &8>> "
# Placeholders: {time}, {seconds}, %time%, %seconds%.
cooldown: "&7You must wait &c{time} &7seconds before using another Ender Pearl."
# Sent when a pearl is successfully thrown.
use: "&7You used an Ender Pearl! Teleporting..."
# Sent after the ender pearl teleport succeeds.
success: "&aTeleportation successful!"
# Sent after /enderpearllogic reload.
reload: "&aEnderPearlLogic configuration reloaded successfully!"
# Sent when a player cannot use Ender Pearls.
no-permission: "&cYou do not have permission to use Ender Pearls."
# Command and safety messages.
reload-no-permission: "&cYou do not have permission to reload this plugin."
reload-error: "&cThe configuration could not be reloaded. Check the console."
config-error: "&cThere is a configuration problem. Safe values will be used."
command-usage: "&eUsage: &f/enderpearllogic reload"
command-no-permission: "&cYou do not have permission to use this command."
# Economy messages. Placeholders: {cost}, {balance}.
not-enough-money: "&cYou need &e{cost} &cto use an Ender Pearl. Your balance: &e{balance}&c."
cost-charged: "&7Ender Pearl cost charged: &e{cost}&7."
economy-error: "&cThe economy payment could not be completed. Try again later."
# Update message. Placeholders: {current}, {latest}, {url}.
update-available: "&eA new EnderPearlLogic version is available: &f{latest} &7(current: &f{current}&7). &b{url}"
# Custom damage dealt by an Ender Pearl when it hits a mob or player.
enderpearl-damage:
enabled: true
amount: 5.0
# Potion effect applied to the player after teleporting.
# Valid effect IDs:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/potion/PotionEffectType.html
teleport-effect:
enabled: true
type: "SPEED"
# Duration in seconds.
duration: 5
# 0 = level I, 1 = level II.
amplifier: 1
# Sound played when an Ender Pearl is thrown.
# Valid sound IDs:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
launch-sound:
enabled: true
type: "ENTITY_ENDER_PEARL_THROW"
volume: 1.0
pitch: 1.0
# Sound played when an Ender Pearl impacts.
# Valid sound IDs:
# https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
hit-sound:
enabled: true
type: "ENTITY_ENDERMAN_TELEPORT"
volume: 1.0
pitch: 1.0
# Endermite spawn control after a successful Ender Pearl teleport.
# The plugin cancels the vanilla Ender Pearl Endermite spawn and applies
# this chance itself, which keeps behavior consistent across supported versions.
endermite:
# Set to false to fully disable Endermites from Ender Pearls.
enabled: true
# Spawn chance from 0.0 to 1.0.
# 0.0 = never, 0.05 = 5%, 1.0 = always.
chance: 0.05
# Optional Vault economy support.
# Requires Vault and an economy plugin. Disabled by default.
# If Vault or an economy provider is missing, only this feature is disabled.
# Players with enderpearllogic.bypass are not charged.
# The cost is charged only when the Ender Pearl launch is valid.
economy:
enabled: false
# Money charged for a valid Ender Pearl launch.
# Set to 0.0 to avoid charging even if economy is enabled.
cost: 0.0
# Sends messages.cost-charged after a successful payment.
send-cost-charged-message: true
# Optional update checker.
# Enabled by default. Uses a lightweight Spigot resource version endpoint
# based on the configured resource URL. Notifications are shown only to OPs
# or players with enderpearllogic.update.
# The main resource URL, the /updates URL, or the numeric resource id are accepted.
# This does not download updates automatically.
update-checker:
enabled: true
resource-url: "https://www.spigotmc.org/resources/enderpearllogic.120087/"
# Optional PlaceholderAPI support.
# If PlaceholderAPI is not installed, this does nothing.
# Registered placeholders:
# - %enderpearllogic_cooldown_remaining%
# - %enderpearllogic_cooldown_status%
# - %enderpearllogic_cooldown_active%
placeholders:
enabled: true
# Values returned by PlaceholderAPI placeholders.
# These values do not use messages.prefix.
# Color codes with & are supported if your placeholder target supports colors.
values:
# Returned by %enderpearllogic_cooldown_remaining% when no cooldown is active.
# During cooldown, the placeholder returns the remaining seconds as a number.
cooldown-remaining-none: "0"
# Returned by %enderpearllogic_cooldown_status%.
cooldown-status-cooldown: "cooldown"
cooldown-status-ready: "ready"
# Returned by %enderpearllogic_cooldown_active%.
cooldown-active-true: "true"
cooldown-active-false: "false"
? Use Cases
- Survival servers: Prevent Ender Pearl abuse
- PvP servers: Improve combat balance
- Minigame servers: Add custom teleport mechanics
- Networks: Stable and scalable solution
? Compatibility
- Minecraft: 1.20.x → 1.21.x
- Java: 17 or higher
- Platforms: Paper, Spigot, Purpur
Optional dependencies
- Vault (economy system)
- PlaceholderAPI (placeholders)
❤️ Designed for Performance
EnderPearlLogic is built to be lightweight, safe and efficient.
It minimizes resource usage while ensuring stable behavior across different server setups.
Simple to install, safe to use, and ready for your minecraft server. ⚔️
评论 0
登录后参与评分
还没有评论,来抢沙发吧