Aller au contenu
Inari

Aperçu du connecteur

Inari ne sait rien de votre jeu par lui-même. Un connecteur est le pont : un plugin, addon ou mod exécuté sur (ou à côté de) votre serveur de jeu qui indique à Inari où se trouve chaque joueur.

Connecteurs préconstruits

Section intitulée « Connecteurs préconstruits »

Pas envie d’écrire le vôtre ? Utilisez un connecteur officiel, maintenu dans l’organisation InariProject.

Jeu Connecteur Statut
Minecraft Bedrock connector-minecraft-bedrock-addon Bêta
Minecraft Java (Spigot / Paper) Plugin En développement

Responsabilités

Section intitulée « Responsabilités »

Un connecteur doit :

  1. Ouvrir un WebSocket vers wss://<votre-inari>/ws.
  2. S’authentifier avec l’API_KEY du serveur sur un channel.
  3. Donner un code à chaque joueur et lui envoyer soit un lien vers Inari, soit uniquement le code, qu’il saisit manuellement sur la page d’Inari (voir Connecter les joueurs).
  4. Toutes les ~300 ms, envoyer la position, l’orientation, le groupe et l’état de chaque joueur avec sync_connector_state.

Il peut aussi lire la réponse pour afficher l’état muet ou sourdine en jeu.

Checklist de mise en place

Section intitulée « Checklist de mise en place »
Étape Détail
Définir une API_KEY Dans l’environnement d’Inari. Gardez-la secrète : elle donne le contrôle complet du channel.
Choisir un channel Un connecteur par channel. Utilisez un autre channel pour un autre serveur de jeu.
Utiliser la bonne URL ws:// pour un test local, wss:// derrière votre reverse proxy.
Générer les codes des joueurs Au moins 6 caractères, uniques dans le channel. Des chaînes aléatoires conviennent bien.
Se reconnecter Si la socket se ferme, reconnectez-vous et authentifiez-vous à nouveau.

Données à fournir par joueur

Section intitulée « Données à fournir par joueur »
Champ Source typique
code Le code généré pour ce joueur.
position Coordonnées du monde du personnage.
head Direction dans laquelle regarde le personnage, sous forme de vecteur unitaire (longueur 1, chaque composante entre -1 et 1).
is_force_muted Mort, spectateur, cinématique…
group Équipe, monde, dimension ou salle, pour que seuls les joueurs concernés s’entendent.
display_name Nom du personnage ou du compte.
actions Touche en jeu pour basculer muet ou sourdine.

Pour aller plus loin

Section intitulée « Pour aller plus loin »