Armor Says Wiki

01

Résumé rapide

Armor Says est un plugin orienté administration pour créer, modifier et sauvegarder des armor stands interactifs directement en jeu via une interface graphique complète.

Cas d'usage typiques

Hub / lobby
PNJ décoratifs interactifs
Stands boutique
Liens Discord, site ou vote
Portails d'information
Hologrammes cliquables

Compatibilité runtime

Spigot / Paper 1.20.4+ Java 17 api-version 1.20

Hooks optionnels

Vault PlaceholderAPI ProtocolLib

💡

Le plugin démarre sans ces hooks. Leur état est simplement détecté et affiché au lancement.

02

Installation

Installation simple depuis le jar puis premier démarrage du plugin.

Placez ArmorSays-1.0.0.jar dans le dossier plugins/ de votre serveur.
Démarrez le serveur et vérifiez la création du dossier plugins/ArmorSays/.
Contrôlez la bannière console et l'état des hooks au lancement.
Connectez-vous avec un compte disposant de la permission armorsays.admin.

Premier lancement

Création automatique du dossier de données si besoin.
Copie des fichiers lang/fr.yml et lang/en.yml.
Synchronisation automatique des clés de langue manquantes.
Chargement de la langue configurée et des stands sauvegardés.
Respawn de tous les stands gérés au démarrage.

Fichiers principaux

plugins/ArmorSays/ ├── config.yml ├── lang/ │ ├── fr.yml │ └── en.yml ├── stands.yml └── armor-says.db

03

Commandes

Le plugin expose une seule commande principale avec plusieurs sous-commandes d'administration.

Commande	Description
`/armorsays` / `/as`	Ouvre le menu principal.
`/as new` / `/as new <id>`	Crée un nouveau stand, demande ou utilise l'ID, puis ouvre l'éditeur.
`/as create <id>`	Alias de la création.
`/as edit` / `/as edit <id>`	Ouvre la liste des stands ou l'éditeur d'un stand précis.
`/as delete <id>`	Supprime un stand existant.
`/as list`	Affiche la liste paginée des stands.
`/as reload`	Recharge la configuration, les langues et les stands.

ℹ️

La tab-completion propose les sous-commandes principales, les IDs existants pour edit/delete et quelques suggestions d'IDs pour la création.

04

Permissions

Permission	Description
`armorsays.admin`	Donne accès à toute l'administration du plugin, à l'éditeur et au clic d'édition en sneak. Par défaut: op.

05

Fonctionnement général en jeu

5.1 Création d'un stand

Définir un ID non vide et valide.
Vérifier qu'il n'existe pas déjà.
Créer un brouillon avec valeurs par défaut.
Sauvegarder immédiatement ce brouillon.
Ouvrir le mode d'édition avec preview.

💡

Les IDs acceptent uniquement lettres, chiffres, underscore et tiret, avec la regex [a-zA-Z0-9_-]+.

5.2 Interaction joueur

Le stand réagit au clic droit et au clic gauche via les dégâts d'entité.
Le comportement vanilla est annulé sur les stands gérés.
Un admin en sneak avec la permission ouvre directement l'éditeur au lieu d'exécuter l'action publique.

5.3 Robustesse d'apparition

Suppression des doublons déjà présents.
Restauration des stands sauvegardés au chargement du plugin et des chunks.
Vérification du stand et de ses lignes flottantes.
Respawn automatique si une partie manque.

06

Menus GUI

Le plugin est structuré autour de plusieurs interfaces spécialisées pour garder un flux d'administration lisible.

Menu principal et liste

Créer un armor stand.
Ouvrir la liste paginée avec recherche par ID.
Afficher rapidement ID, URL, monde et position.
Accéder aux paramètres de langue et de stockage.

Éditeurs dédiés

Éditeur principal du stand: nom, action, texte flottant, placement, orientation, équipement, pose, toggles, sauvegarde et suppression.
Éditeur d'action: type, message, URL et commande.
Éditeur de texte flottant: voir, ajouter, modifier ou supprimer des lignes.
Éditeur d'équipement et choix de tête avec navigateur d'objets et têtes joueur.
Éditeur de pose via mode outil qui remplace temporairement la hotbar.

07

Système de preview et sécurité d'édition

Pendant l'édition, le plugin remplace temporairement le stand réel par une preview pour préserver la version sauvegardée.

Le stand réel est despawn pendant l'édition.
Un stand de preview et ses lignes flottantes sont affichés.
Une sauvegarde convertit le brouillon en stand final puis respawn le stand réel.
Fermer l'éditeur sans sauvegarder restaure la dernière version enregistrée.
Un stand nouvellement créé n'est pas perdu grâce à l'auto-sauvegarde initiale.

08

Actions au clic, placeholders et rendu

Type	Comportement
`LINK_MESSAGE`	Envoie un message cliquable qui ouvre l'URL configurée.
`MESSAGE`	Envoie un message simple dans le chat.
`PLAYER_COMMAND`	Fait exécuter une commande au joueur, avec support de %player% et %uuid%.
`CONSOLE_COMMAND`	Fait exécuter une commande par la console, avec support de %player% et %uuid%.

%stand_name% Nom du stand dans le format principal de clic.

%message% Message configuré pour l'action du stand.

%player% Nom du joueur dans les commandes.

%uuid% UUID du joueur dans les commandes.

ℹ️

Si PlaceholderAPI est installé, les messages envoyés aux joueurs peuvent être enrichis avec les placeholders PAPI. Les couleurs utilisent aussi les codes & classiques de Minecraft.

09

Texte flottant

Chaque stand peut porter un hologramme multi-lignes, prévisualisé en live et restauré automatiquement après redémarrage.

Plusieurs lignes sont supportées avec ordre préservé.
Le GUI permet d'ajouter, modifier ou supprimer des lignes.
La preview du texte flottant reste visible pendant l'édition.
La sauvegarde et le respawn sont persistants.

Positionnement vertical

Stand normal: base autour de +2.05 Stand small: base autour de +1.65 Espacement entre lignes: 0.28

10

Placement et orientation

Le placement se fait directement en jeu, puis le stand peut être orienté vers le joueur pour accélérer le setup visuel.

Choisir l'option de placement dans l'éditeur.
Fermer temporairement le GUI.
Cliquer un bloc en jeu.
Placer le stand au centre du bloc avec offset vertical.

x + 0.5 y + 1.0 z + 0.5

💡

L'option d'orientation vers le joueur accélère la mise en scène d'un stand sans avoir à retoucher manuellement sa rotation.