Documentation · Événements standard
Événements standard cross-jeu
Catalogue officiel des eventType partagés entre jeux (Minecraft Java, Bedrock, Hytale…). Source de vérité : @gamestats/shared-types (54 types, dont alias dépréciés).
Zones vs territoires
- ENTER_ZONE / LEAVE_ZONE — zones définies par le serveur ou un plugin (WorldGuard spawn, warzone Factions, arène, safezone…).
- ENTER_TERRITORY / LEAVE_TERRITORY — territoires possédés par des joueurs ou factions (claims, plots Towny, bases de guilde…).
- ZONE_ENTER / ZONE_EXIT restent acceptés mais dépréciés (alias de ENTER_ZONE / LEAVE_ZONE).
Présence & session
| eventType | Description | Payload |
|---|---|---|
| PLAYER_JOIN | Connexion au serveur / monde | displayName, isFirstJoin, source |
| PLAYER_QUIT | Déconnexion | reason, disconnectSource |
| SESSION_START | Début de session de jeu | mode, instance_id |
| SESSION_END | Fin de session | mode, duration_s, reason |
| AFK_START | Joueur passé AFK | trigger (idle, command, tab) |
| AFK_END | Retour actif | afk_duration_s |
| SERVER_TRANSFER | Changement de serveur (réseau) | from_server, to_server, reason |
Économie
| eventType | Description | Payload |
|---|---|---|
| ECONOMY_TRANSACTION | Mouvement monétaire | amount / delta, currency, reason_code |
| SHOP_PURCHASE | Achat boutique (NPC, GUI) | shop_id, item_id, quantity, price, currency |
| AUCTION_BID | Enchère placée | auction_id, amount, currency |
| AUCTION_WON | Enchère remportée | auction_id, amount, seller_id |
Communication
| eventType | Description | Payload |
|---|---|---|
| CHAT | Message chat | message, channel (optionnel) |
Modération
| eventType | Description | Payload |
|---|---|---|
| MODERATION_ACTION | Action staff | action, actorPlayerId, targetPlayerId, durationSeconds, reason |
Ressources & inventaire
| eventType | Description | Payload |
|---|---|---|
| FIND_GEM | Découverte rare | resource_id, rarity |
| RESOURCE_GATHER | Récolte | resource_id, quantity, source |
| RESOURCE_DEPLETED | Ressource épuisée | resource_id, source_id |
| CRAFT_ITEM | Fabrication | recipe_id, inputs, output |
| UPGRADE_ITEM | Amélioration d’objet | item_id, before, after, method |
| ITEM_PICKUP | Ramasse un objet notable | item_id, quantity, source |
| ITEM_DROP | Dépose / jette un objet | item_id, quantity, reason |
Progression
| eventType | Description | Payload |
|---|---|---|
| LEVEL_UP | Montée de niveau | level, system |
| MILESTONE_REACHED | Palier atteint | milestone_id, threshold |
| ACHIEVEMENT_UNLOCKED | Succès débloqué | achievement_id ou advancement |
| QUEST_STEP | Étape de quête | quest_id, step_index, step_id |
Combat & vie
| eventType | Description | Payload |
|---|---|---|
| COMBAT_ENGAGE | Début de combat | initiator_id, target_id, target_kind |
| COMBAT_END | Fin de combat | outcome, killer_player_id, victim_player_id, combat_scope |
| DAMAGE_TAKEN | Dégâts reçus | source, cause, amount |
| STATUS_EFFECT | Effet appliqué / retiré | effect_id, applied, duration_s |
| BOSS_ENGAGE | Début combat boss / raid | boss_id, boss_label, instance_id |
| BOSS_DEFEATED | Boss vaincu | boss_id, participants_count, duration_s |
| DEATH | Mort du joueur | cause, message, killer_player_id |
| RESPAWN | Réapparition | isBedSpawn, isAnchorSpawn, spawn_kind |
Échanges & social
| eventType | Description | Payload |
|---|---|---|
| TRADE_INITIATED | Début d’échange | peer_player_id, items_offered |
| TRADE_COMPLETED | Échange conclu | peer_player_id, items_given, items_received |
| GROUP_JOIN | Rejoint un groupe | group_id, group_type |
| GROUP_LEAVE | Quitte un groupe | group_id, group_type, reason |
| CHANGE_PERMISSION_GROUP | Changement grade / permission | groupName, previousGroupName |
| CHANGE_TEAM_GROUP | Changement équipe / faction | groupName, previousGroupName |
| CHANGE_OTHER_GROUP | Autre regroupement | groupName, previousGroupName |
| PLAYER_INTERACT | Interaction sociale | kind, target_player_id |
Monde, zones & déplacement
| eventType | Description | Payload |
|---|---|---|
| ENTER_ZONE | Entrée zone serveur / plugin (WorldGuard, warzone, spawn…) | zone_id, zone_label, zone_kind, plugin_source, world |
| LEAVE_ZONE | Sortie de zone serveur / plugin | zone_id, zone_label, dwell_time_s, world |
| ENTER_TERRITORY | Entrée territoire joueur / faction (claim, plot…) | territory_id, territory_label, owner_kind, owner_id, owner_name, relation, plugin_source, world |
| LEAVE_TERRITORY | Sortie de territoire joueur / faction | territory_id, dwell_time_s, relation, world |
| STRUCTURE_DISCOVERED | Structure / POI découverte | structure_id, structure_label |
| FAST_TRAVEL | Voyage rapide gameplay | from, to, method |
| TELEPORT | Téléportation générique | from, to, cause |
| VEHICLE_ENTER | Monte véhicule / monture | vehicle_kind, vehicle_id |
| VEHICLE_EXIT | Descend véhicule / monture | vehicle_kind, duration_s |
| INTERACT_BLOCK | Interaction bloc significative | block_type, action, block_id |
| ZONE_ENTER→ ENTER_ZONE | Alias historique — entrée de zone | Identique à ENTER_ZONE |
| ZONE_EXIT→ LEAVE_ZONE | Alias historique — sortie de zone | Identique à LEAVE_ZONE |
Engagement
| eventType | Description | Payload |
|---|---|---|
| VOTE_CAST | Vote (site, in-game) | vote_site, reward |
| CUSTOM_UI_OPEN | Ouverture menu suivi | ui_id, context |
Alias dépréciés : ZONE_ENTER → ENTER_ZONE, ZONE_EXIT → LEAVE_ZONE. Autres alias hors catalogue : PLAYER_DEATH, PLAYER_KILL, PLAYER_ADVANCEMENT.
Contrat d’ingestion détaillé : API & ingestion.