Titanium Safe

Get support at Discord

TitaniumSafe provides players with a personal, persistent vault. The German display name is **TitaniumTresor**.

The vault is **cross-world within the same server only**. All worlds on one server use the same player vault. Different servers use separate vault data based on their configured `server-id`.

### Features

- Personal vault via `/tresor` or `/safe`
- Multiple vault pages
- Page count controlled by LuckPerms or configuration
- LuckPerms page permissions using `titaniumsafe.pages.<number>`
- The highest assigned page permission determines the maximum available page
- Configurable maximum page count via `vault.maximum-pages`
- Administrator access via `/sa <player>`
- Administrators can edit another player's vault pages
- Reload via `/safe reload` and `/tresor reload`
- Cross-world storage within one server
- Separate vault data per `server-id`
- Vault contents remain after player death
- Automatic backups, enabled by default every 24 hours
- Backups stored in the `Backup` subfolder
- Backup import with `server-id` validation
- The current data is backed up automatically before an import
- Six languages: German, English, Italian, French, Polish and Russian
- Configurable opened-vault title
- Minecraft color and formatting codes for the vault title
- Placeholders for player name, current page and maximum page count

### Language and Configuration

First select the desired `language` in `config.yml`. Save the file and then run `/safe reload` or `/tresor reload` in-game.

After that, the `config.yml` can be edited again. Existing settings are preserved when the localized configuration is updated, while newly introduced settings are added with their default values.

Supported language values are:

- `de` – German
- `en` – English
- `it` – Italian
- `fr` – French
- `pl` – Polish
- `ru` – Russian

### Vault Title

The opened vault title can be configured with `vault-name` in `config.yml`. The placeholders are recalculated whenever the vault is opened or the page is changed.

Example:

```yaml
vault-name: "&6&lTitanium Safe &8- &fPage {page}/{pages}"
```

Supported color and formatting codes:

- `&0`–`&9`
- `&a`–`&f`
- `&k`, `&l`, `&m`, `&n`, `&o`
- `&r` to reset formatting

Placeholders:

- `{player}` – player name
- `{page}` – current page
- `{pages}` – maximum available pages

After changing the setting, save the file and run `/safe reload` or `/tresor reload` in-game.

### Pages and LuckPerms

When LuckPerms is enabled, available pages are determined by `titaniumsafe.pages.<number>`. The **highest assigned page number** is used. For example, assigning `titaniumsafe.pages.1` and `titaniumsafe.pages.3` makes pages 1 through 3 available.

The configured `vault.maximum-pages` value limits the maximum possible page count.

When LuckPerms is disabled, the page count is controlled through the corresponding settings in `config.yml`.

### Administrator Access

Authorized administrators can open and edit a player's vault with `/sa <player>`. Administrator access is independent of the player's current world.

`/sa reload`, `/safe reload` and `/tresor reload` reload the configuration and selected language.

### Backups and Import

Backups are created by default every 24 hours in the `Backup` subfolder.

The backup naming scheme is:

```text
TitaniumSafe-<date>-<time>.zip
```

An authorized administrator can import a backup with explicit confirmation. The current data is backed up automatically before the import. Backups from another server are rejected based on the stored `server-id`.

### Liability Disclaimer

**Titanium provides no guarantee or liability for lost, damaged, missing, or otherwise unavailable items.** The backup feature does not replace a complete and regularly tested server backup.

### Installation

1. Copy `TitaniumSafe.jar` into the server's `plugins` folder.
2. Start the server once so the configuration is created.
3. Select the desired `language` in `config.yml` first.
4. Save the file.
5. Run `/safe reload` or `/tresor reload` in-game.
6. Adjust the remaining settings in `config.yml` as required.

TitaniumSafe is designed for Paper and uses a `server-id` to keep the vault data of one server separate from vault data on other servers.