ApoTags

# 🏷️ ApoTags <div align="center"> <!-- Replace with your actual banner URL --> !(https://cdn.modrinth.com/data/cached_images/c96e2e37685dac49275f185bb51e761d764d281f_0.webp) **The complete RGB tag manager for Paper servers.** Give your players beautifully colored prefix tags — with full GUI, PlaceholderAPI support, and zero file editing required. (https://img.shields.io/badge/Paper-1.19.4-blue?style=flat-square)](https://papermc.io) (https://img.shields.io/badge/Java-17-orange?style=flat-square)](https://adoptium.net) (https://img.shields.io/badge/PlaceholderAPI-optional-green?style=flat-square)](https://www.spigotmc.org/resources/6245/) </div> --- ## ✨ Features - 🎨 **Full RGB / HEX color support** — use `&#RRGGBB` hex codes and legacy `&` codes anywhere - 🖥️ **Paginated player GUI** — browse and equip tags with a clean inventory menu - 🛠️ **Admin GUI** — manage all tags in-game, toggle enable/disable with Shift+Click - 💾 **H2 embedded database** or **FlatFile** storage — no external database setup required - 📡 **PlaceholderAPI** — display active tags in chat, tab, scoreboards, and more - 🌍 **Multi-language** — built-in English and Spanish, easily add any language - ⚙️ **Fully customizable GUIs** — separate `gui_user.yml` and `gui_admin.yml` config files - 🔐 **Granular permissions** — one permission node per subcommand for maximum control - 🔄 **Live reload** — apply any config or tag changes without restarting the server - 🏷️ **Multi-line tag lore** — add rich descriptions to each tag shown in the GUI - 💡 **Zero hardcoded text** — every player-facing message lives in the language file --- ## 📦 Requirements | Dependency | Type | Version | |---|---|---| | Paper | Required | 1.19.4 | | Java | Required | 17+ | | PlaceholderAPI | Optional | 2.11.6+ | --- ## 🚀 Installation 1. Download `ApoTags.jar` and drop it into your `/plugins/` folder 2. Start or restart your server 3. All config files are generated automatically on first launch 4. Install (https://www.spigotmc.org/resources/6245/) if you want to display tags in chat or tab --- ## 📁 Default Configuration ### `config.yml` ```yaml # ───────────────────────────────────────────── # ApoTags Configuration # Authors: ApoloCR & ApoStudios # Version: 1.0.0 # ───────────────────────────────────────────── # Plugin locale: en / es locale: 'en' # Storage type: H2 / FLATFILE storage: 'H2' # GUI Settings gui_settings: title: 'ApoTags - Select your Tag' rows: 6 # Items for GUI navigation (Material names) next_page_item: 'ARROW' previous_page_item: 'ARROW' reset_tag_item: 'BARRIER' # Slot positions in row 6 (0-indexed from row start = slot 45) # Row 6: slots 45-53 prev_slot: 45 next_slot: 53 reset_slot: 49 # Filler item for empty slots (set to 'NONE' to disable) filler_item: 'GRAY_STAINED_GLASS_PANE' filler_name: ' ' ``` ### `tags.yml` — Default tags ```yaml VIP: order: 1 tag: '&7' lore: - '&eAwarded to VIP members' - '&7Thank you for your support!' permission: apotags.tag.vip enabled: true MVP: order: 2 tag: '&7' lore: - '&bAwarded to MVP members' - '&7The highest donor rank.' permission: apotags.tag.mvp enabled: true Apolo: order: 3 tag: '&#00f2ff&l ' lore: - '&#00f2ffExclusive Developer Tag' - '&7Reserved for ApoStudios staff.' permission: none enabled: true Staff: order: 4 tag: '&7' lore: - '&cFor server staff members' - '&7Helping keep the server safe.' permission: apotags.tag.staff enabled: true Helper: order: 5 tag: '&7' lore: - '&aFor server helpers' - '&7Always ready to assist.' permission: apotags.tag.helper enabled: true Builder: order: 6 tag: '&#ff9900&l ' lore: - '&#ff9900For talented builders' - '&7Creating amazing things.' permission: apotags.tag.builder enabled: true ``` > **Tip:** Tags with `permission: none` are available to every player for free. ### `gui/gui_user.yml` — Player GUI appearance ```yaml title: '&#00f2ff&lApoTags &8― &7Select your Tag' rows: 6 tag_item_material: 'NAME_TAG' tag_item_locked_material: 'PAPER' filler_material: 'GRAY_STAINED_GLASS_PANE' prev_page: material: 'ARROW' slot: 45 # leftmost slot of row 6 next_page: material: 'ARROW' slot: 53 # rightmost slot of row 6 reset_tag: material: 'BARRIER' slot: 49 # center of row 6 glow_active_tag: true custom_model_data_available: 0 custom_model_data_active: 1 custom_model_data_locked: 2 ``` ### `gui/gui_admin.yml` — Admin GUI appearance ```yaml title_prefix: '&c&l &r' enabled_tag_material: 'NAME_TAG' disabled_tag_material: 'PAPER' glow_enabled_tags: true filler_material: 'BLACK_STAINED_GLASS_PANE' info_item: material: 'COMMAND_BLOCK' slot: 49 ``` --- ## 💬 Commands All commands use `/tags` as the main label. Aliases: `/apotags`, `/tag` ### Player C