TimeTags - Reward Your Players' Loyalty
A complete system of tags based on playtime and special tags, with interactive menus and full support for PlaceholderAPI.

TimeTags is the definitive solution for servers that want to recognize and reward their players' dedication. Create a visual progression system where players unlock new chat and tablist tags as they accumulate hours of gameplay. Additionally, create and assign special tags to your staff, VIPs, or event winners with a simple command.

With modern GUI menus and an extremely flexible configuration, TimeTags offers a premium experience for both players and administrators.

Interactive main menu for tag selection.

⭐ Key Features ⭐

• Playtime Tags: Create a ladder of prestige! Define as many tags as you want, each requiring a certain number of hours played to be unlocked.
  
  
• Unlimited Special Tags: Need a [Staff], [VIP], or [Youtuber] tag? Create special tags that don't depend on time and assign them to specific players via command.
  
  
• 100% Interactive GUIs: No more confusing commands! With /tags, players access a complete menu to:
  • View and select their unlocked playtime tags.
    
    
  • Access a separate menu for their special tags.
    
    
  • See a ranking with the playtime of the server's top players.
• Total Player Control: Your players can choose where to display the selected tag: only in Chat, only in the Tablist, in Both, or they can choose to temporarily remove the tag.
  
  
• Seamless PlaceholderAPI Integration: Use the %timetags_chat% and %timetags_tab% placeholders to display tags in any chat, tablist, scoreboard plugin, or wherever else you desire.
  
  
• Deep Customization: Customize EVERYTHING!
  • Size of menus, items, names, and lores.
    
    
  • Sound and particle effects for each action (opening menu, selecting a tag, etc.).
    
    
  • All messages are translatable through the lang folder.
• Lightweight and Optimized: Designed to have minimal impact on your server's performance.
  
  
• Playtime ranking with pagination.

Commands and Permissions


Simple Configuration
The configuration of TimeTags is designed to be easy and powerful. Adding new tags is as simple as copying and pasting in the config.yml file.



Placeholders
For the tags to appear, you need to have PlaceholderAPI installed.

• %timetags_chat% - Use this placeholder in your chat plugin's format.
  
  
• %timetags_tab% - Use this placeholder in your tablist plugin's format.

If a player does not have a visible tag, the placeholder will display whatever is configured in no_tag_placeholder in your messages file, allowing for full integration with prefixes from other plugins like LuckPerms.

Installation

1. Download TimeTags.jar and PlaceholderAPI.jar.
   
   
2. Place both files in your server's plugins folder.
   
   
3. Restart the server. The configuration files will be generated automatically.
   
   
4. Configure the tags and messages as you wish and use /timetags reload.