Titanium PlayerInfo

Get support at Discord

### 1. Overview

**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
**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

2. Install and enable LuckPerms.
3. Start the server.
5. Select the desired language in `config.yml`.
6. 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`:

```yaml
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:

```text
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:

```text
ec.pages.1
ec.pages.2
ec.pages.3
```

only pages 1, 2 and 3 are offered.

Another player may have:

```text
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:

```text
/ecsee <player> <page>
```

Example:

```text
/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`:

```yaml
language: en
```

Then run:

```text
/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:

```text
```

Important settings include:

```yaml
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.