|
|
| Ligne 1 : |
Ligne 1 : |
| = Achat de structure (CV / Base) = | | == Notifications Discord - Mod Empyrion == |
|
| |
|
| == Description ==
| | '''Les notifications Discord'' permettent au serveur Empyrion de communiquer automatiquement avec votre serveur Discord dès que des événements importants se produisent : connexions/déconnexions de joueurs, décès, gains de crédits, et bien d'autres. |
| Cette page décrit la fonctionnalité '''Achat de structure''' de la Boîte à Outils.
| |
|
| |
|
| Elle permet à un joueur de '''demander au staff la création d’un blueprint en jeu'''
| | === Qu'est-ce que c'est ? === |
| (vaisseau CV ou base), en échange de crédits.
| |
|
| |
|
| 👉 Cette fonctionnalité repose sur un '''système de ticket structuré''' permettant :
| | Le système de notifications repose sur une intégration entre : |
| * de tracer les demandes
| | * '''Le mod Empyrion''' qui détecte les événements en jeu |
| * de contrôler les règles | | * '''Le bot Discord''' qui reçoit ces événements et les poste dans vos canaux |
| * de sécuriser les transactions
| |
| * d’assurer un traitement par le staff
| |
|
| |
|
| == Important : différence avec les blueprints ==
| | Chaque événement est automatiquement formaté en message Discord avec emojis et informations pertinentes. Aucune intervention manuelle n'est requise. |
| Cette fonctionnalité est '''distincte''' des pages suivantes :
| |
|
| |
|
| * [[Blueprints sur le PC]] → vos blueprints locaux
| | === Événements supportés === |
| * [[Workshop OA]] → les blueprints communautaires
| |
|
| |
|
| 👉 Ici, vous ne consultez pas des blueprints.
| | ; Connexion/Déconnexion |
| 👉 Vous demandez au staff de '''spawn une structure en jeu'''.
| | : Notification à chaque joueur qui se connecte ou se déconnecte du serveur |
| | ; Décès |
| | : Message immédiat lors du décès d'un joueur en jeu |
| | ; Gains de crédits |
| | : Notifications pour tous les types d'opérations de crédits (gains, débits, transferts, rewards, actions admin) |
| | ; Transactions |
| | : Événements de transactions spéciales selon votre configuration |
|
| |
|
| == Principe général == | | === Guides d'utilisation === |
|
| |
|
| Le système fonctionne en plusieurs étapes :
| | * [[#Fonctionnement technique|Configuration technique]] — Détails des endpoints API et paramètres |
| | * [[#Intégration serveur|Intégration avec votre serveur]] — Comment connecter le mod et vérifier le fonctionnement |
|
| |
|
| * 1. Le joueur '''forge un ticket'''
| | === Configuration rapide === |
| * 2. Le ticket est envoyé au serveur
| |
| * 3. Le joueur '''publie le ticket'''
| |
| * 4. Le ticket est transmis sur Discord
| |
| * 5. Le staff traite la demande
| |
| * 6. La structure est spawn en jeu si validée
| |
|
| |
|
| 👉 Tout est tracé et sécurisé.
| | Pour activer les notifications, vous devez : |
|
| |
|
| == Interface ==
| | 1. Configurer la '''clé API interne''' (X-API-Key) dans votre configuration Discord |
| <br clear="all"/>
| | 2. Pointer le mod Empyrion vers l'endpoint Discord du bot |
| [[Fichier:Ticket structure.png|cadre|gauche|Formulaire de demande d'achat de structure]]
| | 3. Vérifier que le canal Discord cible est accessible au bot |
| <br clear="all"/>
| |
|
| |
|
| Cette interface permet de :
| | [[Category:BAO]] |
| | | [[Category:Discord]] |
| * sélectionner le type de structure (CV ou Base)
| | [[Category:Empyrion]] |
| * renseigner la classe
| |
| * générer automatiquement le ticket
| |
| * publier la demande au staff
| |
| | |
| == Cycle de vie d’un ticket ==
| |
| | |
| === Étapes techniques ===
| |
| | |
| 1. '''Forge'''
| |
| * création du ticket côté serveur
| |
| * génération du contenu du ticket
| |
| | |
| 2. '''Publication'''
| |
| * envoi vers Discord via un job asynchrone
| |
| * suivi du statut (queued, running, completed, failed)
| |
| | |
| 3. '''Traitement'''
| |
| * analyse par le staff
| |
| * validation ou refus
| |
| | |
| 4. '''Exécution'''
| |
| * spawn de la structure en jeu
| |
| * clôture du ticket
| |
| | |
| 👉 Le système gère automatiquement les états et les erreurs.
| |
| == Règles générales ==
| |
| | |
| ⚠️ Toute demande doit respecter les règles suivantes :
| |
| | |
| * minimum facturé : '''5 classes'''
| |
| * si un équipement interdit est détecté :
| |
| * pénalité de '''30%'''
| |
| * nouvelle demande obligatoire
| |
| | |
| 👉 Les règles sont vérifiées au moment du '''spawn'''.
| |
| | |
| == Règles pour les Bases ==
| |
| | |
| * classe maximale : '''70'''
| |
| | |
| === Équipements interdits ===
| |
| | |
| Les équipements suivants sont interdits au moment du spawn :
| |
| | |
| ==== 1. Énergie ====
| |
| Tous les systèmes de génération ou d’optimisation d’énergie avancée :
| |
| | |
| * réacteur à fusion
| |
| * générateurs plasma
| |
| * panneaux solaires
| |
| * éoliennes
| |
| * tout équipement de réduction de consommation énergétique
| |
| | |
| ==== 2. Défense ====
| |
| Tous les systèmes défensifs :
| |
| | |
| * générateurs de bouclier
| |
| * systèmes de protection avancée
| |
| | |
| ==== 3. Production ====
| |
| * baie hydroponique
| |
| | |
| ==== 4. Armement ====
| |
| * toute forme d’armement (même passif ou non chargé)
| |
| | |
| ==== 5. Équipements spéciaux ====
| |
| * équipements quantiques
| |
| | |
| ==== 6. Restrictions techniques ====
| |
| * uniquement '''noyau standard'''
| |
| * aucun équipement admin
| |
| | |
| ==== 7. Équipage ====
| |
| * maximum '''1 équipage (humain ou alien) par niveau de classe'''
| |
| | |
| 👉 Exemple : classe 10 → maximum 10 équipages
| |
| | |
| === Important ===
| |
| | |
| 👉 Ces restrictions s’appliquent '''uniquement au moment du spawn'''
| |
| 👉 Une fois la structure spawn, vous pouvez l’équiper librement
| |
| | |
| === Coût ===
| |
| | |
| * '''2,5M crédits / classe'''
| |
| * '''2M crédits / classe''' (donateurs)
| |
| | |
| == Règles pour les CV ==
| |
| | |
| * classe maximale : '''50'''
| |
| | |
| === Équipements interdits ===
| |
| | |
| ==== 1. Énergie ====
| |
| Tous les systèmes de génération ou d’optimisation d’énergie avancée :
| |
| | |
| * réacteur à fusion
| |
| * générateurs plasma
| |
| * tout équipement de réduction énergétique
| |
| | |
| ==== 2. Propulsion ====
| |
| * moteurs ou propulseurs à antimatière
| |
| | |
| ==== 3. Défense ====
| |
| * générateurs de bouclier
| |
| * systèmes défensifs avancés
| |
| | |
| ==== 4. Armement ====
| |
| * tourelles
| |
| * armes fixes
| |
| * foreuses
| |
| * tout système offensif
| |
| | |
| ==== 5. Saut ====
| |
| * tout moteur de saut supérieur au moteur de saut avancé
| |
| | |
| ==== 6. Production ====
| |
| * baie hydroponique
| |
| | |
| ==== 7. Équipements spéciaux ====
| |
| * équipements quantiques
| |
| | |
| ==== 8. Restrictions techniques ====
| |
| * uniquement '''noyau standard'''
| |
| * aucun équipement admin
| |
| | |
| ==== 9. Équipage ====
| |
| * maximum '''1 équipage (humain ou alien) par niveau de classe'''
| |
| | |
| === Important ===
| |
| | |
| 👉 Les règles sont vérifiées '''au moment du spawn'''
| |
| 👉 Après spawn, vous êtes libre d’équiper votre vaisseau
| |
| | |
| === Coût ===
| |
| | |
| * '''3M crédits / classe'''
| |
| * '''2,5M crédits / classe''' (donateurs)
| |
| | |
| == Catégorie du ticket ==
| |
| <br clear="all"/>
| |
| [[Fichier:Ticket Achat.png|gauche]] | |
| <br clear="all"/>
| |
| | |
| 👉 Toutes les demandes passent par :
| |
| '''Ticket → Demande d’aide → Achat de structure'''
| |
| | |
| == Fonctionnement technique (résumé) ==
| |
| | |
| * création du ticket via l’API serveur
| |
| * génération d’un texte structuré
| |
| * publication via un job asynchrone
| |
| * suivi du statut jusqu’à completion
| |
| * lien Discord retourné au joueur
| |
| | |
| 👉 Le système garantit :
| |
| * traçabilité
| |
| * sécurité
| |
| * non-duplication
| |
| * gestion des erreurs
| |
| | |
| == Ce que cette fonctionnalité permet ==
| |
| * demander un spawn de structure en jeu
| |
| * encadrer les règles serveur
| |
| * sécuriser les transactions
| |
| * automatiser les demandes staff
| |
| | |
| == Ce que cette fonctionnalité ne permet pas ==
| |
| | |
| * consulter des blueprints
| |
| * gérer des blueprints locaux
| |
| * partager des blueprints
| |
| * s’abonner à des blueprints
| |
| * utiliser le Workshop OA
| |
| | |
| 👉 Pour ces usages :
| |
| * voir [[Blueprints sur le PC]]
| |
| * voir [[Workshop OA]]
| |
| | |
| == Conseils ==
| |
| | |
| * vérifie ta classe avant demande
| |
| * nettoie ton blueprint des équipements interdits
| |
| * anticipe le coût en crédits
| |
| * évite les demandes incorrectes (pénalité)
| |
| | |
| == À savoir ==
| |
| | |
| * toute demande est tracée
| |
| * toute erreur entraîne une nouvelle demande
| |
| * le traitement dépend du staff
| |
| * le système est asynchrone (peut prendre du temps)
| |
Notifications Discord - Mod Empyrion
'Les notifications Discord permettent au serveur Empyrion de communiquer automatiquement avec votre serveur Discord dès que des événements importants se produisent : connexions/déconnexions de joueurs, décès, gains de crédits, et bien d'autres.
Qu'est-ce que c'est ?
Le système de notifications repose sur une intégration entre :
- Le mod Empyrion qui détecte les événements en jeu
- Le bot Discord qui reçoit ces événements et les poste dans vos canaux
Chaque événement est automatiquement formaté en message Discord avec emojis et informations pertinentes. Aucune intervention manuelle n'est requise.
Événements supportés
- Connexion/Déconnexion
- Notification à chaque joueur qui se connecte ou se déconnecte du serveur
- Décès
- Message immédiat lors du décès d'un joueur en jeu
- Gains de crédits
- Notifications pour tous les types d'opérations de crédits (gains, débits, transferts, rewards, actions admin)
- Transactions
- Événements de transactions spéciales selon votre configuration
Guides d'utilisation
Configuration rapide
Pour activer les notifications, vous devez :
1. Configurer la clé API interne (X-API-Key) dans votre configuration Discord
2. Pointer le mod Empyrion vers l'endpoint Discord du bot
3. Vérifier que le canal Discord cible est accessible au bot