EnderPearlLogic

插件

· 作者 ThaRialSniper

一个增强末影珍珠使用的插件,包含冷却时间、自定义消息、伤害控制、可配置音效和传送效果。

0 本站下载 0 关注 更新于 6 个月前

最新 1.5.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

⚡ 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 服务器服务。 ⚔️

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源