Arcadia Pets

## [1.3.1] - 2026-09-28

### Added

- **Two variant skins for every pet** — each species now has its original look plus a Tier I and a Tier II variant, designed one by one: the snowy and the black wolf, the copper and the oxidised golem, the Tamworth and the spotted pig, the soul and the void blaze, and so on across all 27 pool species and the four Arcane pets. Where the game already ships an alternative look for a species (wolves, cats, foxes, rabbits, axolotls, frogs, striders, shulkers, pandas, mooshroom hides, stray and bogged, the guardian, the armoured wither) that is the variant, read from the installed game and never redistributed; the others are recoloured from the species' own texture with a palette written for it. Sheep change fleece colour instead. Staff pets keep their original look, and a species with no designed variants, such as a modded mob added to the pools, simply has none.

- **Skin Gems I and II** — apply one at the anvil, pet on the left and gem on the right, to unlock that tier of its species' skin for good and put it on; the gem is used up and the pet keeps everything else. An unlocked skin is never paid for twice: the pet panel has Base / I / II tabs under the portrait to switch between the skins that pet has unlocked, for free, and the anvil refuses a gem for a tier the pet already has. Gems have no recipe: staff hand them out, which lets a server sell them. They can also be found in loot chests at very low odds (0.1% and 0.02% per common chest, 0.4% and 0.1% per endgame chest by default), with `token_loot_enabled` under a new `[skins]` section to turn that off on servers that sell them. Every pet starts on its original look, and existing pets are unchanged.

- **Arcane flyers carry two** — Vaelryn, Nyssara and Magmara seat a passenger behind their owner: once the owner is riding, another player right-clicks the pet to climb on. The owner keeps the reins, the passenger never rides without them, and both get off together when the owner does.

- **Sort and filter the pet collection** — the Pets tab has a sort button (rarity by default, then stars, name, arrival) and a collection threshold: opened pet bags only send pets of the chosen rarity and above to the collection, lower ones go straight to the inventory. Both are remembered per player, and pets already stored are untouched.

- **Lock your favourite pets** — click the page item in the Pets tab to enter lock mode, then click pets to lock or unlock them. A locked pet cannot be taken out of the collection or fused. Locks are kept per player.

- **Collection progress** — the page item shows how many species you have collected out of all obtainable ones.

- **Call your mount** — a new key (H by default) brings your pet to you from up to 64 blocks and climbs on; press it again to get off. That key is now the way off a pet: sneak steers a flying mount down (and an aquatic one deeper) instead of throwing you off, so you can land without leaving the saddle. The flight gauge now also shows while it refills on the ground, so you know when you can take off again.

- **Skin preview in the Compendium** — the detail page of each species has an Original / Tier I / Tier II selector, so a player can see exactly what a gem will give before using one.

- **The skin shows everywhere the pet does** — the summoned pet for every player who can see it, including when a gem is used while the pet is out, the pocket pet, item icons, the pedestal, the HUD portrait, the pet panel, duel cards, a "Skin" line on the tooltip and the name line of the crate reveal.

- **Duel wagers can be switched off** — new `duel_bets_enabled` toggle under `[gameplay]`. Servers that sell items or currency should turn it off, since letting players stake that currency on a game of chance can breach the Minecraft EULA. With it off, `/arcadia_pets duel <player> <bet>` is refused with a message, every other challenge runs unstaked, and a wager still pending when the setting changes is never collected. Defaults to on, so nothing changes for servers that leave it alone.

- **`/arcadia_pets skin <original|variant_1|variant_2>`** — operator command that sets the active pet's skin, for checking a variant on a given species.

### Fixed

- **Owners could not ride their own pet inside someone else's claim** — claim mods cancel entity interaction in claims the player does not own, and the mount handler gave way to that like any other interaction, then the ride itself was vetoed a second time when the player got on. The owner of a pet is now let through both checks for that pet only: anyone else trying to ride it, and every other interaction in the claim, is still decided by the claim mod.

- **The dragons were far too small** — the companion size aims for knee height and caps width at one block, which brought the 16-block Ender Dragon down to half a block tall and Vaelryn to the size of a cat; players compared it to a mosquito. Dragons now have a size class of their own, about 1.5 blocks tall and up to 1.9 at 5★ Endurance, with room to be 3.5 blocks across.

- **Small pets were bigger than the real animal** — every pet was sized to the same height, so large mobs shrank into place but small ones were blown up past their natural size: a 5★ chicken, rabbit, frog, allay or axolotl stood 0.8 blocks tall, and wide mobs such as the Elder Guardian stayed massive at that height. Pets are now sized by bulk, height plus width, and never shown above 80% of their natural size, so a wide mob shrinks further than a narrow one and small animals only get a little smaller. Staff pets, which were already the right size, keep it: the new sizing is calibrated on them. Pets keep their companion size while ridden, and the rider sits on the pet's back at that size. Arcane pets keep their current sizing.

- **The Ender Dragon could not be ridden** — it was in none of the mount lists. It is now a flying mount; since its movement is driven by hand rather than by vanilla travel, the ride input is applied there too.

- **A pet pocketed by flight or a teleport never came back out** — flying, gliding far ahead, a long teleport or a dimension change switches a Follow pet to pocket mode, and the message says it follows again, but the code that restores it existed and was never called: the pet stayed pocketed until re-summoned by hand. It now comes back out as soon as its owner is on the ground. Picking a mode or recalling the pet yourself in the meantime cancels that.

- **A malformed mob id in a pet's data could break summoning** — the id was read with a parser that throws, from the summon path, the pocket-mode switch and the skill-used message, so a hand-edited or damaged pet item threw out of all three instead of just failing to resolve. All of them now share one lenient lookup, which also resolves staff aliases on the two pocket paths that skipped them.

- **The pet guide promised duel rewards that do not exist** — it said bot duels "reward less" and that bot practice counts for ELO. No duel pays out coins or essence beyond a wager, and bot duels never change ELO. The two pages now say so.

- **The same pet could be fielded three times in a duel** — the roster accepted a repeated id. Ids are now taken once each.

- **Star Essence reset a pet's bond** — upgrading a stat, by right-click or at the anvil, rebuilt the pet through an older constructor that fills bond with its rarity default, so a pet that had earned its ride lost it to the upgrade. The debug skill command dropped the duel record and bond the same way. All three now copy the pet and change only what they mean to.

### Changed

- **Mount speeds rebalanced** — ground mounts were far too fast and now move at half their previous speed. Arcane mounts are a quarter faster than the rest, flying and on foot, which makes the long flights on Vaelryn, Nyssara and Magmara 25% shorter. A flying mount walking on the ground now uses ground speed rather than its flight speed. The ground speed setting is now `ground_ride_speed` (default 0.12) under `[mounts]`; the old `ground_speed` key is retired so that existing configs pick up the new default.

- **Swim and flight speeds rebalanced** — aquatic mounts were too fast and now swim at half their previous speed; every flying mount flies 25% faster, on top of the Arcane bonus. The settings are now `swim_ride_speed` (default 0.10) and `fly_ride_speed` (default 0.375); the old `swim_speed` and `fly_speed` keys are retired for the same reason.

- **Fewer allocations on hot paths** — the despawn check, which runs for every mob on every tick, the kill-drop and bond hooks, and the start-tracking hook all read a mob's persistent data to tell a pet from anything else, which creates an empty tag on each mob that has none. They now use the existing pet index. Skinned pets no longer build a string per frame to find their texture.

- **Dead code removed** — 25 unreferenced members (duel reward helpers that were never wired, deprecated turn-order stubs and their `TurnSlot` class, a legacy item-render fallback, unused constants) and 27 unused imports.

- **Built against Arcadia Lib 1.3.1** — the minimum required version is now 1.3.1.

- **Network protocol bumped to 2** — the pet HP sync and pocket-pet packets carry the skin now. A client on 1.3.0 is refused at login with a version mismatch instead of misreading them.

### Ajouts

- **Deux skins variants pour chaque familier** — chaque espèce a désormais son apparence originale plus une variante Tier I et une Tier II, conçues une par une : le loup des neiges et le loup noir, le golem de cuivre et le golem oxydé, le cochon Tamworth et le cochon tacheté, le blaze des âmes et celui du néant, et ainsi de suite pour les 27 espèces des pools et les quatre familiers Arcane. Là où le jeu fournit déjà une autre apparence pour l'espèce (loups, chats, renards, lapins, axolotls, grenouilles, arpenteurs, shulkers, pandas, robes de mooshroom, stray et bogged, le gardien, le wither blindé), c'est elle la variante, lue depuis le jeu installé et jamais redistribuée ; les autres sont recolorées depuis la texture de l'espèce avec une palette écrite pour elle. Les moutons changent de couleur de toison. Les familiers du staff gardent leur apparence originale, et une espèce sans variante conçue, comme un mob moddé ajouté aux pools, n'en a simplement pas.

- **Gemmes de skin I et II** — à appliquer à l'enclume, familier à gauche et gemme à droite, pour débloquer définitivement ce tier du skin de son espèce et le lui faire porter ; la gemme est consommée et le familier garde tout le reste. Un skin débloqué ne se paie jamais deux fois : le panneau du familier propose des onglets Base / I / II sous le portrait pour passer gratuitement d'un skin débloqué à l'autre, et l'enclume refuse une gemme pour un tier déjà acquis. Les gemmes n'ont pas de recette : le staff les distribue, ce qui permet à un serveur de les vendre. On peut aussi en trouver dans les coffres de butin avec des chances très faibles (0,1 % et 0,02 % par coffre commun, 0,4 % et 0,1 % par coffre de fin de jeu par défaut), et `token_loot_enabled` dans une nouvelle section `[skins]` coupe ce butin pour les serveurs qui les vendent. Tout familier démarre avec son apparence originale, et les familiers existants ne changent pas.

- **Les Arcane volants portent deux joueurs** — Vaelryn, Nyssara et Magmara accueillent un passager derrière leur propriétaire : une fois le propriétaire en selle, un autre joueur fait clic droit sur le familier pour monter. Le propriétaire garde les commandes, le passager ne voyage jamais sans lui, et tous deux descendent ensemble quand le propriétaire descend.

- **Tri et filtre de la collection** — l'onglet Familiers gagne un bouton de tri (rareté par défaut, puis étoiles, nom, arrivée) et un seuil de collection : les sacs ouverts n'envoient dans la collection que les familiers de la rareté choisie et au-dessus, les autres vont directement dans l'inventaire. Les deux réglages sont mémorisés par joueur, et les familiers déjà rangés ne bougent pas.

- **Verrouiller ses familiers préférés** — clique sur l'objet de page de l'onglet Familiers pour passer en mode verrouillage, puis clique sur les familiers pour les verrouiller ou les déverrouiller. Un familier verrouillé ne peut ni être retiré de la collection ni fusionné. Les verrous sont gardés par joueur.

- **Progression de collection** — l'objet de page indique combien d'espèces tu as collectées sur toutes celles obtenables.

- **Appeler sa monture** — une nouvelle touche (H par défaut) fait venir ton familier jusqu'à 64 blocs et te met en selle ; appuie de nouveau pour descendre. C'est désormais la façon de quitter un familier : s'accroupir fait descendre une monture volante (et plonger une monture aquatique) au lieu de te faire tomber, pour atterrir sans quitter la selle. La jauge de vol s'affiche aussi pendant qu'elle se recharge au sol, pour savoir quand tu peux redécoller.

- **Aperçu des skins dans le Bestiaire** — la fiche détaillée de chaque espèce propose un sélecteur Originale / Tier I / Tier II, pour voir exactement ce que donnera une gemme avant de l'utiliser.

- **L'apparence se voit partout où le familier apparaît** — le familier invoqué pour chaque joueur qui le voit, y compris quand une gemme est utilisée alors qu'il est sorti, le familier de poche, les icônes d'objet, le piédestal, le portrait du HUD, le panneau du familier, les cartes de duel, une ligne « Apparence » dans l'infobulle et la ligne du nom à l'ouverture des caisses.

- **Les mises en duel peuvent être désactivées** — nouveau réglage `duel_bets_enabled` dans `[gameplay]`. Les serveurs qui vendent des objets ou de la monnaie devraient le couper, car laisser les joueurs miser cette monnaie sur un jeu de hasard peut enfreindre l'EULA de Minecraft. Désactivé, `/arcadia_pets duel <joueur> <mise>` est refusé avec un message, tout autre défi se joue sans mise, et une mise encore en attente au moment du changement n'est jamais prélevée. Activé par défaut, rien ne change donc pour les serveurs qui n'y touchent pas.

- **`/arcadia_pets skin <original|variant_1|variant_2>`** — commande opérateur qui change l'apparence du familier actif, pour vérifier une variante sur une espèce donnée.

### Correctifs

- **Impossible de monter son propre familier dans le claim d'un autre joueur** — les mods de claims annulent l'interaction avec les entités dans un claim qui n'appartient pas au joueur, et le gestionnaire de monte s'y pliait comme pour toute autre interaction, puis la monte elle-même était refusée une seconde fois au moment de monter. Le propriétaire d'un familier passe désormais ces deux contrôles, pour ce familier uniquement : quiconque d'autre tente de le monter, et toute autre interaction dans le claim, reste soumis au mod de claims.

- **Les dragons étaient beaucoup trop petits** — la taille de compagnon vise la hauteur du genou et plafonne la largeur à un bloc, ce qui ramenait l'Ender Dragon de 16 blocs à un demi-bloc de haut et Vaelryn à la taille d'un chat ; les joueurs le comparaient à un moustique. Les dragons ont désormais leur propre gabarit, environ 1,5 bloc de haut et jusqu'à 1,9 à 5★ d'Endurance, avec jusqu'à 3,5 blocs de large.

- **Les petits familiers étaient plus grands que l'animal réel** — tous les familiers visaient la même hauteur : les grands mobs rétrécissaient bien, mais les petits étaient gonflés au-delà de leur taille naturelle. Un poulet, lapin, grenouille, allay ou axolotl 5★ mesurait 0,8 bloc, et les mobs larges comme l'Elder Guardian restaient massifs à cette hauteur. Les familiers sont désormais dimensionnés selon leur corpulence, hauteur plus largeur, et jamais affichés au-delà de 80 % de leur taille naturelle : un mob large rétrécit davantage qu'un mob fin, et les petits animaux ne sont que légèrement réduits. Les familiers du staff, déjà à la bonne taille, la conservent, puisque le nouveau calcul est calé sur eux. Les familiers gardent leur taille de compagnon quand on les monte, et le cavalier est assis sur leur dos à cette taille. Les familiers Arcane gardent leur taille actuelle.

- **L'Ender Dragon ne pouvait pas être monté** — il ne figurait dans aucune liste de montures. C'est désormais une monture volante ; comme ses déplacements sont pilotés à la main plutôt que par le déplacement vanilla, les commandes du cavalier y sont appliquées aussi.

- **Un familier passé en poche en vol ou par téléportation n'en ressortait jamais** — voler, planer loin devant, une longue téléportation ou un changement de dimension fait passer un familier Follow en mode poche, et le message annonce qu'il suivra de nouveau, mais le code qui le rétablit existait sans jamais être appelé : le familier restait en poche jusqu'à une réinvocation manuelle. Il ressort désormais dès que son propriétaire est au sol. Choisir soi-même un mode ou rappeler le familier entre-temps annule ce retour.

- **Un identifiant de mob malformé dans les données d'un familier pouvait casser l'invocation** — l'identifiant était lu avec un analyseur qui lève une exception, depuis l'invocation, le passage en mode poche et le message de compétence utilisée : un objet familier modifié à la main ou abîmé faisait échouer les trois au lieu de simplement ne pas se résoudre. Tous partagent désormais une seule recherche tolérante, qui résout aussi les alias du staff sur les deux chemins du mode poche qui les ignoraient.

- **Le guide promettait des récompenses de duel inexistantes** — il annonçait que les duels contre le bot « rapportent moins » et que l'entraînement contre le bot compte pour l'ELO. Aucun duel ne verse de pièces ni d'essence en dehors d'une mise, et les duels contre le bot ne modifient jamais l'ELO. Les deux pages le disent maintenant.

- **Un même familier pouvait être aligné trois fois en duel** — la composition acceptait un identifiant répété. Chaque identifiant n'est plus pris qu'une fois.

- **L'Essence d'étoile remettait le Lien à zéro** — améliorer une statistique, au clic droit comme à l'enclume, reconstruisait le familier via un ancien constructeur qui remplit le Lien avec la valeur par défaut de la rareté : un familier qui avait mérité sa monte la perdait à l'amélioration. La commande de debug d'ajout de compétence effaçait de même le palmarès de duel et le Lien. Les trois copient désormais le familier en ne changeant que ce qu'ils doivent changer.

### Modifications

- **Vitesses des montures rééquilibrées** — les montures terrestres étaient beaucoup trop rapides et vont désormais deux fois moins vite. Les montures Arcane sont 25 % plus rapides que les autres, en vol comme au sol, ce qui raccourcit d'un quart les longs vols sur Vaelryn, Nyssara et Magmara. Une monture volante qui marche au sol utilise désormais la vitesse terrestre au lieu de sa vitesse de vol. Le réglage de vitesse au sol s'appelle maintenant `ground_ride_speed` (0,12 par défaut) dans `[mounts]` ; l'ancienne clé `ground_speed` est retirée pour que les configs existantes reprennent la nouvelle valeur par défaut.

- **Vitesses de nage et de vol rééquilibrées** — les montures aquatiques étaient trop rapides et nagent désormais deux fois moins vite ; toutes les montures volantes volent 25 % plus vite, en plus du bonus Arcane. Les réglages s'appellent maintenant `swim_ride_speed` (0,10 par défaut) et `fly_ride_speed` (0,375 par défaut) ; les anciennes clés `swim_speed` et `fly_speed` sont retirées pour la même raison.

- **Moins d'allocations sur les chemins chauds** — la vérification de despawn, exécutée pour chaque mob à chaque tick, les hooks de butin et de Lien, et le hook de début de suivi lisaient tous les données persistantes d'un mob pour distinguer un familier du reste, ce qui crée un tag vide sur chaque mob qui n'en a pas. Ils utilisent désormais l'index des familiers existant. Les familiers skinnés ne construisent plus une chaîne par image pour trouver leur texture.

- **Code mort retiré** — 25 membres jamais référencés (fonctions de récompense de duel jamais branchées, anciens bouchons d'ordre de tour et leur classe `TurnSlot`, un ancien rendu de repli des objets, des constantes inutilisées) et 27 imports inutilisés.

- **Compilé contre Arcadia Lib 1.3.1** — la version minimale requise est désormais 1.3.1.

- **Protocole réseau passé à 2** — la synchro des PV du familier et le paquet du familier de poche transportent maintenant l'apparence. Un client en 1.3.0 est refusé à la connexion pour version incompatible au lieu de les lire de travers.