1, Easy NPC: Création & bases
Tout commence par poser un PNJ. Voici comment.
Avant de commencer
- Tu dois être opérateur (OP niveau 2+) pour utiliser les commandes Easy NPC.
- Sur le serveur Arcadia, demande à un admin de t'accorder une zone via FTB Chunks avant de poser des PNJ permanents.
- Les PNJ Easy NPC sont persistants: ils restent même quand le chunk est déchargé.
- La racine de toutes les commandes est /easy_npc (avec underscore).
- Les écrans de configuration viennent du module Easy NPC: Config UI, qui ajoute aussi la baguette de configuration de PNJ (elle sélectionne un PNJ sans avoir à le viser de près, et Maj + clic droit le tourne vers toi) et le navigateur de préréglages. Le module Easy NPC: Bundle, lui, ne fait que charger le cœur du mod et ce module ensemble.
Poser un PNJ, méthode par item
Poser un PNJ, méthode par commande
/easy_npc spawn create <entity_type> ~ ~ ~ // exemple: /easy_npc spawn create humanoid ~ ~ ~ /easy_npc spawn create villager ~ ~ ~ minecraft:overworld
2, Commandes Easy NPC (vérifiées)
Toutes les sous-commandes réelles, vérifiées pour Easy NPC 7, version livrée avec le pack (7.14.0 à partir de la 2.0.33).
Pour un panorama de toutes les commandes du serveur, voir la Les commandes. Toutes les commandes Easy NPC commencent par /easy_npc <sous-commande>. La plupart ciblent un PNJ avec l'argument npc_target (UUID ou sélecteur).
| Sous-commande | Effet |
|---|---|
| /easy_npc list | Liste tous les PNJ chargés (avec UUID, position, dimension). |
| /easy_npc info <npc> | Affiche les infos détaillées d'un PNJ (skin, dialogues, trades, propriétaire). |
| /easy_npc spawn create <type> <pos> | Crée un PNJ à la position donnée. |
| /easy_npc despawn <npc> | Fait disparaître le PNJ (réversible avec respawn). |
| /easy_npc respawn <npc> | Refait apparaître un PNJ despawné. |
| /easy_npc delete <npc> | Supprime définitivement le PNJ. |
| /easy_npc name set <npc> <nom> | Renomme le PNJ. |
| /easy_npc name visibility <npc> <mode> | Change la visibilité du nom (always / on_hover / never). |
| /easy_npc name color <npc> <couleur> | Change la couleur du nom affiché. |
| /easy_npc skin set <npc> <mode> | Change le skin (default / player / url / custom). |
| /easy_npc dialog set <npc> <dialogue> | Définit ou modifie un dialogue. |
| /easy_npc dialog open <npc> <player> | Force l'ouverture d'un dialogue chez un joueur. |
| /easy_npc trading open <npc> <player> | Ouvre l'écran de marchand pour un joueur. |
| /easy_npc trading reset <npc> | Restock manuellement les trades du PNJ. |
| /easy_npc equipment <npc> <slot> <item> | Équipe un item sur le PNJ (head/chest/legs/feet/mainhand/offhand). |
| /easy_npc pose <npc> <pose> | Change la pose (standing / sitting / sleeping / etc.). |
| /easy_npc position <npc> <pos> | Téléporte le PNJ à la position donnée. |
| /easy_npc rotate <npc> <angle> | Tourne le PNJ. |
| /easy_npc scale <npc> <axe> <valeur> | Redimensionne le PNJ (X/Y/Z, 0.1 à 5.0). |
| /easy_npc render <npc> <option> | Modifie le rendu (visible, invisible, glow...). |
| /easy_npc owner set <npc> <player> | Change le propriétaire du PNJ. |
| /easy_npc preset import <preset> | Importe un preset (default / custom / data / world). |
| /easy_npc preset export <npc> <name> | Exporte un PNJ comme preset. |
| /easy_npc objective <npc>... | Configure l'IA (follow, attack, navigation...). |
| /easy_npc reload | Recharge les configs Easy NPC. |
Cibler un PNJ: argument npc_target
- Par UUID: /easy_npc info 12345678-1234-1234-1234-123456789abc
- Par sélecteur: @npc[name=Aélys] (sélecteur custom Easy NPC)
- Par visée: pas de sélecteur direct, utiliser /easy_npc list pour récupérer l'UUID.
3, Configurer un PNJ marchand
Faire en sorte que ton PNJ vende ou achète des objets.
- None- pas de marchand.
- Basic- jusqu'à 12 trades simples, stock illimité.
- Advanced- trades avancés: XP, prix dégressif, stock max, restock par durée.
- Custom- déclenche un dialogue ou une commande au lieu d'ouvrir l'écran marchand.
4, Arcadia Lootbox: Comment ça marche
Le système de coffres à butin propriétaire d'Arcadia.
Arcadia Lootbox (arcadialootbox) ajoute un système complet de coffres avec un Hub graphique, des clés multiples par catégorie, des animations d'ouverture, du free claim avec cooldown, un historique de drops, et un système de preview.
Principe général
- Chaque lootbox a un identifiant unique défini en config (ex: arcadia_starter, boss_overlord).
- À partir de la version 1.3.0 du mod, livrée avec la 2.0.33, une lootbox ne s'ouvre plus avec une clé: chaque lootbox est un coffre que le joueur pose au sol. Le coffre s'ouvre en animation, projette les récompenses une à une, et seul son propriétaire peut les ramasser.
- Les anciennes clés présentes dans un inventaire sont échangées automatiquement contre le coffre de la lootbox qui les utilisait. Ce comportement se règle dans lootbox.toml, section de migration des clés (tout convertir, seulement les clés du mod, ou rien), et lootbox par lootbox avec "migrateKeys": false.
- L'ouverture déclenche une animation (configurée par lootbox) puis donne 1 ou plusieurs récompenses tirées par poids ou garanties.
- Certaines lootboxes peuvent avoir un free claim récurrent, réclamable gratuitement toutes les X heures.
Ouvrir le Hub Lootbox
Le hub graphique liste toutes les lootboxes disponibles. Pour l'ouvrir:
/arcadia_lootbox
Ou via le clic-droit sur l'item Lootbox Hub si fourni dans le starter kit.
5, Liste des clés Arcadia Lootbox
Les vrais identifiants extraits du mod ArcadiaLootbox-1.3.0.
Le mod fournit 6 catégories de clés. Chaque catégorie a plusieurs paliers de rareté.
Dungeon Keys (donjons)
Clés obtenues en complétant des donjons et en tuant des boss. 10 paliers:
Format ID: arcadialootbox:dungeon_key_<rareté>
Exemple: arcadialootbox:dungeon_key_legendary
Shop Keys (boutique)
Clés vendues par les PNJ marchands contre Numesticas. Mêmes 10 paliers.
Format: arcadialootbox:shop_key_<rareté>
Vote Keys (votes)
Récompense automatique aux votes sur le site Arcadia. Mêmes 10 paliers (palier dépend du nombre de votes consécutifs).
Format: arcadialootbox:vote_key_<rareté>
Lootable Keys (loot général)
Drops aléatoires depuis structures, mob loot tables, fishing, etc. Mêmes 10 paliers.
Format: arcadialootbox:lootable_key_<rareté>
Event Keys (événements)
Distribuées par le staff lors d'événements ponctuels. 5 paliers uniquement:
Format: arcadialootbox:event_key_bronze/silver/gold/platinum/diamond
Boss Keys (boss raids)
Drop des boss raids. 5 paliers:
Format: arcadialootbox:boss_key_minor/major/elite/supreme/overlord
/arcadia_lootbox givekey <joueur> <key_id> <quantité> // exemples: /arcadia_lootbox givekey Vyrriox arcadialootbox:dungeon_key_legendary 1 /arcadia_lootbox givekey @a arcadialootbox:vote_key_common 1 /arcadia_lootbox givekey Vyrriox arcadialootbox:boss_key_overlord 1
6, Commandes Arcadia Lootbox (vérifiées)
Toutes les sous-commandes réelles, extraites du mod ArcadiaLootbox-1.3.0.
Racine: /arcadia_lootbox <sous-commande>. Il n'existe pas de raccourci /arcadia_lootbox.
| Commande | Effet |
|---|---|
| /arcadia_lootbox | Ouvre le Hub graphique (sans argument). |
| /arcadia_lootbox reload | Recharge les configs lootboxes (async, sans freeze serveur). |
| /arcadia_lootbox list | Liste toutes les lootboxes disponibles avec leurs IDs. |
| /arcadia_lootbox listkeys | Liste tous les key_id enregistrés. |
| /arcadia_lootbox stats | Statistiques globales (ouvertures totales, drops, etc.). |
| /arcadia_lootbox info <lootbox_id> | Affiche le contenu détaillé d'une lootbox (loot table, weights). |
| /arcadia_lootbox give <joueur> <lootbox_id> [amount] | Donne le BLOC lootbox (à poser au sol). |
| /arcadia_lootbox giveall <lootbox_id> [amount] | Donne le bloc lootbox à tous les joueurs en ligne. |
| /arcadia_lootbox givekey <joueur> <key_id> [amount] | Donne une clé. |
| /arcadia_lootbox preview <lootbox_id> | Ouvre l'écran de prévisualisation des récompenses. |
| /arcadia_lootbox history | Affiche l'historique de tes derniers drops. |
| /arcadia_lootbox clearhistory | Efface ton historique. |
| /arcadia_lootbox create <id> <displayName> | Crée une nouvelle définition de lootbox (admin). |
| /arcadia_lootbox delete <id> | Supprime une définition de lootbox. |
| /arcadia_lootbox setuses <pos> <uses> | Modifie les utilisations restantes d'un bloc lootbox posé. |
| /arcadia_lootbox resetcooldown | Remet ton cooldown global à zéro. |
| /arcadia_lootbox free <lootbox_id> | Tente de réclamer le free claim disponible. |
| /arcadia_lootbox migrate | Nouveau en 1.3.0: échange les anciennes clés contre les coffres correspondants. |
| /arcadia_lootbox template <id> | Nouveau en 1.3.0: installe une lootbox à partir d'un modèle fourni par le mod. |
7, Numesticas: La monnaie d'Arcadia
Note: la monnaie "Numesticas" est gérée par les scripts KubeJS du serveur.
À quoi sert la monnaie?
Le fonctionnement détaillé de la monnaie et des prix est décrit dans la page Économie et boutique. Sur un serveur privé, la monnaie Arcadia permet d'acheter chez les PNJ marchands:
- Des Shop Keys Arcadia Lootbox (voir Section 5).
- Des items rares (gemmes Apothic, sorts Iron's Spellbooks, glyphes Ars Nouveau).
- Des téléportations entre villes via PNJ Voyageur.
- Des accès donjons VIP, mini-jeux, etc.
Comment en obtenir?
- Vendre des items à un PNJ acheteur (récolte agricole, drops, ressources rares).
- Quêtes FTB Quests- récompense en monnaie selon la quête.
- Boss kills- drops directs sur les boss majeurs.
- Vote quotidien- bonus + Vote Keys.
- Boutique web Arcadia (voir les Grades et privilèges)- achat avec monnaie réelle (catégorie Donations).
Donner / vérifier (admin, syntaxe générique)
// remplacer arcadia:numestica par l'ID réel /give <joueur> arcadia:numestica 1000 /clear <joueur> arcadia:numestica
- Range tes Numesticas dans un coffre dédié chez toi, pas dans l'inventaire.
- En PvP: selon le keepInventory du serveur, les Numesticas peuvent être perdues.
- Évite de transporter plus de 10 000 Numesticas en zone PvP.
8, Recette complète: un PNJ vendeur de clés
Le tutoriel pas à pas pour combiner Easy NPC + Arcadia Lootbox + Numesticas.
Objectif: créer un PNJ "Aélys, Marchande de Clés" qui vend les Shop Keys Arcadia Lootbox contre Numesticas.
| Tu paies | Tu reçois | Max Uses / Reset |
|---|---|---|
| 50× monnaie | 1× arcadialootbox:shop_key_common | 32 / 24h |
| 250× monnaie | 1× arcadialootbox:shop_key_uncommon | 16 / 24h |
| 1000× monnaie | 1× arcadialootbox:shop_key_rare | 8 / 24h |
| 5000× monnaie | 1× arcadialootbox:shop_key_epic | 4 / 24h |
| 15000× monnaie | 1× arcadialootbox:shop_key_legendary | 2 / 48h |
| 50000× monnaie | 1× arcadialootbox:shop_key_mythic | 1 / 7 jours |
"Bienvenue, aventurier! J'ai des clés de toutes les raretés... mais elles ne sont pas pour les bourses légères."
9, Dialogues & scénarios avancés
Donner du caractère à tes PNJ avec des dialogues à embranchements.
Dialogue simple (UI)
Sneak + clic droit → onglet Dialog → Standard. Tape ton texte, ajoute jusqu'à 8 boutons de réponse.
Dialogue à choix multiples
Mode Advanced. Chaque dialogue peut:
- Avoir plusieurs boutons de réponse, chacun menant à un autre dialogue.
- Déclencher une action (ouvrir trade, exécuter une commande, donner un item).
- Se conditionner sur des variables (item dans l'inventaire, niveau XP, faction).
Déclencher une commande depuis un dialogue
Sur un bouton de dialogue, choisis l'action Run Command. Exemple, donner une clé gratuite la première rencontre:
/arcadia_lootbox givekey @initiator arcadialootbox:lootable_key_common 1
- Aélys- marchande de Shop Keys (Section 8).
- Korvath le Forgeron- vend des armes Apothic affixées contre monnaie + matériaux.
- Mère Sylvane- quêtes Ars Nouveau, donne mana en récompense.
- Le Voyageur- téléportation entre villes (déclenche /waystones tp).
- Le Croupier- mini-jeu: 10% de chance de gagner une arcadialootbox:event_key_gold contre 100 Numesticas.
- Le Gardien des Boss Keys- échange 5 dungeon keys legendary contre 1 boss key minor.
10, Astuces, bugs courants & FAQ
Les pièges classiques et leurs solutions.
FAQ Easy NPC
Q: Mon PNJ a disparu après un redémarrage.
R: Vérifie que le chunk est chargé en permanence via FTB Chunks → Force Load. Sinon utilise /easy_npc list dans le bon dimension pour le retrouver.
Q: Le trade ne se déclenche pas, le PNJ ne fait rien au clic droit.
R: Sneak + clic droit → onglet Action. Si "Action on right click" est sur "None", change en "Open Trade".
Q: Comment empêcher un joueur de tuer un PNJ?
R: Onglet Présence → Invulnerable. À activer systématiquement sur tous les PNJ marchands.
Q: Peut-on dupliquer un PNJ déjà configuré?
R: Oui, via les presets. Exporte: /easy_npc preset export <uuid> aelys_marchande. Importe ailleurs: /easy_npc preset import custom aelys_marchande.
FAQ Arcadia Lootbox
Q: J'ai une clé mais je ne sais pas quelle lootbox elle ouvre.
R: Utilise /arcadia_lootbox list pour voir toutes les lootboxes, puis /arcadia_lootbox info <id> pour voir quelle clé elle requiert.
Q: Le free claim ne marche pas.
R: Vérifie le timer avec /arcadia_lootbox freetimer <lootbox_id>. Si freeEnabled est sur false dans la config, le free claim est désactivé pour cette lootbox.
Q: J'ai modifié la config lootbox, comment recharger sans redémarrer?
R: /arcadia_lootbox reload. Le rechargement est asynchrone et ne freeze pas le serveur (option ASYNC_CONFIG_RELOAD activée par défaut).
Q: Comment voir mes derniers drops?
R: /arcadia_lootbox history.
Bugs connus
Reporter un bug
Si tu rencontres un problème non listé ici: connecte-toi sur le site Arcadia → onglet Support → Ticket→ joins une capture d'écran et le fichier latest.log.