Recraft pets

# Recraft Pets

Recraft Pets adds a collection of animated cosmetic familiars to Minecraft.
Hatch them from eggs, raise them over the long term, evolve them into their
ultimate forms, and deploy your favorites as real-size companions that fight
by your side and can be ridden.

Every reward is obtainable in game. This is a pay-to-fast design, never
pay-to-win: the value of a familiar is its look, its rarity, and the prestige
of raising it, nothing that makes you stronger than another player.

## Collect and hatch

- **15 familiars** across **5 rarities**: Common, Rare, Epic, Legendary, Mythic.
- Hatch familiars from **eggs** with a fair **pity system** so a long dry
  streak always ends in a high rarity.
- Duplicates are never wasted: they convert into **Essence**, and can unlock a
  familiar's **shiny** or **color variant** you did not own yet.
- A dedicated **Pet-Dex** interface to browse your collection, equip a
  familiar, switch its display, and open your eggs.

## Three display modes

Show your familiar the way you like: **following** beside you, **orbiting**
around you, or **perched on your shoulder**. Flying familiars glide, the others
move naturally, and each one keeps its own little idle animations.

## Long-term progression

- Familiars gain **affinity** simply by being active with you. The curve is
  deliberately slow: reaching an ultimate form is a real long-term goal.
- **Evolution is a ceremony**: when a familiar is ready, you confirm its
  transformation into a new, more majestic model (baby, adult, ultimate).
- **Shiny** forms are a distinct collectible, with an iridescent tint and
  glow. You can own both the base and the shiny.
- **Color variants** give each familiar an alternate palette to hunt for.
- Reaching maximum affinity unlocks **recoloring**, a cosmetic reward for the
  most dedicated owners.

## Companion mode

Deploy a collected familiar as a full, real-size active entity:

- It follows you, sits on command, and behaves like a loyal beast.
- It **fights**: it attacks nearby hostile mobs, defends you, takes damage, and
  goes down temporarily on a short cooldown instead of being lost.
- **Feed it treats to heal** it after a fight.
- The four ultimate forms are **rideable mounts**. Two of them **fly**: hold
  jump to climb, look where you want to go, and land softly. Right-click while
  riding to make your mount **bite** the target in front of it.

Only one familiar is ever manifested at a time, so it stays lightweight.

## Built to last and to run well

- **Cross-season persistence**: your collection is stored outside the world
  save, so it survives map resets and new seasons.
- Smooth **GeckoLib** models and animations.
- The cosmetic entities are optimized to keep server tick time low.

## Requirements

- Minecraft **1.20.1**, **Forge**
- **GeckoLib 4** (required dependency)

---

by zenh

# Recraft Pets

Recraft Pets ajoute une collection de familiers cosmétiques animés. Fais-les
éclore d'œufs, élève-les sur le long terme, fais-les évoluer jusqu'à leur forme
ultime, et déploie tes préférés en compagnons vraie taille qui combattent à tes
côtés et se chevauchent.

Toutes les récompenses s'obtiennent en jeu. C'est un design pay-to-fast, jamais
pay-to-win : la valeur d'un familier tient à son look, sa rareté et le prestige
de l'avoir élevé, rien qui te rende plus fort qu'un autre joueur.

## Collectionner et faire éclore

- **15 familiers** répartis en **5 raretés** : Commun, Rare, Épique, Légendaire,
  Mythique.
- Fais éclore des familiers depuis des **œufs**, avec un **système de pity**
  équitable pour qu'une longue série malchanceuse finisse toujours par une
  rareté élevée.
- Les doublons ne sont jamais perdus : ils se convertissent en **Essence**, et
  peuvent débloquer la version **shiny** ou une **variante de couleur** que tu
  ne possédais pas encore.
- Une interface **Pet-Dex** dédiée pour parcourir ta collection, équiper un
  familier, changer son affichage et ouvrir tes œufs.

## Trois modes d'affichage

Affiche ton familier comme tu veux : en **suivi** à côté de toi, en **orbite**
autour de toi, ou **posé sur ton épaule**. Les familiers volants planent, les
autres bougent naturellement, et chacun garde ses petites animations.

## Progression au long cours

- Les familiers gagnent de l'**affinité** simplement en étant actifs avec toi.
  La courbe est volontairement lente : atteindre une forme ultime est un vrai
  objectif de longue haleine.
- **L'évolution est une cérémonie** : quand un familier est prêt, tu confirmes
  sa transformation en un modèle plus majestueux (bébé, adulte, ultime).
- Les formes **shiny** sont un collectible distinct, avec une teinte iridescente
  et une lueur. Tu peux posséder à la fois la base et le shiny.
- Les **variantes de couleur** donnent à chaque familier une palette alternative
  à chasser.
- Atteindre l'affinité maximale débloque le **recolorage**, une récompense
  cosmétique pour les plus assidus.

## Mode compagnon

Déploie un familier collecté en entité active, à sa vraie taille :

- Il te suit, s'assoit sur commande, et se comporte comme une bête fidèle.
- Il **combat** : il attaque les monstres hostiles proches, te défend, encaisse
  des dégâts, et tombe temporairement KO (court cooldown) au lieu d'être perdu.
- **Nourris-le de friandises pour le soigner** après un combat.
- Les quatre formes ultimes sont des **montures**. Deux d'entre elles **volent** :
  maintiens saut pour monter, regarde où tu veux aller, et pose-toi en douceur.
  Clic droit en chevauchant pour que ta monture **morde** la cible en face.

Un seul familier est manifesté à la fois, pour rester léger.

## Conçu pour durer et bien tourner

- **Persistance cross-saison** : ta collection est stockée hors de la sauvegarde
  du monde, elle survit donc aux resets de map et aux nouvelles saisons.
- Modèles et animations fluides via **GeckoLib**.
- Les entités cosmétiques sont optimisées pour garder un faible temps de tick
  serveur.

## Prérequis

- Minecraft **1.20.1**, **Forge**
- **GeckoLib 4** (dépendance obligatoire)

---

*par zenh*