AdminPlayerMenu - GUI - AdminPlayerMenu - 玩家管理面板

AdminPlayerMenu 是一款专为服务器所有者设计的插件，旨在帮助管理员和工作人员通过一个简单的命令，快速学习和执行所有管理玩家的指令。它提供了一个高度可定制的 GUI 菜单，让玩家管理变得直观高效。

💡功能特性

• 集中管理：在一个菜单界面中查看和管理所有在线/离线玩家。
• 高度可定制：可设置插件内所有消息的前缀和文本，自定义控制面板中每个物品的名称、描述、材质、槽位和执行的命令。
• 多页面支持：通过设置大于 (54 * 当前页码) 的槽位，可以创建无限页面的控制面板。
• 玩家搜索：支持搜索在线/离线玩家并直接打开其控制面板，可选启用相似名称建议。
• 确认屏幕：为任何操作添加“确认”步骤，防止误操作。
• PlaceholderAPI 支持：可使用数千种占位符来丰富物品名称、描述和命令。
• 更新检查器：当有新版本时，拥有相应权限的玩家会在加入服务器时收到通知。

🎮安装步骤

• 从 Spigot 页面下载 AdminPlayerMenu.jar。
• 将 AdminPlayerMenu.jar 放入服务器的 plugins 文件夹。
• 重启或重载服务器，配置后执行 /admin reload 即可完成设置。

🔧命令列表

• /admin - 在 GUI 中显示所有在线玩家，点击即可对其执行命令。（别名：apm）
• /adminoffline - 在 GUI 中查看/管理所有离线玩家。（别名：apmo）
• /admin reload - 重载插件的 config.yml 配置文件。
• /admin search <玩家名> - 搜索指定玩家（无论在线与否），如果该玩家曾进入服务器，则直接打开其控制面板。

🔧权限节点

• adminplayermenu.use - 允许使用本插件的基础功能。
• adminplayermenu.* - 拥有所有下级权限节点。
• adminplayermenu.search - 允许使用 /admin search <玩家名> 命令。
• adminplayermenu.updater - 当有更新可用时接收通知消息。
• adminplayermenu.reload - 允许重载插件配置。

✨依赖与配置说明

PlaceholderAPI

默认配置使用了 PlaceholderAPI 的两个扩展。如需启用 PlaceholderAPI 并使默认配置生效，请在服务器控制台执行以下命令：

• /papi ecloud download Player
• /papi ecloud download Server

配置文件概览

配置文件 (config.yml) 结构清晰，主要包含以下部分：

General 部分

设置翻页按钮、搜索功能反馈消息等。

Menu 部分

定义玩家列表菜单中在线/离线玩家的显示物品、确认 GUI 的布局与物品。

Messages 部分

设置插件消息前缀、重载提示、无权限提示以及菜单中玩家头颅的显示名称和描述。

ControlPanel 部分

这是核心配置区，用于定义控制面板中的每个功能项。每个条目支持以下参数：

• Name：物品显示名称，支持 PlaceholderAPI。
• Lore：物品描述列表，支持 PlaceholderAPI。
• Item：物品材质（如 bedrock）。
• Slot：物品在菜单中的槽位（0-53）。
• Command：点击后执行的命令（字符串或列表），支持 PlaceholderAPI。
• SeePermission：查看此物品所需的权限节点。
• Confirm：设置为 true 时，点击后会弹出确认屏幕。
• Close：设置为 false 时，执行命令后菜单不会关闭（适用于如 invsee 这类命令）。
• Back：设置为 true 时，该物品将作为返回按钮，根据玩家来源（在线/离线列表）返回上一级菜单。

菜单大小会根据配置的最大 Slot 值自动调整，最大支持 54 格（一页）。通过设置超过当前页面容量的槽位，可以自动创建新页面。

❓支持与统计

需要帮助？

欢迎加入我们的 Discord 服务器获取实时支持！

• Discord 邀请码：8Kt4wKm
• 邀请链接：http://discord.gg/8Kt4wKm

关于统计 (bStats)

本插件会匿名收集服务器数量、核心数、在线玩家数等基本统计信息，以帮助开发者了解插件使用情况并激励更新。您可以在 plugins/bStats 目录下选择退出。我们恳请您不要禁用此功能。

⭐重要声明

• 您可以分发此插件，但必须提供指向本 Spigot 页面的原始下载链接。
• 禁止复制、重命名或反编译代码并声称是您自己的作品。
• 如果您喜欢这个插件，请留下五星好评。
• 请勿在评价中提交 Bug 报告，请前往“讨论区”页面提交错误或建议。
• 欢迎在讨论区留下您的服务器地址（需提供证明），我们会将其添加到用户列表。

---

致谢：感谢插件作者 SuperRonanCraft 的辛勤工作！欢迎访问他的公开服务器：mc.RonanCraft.net。

> 提示：如果您需要一款主要为普通玩家设计、而非管理员的管理菜单，可以查看作者的另一个插件：OnlinePlayersMenu。