Agrado : namespace essentialX

2026-02-13T18:32:10Z

namespace essentialX

← Version précédente		Version du 13 février 2026 à 18:32
Ligne 14 :		Ligne 14 :
	\| docs = https://github.com/NEZNAMY/TAB/wiki		\| docs = https://github.com/NEZNAMY/TAB/wiki
	\| dépendance = Aucune (PlaceholderAPI recommandé)		\| dépendance = Aucune (PlaceholderAPI recommandé)
	\| compatibilité = [[Vault]], [[PlaceholderAPI]], [[LuckPerms]], [[EssentialsX]]		\| compatibilité = [[Vault]], [[PlaceholderAPI]], [[LuckPerms]], [[Plugin:EssentialsX\|EssentialsX]]
	}}		}}

Ligne 221 :		Ligne 221 :
	* [[LuckPerms]] — source de vérité pour '''prefix/suffix/meta/weights'''.		* [[LuckPerms]] — source de vérité pour '''prefix/suffix/meta/weights'''.
	* [[PlaceholderAPI]] — ouvre l’accès à des centaines de placeholders (économie, factions, stats...).		* [[PlaceholderAPI]] — ouvre l’accès à des centaines de placeholders (économie, factions, stats...).
	* [[EssentialsX]] — AFK, ping, infos joueur (placeholders utiles).		* [[Plugin:EssentialsX\|EssentialsX]] — AFK, ping, infos joueur (placeholders utiles).
	* [[Vault]] — économie/permissions en passerelle.		* [[Vault]] — économie/permissions en passerelle.

Ligne 254 :		Ligne 254 :
	* [[LuckPerms]]		* [[LuckPerms]]
	* [[PlaceholderAPI]]		* [[PlaceholderAPI]]
	* [[EssentialsX]]		* [[Plugin:EssentialsX\|EssentialsX]]
	* [[Scoreboard-revision]] / [[FeatherBoard]] (alternatives scoreboard)		* [[Scoreboard-revision]] / [[FeatherBoard]] (alternatives scoreboard)

Hiob : Hiob a déplacé la page TAB vers Plugin:TAB sans laisser de redirection

2026-02-10T20:34:12Z

Hiob a déplacé la page TAB vers Plugin:TAB sans laisser de redirection

← Version précédente	Version du 10 février 2026 à 20:34
(Aucune différence)

Hiob : Création

2025-10-18T08:01:57Z

Création

Nouvelle page

{{SHORTDESC:Personnalisation avancée du tablist, nametags, scoreboard et bossbar avec placeholders et règles conditionnelles.}}
{{Infobox Plugin
| nom = TAB
| image = TAB_Logo.png
| legende = Personnalisation tablist / scoreboard / nametag
| type = Cosmétique, utilitaire
| dev = NEZNAMY
| status = installé
| grade = [[Maraud]]
| spigot = 57806
| modrinth = tab-was-taken
| builtbybit = 20631
| sources = https://github.com/NEZNAMY/TAB
| docs = https://github.com/NEZNAMY/TAB/wiki
| dépendance = Aucune (PlaceholderAPI recommandé)
| compatibilité = [[Vault]], [[PlaceholderAPI]], [[LuckPerms]], [[EssentialsX]]
}}

'''TAB''' est un plugin premium qui permet de contrôler précisément l’affichage en jeu : tablist (préfixes/suffixes, tri, header/footer), '''nametags''' au‑dessus des joueurs (avec préfixe/suffixe dynamiques), '''scoreboards''' conditionnels et '''bossbars''' d’information, le tout avec support complet des placeholders (PlaceholderAPI et plugins populaires).

== Objectif ==
Fournir un cadre unifié pour afficher des informations propres et cohérentes sur TOUTES les surfaces visuelles (tab, nametag, scoreboard, bossbar), sans scripts complexes, et avec un système de règles simple (par monde, par serveur, par groupe, par permission, par placeholder).

== Cas d’usage courants ==
; 1) Préfixes/suffixes LuckPerms partout
* Afficher le '''grade''' LP devant les pseudos dans la tablist et les nametags.
* Reprendre le '''prefix/suffix/meta''' de LuckPerms et l’unifier avec les couleurs du serveur.
: Exemple (extrait typique) :
<syntaxhighlight lang="yaml">
# Nametag format (exemple d'intention)
nametag:
enable: true
formatting:
default:
prefix: "%luckperms_prefix%"
suffix: "%luckperms_suffix%"
belowname: "&7❤ %player_health_rounded%"
</syntaxhighlight>

; 2) Tri du tablist
* Ordonner les joueurs par rang (poids LuckPerms), puis par statut (staff en haut, AFK en bas, etc.).
: Exemple d’intention :
<syntaxhighlight lang="yaml">
sorting:
by: [ "group-weight", "staff", "afk", "alphabetic" ]
</syntaxhighlight>

; 3) Header/Footer dynamiques
* Messages d’accueil, infos d’événements, stats, rotation de lignes, support placeholders PAPI.
: Exemple :
<syntaxhighlight lang="yaml">
tablist:
header:
- "&bBienvenue &f%player_name% &7sur &aMonServeur"
- "&7En ligne: &a%server_online%&7/&a%server_max_players%"
footer:
- "&7Ping: &a%player_ping%ms &7TPS: &a%server_tps_1%"
</syntaxhighlight>

; 4) Scoreboards contextuels
* Un scoreboard différent par monde/jeu/permission (ex: survie, skyblock, pvp), avec placeholders PAPI.
: Exemple :
<syntaxhighlight lang="yaml">
scoreboards:
enable: true
default:
title: "&bMonServeur"
lines:
- "&fJoueur: &a%player_name%"
- "&fArgent: &a%vault_eco_balance_formatted%"
- "&fK/D: &a%statistic_player_kills%&7/&c%statistic_deaths%"
conditions:
- condition: "%player_world%=skyblock"
use: "skyblock"
- condition: "%player_has_permission% pvp.mode"
use: "pvp"
</syntaxhighlight>

; 5) Bossbar d’information
* Barres temporisées (compte à rebours, annonce, event).
: Exemple :
<syntaxhighlight lang="yaml">
bossbar:
enable: true
bars:
info:
text: "&eEvent dans &c%event_time_remaining%"
color: "YELLOW"
style: "SEGMENTED_10"
progress: 1.0
permission: "tab.bossbar.info"
</syntaxhighlight>

; 6) Messages sous le pseudo (belowname)
* Afficher vie, mana, points, faction, etc.
: Exemple :
<syntaxhighlight lang="yaml">
belowname:
enable: true
text: "&c❤ &f%player_health_rounded% &b⚡ &f%aureliumskills_mana%"
</syntaxhighlight>

== Placeholders (idées pratiques) ==
TAB consomme les placeholders de PlaceholderAPI et d’autres plugins.
* Grades : %luckperms_prefix%, %luckperms_suffix%, %luckperms_meta_weight%
* Économie : %vault_eco_balance_formatted%
* Réseau : %server_online%, %bungee_total%, %velocity_total%
* Perf : %server_tps_1%, %server_tps_5%, %player_ping%
* Jeu : %player_world%, %statistic_player_kills%, %statistic_deaths%

Astuce : combine des couleurs et symboles Unicode pour une hiérarchie lisible (◆, ★, ✦).

== Règles et ciblage (conditions) ==
Tu peux cibler n’importe quelle surface (tablist/nametag/scoreboard/bossbar) par :
* permission (ex : tab.view.staff)
* groupe (via placeholders LP)
* monde / serveur (proxy) / gamemode
* valeur de placeholder (égalité, contient, regex selon le placeholder)

Patron générique :
<syntaxhighlight lang="yaml">
conditions:
- condition: "%player_has_permission% staff.view"
use: "staff"
- condition: "%player_world%=nether"
use: "nether"
- condition: "%some_placeholder%~=^event_.+"
use: "event"
</syntaxhighlight>

== Commandes TAB — tableaux complets ==
; Remarque : sur proxy (Bungee/Velocity), la commande est '''/btab''' (mêmes permissions). Exemple : <code>/btab reload</code>.

=== Configuration et debug ===
{| class="wikitable sortable"
! Commande !! Description !! Permission !! Options/Remarques
|-
| <code>/tab <player/group/playeruuid> <name> <property> [value] [options]</code> || Définit une propriété pour un joueur/groupe. Sans value, la propriété est supprimée. Propriétés : <code>tabprefix</code>, <code>customtabname</code>, <code>tabsuffix</code>, <code>tagprefix</code>, <code>tagsuffix</code>. || <code>tab.change.<property></code> || Options : <code>-s <server></code>, <code>-w <world></code>. <code>player</code> accepte pseudo ou UUID ; <code>group</code> = groupe permissions ; <code>_DEFAULT_</code> = défaut global.
|-
| <code>/tab <player/group/playeruuid> <name> remove</code> || Supprime toutes les données directes du joueur/groupe ciblé. || <code>tab.remove</code> || <code>playeruuid</code> requiert un joueur en ligne.
|-
| <code>/tab reload</code> || Recharge complètement le plugin et la configuration. || <code>tab.reload</code> || —
|-
| <code>/tab debug [player]</code> || Infos version, logique de groupe, méthode de tri ; avec <code>player</code> : détails (valeurs de tri, groupe, propriétés et sources). || <code>tab.debug</code> || Sur proxy, indique si Bridge est connecté.
|-
| <code>/tab group <group></code> || Affiche tous les réglages appliqués à un groupe. || <code>tab.groupinfo</code> || Utile avec MySQL.
|-
| <code>/tab groups</code> || Liste tous les groupes ayant des données. || <code>tab.grouplist</code> || Utile avec MySQL.
|}

=== Scoreboard ===
{| class="wikitable sortable"
! Commande !! Description !! Permission !! Options
|-
| <code>/tab scoreboard show <name> [player]</code> || Affiche le scoreboard nommé pour soi ou pour <code>player</code>. || <code>tab.scoreboard.show</code> (soi), <code>tab.scoreboard.show.other</code> (autrui) || —
|-
| <code>/tab scoreboard [on/off/toggle] [player] [options]</code> || Active/désactive/alterne le scoreboard pour soi ou <code>player</code>. || <code>tab.scoreboard.toggle</code> (soi), <code>tab.scoreboard.toggle.other</code> (autrui) || <code>-s</code> = silencieux (pas de message au joueur).
|-
| <code>/tab scoreboard announce <name> <duration></code> || Diffuse le scoreboard nommé à tous pour <code>duration</code> (secondes). || <code>tab.announce.scoreboard</code> || —
|}

=== Bossbar ===
{| class="wikitable sortable"
! Commande !! Description !! Permission !! Options
|-
| <code>/tab bossbar show <name> [player]</code> || Affiche la bossbar nommée pour soi ou <code>player</code>. || <code>tab.bossbar.show</code> (soi), <code>tab.bossbar.show.other</code> (autrui) || —
|-
| <code>/tab bossbar [on/off/toggle] [player] [options]</code> || Active/désactive/alterne la bossbar pour soi ou <code>player</code>. || <code>tab.bossbar.toggle</code> (soi), <code>tab.bossbar.toggle.other</code> (autrui) || <code>-s</code> = silencieux.
|-
| <code>/tab bossbar announce <name> <duration></code> || Diffuse la bossbar nommée à tous pour <code>duration</code> (secondes). || <code>tab.announce.bar</code> || —
|}

=== Nametags / Teams ===
{| class="wikitable sortable"
! Commande !! Description !! Permission !! Options
|-
| <code>/tab nametag <show/hide/toggle> [player] [viewer] [options]</code> || Affiche/masque/alterne le nametag de <code>player</code>. Avec <code>viewer</code>, n’affecte que sa vue. || <code>tab.nametag.visibility</code> (soi), <code>tab.nametag.visibility.other</code> (autrui) || <code>-s</code> = silencieux.
|-
| <code>/tab nametag <showview/hideview/toggleview> [viewer] [options]</code> || Affiche/masque/alterne la VUE des nametags pour <code>viewer</code>. || <code>tab.nametag.view</code> (soi), <code>tab.nametag.view.other</code> (autrui) || <code>-s</code> = silencieux.
|-
| <code>/tab setcollision <player> <true|false></code> || Force la règle de collision pour <code>player</code> (prioritaire sur la config). || <code>tab.setcollision</code> || —
|}

=== MySQL (synchronisation des données) ===
{| class="wikitable sortable"
! Commande !! Description !! Permission !! Remarques
|-
| <code>/tab mysql upload</code> || Envoie toutes les données de <code>users.yml</code> et <code>groups.yml</code> vers MySQL. || <code>tab.mysql.upload</code> || MySQL doit être activé et connecté.
|-
| <code>/tab mysql download</code> || Télécharge toutes les données de MySQL vers <code>users.yml</code> et <code>groups.yml</code>. || <code>tab.mysql.download</code> || MySQL doit être activé et connecté.
|}

=== Outils / Autres ===
{| class="wikitable sortable"
! Commande !! Description !! Permission !! Remarques
|-
| <code>/tab cpu</code> || Affiche l’usage CPU approximatif du plugin (fenêtre ~10s). || <code>tab.cpu</code> || Voir l’optimisation si l’empreinte est élevée.
|-
| <code>/tab parse <player> <text></code> || Évalue les placeholders dans <code>text</code> (TAB + PAPI si installé). || <code>tab.parse</code> || Ex : <code>/tab parse <moi> %vault_eco_balance%</code>.
|}

=== Permissions additionnelles ===
{| class="wikitable"
! Permission !! Effet
|-
| <code>tab.admin</code> || Autorise toutes les commandes TAB.
|-
| <code>tab.bypass</code> || Si « per‑world playerlist » est actif, voit tous les joueurs malgré l’isolation.
|-
| <code>tab.staff</code> || Compte le joueur dans le placeholder <code>%staffonline%</code>.
|-
| <code>tab.spectatorbypass</code> || Bypass pour la fonctionnalité « Spectator fix » (si activé).
|-
| <code>tab.tabcomplete</code> || Autorise l’auto‑complétion de <code>/tab</code>.
|-
| <code>tab.seevanished</code> || Permet de voir les joueurs vanished sur Global Playerlist et Layout.
|}

== Intégrations recommandées ==
* [[LuckPerms]] — source de vérité pour '''prefix/suffix/meta/weights'''.
* [[PlaceholderAPI]] — ouvre l’accès à des centaines de placeholders (économie, factions, stats...).
* [[EssentialsX]] — AFK, ping, infos joueur (placeholders utiles).
* [[Vault]] — économie/permissions en passerelle.

== Convivialité et cohérence visuelle ==
* Définis une charte couleur par rang (staff, vip, joueur) et réutilise‑la dans TOUS les écrans.
* Limite le nombre de lignes dans le scoreboard (<15) et évite les placeholders « chers » mis à jour trop souvent.
* Prévois des versions « compactes » mobile‑friendly pour les packs HUD.

== Dépannage (usage quotidien) ==
; Placeholders non résolus
* Vérifie que PlaceholderAPI est installé et que l’expansion est chargée (<code>/papi ecloud download ...</code>, <code>/papi reload</code>).
* Teste avec <code>/tab parse %placeholder%</code>.

; Conflits d’affichage
* N’utilise qu’UN seul plugin par surface : si un autre plugin gère le scoreboard ou les nametags, désactive la fonctionnalité correspondante dans TAB (ou dans l’autre plugin).
* Sur Paper 1.8–1.12, les nametags longs nécessitent les modes dédiés de TAB (ex. '''unlimited nametag'''). Vérifie la doc de ta version.

; Tri incorrect
* Assure‑toi que les poids de groupes LuckPerms sont cohérents (plus grand = plus haut, ou inverse selon ta convention) et que le mode de tri de TAB les lit bien.

; Perfs
* Évite les placeholders à calcul lourd en rafraîchissement fréquent (préférer 1–2s+).
* Sur réseau (Bungee/Velocity), aligne les versions du plugin et la config côté proxy et backends si tu utilises les fonctions réseau.

== Bonnes pratiques ==
* Centralise les '''prefix/suffix''' dans LuckPerms et laisse TAB les afficher partout (moins de duplication).
* Versionne ta configuration TAB (Git) et documente les règles.
* Utilise des '''conditions''' plutôt que multiplier les fichiers pour chaque monde/rang.
* Teste les gros changements hors‑ligne (serveur de staging) avant la prod.

== Voir aussi ==
* [[LuckPerms]]
* [[PlaceholderAPI]]
* [[EssentialsX]]
* [[Scoreboard-revision]] / [[FeatherBoard]] (alternatives scoreboard)

Plugin:TAB - Historique des versions

Agrado : namespace essentialX

Hiob : Hiob a déplacé la page TAB vers Plugin:TAB sans laisser de redirection

Hiob : Création

Agrado : namespace essentialX

Hiob : Hiob a déplacé la page TAB vers Plugin:TAB sans laisser de redirection

Hiob : Création