Lobby Presents Find the Presents [MYSQL] - Lobby Presents 圣诞寻礼插件

LobbyPresents 是一款为节日（如圣诞节）增添乐趣的插件。玩家可以在世界中寻找并收集礼物，每找到一个礼物即可获得奖励。管理员可以轻松配置礼物位置、奖励内容，并支持使用 PlaceholderAPI 在服务器中显示玩家的收集进度。

💡重要须知

此插件已停止更新。最新版本为 v4.5，仅支持 Minecraft 1.8。请前往 GitHub 页面获取最新文件。

配置完成后，请务必输入 /lps reload 以保存所有设置。

🎮核心功能

• 为节日活动增添趣味性，玩家可以寻找并收集隐藏在世界中的礼物。
• 玩家每找到一个礼物，即可累积计数并获得预设的奖励。
• 管理员可以通过指令 /lps presents 获取各种礼物头颅模型。
• 支持 MySQL 数据库，用于跨服务器存储玩家数据。
• 支持 PlaceholderAPI，可在其他插件中显示收集进度。

🔧指令列表

所有指令都需要权限 lobbypresents.admin。

• /lps help {page} - 查看帮助菜单。
• /lps list - 列出所有已设置的礼物。
• /lps set {id} - 设置指定ID的礼物位置（对目标头颅右键点击）。
• /lps remove {id} - 移除指定ID的礼物。
• /lps reward - 管理奖励相关设置。
• /lps reward settype {Sequence/Custom/Both} - 设置奖励发放类型。
• /lps reward setsequence {sequence} {none/cmd1,cmd2,...} - 设置顺序型奖励。
• /lps reward setcustom {id_presents} {none/cmd1,cmd2,...} - 设置自定义（按ID）奖励。
• /lps heads - 打开礼物头颅选择菜单。
• /lps reload - 重载插件配置。
• /lps clearuserdata {playername} - 清除指定玩家的收集数据。
• /lps checkversion - 检查插件版本。

✨安装与设置

• 下载插件文件。
• 将插件放入服务器的 plugins 文件夹。
• 重启服务器。
• 使用 /lps heads 选择喜欢的礼物头颅，并将其放置在世界上。
• 对放置好的头颅使用 /lps set {id} 来将其注册为一个礼物点。
• 使用 /lps reward settype {sequence/custom/both} 设置奖励发放类型。
• 根据上一步选择的类型，使用 /lps reward setsequence 或 /lps reward setcustom 来配置具体的奖励命令。
• 重启服务器或使用 /lps reload 重载配置。
• 完成！玩家现在可以开始寻找礼物了。

⭐变量与占位符

插件内置变量

• %total% - 礼物总数。
• %found% - 玩家已找到的礼物数。
• %player% - 玩家名。

PlaceholderAPI 占位符（需要 PlaceholderAPI 2.9+）：

• %lobbypresents_max% - 礼物总数。
• %lobbypresents_found% - 玩家已找到的礼物数。
• %lobbypresents_unfound% - 玩家未找到的礼物数。

🔧事件

PlayerClickClaimedPresentEvent

开发者可以通过监听此事件，在玩家点击已领取的礼物时执行自定义操作。

代码示例

@EventHandler
public void onPlayerClickPresents(PlayerClickClaimedPresentEvent e) {
    // 你的代码
}

⭐配置文件摘要

主要配置文件及其结构如下

config.yml

MYSQL:
  Enable: false
  host: 'localhost'
  port: '3306'
  database: 'LobbyPresents'
  table_name: 'presents'
  username: 'root'
  password: '123'
Effect:
  distance: 5
  ticks: 40
  canclaim: VILLAGER_HAPPY
  claimed: CRIT
Messages:
  found: "&aYou found a present! &e(&b%found%&e/&b%total%&e)"
  alreadyfound: "&cFound already!"
  completed: "&bMerry Christmas!! &c(&a%found%&f/&a%total%&c)"
  actionbar: "&b&lLobby Presents &c(&a%found%&f/&a%total%&c)"
  actionbar-completed: "&b&lLobby Presents &a&lCompleted!&f &c(&a%found%&f/&a%total%&c)"
Actionbar:
  enable: false
  world:
    - worldname
  update: 10
Sounds: {}
Rewards:
  type: sequence
  sequence-rewards: {}

presents.yml

此文件存储每个礼物的位置和自定义奖励。

presents:
  1:
    loc: Lobby:-0:0:0
    custom-rewards: say hi %player%,say Good %player%
  2:
    loc: Lobby:-0:0:0
    custom-rewards: say hi %player%,say Good %player%

data.yml

此文件存储玩家的收集进度。

user:
  u-u-i-d: 1,2,3,4

heads.yml

此文件包含所有可用的自定义礼物头颅的材质值。你可以在 minecraft-heads.com/custom/heads 等网站获取更多材质值。

heads:
  Present 1: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZTgxYTM5OWU0ZDJlOGYxYTgyOGUxYzRiYzRjYTk5ZWZlZDE1MDhmM2Y0MjFkOTg4NzQ3MjlhZTY0ZDgzIn19fQ==
  Present 2: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODg0YjhhMzJiYzZkZTI4ODRiYTMxMzk4ZDViMDI4ZDFhNGZhNzdmNTlhNDE1YjdlNmY2MmYyNjIzZjRmNiJ9fX0=
  # ... 更多头颅材质