祈愿井

wuqi77

---

许愿井插件 (WishingWell)

一个Minecraft服务器插件，允许玩家通过向许愿井中丢入特定物品来触发各种各种效果，如改变天气或时间。

• 创建许愿井：可以在游戏中的任何位置设置许愿井
• 多井支持：可以同时设置多个许愿井
• 效果触发：向井中丢入特定物品触发对应效果
• 物品-效果映射：默认支持多种物品对应不同效果，也可自定义
• 冷却时间：防止玩家短时间内频繁使用许愿井
• 权限控制：管理员可以配置和控制许愿井，也可以无视冷却时间
• Tab补全：输入命令时可以使用Tab键自动补全子命令和参数
• 特殊许愿：向井中丢入命名为玩家名称的烈焰棒可召唤雷电劈向该玩家（所有玩家均可使用）
• 状态效果：向井中丢入命名为玩家名称的特殊物品可对目标玩家施加状态效果
  

---

命令详解

所有功能均通过 /well 命令（或其别名 /wishingwell、/ww）来使用：

命令               描述                        所需权限

/well              显示帮助信息                无

/well set [井ID]   在当前位置设置一个许愿井    wishingwell.admin.set

/well create <井ID> <世界名> <X> <Y> <Z> 使用自定义坐标创建许愿井  wishingwell.admin.create

/well remove <井ID> 移除指定的许愿井            wishingwell.admin.remove

/well list         列出所有许愿井及其坐标      wishingwell.admin.list

/well reload       重载插件配置                wishingwell.admin.reload

/well debug        切换调试模式                wishingwell.admin.debug

/well strike <玩家名> 在指定玩家位置召唤闪电    wishingwell.admin

/well particles <on/off> 开启/关闭粒子特效       wishingwell.command.particles

提示：使用Tab键可以自动补全命令。例如，输入/well 后按Tab键会显示可用的子命令，输入/well remove 后按Tab键会显示可以移除的井ID列表。

---

权限

许愿井插件使用分层权限系统，将权限分为三大类别，方便管理和分配。

• 权限组层级
  

权限组          包含的子权限                       默认值

wishingwell.admin 包含所有管理类权限、绕过类权限和命令类权限 op

wishingwell.bypass.* 包含所有绕过类权限              op

wishingwell.command.* 包含所有命令类权限             op

2.管理类权限

权限                     描述                                     默认值 用途

wishingwell.admin        管理员权限组 - 包含所有许愿井插件的管理权限 op   授予所有管理功能

wishingwell.admin.set    允许设置许愿井位置                       op   使用/well set命令

wishingwell.admin.create 允许使用坐标创建许愿井                   op   使用/well create命令

wishingwell.admin.remove 允许移除许愿井                           op   使用/well remove命令

wishingwell.admin.list   允许列出所有许愿井                       op   使用/well list命令

wishingwell.admin.reload 允许重载插件配置                       op   使用/well reload命令

wishingwell.admin.debug  允许使用调试功能                       op   使用/well debug命令

3.绕过类权限

权限                      描述                                默认值 用途

wishingwell.bypass.* 包含所有绕过限制的权限              op   授予所有绕过限制功能

wishingwell.bypass.cooldown 允许绕过许愿井的冷却时间限制      op   无需等待冷却时间即可再次使用许愿井

wishingwell.bypass.backfire 允许绕过负面效果的反噬              op   使用负面效果时不会受到反噬影响

4.命令类权限

权限                         描述                             默认值 用途

wishingwell.command.* 包含所有特殊命令权限               op   授予所有特殊命令功能

wishingwell.command.particles 允许控制雷击粒子特效             op   使用/well particles <on/off>命令

• 常见权限配置示例以下是一些常见的权限配置示例，可以在权限插件中使用：
  

管理员权限配置

permissions:

admin:

permissions:

- wishingwell.admin

VIP玩家权限配置

permissions:

vip:

permissions:

- wishingwell.bypass.cooldown

活动管理员权限配置

permissions:

eventadmin:

permissions:

- wishingwell.admin.set

- wishingwell.admin.remove

---

默认效果

物品                   效果

蓝色兰花               开始下雨

向日葵                 停止下雨（晴天）

金锭                   设置时间为早晨

铁锭                   设置时间为午夜

烈焰棒                 开始雷暴

命名为玩家名称的烈焰棒 开始雷暴，并在雷暴开始时劈向该玩家

命名为玩家名称的蜘蛛眼 对目标玩家施加致盲效果

命名为玩家名称的蜘蛛网 对目标玩家施加减速效果

命名为玩家名称的潜影壳 对目标玩家施加漂浮效果

命名为玩家名称的河豚 对目标玩家施加中毒效果

---

特殊功能：雷电召唤

使用铁砧将烈焰棒命名为与服务器上存在的任何玩家的名称，然后将该烈焰棒丢入许愿井中，将会：

• 触发雷暴天气
• 在雷暴开始时，以闪电劈向该玩家
• 服务器广播一条特殊消息，显示谁对谁使用了雷击注意所有玩家均可使用此功能，无需特殊权限。但使用时有一定几率反噬，导致雷电劈向施法者自己。
  

---

特殊功能：状态效果

使用铁砧将特定物品命名为目标玩家的名称，然后丢入许愿井中，可以对目标玩家施加状态效果：

• 蜘蛛眼：致盲效果
• 蜘蛛网：减速效果
• 潜影壳：漂浮效果
• 河豚：中毒效果使用时会广播消息，显示谁对谁施加了什么效果。同样有一定几率反噬，导致效果反弹给施法者自己。