TagsRK | Tags, GUI, Progress & KOTH Rewards

Features

• Inventory-based tag selector with automatic unlimited pagination
• Custom tag names, descriptions, lore, materials and custom head textures
• Permission-based tags with live permission checks
• Vault purchases with persistent unlocks
• Kills, playtime and AxKoth victory conditions
• AxKoth CAPTURE and SCORE mode support
• Progress bars and percentages inside the GUI
• Optional per-tag color and formatting editor
• Legacy colors, hexadecimal colors and MiniMessage support
• SQLite database by default
• Optional MySQL connection through HikariCP
• Per-server progress using a configurable server ID
• PlaceholderAPI integration
• Optional Floodgate detection and alternative Bedrock items
• Configurable GUI borders, sounds, item glow and messages
• Spanish, English, Portuguese, German and Russian language files
• Per-key fallback to Spanish when a translation is missing
• No ProtocolLib or PacketEvents dependency

Progress Conditions

Tags can be unlocked by completing configured requirements:

• Player kills
• Days played
• AxKoth victories

Multiple conditions inside one tag must all be completed. Permission access, Vault purchases and completed conditions are evaluated independently.

Optional Integrations

• Vault: purchase tags using the server economy
• PlaceholderAPI: display the selected tag in chat, TAB or scoreboards
• Floodgate: use alternative GUI items for Bedrock players
• AxKoth: unlock tags by winning KOTH events

TagsRK can run without these integrations. Their related features are enabled only when the corresponding plugin is installed.

Installation

1. Download TagsRK.
2. Place the JAR inside your server's plugins directory.
3. Restart the server.
4. Edit plugins/TagsRK/config.yml and tags.yml.
5. Set a unique Server.Id when using a shared MySQL database.
6. Run /tagsrk reload after editing the configuration.

Java 8 or newer is required for the 1.16 baseline. Use the Java version required by your Minecraft server.

Main Commands

Permissions

Server operators can bypass tag requirements when operator bypass is enabled.

PlaceholderAPI

Condition placeholders are also available for progress, targets, remaining amounts, percentages and progress bars.

Important

Always back up your database and configuration before updating or using the global reset command.

/tagsrk resetall confirm removes TagsRK purchases, progress, selections, colors and favorites for the configured server. It does not modify external permissions.