Wiki

Révision #119

Enregistrée le 21 juillet 2026 à 3:25

Auteur: vyrriox Type: Édition « Nettoyage du CSS inline (style déplacé dans le CSS intégré du wiki) »

Cette révision #119

Economie 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

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.

Faites un clic droit au sol avec l'œuf. Le PNJ apparaît avec une apparence par défaut.

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.

Toutes les commandes 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.

Sneak + clic droit sur le PNJ → onglet Trading.

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.

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).

Pour le mode Advanced : ajustez Max Uses (stock avant restock), Reset Time (durée avant restock auto), et XP (gagné par le PNJ).

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 :

common uncommon rare superior epic legendary mythic divine celestial transcendent

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 :

bronze silver gold platinum diamond

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

👑 Boss Keys (boss raids)

Drop des boss raids. 5 paliers :

minor major elite supreme overlord

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 KubeJS scripts 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 me confirmer le namespace exact (probablement arcadia:numestica ou via un mod externe genre numismatic-overhaul:gold_coin).

À quoi sert la monnaie ?

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 — 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.

Posez le PNJ : /easy_npc spawn create humanoid ~ ~ ~ (ou via spawn egg dans le créatif).

Récupérez son UUID : /easy_npc list et copiez l'UUID du PNJ visé.

Renommez-le : /easy_npc name set <uuid> "Aélys, Marchande de Clés"

Donnez-lui un skin de joueur : /easy_npc skin set <uuid> player <pseudo_marchand>

Sneak + clic droit sur le PNJ → onglet Présence : activez Invulnerable, Silent, No Gravity et Position Lock.

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

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."

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

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.

Faites un clic droit au sol avec l'œuf. Le PNJ apparaît avec une apparence par défaut.

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.

Sneak + clic droit sur le PNJ → onglet Trading.

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.

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).

Pour le mode Advanced: ajustez Max Uses (stock avant restock), Reset Time (durée avant restock auto), et XP (gagné par le PNJ).

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.

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

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.

Posez le PNJ: /easy_npc spawn create humanoid ~ ~ ~ (ou via spawn egg dans le créatif).

Récupérez son UUID: /easy_npc list et copiez l'UUID du PNJ visé.

Renommez-le: /easy_npc name set <uuid> "Aélys, Marchande de Clés"

Donnez-lui un skin de joueur: /easy_npc skin set <uuid> player <pseudo_marchand>

Sneak + clic droit sur le PNJ → onglet Présence: activez Invulnerable, Silent, No Gravity et Position Lock.

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

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."

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: 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.

Différences

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

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.

Faites un clic droit au sol avec l'œuf. Le PNJ apparaît avec une apparence par défaut.

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.

Toutes les commandes 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.

Sneak + clic droit sur le PNJ → onglet Trading.

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.

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).

Pour le mode Advanced : ajustez Max Uses (stock avant restock), Reset Time (durée avant restock auto), et XP (gagné par le PNJ).

Sauvegardez. Le clic droit normal sur le PNJ ouvre désormais l'écran marchand.

💡 Les data components dans les trades

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 :

common uncommon rare superior epic legendary mythic divine celestial transcendent

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 :

bronze silver gold platinum diamond

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

👑 Boss Keys (boss raids)

Drop des boss raids. 5 paliers :

minor major elite supreme overlord

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 KubeJS scripts 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 me confirmer le namespace exact (probablement arcadia:numestica ou via un mod externe genre numismatic-overhaul:gold_coin).

À quoi sert la monnaie ?

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 — 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.

Posez le PNJ : /easy_npc spawn create humanoid ~ ~ ~ (ou via spawn egg dans le créatif).

Récupérez son UUID : /easy_npc list et copiez l'UUID du PNJ visé.

Renommez-le : /easy_npc name set <uuid> "Aélys, Marchande de Clés"

Donnez-lui un skin de joueur : /easy_npc skin set <uuid> player <pseudo_marchand>

Sneak + clic droit sur le PNJ → onglet Présence : activez Invulnerable, Silent, No Gravity et Position Lock.

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

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."

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.

1, Easy NPC: Création & bases

Les PNJ Easy NPC sont persistants: ils restent même quand le chunk est déchargé.

Poser un PNJ, méthode par item

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.

Poser un PNJ, méthode par commande

// exemple:

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)

/easy_npc objective <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

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.

Pour le mode Advanced: ajustez Max Uses (stock avant restock), Reset Time (durée avant restock auto), et XP (gagné par le PNJ).

Les data components dans les trades

4, Arcadia Lootbox: Comment ça marche

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

5, Liste des clés Arcadia Lootbox

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)

Format: arcadialootbox:shop_key_<rareté>

Vote Keys (votes)

Format: arcadialootbox:vote_key_<rareté>

Lootable Keys (loot général)

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:

// exemples:

6, Commandes Arcadia Lootbox (vérifiées)

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

Le système Free Claim

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:

Comment en obtenir?

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).

Bonnes pratiques

En PvP: selon le keepInventory du serveur, les Numesticas peuvent être perdues.

8, Recette complète: un PNJ vendeur de clés

Objectif: créer un PNJ "Aélys, Marchande de Clés" qui vend les Shop Keys Arcadia Lootbox contre Numesticas.

Posez le PNJ: /easy_npc spawn create humanoid ~ ~ ~ (ou via spawn egg dans le créatif).

Récupérez son UUID: /easy_npc list et copiez l'UUID du PNJ visé.

Renommez-le: /easy_npc name set <uuid> "Aélys, Marchande de Clés"

Donnez-lui un skin de joueur: /easy_npc skin set <uuid> player <pseudo_marchand>

Sneak + clic droit sur le PNJ → onglet Présence: activez Invulnerable, Silent, No Gravity et Position Lock.

Onglet Trading → Advanced. Configurez les lignes (les prix sont à ajuster selon votre économie):

Onglet Dialog: message d'accueil:

"Bienvenue, aventurier! J'ai des clés de

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

Mode Advanced. Chaque dialogue peut:

Sur un bouton de dialogue, choisissez l'action Run Command. Exemple, donner une clé gratuite la première rencontre:

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

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.

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.

Bug: skin custom invisible

Bug: trade qui se reset à chaque connexion

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