📖About ExtractTitles

ExtractTitles is a full-featured titles plugin for Paper 1.21.x servers with a clean GUI, economy integration, PlaceholderAPI support, and configurable active-title effects.

Features

🧩 In-game titles menu (/titles) with card states:
- not owned
- owned but inactive
- owned and active
💰 Purchases via Vault or PlayerPoints
⏳ Ownership modes:
- permanent
- temporary (with configurable durations and prices)
🔌 PlaceholderAPI support for chat, TAB, scoreboard, nametags, holograms, and other compatible plugins
🛠️ Active-title effects:
- max health bonus
- potion effects
- temporary permission nodes
- commands on activate/deactivate
- 3x3 mining mode
💾 Persistent data storage:
- SQLite
- MySQL
⚙️ Full YAML customization:
- messages
- menu layout
- title definitions
- prices and durations
- effect templates

Why

ExtractTitles helps you build a progression and reward system around titles while keeping the player experience simple and visual.

You can create cosmetic titles, utility titles, or hybrid titles with gameplay bonuses — all without hardcoding.
Everything is configurable, including placeholders, formatting, purchase behavior, and menu design.

Requirements

Java 21
Paper 1.21.x (Purpur compatible)

Recommended dependencies:

PlaceholderAPI
Vault (with economy plugin) or PlayerPoints

Notes

Economy purchases require at least one provider:
- Vault + economy plugin, or
- PlayerPoints
PlaceholderAPI is recommended if you want title output in external plugins.
Configure files in plugins/ExtractTitles/:
- config.yml
- storage.yml
- messages.yml
- menus.yml
- titles.yml
- effects.yml

Placeholders

%extracttitles_active_title%
%extracttitles_active_title_name%
%extracttitles_active_title_raw%
%extracttitles_owned_count%
%extracttitles_total_count%
%extracttitles_active_title_or_none%
%extracttitles_active_title_or_blank%
%extracttitles_has_title_<id>%
%extracttitles_title_expiry_<id>%
%extracttitles_title_remaining_<id>%

Duration

You can customize duration words in messages.yml:

duration-forever
duration-day-short
duration-hour-short
duration-minute-short
duration-second-short

This controls how remaining time is shown in menu/messages (for example: 6d. 4h. 12min.).

Screenshots

Titles menu
Information panel
Activated title card
Owned but inactive title card
Not purchased title (permanent option)
Not purchased title (temporary option)

Scoreboard placeholder example