Panel staff

Le panel staff est un site réservé à votre équipe, à l'adresse de votre choix : https://<nom>.staff.ekto.fr (par exemple neocity-rp.staff.ekto.fr). On s'y connecte avec son compte Ekto (le même que l'espace client, lié à Discord). La barre de gauche range les pages par tâche, chacun n'y voit que celles que ses droits ouvrent :

• Tableau de bord et Joueurs connectés (avec la recherche de qui portait un identifiant temporaire, sur les 7 derniers jours) ;
• Jeu : les logs du serveur (connexions, argent, objets, sanctions, actions du staff) avec recherche et fiche par joueur (chaque log garde l'ID qu'avait le joueur à ce moment, même après sa déconnexion ; chercher id:253 affiche les derniers joueurs qui ont eu cette ID et leurs logs), les commandes d'administration (bannir, lever un ban, abonnement, rang, monnaie premium, toutes journalisées dans l'onglet Historique), les nouveaux personnages et les blocages de comptes Discord ;
• Support : tickets fermés, candidatures, bugs signalés, suggestions ;
• Équipe : activité du staff, absences ;
• Discord : tirages au sort, notes de mise à jour ;
• Administration, réservée au propriétaire et aux membres de l'espace client qui ont le droit « Super admin du panel staff » : administrateurs, permissions.

Le panel staff sert au travail de votre équipe. Les réglages se font dans l'espace client, selon les droits de chaque membre : page Bot Discord pour les modules, les salons et les messages du bot, page Site joueur pour le contenu du site.

Une section se replie d'un clic sur son titre. Pour aller vite, Ctrl+K (ou la touche /) ouvre la recherche : tapez quelques lettres du nom d'une page puis Entrée. Quand plusieurs serveurs Discord utilisent le même module, le serveur sur lequel on agit se choisit en haut de la page.

Dans Commandes, un joueur se cherche par son numéro de compte (commande /id en jeu) ou son ID Discord. Un abonnement s'y offre en choisissant la formule et le nombre de jours ajoutés, ou se retire ; les rangs donnés par un abonnement n'apparaissent pas dans la liste des rangs.

Tout est à la marque de votre serveur : nom, logo et couleur viennent de la personnalisation de l'espace client.

Formules#

Le panel staff est inclus dans toutes les formules.

Activer le panel staff#

Onglet Panel staff de votre serveur (groupe Outils). Tant que la mise en route n'est pas terminée, l'onglet est verrouillé (« S'ouvre après la mise en route »).

L'adresse est celle de votre serveur, la même pour le panel staff, Orion et le site joueur. Elle est tirée du nom du serveur à la mise en route, et Orion s'active tout seul avec elle : la page affiche alors Adresse réservée pour votre panel staff, et il n'y a rien à choisir. Si votre serveur n'a pas encore d'adresse, le champ Adresse du panel staff la demande :

• de 3 à 32 caractères : lettres minuscules, chiffres et tirets, sans tiret au début, à la fin ni deux tirets à la suite ;
• certains noms sont réservés par Ekto (« Ce nom est réservé par Ekto : choisissez-en un autre. ») ;
• l'espace client vérifie pendant la saisie qu'elle est libre (« Disponible »), sinon : « Cette adresse est déjà prise par un autre serveur. »

Puis Activer le panel staff. L'installation prend quelques minutes la première fois : une barre de progression la suit et la page se met à jour seule. Ensuite :

1. Copiez l'Adresse du panel staff, ou ouvrez-le avec Ouvrir le panel staff : vous y entrez déjà connecté.
2. Redémarrez votre serveur de jeu quand l'encadré « Redémarrez votre serveur de jeu » apparaît sur la page (la notification « Panel staff activé » le rappelle) : c'est ce qui relie le jeu au panel staff (journaux, joueurs connectés, commandes). Faites-le quand cela vous arrange, depuis la vue d'ensemble.

État du panel staff#

Le badge en haut de la page :

Les messages d'erreur possibles, tous suivis de « L'équipe Ekto est prévenue. » :

• « Le panel staff ne répond pas encore. »
• « L'adresse du panel staff n'est pas encore prête (certificat en attente). »
• « L'adresse du site joueur n'est pas encore prête (certificat en attente). »
• « L'activation du panel staff n'a pas abouti. »

Le panel staff ne s'active pas tant que le serveur n'est pas mis en service, ni s'il est suspendu ou résilié : la raison s'affiche sur la page (« Le serveur n'est pas encore mis en service. », « Le serveur est suspendu. », « L'abonnement de ce serveur est résilié. »). Une seule opération tourne à la fois sur un serveur : « Une opération est déjà en cours sur ce serveur, patientez quelques instants ».

Un serveur suspendu arrête aussi son panel staff, qui repart au paiement. Un abonnement résilié retire son adresse.

Désactiver le panel staff#

Bouton Désactiver de l'onglet Panel staff, réservé au propriétaire. Le panel staff et son bot s'arrêtent et son adresse ne répond plus. Ses données (logs, tickets, sanctions) sont gardées et reviennent si vous le réactivez ; l'adresse reste à votre serveur (Adresse réservée pour votre panel staff). Redémarrez ensuite le serveur de jeu quand l'encadré le propose.

Changer d'adresse#

Bouton Changer l'adresse de l'onglet Panel staff (ou de l'onglet Orion), réservé au propriétaire, au plus une fois par 24 heures. Le premier choix d'une adresse ne compte pas dans ce délai. Pendant les 24 heures, le bouton est grisé et la page indique : « Un seul changement d'adresse par 24 heures : prochain changement possible le ... ». Le bouton est aussi grisé pendant une opération en cours.

La nouvelle adresse suit les mêmes règles qu'à l'activation. Le panel staff, Orion et le site joueur changent d'adresse ensemble, dans la minute (le temps d'obtenir le certificat). L'ancienne adresse cesse aussitôt de fonctionner : prévenez votre équipe. Ensuite :

• redémarrez le serveur de jeu : les liens des vidéos envoyés par le jeu à Orion prennent la nouvelle adresse au redémarrage ;
• avec le site joueur, remplacez l'adresse de retour du site joueur dans votre application Discord (page OAuth2, Redirects) par la nouvelle. Elle est donnée par la notification « Adresse du panel staff changée » et sur la page Discord de l'espace client. La connexion de votre staff passe par Ekto : c'est la seule adresse à changer dans Discord.

Se connecter#

Bouton Se connecter avec Ekto sur la page de connexion du panel staff : il passe par Ekto (connexion avec Discord si besoin) puis revient, connecté. Un membre de votre staff n'a pas besoin de compte dans l'espace client et n'en reçoit pas : Ekto vérifie seulement son Discord. Il ne voit que le panel staff, et seulement les pages que ses droits ouvrent. Une session dure au plus 30 jours, puis il se reconnecte.

Depuis l'espace client, Ouvrir le panel staff ouvre le panel staff déjà connecté. Le lien de connexion ne vaut qu'une minute et ne sert qu'une fois : s'il a expiré, repassez par le bouton.

Qui a accès#

• Le propriétaire, et les membres de l'espace client dont le grade a le droit Super admin du panel staff (voir Grades), ont tous les droits sur le panel staff et sont les seuls à voir la section Administration. Les autres membres de l'espace client n'ont dans le panel staff que les droits donnés par la page Permissions, comme le reste du staff.
• La page Administrateurs donne tous les droits du panel staff à une personne qui s'y est déjà connectée, sans la section Administration.
• Le reste de votre staff reçoit ses droits dans la page Permissions du panel staff (types de journaux visibles, actions autorisées, module par module) :
  • onglet Utilisateurs : droits donnés à une personne, désignée par son ID Discord (clic droit sur son nom dans Discord, Copier l'identifiant, mode développeur activé). Vous pouvez l'ajouter avant sa première connexion. Aucun bot n'est nécessaire ;
  • onglet Rôles : droits donnés à un rôle Discord de votre serveur, si votre bot est en place (voir plus bas). Quitter le Discord ou perdre le rôle retire ces droits.

Attention : le droit « Super admin du panel staff » donne tous les droits du panel staff, section Administration comprise. Le grade Administrateur l'a au départ, pas les grades Modérateur et Support.

Une personne sans aucun droit est refusée à la connexion. Retirer un membre de l'espace client, ou ce droit de son grade, lui retire aussi ses droits d'office sur le panel staff.

Les sanctions (bannir, lever un ban, expulser) suivent les droits de chacun. Par sécurité, le panel staff et le bot acceptent au plus 3 bans et 3 expulsions par heure, toutes personnes confondues : au-delà, le panel indique combien de temps attendre. Les sanctions posées en jeu ne sont pas comptées.

Dans l'espace client#

Votre bot Discord (facultatif)#

Le panel staff fonctionne sans bot. Le bot ajoute les tickets, candidatures, suggestions, tirages au sort, rôles de notification, les droits par rôle Discord, les commandes Discord et les rôles Discord des abonnements (voir Le bot et le jeu). Il passe par votre propre application Discord, au nom de votre serveur. Ekto n'utilise jamais la sienne.

Tout se règle dans la page Discord de l'espace client (groupe Intégrations), bloc Bot du panel staff. La page Panel staff n'en montre que l'état, avec le lien « Configurer sur la page Discord ».

1. Sur le portail des développeurs Discord, créez une application au nom de votre serveur.
2. Copiez son Application ID (page General Information) dans « Application Discord », en haut de la page Discord, avec l'identifiant de votre serveur Discord (clic droit sur le serveur, « Copier l'identifiant du serveur », mode développeur activé), puis Enregistrer dans la barre du bas (ou Ctrl+S).
3. Page Bot du portail : générez le jeton (Reset Token), collez-le dans « Jeton du bot » et cliquez sur le bouton Enregistrer du bloc Bot du panel staff (Ctrl+S ne l'enregistre pas). Activez les intents Server Members et Message Content.
4. Inviter le bot sur votre Discord : le bouton apparaît une fois l'application et le serveur Discord enregistrés, et ajoute le bot avec les droits d'administration.

Le bot démarre avec le panel staff, dès que l'application, le serveur Discord et le jeton sont enregistrés. Le badge du bloc indique où il en est :

Le Client Secret (page OAuth2 du portail) ne sert qu'à la connexion des joueurs à la boutique du site joueur. Les secrets ne sont jamais réaffichés : un badge Enregistré indique qu'ils sont en place. Pour en changer un, collez la nouvelle valeur (champ vide : la valeur enregistrée est gardée). Panel staff actif, l'enregistrement le redémarre avec ses nouveaux secrets (« Secrets enregistrés : le panel staff redémarre avec eux »).

Réglages du bot Discord#

Page Bot Discord de l'espace client (groupe Intégrations). Elle s'ouvre une fois le panel staff activé et le bot configuré (sinon elle renvoie vers la page Panel staff ou la page Discord). Les changements s'appliquent tout de suite, sans redémarrage :

Avec le module Logs vers Discord, le bot crée un salon par type de log, rangé dans une catégorie par famille (Staff, Économie...). La carte Salons de logs de l'onglet Modules coupe un salon, ou une catégorie entière : il ne reçoit plus rien et n'est plus recréé, les logs restent consultables dans le panel staff. Supprimer les salons coupés sur Discord efface ensuite ces salons (avec leurs messages) et les catégories de logs restées vides, sans toucher à vos autres salons.

Le bot et le jeu#

Le bot parle à votre serveur de jeu :

• Commandes Discord : /ban, /unban, /givevip, /setrank et /givecoins (module Commandes), /block, /unblock et /blocklist (module Blocages Discord). Le joueur se désigne par son numéro de compte (/id en jeu) ou par son compte Discord. Elles suivent les mêmes droits que le panel staff et sont journalisées.
• Rôles Discord des abonnements : dans Éléments du jeu, onglet Abonnements, l'avantage Rôle Discord d'une formule reçoit l'identifiant d'un rôle de votre Discord (voir Abonnements). Le bot donne ce rôle aux abonnés et le retire quand l'abonnement s'arrête, toutes les 5 minutes et juste après un /givevip. Il ne touche à aucun autre rôle. Dans les réglages de votre Discord, placez le rôle du bot au-dessus de ces rôles, sinon Discord refuse.
• Attente BDA : page Bot Discord de l'espace client, onglet Salons (module Attente BDA allumé dans l'onglet Modules), choisissez le salon vocal où les joueurs attendent le staff. Le HUD du staff en jeu affiche le nombre de personnes dans ce salon (« en attente BDA »), mis à jour toutes les 30 secondes.
• Orion se sert aussi du bot pour afficher les profils Discord et repérer les comptes Discord jetables (voir Orion).

Site joueur#

Le site joueur est le site public de votre serveur, à l'adresse https://<nom>.site.ekto.fr (le même nom que le panel staff). Il est à la marque de votre serveur : nom, logo et couleur de la personnalisation de l'espace client.

Activer le site : activez l'interrupteur Site joueur dans l'onglet Panel staff (coupé par défaut). L'Adresse du site joueur et le bouton Ouvrir le site s'affichent aussitôt ; le site répond dans les minutes qui suivent, le temps d'obtenir son certificat. Le site est servi par le panel staff : tant que celui-ci est éteint, la page indique « En ligne dès que le panel staff est activé. »

La connexion des joueurs (bouton « Connexion » de la boutique et du recrutement) passe par votre application Discord. Il faut :

• l'Adresse de retour du site joueur, affichée sur la page Discord de l'espace client une fois le site activé, à ajouter dans votre application Discord (page OAuth2, Redirects). Elle a la forme https://<nom>.site.ekto.fr/api/shop/discord/callback ;
• le Client Secret de l'application, enregistré sur la même page.

Remplir le site : page Site joueur de l'espace client (groupe Outils), ouverte une fois le site activé. Les changements sont en ligne dans les 30 secondes :

• onglet Réglages : présentation, image d'accueil (une capture en jeu, 1920 x 1080 ou plus), liens (Jouer, Discord, Twitch, YouTube, TikTok, Instagram, X), pages affichées, éditeur et e-mail de contact des mentions légales ;
• onglets Règlement et Entreprises : une page n'apparaît sur le site qu'une fois remplie.

Le comparatif des abonnements de la boutique se remplit seul : une colonne par formule vendue sur Tebex (Éléments du jeu, onglet Abonnements, voir Abonnements), avec le prix de son paquet, et une ligne par avantage réglé. L'onglet Boutique de la page Site joueur le montre tel que les joueurs le verront.

Boutique : elle se relie dans la page Tebex (jeton public, et clé privée facultative dans ses réglages avancés), une seule fois pour tout le serveur. L'onglet Panel staff indique si elle est reliée (« Reliée : le site joueur affiche vos paquets Tebex. » ou « Pas encore reliée. »). La boutique Tebex est à votre nom. L'acheteur est reconnu par son compte Cfx.re ; s'il indique un numéro de compte (commande /id en jeu) dans la variable ekto_account d'un paquet, c'est ce compte qui est livré (voir Tebex).

Images du jeu#

Les photos d'identité des personnages, les captures et les enregistrements Weazel sont stockés par le panel staff de votre serveur. Panel staff désactivé, Orion les prend en charge ; sans l'un ni l'autre, ces images ne sont pas enregistrées.

Mises à jour#

Le panel staff reçoit des mises à jour comme la base : un bandeau Nouvelle version du panel staff disponible : v... apparaît en haut des pages de votre serveur, avec trois boutons :

• Voir les nouveautés : les notes de chaque version depuis celle installée ;
• Planifier (ou Modifier l'heure une fois planifiée) : date et heure de Paris, au plus tôt dans 10 minutes. Une mise à jour planifiée s'annule avec Annuler la mise à jour planifiée ;
• Mettre à jour maintenant.

Une sauvegarde des données du panel staff est faite juste avant ; en cas de problème, la version précédente est remise automatiquement. Le panel staff redémarre quelques secondes. Le serveur de jeu n'est pas redémarré et aucune annonce n'est faite en jeu. La notification « Panel staff mis à jour » confirme la nouvelle version.

Une mise à jour peut être obligatoire : le bandeau indique « Obligatoire avant le ... : passé ce délai, elle sera installée automatiquement. » Une mise à jour planifiée par Ekto est marquée « Planifiée par Ekto ».

Questions fréquentes#

Comment donner accès au panel staff à un modérateur ?#

Dans le panel staff, page Permissions, onglet Utilisateurs : ajoutez son ID Discord et cochez ses droits. Aucun bot n'est nécessaire et il n'a pas besoin de compte dans l'espace client. Il se connecte ensuite sur l'adresse du panel staff avec Se connecter avec Ekto. Avec le bot en place, vous pouvez aussi donner les droits à un rôle Discord (onglet Rôles).

S'il pilote aussi le serveur avec vous, ajoutez-le plutôt comme membre de l'espace client avec le grade voulu : sans le droit « Super admin du panel staff », il garde dans le panel staff les seuls droits de la page Permissions. Un serveur compte au plus 25 membres.

Le bot n'est pas en ligne ou ne répond pas#

Vérifiez dans l'ordre :

1. Page Discord : « Application Discord » et « Serveur Discord » remplis et enregistrés (barre du bas).
2. « Jeton du bot » enregistré avec le bouton Enregistrer du bloc Bot du panel staff, badge Enregistré à côté du champ.
3. Badge du bloc : Configuré. S'il indique Panel staff inactif, activez le panel staff : le bot ne tourne qu'avec lui.
4. Le bot a été invité avec Inviter le bot sur votre Discord.
5. Intents Server Members et Message Content activés sur la page Bot du portail Discord.
6. Les modules du bot sont allumés dans la page Bot Discord de l'espace client, onglet Modules.
7. Pour les rôles des abonnements : le rôle du bot est placé au-dessus de ces rôles dans votre Discord.

Je n'arrive pas à me connecter au panel staff#

Selon le message affiché :

• « Vous n'avez aucun droit sur ce panel staff : demandez à un responsable de vous en donner. » : ajoutez la personne dans la page Permissions du panel staff (voir plus haut).
• « Le panel staff de ce serveur n'est pas disponible pour le moment. Réessayez dans quelques minutes. » : le panel staff est désactivé, en erreur, ou le serveur est suspendu. Regardez l'onglet Panel staff de l'espace client.
• « Le lien de connexion a expiré, veuillez réessayer. » : le lien ne vaut qu'une minute, recommencez la connexion.

Si l'adresse a été changée, l'ancienne ne répond plus : utilisez celle affichée dans l'onglet Panel staff.

Mon adresse est prise#

« Cette adresse est déjà prise par un autre serveur. » : choisissez un autre nom, par exemple en ajoutant un mot ou un chiffre. Certains noms sont réservés par Ekto. L'adresse est la même pour le panel staff, Orion et le site joueur.

Le bouton « Changer l'adresse » est grisé#

Seul le propriétaire peut changer l'adresse, une fois par 24 heures (la date du prochain changement possible est affichée sous l'adresse), et jamais pendant une opération en cours.

Mes joueurs n'arrivent pas à se connecter à la boutique du site joueur#

Ajoutez l'Adresse de retour du site joueur (page Discord de l'espace client) dans votre application Discord, page OAuth2, Redirects, et enregistrez le Client Secret sur la même page Discord. Après un changement d'adresse, remplacez l'ancienne adresse de retour par la nouvelle.

Le site joueur ne s'ouvre pas#

Le panel staff doit être activé : c'est lui qui sert le site. Si l'onglet Panel staff affiche « L'adresse du site joueur n'est pas encore prête (certificat en attente). », l'équipe Ekto est déjà prévenue.

Un membre peut-il désactiver le panel staff ?#

Oui, s'il a le droit « Panel staff : Modifier ». Le site joueur et le bot suivent les droits de leurs pages. Seule l'option payante reste au propriétaire.