LuckPerms - Hover - Addon

Overview
The LuckPerms Hover Addon is a plugin that adds hover messages and click actions to LuckPerms prefixes and suffixes. It works with ANY chat plugin and doesn't overwrite existing formats.

Commands
/lphover sethover <group> <prefix/suffix> <message>
Sets a hover message for a group's prefix or suffix.

• group: Name of the LuckPerms group (e.g., VIP, Admin, Player)
  
  
• prefix/suffix: Where the hover message should appear
  
  
• message: The text shown when hovering over it
  

Examples:

text
/lphover sethover VIP prefix &6&lVIP\n&7Click for VIP info
/lphover sethover Admin prefix &c&lADMIN\n&7Server Admin
/lphover sethover Premium suffix &a✓\n&7Premium Member
/lphover removehover <group> <prefix/suffix>
Removes the hover message from a group.

Example:

text
/lphover removehover VIP prefix
/lpclick setclick <group> <prefix/suffix> <suggest/run> <command>
Sets a click action for prefix or suffix.

• suggest: Command appears in chat input (must be confirmed with Enter)
  
  
• run: Command is executed immediately on click
  

Examples:

text
/lpclick setclick VIP prefix suggest /ranks info
/lpclick setclick Admin prefix run /admin menu
/lpclick setclick Premium suffix run /shop
/lpclick removeclick <group> <prefix/suffix>
Removes the click action from a group.

Example:

text
/lpclick removeclick VIP prefix
Color Codes
The plugin supports ALL Minecraft color codes:



Code Color/Effect Code Color/Effect
&0 Black &a Green
&1 Dark Blue &b Aqua
&2 Dark Green &c Red
&3 Cyan &d Pink
&4 Dark Red &e Yellow
&5 Purple &f White
&6 Gold/Orange &7 Gray
&8 Dark Gray &9 Blue
&k Magic (obfuscated) &l Bold
&m ~~Strikethrough~~ &n Underlined
&o Italic &r Reset
Hex Colors (Minecraft 1.16+):

text
&#FF0000 = Red
&#00FF00 = Green
&#0000FF = Blue
&#FFAA00 = Orange
Line Break:

text
\n = New line in hover message
Placeholders (for PlaceholderAPI)


Placeholder Description
%lpgroup_hover_prefix% Shows hover message of the PREFIX of the player's current group
%lpgroup_hover_suffix% Shows hover message of the SUFFIX of the player's current group
Important:

• Placeholders show ONLY the text of the hover message (no automatic hover function)
  
  
• If no hover is set, they show nothing (empty)
  
  
• They automatically detect the player's group
  
  
• Each player sees their own group's hover message
  

Integration in Chat Plugins
Example: ChatSystem Config (config.yml):

yaml
chat:
format: "%luckperms_prefix% %player_name% %luckperms_suffix% &8» &f%message%"
hover:
enabled: true
lines:
- "%lpgroup_hover_prefix%"
- "%lpgroup_hover_suffix%"
Example: Other Chat Plugin:

yaml
format: "{PREFIX} {NAME} {SUFFIX} &8» &f{MESSAGE}"
hover_format: "{lpgroup_hover_prefix}\n{lpgroup_hover_suffix}"
The plugin itself automatically adds hover and click to prefix/suffix in chat, even WITHOUT the chat plugin being configured!

Permissions


Permission Description Default
luckperms.hoveraddon.admin Allows managing hover and click OPs only
Grant permission:

text
/lp user PlayerName permission set luckperms.hoveraddon.admin true
/lp group Moderator permission set luckperms.hoveraddon.admin true
Storage
1. LuckPerms Meta Data:

• Stored in LuckPerms database
  
  
• Automatically inherited by players
  
  
• Keys: hover-prefix, hover-suffix, click-prefix, click-suffix
  

2. Custom YML Files:

• Folder: plugins/LuckPerms-HoverAddon/hoverdata/
  
  
• One file per group (e.g., VIP.yml, Admin.yml)
  
  
• Contains all hover and click information
  
  
• Serves as backup and for manual editing
  

Example VIP.yml:

yaml
group: VIP
hover:
prefix:
message: "&6&lVIP\n&7Click for VIP info"
last_updated: 1234567890
last_updated_by: "AdminName"
click:
prefix:
action: "SUGGEST"
command: "/ranks info"
last_updated: 1234567890
last_updated_by: "AdminName"
Chat Functionality
Process when a player sends a message:

1. Chat Plugin formats the message with %luckperms_prefix%, %player_name%, %luckperms_suffix%, etc.
   
   
2. LuckPerms Hover Addon automatically detects:
   
   • Which group the player belongs to
     
     
   • If hover messages are set for that group
     
     
   • If click actions are set for that group
     
3. Hover and Click are applied ONLY to prefix/suffix, the rest of the message remains untouched
   

Result:

• Without Hover/Click: Prefix and suffix displayed normally
  
  
• With Hover: Hovering with the mouse shows the configured message
  
  
• With Click: Clicking on prefix/suffix executes the action
  
  
• No Overwriting: Other hover events or click actions in the message remain intact
  

Auto-Save
The plugin saves automatically:

• After each command (sethover, removehover, setclick, removeclick)
  
  
• On server shutdown (onDisable)
  
  
• Manually via /lphover reload (reload config)
  

Quick Start

1. Install Plugin: Place JAR in plugins/ folder
   
   
2. Start Server: Plugin loads automatically
   
   
3. Set Hover: /lphover sethover VIP prefix &6&lVIP
   
   
4. Set Click: /lpclick setclick VIP prefix suggest /ranks
   
   
5. Test: Write in chat as VIP player and hover over the prefix

⚡ Performance

• All data is cached in memory
  
  
• Hover/Click checks are instant
  
  
• No database queries during chat events
  
  
• Minimal impact on server performance
  
  
• Compatible with all Paper/Spigot versions 1.21+
  

✅ Summary / Zusammenfassung
The plugin provides:

• ✅ Hover messages on prefixes and suffixes
  
  
• ✅ Click actions on prefixes and suffixes
  
  
• ✅ Automatic group detection for each player
  
  
• ✅ Full color code support (including hex)
  
  
• ✅ Compatible with all chat plugins
  
  
• ✅ PlaceholderAPI support
  
  
• ✅ No overwriting of other formats
  
  
• ✅ File-based storage for easy backup
  
  
• ✅ 100% configurable messages
  

Übersicht
Das LuckPerms Hover Addon ist ein Plugin, das Hover-Nachrichten und Klick-Aktionen zu LuckPerms Prefixen und Suffixen hinzufügt. Es funktioniert mit JEDEM Chat-Plugin und überschreibt keine bestehenden Formate.

Befehle (Commands)
/lphover sethover <gruppe> <prefix/suffix> <nachricht>
Setzt eine Hover-Nachricht für den Prefix oder Suffix einer Gruppe.

• Gruppe: Name der LuckPerms Gruppe (z.B. VIP, Admin, Spieler)
  
  
• prefix/suffix: Wo die Hover-Nachricht erscheinen soll
  
  
• Nachricht: Der Text der beim Drüberhovern angezeigt wird
  

Beispiele:

text
/lphover sethover VIP prefix &6&lVIP\n&7Klicke für VIP-Infos
/lphover sethover Admin prefix &c&lADMIN\n&7Server-Leiter
/lphover sethover Premium suffix &a✓\n&7Premium Mitglied
/lphover removehover <gruppe> <prefix/suffix>
Entfernt die Hover-Nachricht von einer Gruppe.

Beispiel:

text
/lphover removehover VIP prefix
/lpclick setclick <gruppe> <prefix/suffix> <suggest/run> <befehl>
Setzt eine Klick-Aktion für Prefix oder Suffix.

• suggest: Der Befehl erscheint im Chat-Eingabefeld (muss mit Enter bestätigt werden)
  
  
• run: Der Befehl wird sofort beim Klicken ausgeführt
  

Beispiele:

text
/lpclick setclick VIP prefix suggest /ränge info
/lpclick setclick Admin prefix run /admin menü
/lpclick setclick Premium suffix run /shop
/lpclick removeclick <gruppe> <prefix/suffix>
Entfernt die Klick-Aktion von einer Gruppe.

Beispiel:

text
/lpclick removeclick VIP prefix
Farbcodes
Das Plugin unterstützt ALLE Minecraft-Farbcodes:



Code Farbe/Effekt Code Farbe/Effekt
&0 Schwarz &a Grün
&1 Dunkelblau &b Aqua
&2 Dunkelgrün &c Rot
&3 Cyan &d Pink/Lila
&4 Dunkelrot &e Gelb
&5 Lila &f Weiß
&6 Gold/Orange &7 Grau
&8 Dunkelgrau &9 Blau
&k Magic (wirr) &l Fett
&m ~~Durchgestrichen~~ &n Unterstrichen
&o Kursiv &r Reset
Hex-Farbcodes (Minecraft 1.16+):

text
&#FF0000 = Rot
&#00FF00 = Grün
&#0000FF = Blau
&#FFAA00 = Orange
Zeilenumbruch:

text
\n = Neue Zeile in der Hover-Nachricht
Placeholder (für PlaceholderAPI)


Placeholder Beschreibung
%lpgroup_hover_prefix% Zeigt die Hover-Nachricht des PREFIX der aktuellen Spieler-Gruppe
%lpgroup_hover_suffix% Zeigt die Hover-Nachricht des SUFFIX der aktuellen Spieler-Gruppe
Wichtig:

• Die Placeholder zeigen NUR den Text der Hover-Nachricht (keine automatische Hover-Funktion)
  
  
• Wenn kein Hover gesetzt ist, zeigen sie nichts an (leer)
  
  
• Sie erkennen automatisch die Gruppe des Spielers
  
  
• Jeder Spieler sieht die Hover-Nachricht seiner eigenen Gruppe
  

Integration in Chat-Plugins
Beispiel: ChatSystem Konfiguration (config.yml):

yaml
chat:
format: "%luckperms_prefix% %player_name% %luckperms_suffix% &8» &f%message%"
hover:
enabled: true
lines:
- "%lpgroup_hover_prefix%"
- "%lpgroup_hover_suffix%"
Beispiel: Anderes Chat-Plugin:

yaml
format: "{PREFIX} {NAME} {SUFFIX} &8» &f{MESSAGE}"
hover_format: "{lpgroup_hover_prefix}\n{lpgroup_hover_suffix}"
Das Plugin selbst fügt automatisch Hover und Click zu Prefix/Suffix im Chat hinzu, auch OHNE dass das Chat-Plugin konfiguriert werden muss!

Permissions (Berechtigungen)


Permission Beschreibung Standard
luckperms.hoveraddon.admin Erlaubt das Verwalten von Hover und Click Nur OPs
Permission vergeben:

text
/lp user SpielerName permission set luckperms.hoveraddon.admin true
/lp group Moderator permission set luckperms.hoveraddon.admin true
Speicherung
1. LuckPerms Meta-Daten:

• Werden in der LuckPerms-Datenbank gespeichert
  
  
• Werden automatisch an Spieler vererbt
  
  
• Keys: hover-prefix, hover-suffix, click-prefix, click-suffix
  

2. Eigene YML-Dateien:

• Ordner: plugins/LuckPerms-HoverAddon/hoverdata/
  
  
• Für jede Gruppe eine eigene Datei (z.B. VIP.yml, Admin.yml)
  
  
• Enthält alle Hover- und Click-Informationen
  
  
• Dient als Backup und zur manuellen Bearbeitung
  

Beispiel VIP.yml:

yaml
group: VIP
hover:
prefix:
message: "&6&lVIP\n&7Klicke für VIP-Infos"
last_updated: 1234567890
last_updated_by: "AdminName"
click:
prefix:
action: "SUGGEST"
command: "/ränge info"
last_updated: 1234567890
last_updated_by: "AdminName"
Funktionsweise im Chat
Ablauf wenn ein Spieler eine Nachricht sendet:

1. Chat-Plugin formatiert die Nachricht mit %luckperms_prefix%, %player_name%, %luckperms_suffix%, etc.
   
   
2. LuckPerms Hover Addon erkennt automatisch:
   
   • Welche Gruppe der Spieler hat
     
     
   • Ob für diese Gruppe Hover-Nachrichten gesetzt sind
     
     
   • Ob für diese Gruppe Klick-Aktionen gesetzt sind
     
3. Hover und Click werden NUR auf den Prefix/Suffix angewendet, der Rest der Nachricht bleibt unberührt
   

Ergebnis:

• Ohne Hover/Click: Prefix und Suffix werden normal angezeigt
  
  
• Mit Hover: Beim Drüberhovern mit der Maus erscheint die eingestellte Nachricht
  
  
• Mit Click: Beim Klicken auf Prefix/Suffix wird die Aktion ausgeführt
  
  
• Kein Überschreiben: Andere Hover-Events oder Klick-Aktionen in der Nachricht bleiben erhalten
  

Auto-Speicherung
Das Plugin speichert automatisch:

• Nach jedem Befehl (sethover, removehover, setclick, removeclick)
  
  
• Beim Server-Stop (onDisable)
  
  
• Manuell durch /lphover reload (Config neu laden)
  

Schnellstart

1. Plugin installieren: JAR in plugins/ Ordner legen
   
   
2. Server starten: Plugin wird automatisch geladen
   
   
3. Hover setzen: /lphover sethover VIP prefix &6&lVIP
   
   
4. Click setzen: /lpclick setclick VIP prefix suggest /ränge
   
   
5. Testen: Als VIP-Spieler in den Chat schreiben und über den Prefix hovern