Aller au contenu

Wiki

Révision #467

Enregistrée le 15 août 2026 à 0:32

Auteur: vyrriox Type: Édition « Harmonisation des titres du wiki (schema unique). »
Cette révision #467

Économie sur serveur privé

1, Easy NPC: Création & bases

Tout commence par poser un PNJ. Voici comment.

Avant de commencer

  • Vous devez être opérateur (OP niveau 2+) pour utiliser les commandes Easy NPC.
  • Sur le serveur Arcadia, demandez à un admin de vous 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).

Poser un PNJ, méthode par item

1
Récupérez l'item de spawn correspondant au type de PNJ voulu via le menu créatif (cherchez "Easy NPC" dans JEI). Exemple: easy_npc:humanoid_npc_spawn_egg, easy_npc:villager_npc_spawn_egg, etc.
2
Faites un clic droit au sol avec l'œuf. Le PNJ apparaît avec une apparence par défaut.
3
Sneak (Shift) + clic droit sur le PNJ pour ouvrir le menu de configuration complet.

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
Astuce skin
Pour copier le skin d'un autre joueur du serveur, allez dans l'onglet Skin → Player Skin et entrez son pseudo. Ou en commande: /easy_npc skin set player <pseudo> en visant le PNJ.

2, Commandes Easy NPC (vérifiées)

Toutes les sous-commandes réelles, extraites du mod easy_npc-6.12.0.

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.
Attention
La commande /easy_npc delete est irréversible. Préférez despawn+ respawn pour cacher temporairement un PNJ.

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 votre PNJ vende ou achète des objets.

1
Sneak + clic droit sur le PNJ → onglet Trading.
2
Choisissez le type de trade:
  • 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.
3
Pour chaque ligne, glissez l'objet d'entrée A (ce que le joueur paie), éventuellement l'entrée B (paiement secondaire), puis l'objet de sortie (ce qu'il reçoit).
4
Pour le mode Advanced: ajustez Max Uses (stock avant restock), Reset Time (durée avant restock auto), et XP (gagné par le PNJ).
5
Sauvegardez. Le clic droit normal sur le PNJ ouvre désormais l'écran marchand.
Les data components dans les trades
Easy NPC respecte les data components de MC 1.21. Pour vendre un item enchanté, avec un nom custom, ou un item Apothic affixé, glissez-le directement depuis l'inventaire, le PNJ vendra une copie identique.

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).
  • Pour ouvrir une lootbox, il faut la clé compatible dans son inventaire.
  • 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 ont un free claim récurrent (toutes les X heures) sans clé.

Ouvrir le Hub Lootbox

Le hub graphique liste toutes les lootboxes disponibles. Pour l'ouvrir:

/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.2.3.

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:

commonuncommonraresuperiorepiclegendarymythicdivinecelestialtranscendent

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:

bronzesilvergoldplatinumdiamond

Format: arcadialootbox:event_key_bronze/silver/gold/platinum/diamond

Boss Keys (boss raids)

Drop des boss raids. 5 paliers:

minormajorelitesupremeoverlord

Format: arcadialootbox:boss_key_minor/major/elite/supreme/overlord

Donner une clé (admin)
Utilisez la commande native du mod: 
/lootbox givekey <joueur> <key_id> <quantité>
// exemples:
/lootbox givekey Vyrriox arcadialootbox:dungeon_key_legendary 1
/lootbox givekey @a arcadialootbox:vote_key_common 1
/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.2.3.

Racine: /lootbox <sous-commande> (alias /arcadia_lootbox).

Commande Effet
/lootbox Ouvre le Hub graphique (sans argument).
/lootbox reload Recharge les configs lootboxes (async, sans freeze serveur).
/lootbox list Liste toutes les lootboxes disponibles avec leurs IDs.
/lootbox listkeys Liste tous les key_id enregistrés.
/lootbox stats Statistiques globales (ouvertures totales, drops, etc.).
/lootbox info <lootbox_id> Affiche le contenu détaillé d'une lootbox (loot table, weights).
/lootbox give <joueur> <lootbox_id> [amount] Donne le BLOC lootbox (à poser au sol).
/lootbox giveall <lootbox_id> [amount] Donne le bloc lootbox à tous les joueurs en ligne.
/lootbox givekey <joueur> <key_id> [amount] Donne une clé.
/lootbox preview <lootbox_id> Ouvre l'écran de prévisualisation des récompenses.
/lootbox history Affiche l'historique de vos derniers drops.
/lootbox clearhistory Efface votre historique.
/lootbox create <id> <displayName> Crée une nouvelle définition de lootbox (admin).
/lootbox delete <id> Supprime une définition de lootbox.
/lootbox setuses <pos> <uses> Modifie les utilisations restantes d'un bloc lootbox posé.
/lootbox resetcooldown Reset votre cooldown global.
/lootbox free <lootbox_id> Tente de réclamer le free claim disponible.
/lootbox freetimer <lootbox_id> Affiche le temps restant avant le prochain free claim.
/lootbox resetfree <joueur> <lootbox_id> Reset le timer de free claim d'un joueur (admin).
Le système Free Claim
Si une lootbox a freeEnabled = true dans sa config, chaque joueur peut la réclamer gratuitement toutes les X heures (défini par lootbox). Pas besoin de clé. Idéal pour le starter / récompenses quotidiennes.

7, Numesticas: La monnaie d'Arcadia

Note: la monnaie "Numesticas" est gérée par les scripts KubeJS du serveur.

Item à confirmer
L'ID exact de l'item Numesticas n'est pas encore enregistré dans le KubeJS d'Arcadia V2. Avant de publier ce wiki, l'admin doit confirmer le namespace exact (en ouvrant les fichiers du modpack) (probablement arcadia:numestica ou via un mod externe genre numismatic-overhaul:gold_coin).

À 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
Bonnes pratiques
  • Stockez vos Numesticas dans un coffre dédié chez vous, pas dans l'inventaire.
  • En PvP: selon le keepInventory du serveur, les Numesticas peuvent être perdues.
  • Évitez 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.

1
Posez le PNJ: /easy_npc spawn create humanoid ~ ~ ~ (ou via spawn egg dans le créatif).
2
Récupérez son UUID: /easy_npc list et copiez l'UUID du PNJ visé.
3
Renommez-le: /easy_npc name set <uuid> "Aélys, Marchande de Clés"
4
Donnez-lui un skin de joueur: /easy_npc skin set <uuid> player <pseudo_marchand>
5
Sneak + clic droit sur le PNJ → onglet Présence: activez Invulnerable, Silent, No Gravity et Position Lock.
6
Onglet Trading → Advanced. Configurez les lignes (les prix sont à ajuster selon votre économie):
Vous payez Vous recevez 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
7
Onglet Dialog: message d'accueil: 
"Bienvenue, aventurier! J'ai des clés de
toutes les raretés... mais elles ne sont pas
pour les bourses légères."
8
Sauvegardez. Test: un joueur clique droit sur Aélys, voit le dialogue, achète une clé, puis utilise /lootbox pour ouvrir le hub et dépenser sa clé.
Anti-abus
Le Max Uses+ Reset Time sont CRITIQUES. Sans cela, un joueur riche peut acheter l'infini de clés en quelques secondes et casser l'économie. Préférez des paliers serrés sur les hautes raretés.

9, Dialogues & scénarios avancés

Donner du caractère à vos PNJ avec des dialogues à embranchements.

Dialogue simple (UI)

Sneak + clic droit → onglet Dialog → Standard. Tapez votre texte, ajoutez 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, choisissez l'action Run Command. Exemple, donner une clé gratuite la première rencontre:

/lootbox givekey @initiator arcadialootbox:lootable_key_common 1
Idées de PNJ pour Arcadia
  • 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érifiez que le chunk est chargé en permanence via FTB Chunks → Force Load. Sinon utilisez /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", changez 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. Exportez: /easy_npc preset export <uuid> aelys_marchande. Importez 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: Utilisez /lootbox list pour voir toutes les lootboxes, puis /lootbox info <id> pour voir quelle clé elle requiert.

Q: Le free claim ne marche pas.
R: Vérifiez le timer avec /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: /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: /lootbox history.

Bugs connus

Bug: skin custom invisible
Si un skin URL custom ne charge pas, c'est probablement le cache local. Supprimez easy_npc/cache/ dans votre instance et relancez le client.
Bug: trade qui se reset à chaque connexion
Si le stock se remet à zéro à chaque reload, vérifiez que le PNJ a Position Lock activé. Sans cela, NeoForge peut le considérer comme une nouvelle entité après reload.

Reporter un bug

Si vous rencontrez un problème non listé ici: connectez-vous sur le site Arcadia → onglet Support → Ticket→ joignez une capture d'écran et le fichier latest.log.

Version actuelle

Économie sur serveur privé

1, Easy NPC: Création & bases

Tout commence par poser un PNJ. Voici comment.

Avant de commencer

  • Vous devez être opérateur (OP niveau 2+) pour utiliser les commandes Easy NPC.
  • Sur le serveur Arcadia, demandez à un admin de vous 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).

Poser un PNJ, méthode par item

1
Récupérez l'item de spawn correspondant au type de PNJ voulu via le menu créatif (cherchez "Easy NPC" dans JEI). Exemple: easy_npc:humanoid_npc_spawn_egg, easy_npc:villager_npc_spawn_egg, etc.
2
Faites un clic droit au sol avec l'œuf. Le PNJ apparaît avec une apparence par défaut.
3
Sneak (Shift) + clic droit sur le PNJ pour ouvrir le menu de configuration complet.

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
Astuce skin
Pour copier le skin d'un autre joueur du serveur, allez dans l'onglet Skin → Player Skin et entrez son pseudo. Ou en commande: /easy_npc skin set player <pseudo> en visant le PNJ.

2, Commandes Easy NPC (vérifiées)

Toutes les sous-commandes réelles, extraites du mod easy_npc-6.12.0.

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.
Attention
La commande /easy_npc delete est irréversible. Préférez despawn+ respawn pour cacher temporairement un PNJ.

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 votre PNJ vende ou achète des objets.

1
Sneak + clic droit sur le PNJ → onglet Trading.
2
Choisissez le type de trade:
  • 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.
3
Pour chaque ligne, glissez l'objet d'entrée A (ce que le joueur paie), éventuellement l'entrée B (paiement secondaire), puis l'objet de sortie (ce qu'il reçoit).
4
Pour le mode Advanced: ajustez Max Uses (stock avant restock), Reset Time (durée avant restock auto), et XP (gagné par le PNJ).
5
Sauvegardez. Le clic droit normal sur le PNJ ouvre désormais l'écran marchand.
Les data components dans les trades
Easy NPC respecte les data components de MC 1.21. Pour vendre un item enchanté, avec un nom custom, ou un item Apothic affixé, glissez-le directement depuis l'inventaire, le PNJ vendra une copie identique.

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).
  • Pour ouvrir une lootbox, il faut la clé compatible dans son inventaire.
  • 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 ont un free claim récurrent (toutes les X heures) sans clé.

Ouvrir le Hub Lootbox

Le hub graphique liste toutes les lootboxes disponibles. Pour l'ouvrir:

/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.2.3.

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:

commonuncommonraresuperiorepiclegendarymythicdivinecelestialtranscendent

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:

bronzesilvergoldplatinumdiamond

Format: arcadialootbox:event_key_bronze/silver/gold/platinum/diamond

Boss Keys (boss raids)

Drop des boss raids. 5 paliers:

minormajorelitesupremeoverlord

Format: arcadialootbox:boss_key_minor/major/elite/supreme/overlord

Donner une clé (admin)
Utilisez la commande native du mod: 
/lootbox givekey <joueur> <key_id> <quantité>
// exemples:
/lootbox givekey Vyrriox arcadialootbox:dungeon_key_legendary 1
/lootbox givekey @a arcadialootbox:vote_key_common 1
/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.2.3.

Racine: /lootbox <sous-commande> (alias /arcadia_lootbox).

Commande Effet
/lootbox Ouvre le Hub graphique (sans argument).
/lootbox reload Recharge les configs lootboxes (async, sans freeze serveur).
/lootbox list Liste toutes les lootboxes disponibles avec leurs IDs.
/lootbox listkeys Liste tous les key_id enregistrés.
/lootbox stats Statistiques globales (ouvertures totales, drops, etc.).
/lootbox info <lootbox_id> Affiche le contenu détaillé d'une lootbox (loot table, weights).
/lootbox give <joueur> <lootbox_id> [amount] Donne le BLOC lootbox (à poser au sol).
/lootbox giveall <lootbox_id> [amount] Donne le bloc lootbox à tous les joueurs en ligne.
/lootbox givekey <joueur> <key_id> [amount] Donne une clé.
/lootbox preview <lootbox_id> Ouvre l'écran de prévisualisation des récompenses.
/lootbox history Affiche l'historique de vos derniers drops.
/lootbox clearhistory Efface votre historique.
/lootbox create <id> <displayName> Crée une nouvelle définition de lootbox (admin).
/lootbox delete <id> Supprime une définition de lootbox.
/lootbox setuses <pos> <uses> Modifie les utilisations restantes d'un bloc lootbox posé.
/lootbox resetcooldown Reset votre cooldown global.
/lootbox free <lootbox_id> Tente de réclamer le free claim disponible.
/lootbox freetimer <lootbox_id> Affiche le temps restant avant le prochain free claim.
/lootbox resetfree <joueur> <lootbox_id> Reset le timer de free claim d'un joueur (admin).
Le système Free Claim
Si une lootbox a freeEnabled = true dans sa config, chaque joueur peut la réclamer gratuitement toutes les X heures (défini par lootbox). Pas besoin de clé. Idéal pour le starter / récompenses quotidiennes.

7, Numesticas: La monnaie d'Arcadia

Note: la monnaie "Numesticas" est gérée par les scripts KubeJS du serveur.

Item à confirmer
L'ID exact de l'item Numesticas n'est pas encore enregistré dans le KubeJS d'Arcadia V2. Avant de publier ce wiki, l'admin doit confirmer le namespace exact (en ouvrant les fichiers du modpack) (probablement arcadia:numestica ou via un mod externe genre numismatic-overhaul:gold_coin).

À 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
Bonnes pratiques
  • Stockez vos Numesticas dans un coffre dédié chez vous, pas dans l'inventaire.
  • En PvP: selon le keepInventory du serveur, les Numesticas peuvent être perdues.
  • Évitez 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.

1
Posez le PNJ: /easy_npc spawn create humanoid ~ ~ ~ (ou via spawn egg dans le créatif).
2
Récupérez son UUID: /easy_npc list et copiez l'UUID du PNJ visé.
3
Renommez-le: /easy_npc name set <uuid> "Aélys, Marchande de Clés"
4
Donnez-lui un skin de joueur: /easy_npc skin set <uuid> player <pseudo_marchand>
5
Sneak + clic droit sur le PNJ → onglet Présence: activez Invulnerable, Silent, No Gravity et Position Lock.
6
Onglet Trading → Advanced. Configurez les lignes (les prix sont à ajuster selon votre économie):
Vous payez Vous recevez 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
7
Onglet Dialog: message d'accueil: 
"Bienvenue, aventurier! J'ai des clés de
toutes les raretés... mais elles ne sont pas
pour les bourses légères."
8
Sauvegardez. Test: un joueur clique droit sur Aélys, voit le dialogue, achète une clé, puis utilise /lootbox pour ouvrir le hub et dépenser sa clé.
Anti-abus
Le Max Uses+ Reset Time sont CRITIQUES. Sans cela, un joueur riche peut acheter l'infini de clés en quelques secondes et casser l'économie. Préférez des paliers serrés sur les hautes raretés.

9, Dialogues & scénarios avancés

Donner du caractère à vos PNJ avec des dialogues à embranchements.

Dialogue simple (UI)

Sneak + clic droit → onglet Dialog → Standard. Tapez votre texte, ajoutez 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, choisissez l'action Run Command. Exemple, donner une clé gratuite la première rencontre:

/lootbox givekey @initiator arcadialootbox:lootable_key_common 1
Idées de PNJ pour Arcadia
  • 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érifiez que le chunk est chargé en permanence via FTB Chunks → Force Load. Sinon utilisez /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", changez 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. Exportez: /easy_npc preset export <uuid> aelys_marchande. Importez 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: Utilisez /lootbox list pour voir toutes les lootboxes, puis /lootbox info <id> pour voir quelle clé elle requiert.

Q: Le free claim ne marche pas.
R: Vérifiez le timer avec /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: /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: /lootbox history.

Bugs connus

Bug: skin custom invisible
Si un skin URL custom ne charge pas, c'est probablement le cache local. Supprimez easy_npc/cache/ dans votre instance et relancez le client.
Bug: trade qui se reset à chaque connexion
Si le stock se remet à zéro à chaque reload, vérifiez que le PNJ a Position Lock activé. Sans cela, NeoForge peut le considérer comme une nouvelle entité après reload.

Reporter un bug

Si vous rencontrez un problème non listé ici: connectez-vous sur le site Arcadia → onglet Support → Ticket→ joignez une capture d'écran et le fichier latest.log.

Retour