
在 Discord 上获取支持
TitaniumPlayerInfo 是一款 Minecraft 服务器管理与玩家信息插件。它通过图形化库存 GUI 提供玩家信息,并支持在线玩家和已知的离线玩家。
其主要目的是提供一个包含状态信息、位置、LuckPerms 数据、库存、盔甲、副手及末影箱访问权限的中心化玩家档案。面向用户的文本通过语言文件进行管理。
支持的服务器平台:
- Paper
- Spigot
- Purpur
- Folia
要求:
- Minecraft/服务器 API 1.21 或更高版本
- Java 21 或更高版本(根据服务器环境)
- LuckPerms
- fernsehheft EnderChest 插件(当启用外部末影箱模式时)
2. 安装
- 安装并启用 LuckPerms。
- 启动服务器。
- 在
config.yml 中选择所需的语言。
- 更改配置后运行
/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 处。

Support at Discord
TitaniumPlayerInfo is a Minecraft server administration and player-information plugin. It provides player information through graphical inventory GUIs and supports both online players and known offline players.
The main purpose is to provide a central player profile containing status information, location, LuckPerms data, inventory, armor, offhand and Ender Chest access. User-visible text is managed through language files.
Supported server platforms:
- Paper
- Spigot
- Purpur
- Folia
Requirements:
- Minecraft/server API 1.21 or newer
- Java 21 or newer according to the server environment
- LuckPerms
- The fernsehheft EnderChest plugin when the external EnderChest mode is enabled
2. Installation
- Install and enable LuckPerms.
- Start the server.
- Select the desired language in
config.yml.
- Run
/playerinfo reload after changing the configuration.
If the fernsehheft EnderChest integration is required, install and enable the fernsehheft EnderChest plugin as well.
3. Commands
| Command |
Function |
/playerinfo <player> |
Open the selected player's profile |
/pi <player> |
Short form of /playerinfo <player> |
/playerinfo reload |
Reload configuration and language files |
/pi reload |
Short form of /playerinfo reload |
The commands require the corresponding TitaniumPlayerInfo permission.
4. Permissions
| Permission |
Meaning |
playerinfo.use |
Use /playerinfo and /pi |
playerinfo.reload |
Reload configuration and language files |
playerinfo.view.ip |
View IP addresses |
playerinfo.view.inventory |
View inventories and equipment |
playerinfo.view.enderchest |
View/open Ender Chests |
playerinfo.view.permissions |
View LuckPerms and permission information |
The default permission level for these nodes is op. Permissions can be assigned individually through LuckPerms.
5. Player profiles
A player profile can contain:
- player name
- UUID
- first login
- last login
- online/offline status
- level
- health
- hunger and saturation
- game mode
- current world
- X/Y/Z coordinates
- IP address when permitted
- LuckPerms primary group
- inherited groups
- prefix
- OP status
- inventory
- hotbar
- armor
- offhand
- Ender Chest
For offline players, only information that is actually available persistently is displayed. Live inventory and live Ender Chest contents are not reconstructed from nonexistent data.
6. Inventory view
The inventory view uses a fixed mapping:
- Minecraft inventory 9–35 → GUI 9–35
- Hotbar 0–8 → GUI 36–44
- Armor → GUI 0–3
- Offhand → GUI 4
- Back → GUI 49
This keeps the back button separate from the player's hotbar slots.
7. Ender Chest modes
The Ender Chest mode is controlled through config.yml:
enderchest:
use-vanilla: true
There are two modes.
use-vanilla: true
TitaniumPlayerInfo uses the normal Minecraft Ender Chest.
use-vanilla: false
TitaniumPlayerInfo uses the fernsehheft EnderChest integration.
The fernsehheft plugin remains responsible for the actual storage and EnderChest management. TitaniumPlayerInfo does not copy its contents into its own database or replace the fernsehheft storage system.
8. Fernsehheft EnderChest and page selection
The fernsehheft EnderChest supports multiple pages. Which pages a player may use is controlled through LuckPerms and the permissions used by fernsehheft, for example:
enderchest.ec.pages.1
enderchest.ec.pages.2
enderchest.ec.pages.3
The exact permission naming must match the installed fernsehheft version. TitaniumPlayerInfo uses the ec.pages.N permissions provided by fernsehheft for its page selection logic.
When use-vanilla: false is enabled, clicking the Ender Chest button first opens a page-selection GUI.
The selector provides:
- direct selection of available pages
- ◀ previous-page arrow
- ▶ next-page arrow
- a clear indication of the current selection
- no selection for pages not granted to the inspected player
- a way back to the player profile
The number of pages is not hardcoded to five or ten. It is based on the ec.pages.N permissions available to the inspected player and fernsehheft's configured maximum.
Example
If a player has only:
ec.pages.1
ec.pages.2
ec.pages.3
only pages 1, 2 and 3 are offered.
Another player may have:
ec.pages.1
ec.pages.2
ec.pages.3
ec.pages.4
ec.pages.5
and will therefore be offered five pages.
This allows different LuckPerms groups to have different numbers of EnderChest pages.
9. Opening a fernsehheft page
After a page is selected, TitaniumPlayerInfo uses the page-opening command provided by fernsehheft:
/ecsee <player> <page>
Example:
/ecsee Andreas 3
This opens the actual fernsehheft EnderChest page. TitaniumPlayerInfo does not take over item storage.
Page access remains controlled by the fernsehheft/LuckPerms permission system. TitaniumPlayerInfo's page selector must not be used to bypass the target player's permissions.
After closing the external EnderChest, the user is returned to the corresponding TitaniumPlayerInfo context.
10. LuckPerms integration
TitaniumPlayerInfo uses the LuckPerms API for group and permission information.
The integration can use:
- primary group
- inherited groups
- prefix
- effective permissions
- OP status
- fernsehheft EnderChest page permissions
If a LuckPerms user is not already available in the local cache, TitaniumPlayerInfo can load the user through the LuckPerms API and update the GUI afterwards.
For EnderChest page selection, the important point is that permissions are evaluated for the player whose profile is being viewed, not simply for the administrator operating the GUI.
11. Languages
Six languages are currently included:
| Language |
Code |
| German |
de |
| English |
en |
| French |
fr |
| Italian |
it |
| Polish |
pl |
| Russian |
ru |
Select the language in config.yml:
language: en
Then run:
/playerinfo reload
All user-visible text should be loaded from the language files rather than unnecessarily hardcoded in Java.
12. Configuration
The main configuration file is:
Important settings include:
language: en
enderchest:
use-vanilla: true
language selects the language file.
enderchest.use-vanilla selects the normal Minecraft Ender Chest or the fernsehheft integration:
true = Vanilla Ender Chest
false = fernsehheft EnderChest
Run /playerinfo reload after configuration changes.
18. Current GUI state
The current player-profile GUI includes, among other things:
- player information
- LuckPerms information
- inventory view
- armor and offhand
- EnderChest access
- fernsehheft page selection
- previous/next page arrows
- direct page selection
The EnderChest icon is currently in GUI slot 37, exactly one complete GUI row below its previous position.
评论 0
登录后参与评分
还没有评论,来抢沙发吧