Documentation/content/world/entities/mounts.fr.md

title, type, weight

title	type	weight
Montures	docs	11

Le systeme de montures permet aux entites de chevaucher d'autres entites ou s'asseoir sur des blocs.

Package: com.hypixel.hytale.builtin.mounts

Apercu

Le systeme de montures supporte:

• Chevaucher des entites NPC
• S'asseoir sur des sieges bases sur blocs
• Mecaniques de vehicules minecart
• Controles de mouvement specifiques aux montures

Architecture

Systeme Montures
├── Composants
│   ├── NPCMountComponent - Config monture NPC
│   ├── MountedComponent - "Je chevauche quelque chose"
│   ├── MountedByComponent - "Quelque chose me chevauche"
│   ├── BlockMountComponent - Siege bloc
│   └── MinecartComponent - Vehicule minecart
├── Systemes
│   ├── MountSystems - Logique monture principale
│   └── NPCMountSystems - Logique specifique NPC
├── Interactions
│   ├── MountInteraction - Monter NPC
│   ├── SeatingInteraction - S'asseoir sur bloc
│   └── SpawnMinecartInteraction - Creer minecart
└── Commandes
    ├── MountCommand - Forcer montage
    ├── MountCheckCommand - Verifier statut
    └── DismountCommand - Forcer demontage

Composants

NPCMountComponent

Attache aux NPCs qui peuvent etre montes:

public class NPCMountComponent implements Component<EntityStore> {
    // Joueur chevauchant actuellement (si present)
    private PlayerRef ownerPlayerRef;

    // Role NPC original avant montage
    private int originalRoleIndex;

    // Configuration monture
    // Vitesses mouvement, capacites, etc.
}

MountedComponent

Attache aux entites qui chevauchent quelque chose:

public class MountedComponent implements Component<EntityStore> {
    // Reference vers ce qu'on chevauche
    private Ref<EntityStore> mountRef;
}

MountedByComponent

Attache aux entites etant chevauchees:

public class MountedByComponent implements Component<EntityStore> {
    // Reference vers le cavalier
    private Ref<EntityStore> riderRef;
}

BlockMountComponent

Composant chunk pour sieges bases sur blocs:

public class BlockMountComponent implements Component<ChunkStore> {
    // Position bloc et configuration
    // Joueur actuellement assis
}

MinecartComponent

Composant vehicule pour minecarts:

public class MinecartComponent implements Component<EntityStore> {
    // Configuration mouvement rails
    // Vitesse, acceleration, etc.
}

Monter des NPCs

Interaction Monture

Les joueurs montent les NPCs via interaction:

// Enregistre comme type interaction "Mount"
Interaction.CODEC.register("Mount",
    MountInteraction.class,
    MountInteraction.CODEC);

Processus de Montage

1. Joueur interagit avec NPC montable
2. NPCMountComponent est ajoute/configure
3. MountedComponent ajoute au joueur
4. MountedByComponent ajoute au NPC
5. Role NPC change vers comportement "monte"
6. Parametres mouvement joueur mis a jour

Demontage

Le demontage peut survenir:

• Joueur demonte manuellement
• Joueur se deconnecte
• Monture ou joueur meurt
• Commande force demontage

// Demonter NPC
MountPlugin.dismountNpc(store, mountEntityId);

// Reinitialiser parametres mouvement joueur
MountPlugin.resetOriginalPlayerMovementSettings(playerRef, store);

Sieges de Blocs

Interaction Siege

Les joueurs s'assoient sur blocs via interaction:

// Enregistre comme type interaction "Seating"
Interaction.CODEC.register("Seating",
    SeatingInteraction.class,
    SeatingInteraction.CODEC);

API Monture Bloc

BlockMountAPI api = BlockMountAPI.get();

// Verifier si bloc est un siege
boolean isSeat = api.isSeat(world, blockPos);

// Obtenir joueur assis
PlayerRef seated = api.getSeatedPlayer(world, blockPos);

Minecarts

Interaction Spawn Minecart

Creer minecarts via interaction:

// Enregistre comme type interaction "SpawnMinecart"
Interaction.CODEC.register("SpawnMinecart",
    SpawnMinecartInteraction.class,
    SpawnMinecartInteraction.CODEC);

Comportement Minecart

• Suit les rails
• Vitesse et acceleration configurables
• Peut transporter joueurs et items
• Collision avec autres minecarts

Composant Core NPC

Les NPCs peuvent utiliser actions de monture:

// Type composant core enregistre
NPCPlugin.get().registerCoreComponentType("Mount", BuilderActionMount::new);

{
  "Type": "Mount",
  "MountTarget": "player",
  "Duration": 10.0
}

Commandes

/mount

Forcer un joueur a monter un NPC:

/mount <joueur> <selecteur_npc>

/mountcheck

Verifier statut monture:

/mountcheck <joueur>

/dismount

Forcer demontage d'un joueur:

/dismount <joueur>

Acces au Plugin

MountPlugin mounts = MountPlugin.getInstance();

// Types de composants
ComponentType<EntityStore, NPCMountComponent> npcMountType =
    mounts.getMountComponentType();
ComponentType<EntityStore, MountedComponent> mountedType =
    mounts.getMountedComponentType();
ComponentType<EntityStore, MountedByComponent> mountedByType =
    mounts.getMountedByComponentType();
ComponentType<EntityStore, MinecartComponent> minecartType =
    mounts.getMinecartComponentType();
ComponentType<ChunkStore, BlockMountComponent> blockMountType =
    mounts.getBlockMountComponentType();

Systemes

Suivi Monture

// Mettre a jour suivi position monture
MountSystems.TrackerUpdate

// Supprimer suivi monture a suppression entite
MountSystems.TrackerRemove

Gestion Mort

// Demonter joueur quand il meurt
NPCMountSystems.DismountOnPlayerDeath

// Demonter quand monture meurt
NPCMountSystems.DismountOnMountDeath

Mouvement

// Gerer input joueur sur monture
MountSystems.HandleMountInput

// Teleporter entite montee avec monture
MountSystems.TeleportMountedEntity

Evenements

Deconnexion Joueur

Quand joueur se deconnecte en montant:

// Demonter automatiquement a deconnexion
getEventRegistry().register(PlayerDisconnectEvent.class,
    MountPlugin::onPlayerDisconnect);