Titanium PlayerInfo

插件

· 作者 MC-Titanium

显示玩家的相关信息

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

最新 1.0.4 · 26.2 · Bukkit / Folia

一键开服(送7天)

Description

在 Discord 上获取支持

TitaniumPlayerInfo 是一款 Minecraft 服务器管理与玩家信息插件。它通过图形化库存 GUI 提供玩家信息,并支持在线玩家和已知的离线玩家。

其主要目的是提供一个包含状态信息、位置、LuckPerms 数据、库存、盔甲、副手及末影箱访问权限的中心化玩家档案。面向用户的文本通过语言文件进行管理。

支持的服务器平台:

  • Paper
  • Spigot
  • Purpur
  • Folia

要求:

  • Minecraft/服务器 API 1.21 或更高版本
  • Java 21 或更高版本(根据服务器环境)
  • LuckPerms
  • fernsehheft EnderChest 插件(当启用外部末影箱模式时)

2. 安装

  1. 安装并启用 LuckPerms。
  2. 启动服务器。
  3. 在 config.yml 中选择所需的语言。
  4. 更改配置后运行 /playerinfo reload。

如果需要 fernsehheft EnderChest 集成,请同时安装并启用 fernsehheft EnderChest 插件。


3. 命令

命令 功能
/playerinfo <player> 打开选定玩家的档案
/pi <player> /playerinfo <player> 的简写形式
/playerinfo reload 重新加载配置和语言文件
/pi reload /playerinfo reload 的简写形式

这些命令需要相应的 TitaniumPlayerInfo 权限。


4. 权限

权限节点 含义
playerinfo.use 使用 /playerinfo 和 /pi
playerinfo.reload 重新加载配置和语言文件
playerinfo.view.ip 查看 IP 地址
playerinfo.view.inventory 查看库存和装备
playerinfo.view.enderchest 查看/打开末影箱
playerinfo.view.permissions 查看 LuckPerms 和权限信息

这些节点的默认权限等级为 op。可以通过 LuckPerms 单独分配权限。


5. 玩家档案

玩家档案可包含以下内容:

  • 玩家名称
  • UUID
  • 首次登录时间
  • 最后登录时间
  • 在线/离线状态
  • 经验等级
  • 生命值
  • 饥饿值与饱和度
  • 游戏模式
  • 当前所在世界
  • X/Y/Z 坐标
  • IP 地址(若获许可)
  • LuckPerms 主组
  • 继承的组
  • 前缀
  • OP 状态
  • 库存
  • 快捷栏
  • 盔甲
  • 副手
  • 末影箱

对于离线玩家,仅显示实际持久存储的信息。不会从不存在的数据中重建实时库存和实时末影箱内容。


6. 库存视图

库存视图使用固定的映射关系:

  • Minecraft 库存 9–35 → GUI 9–35
  • 快捷栏 0–8 → GUI 36–44
  • 盔甲 → GUI 0–3
  • 副手 → GUI 4
  • 返回 → GUI 49

这使返回按钮与玩家的快捷栏槽位分开。


7. 末影箱模式

末影箱模式通过 config.yml 控制:

enderchest:
  use-vanilla: true

有两种模式。

use-vanilla: true

TitaniumPlayerInfo 使用原版 Minecraft 末影箱。

use-vanilla: false

TitaniumPlayerInfo 使用 fernsehheft EnderChest 集成。

fernsehheft 插件仍负责实际的存储和末影箱管理。TitaniumPlayerInfo 不会将其内容复制到其自己的数据库中,也不会替换 fernsehheft 存储系统。


8. Fernsehheft EnderChest 与页面选择

fernsehheft EnderChest 支持多个页面。玩家可以使用哪些页面由 LuckPerms 和 fernsehheft 使用的权限控制,例如:

enderchest.ec.pages.1
enderchest.ec.pages.2
enderchest.ec.pages.3

确切的权限命名必须与安装的 fernsehheft 版本匹配。TitaniumPlayerInfo 使用 fernsehheft 提供的 ec.pages.N 权限进行页面选择逻辑。

当启用 use-vanilla: false 时,点击末影箱按钮会首先打开一个页面选择 GUI。

选择器提供:

  • 可用页面的直接选择
  • ◀ 上一页箭头
  • ▶ 下一页箭头
  • 当前选择的清晰指示
  • 对未授予被检查玩家的页面无选择项
  • 返回玩家档案的途径

页面数量不是硬编码为五或十。它基于被检查玩家可用的 ec.pages.N 权限以及 fernsehheft 配置的最大值。

示例

如果玩家仅有:

ec.pages.1
ec.pages.2
ec.pages.3

则仅提供第 1、2 和 3 页。

另一位玩家可能拥有:

 ec.pages.1
 ec.pages.2
 ec.pages.3
 ec.pages.4
 ec.pages.5

因此将提供五个页面。

这使得不同的 LuckPerms 组可以拥有不同数量的末影箱页面。


9. 打开 fernsehheft 页面

选中页面后,TitaniumPlayerInfo 使用 fernsehheft 提供的页面打开命令:

/ecsee <player> <page>

示例:

/ecsee Andreas 3

这将打开实际的 fernsehheft 末影箱页面。TitaniumPlayerInfo 不接管物品存储。

页面访问仍由 fernsehheft/LuckPerms 权限系统控制。不应使用 TitaniumPlayerInfo 的页面选择器来绕过目标玩家的权限。

关闭外部末影箱后,用户将被返回到相应的 TitaniumPlayerInfo 上下文。


10. LuckPerms 集成

TitaniumPlayerInfo 使用 LuckPerms API 获取组和权限信息。

集成可以使用:

  • 主组
  • 继承的组
  • 前缀
  • 有效权限
  • OP 状态
  • fernsehheft 末影箱页面权限

如果本地缓存中尚不存在 LuckPerms 用户,TitaniumPlayerInfo 可以通过 LuckPerms API 加载该用户,然后更新 GUI。

对于 EnderChest 页面选择,重要的是权限是针对正在查看其档案的玩家进行评估的,而不仅仅是针对操作 GUI 的管理员。


11. 语言

目前包含六种语言:

语言 代码
德语 de
英语 en
法语 fr
意大利语 it
波兰语 pl
俄语 ru

在 config.yml 中选择语言:

language: en

然后运行:

/playerinfo reload

所有用户可见的文本都应从语言文件中加载,而不是不必要地硬编码在 Java 中。


12. 配置

主配置文件为:

重要设置包括:

language: en

enderchest:
  use-vanilla: true

language 用于选择语言文件。

enderchest.use-vanilla 用于选择普通的 Minecraft 末影箱还是 fernsehheft 集成:

  • true = 原版末影箱
  • false = fernsehheft 末影箱

配置更改后请运行 /playerinfo reload。


18. 当前 GUI 状态

当前的玩家资料 GUI 包括以下内容:

  • 玩家信息
  • LuckPerms 信息
  • 物品栏视图
  • 盔甲和副手
  • 末影箱访问
  • fernsehheft 页面选择
  • 上一页/下一页箭头
  • 直接页面选择 末影箱图标目前位于 GUI 的第 37 号槽位,正好在其先前位置下方的一整行 GUI 处。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源