Scripts BAO Windows
🛠️ BAO WINDOWS — Scripts
Scripts communautaires BAO Windows
La page Scripts de la BAO Windows permet de consulter, utiliser, créer et partager des scripts Empyrion au sein de la communauté des Orphelins de l’Apocalypse.
Un script Empyrion est un contenu technique destiné à être utilisé en jeu, le plus souvent avec des écrans LCD. Il peut servir à afficher des informations, automatiser une présentation, organiser un affichage, suivre des ressources ou proposer une aide visuelle directement dans une structure.
Cette page ne sert donc pas seulement à stocker du texte. Elle sert à centraliser des scripts réellement utilisables en jeu, avec leur contenu, leurs instructions et leurs conditions d’utilisation.
Rôle de la page Scripts
La page Scripts sert de bibliothèque communautaire.
Elle permet notamment de :
- consulter les scripts disponibles ;
- retrouver rapidement un script utile ;
- filtrer les scripts par univers ou catégorie ;
- créer ses propres scripts ;
- partager un script en privé, avec sa faction ou avec la communauté ;
- copier le contenu technique d’un script ;
- lire les instructions avant utilisation ;
- modifier un script lorsque les droits le permettent.
Les scripts sont stockés côté serveur BAO. Ils ne sont pas seulement enregistrés sur le PC du joueur.
Ce qu’est un script Empyrion
Dans le contexte de la BAO, un script est un contenu destiné à être utilisé dans Empyrion.
Il peut contenir :
- du code de script ;
- des variables ;
- des conditions ;
- des boucles ;
- des instructions d’affichage ;
- des noms de conteneurs ;
- des règles de lecture de ressources ;
- des informations destinées à un écran LCD.
Le script est ensuite utilisé en jeu par le joueur, selon les instructions fournies dans sa fiche.
Ce que la BAO ne fait pas
La BAO Windows ne lance pas automatiquement les scripts dans Empyrion.
Elle ne fait pas non plus la configuration en jeu à la place du joueur.
La page Scripts permet de stocker, documenter, retrouver et copier les scripts. Le joueur doit ensuite appliquer correctement les instructions dans Empyrion.
Si un écran LCD est mal nommé, si un conteneur attendu n’existe pas, ou si une condition du script n’est pas respectée, le script peut ne pas fonctionner même si le contenu copié depuis la BAO est correct.
Accéder à la page Scripts
Dans le menu latéral de la BAO Windows, cliquez sur :
- Communauté
- Scripts
La page affiche alors la bibliothèque des scripts accessibles au joueur connecté.
Conditions d’accès
L’accès aux scripts dépend des règles BAO.
Le joueur doit être connecté à la BAO Windows avec un compte reconnu.
Selon les règles en vigueur, l’accès peut aussi dépendre :
- de l’appartenance à une faction ;
- du grade du joueur ;
- de l’univers sélectionné ;
- des droits associés au script ;
- du statut de partage du script.
Si l’accès est refusé, la page peut ne pas charger les scripts ou limiter les scripts visibles.
Connexion requise
La page Scripts utilise la session active de la BAO Windows.
La BAO vérifie notamment :
- le SteamID du joueur ;
- le jeton BAO ;
- le joueur associé ;
- les droits d’accès ;
- les droits éventuels de modification.
Si la session est absente ou expirée, il faut retourner sur la page Connexion à la BAO Windows.
Organisation générale de la page
La page principale des scripts est organisée en deux grandes zones.
La première zone contient les filtres.
La seconde zone contient la liste des scripts disponibles.
Cette organisation permet de retrouver rapidement un script sans parcourir toute la bibliothèque communautaire.
Zone de filtres
La zone de filtres permet de limiter les scripts affichés.
Les filtres disponibles sont :
- Univers ;
- Catégorie ;
- Recherche ;
- Mes scripts uniquement.
Les filtres sont cumulables. Il est donc possible de chercher uniquement ses propres scripts dans un univers précis et dans une catégorie précise.
Filtre par univers
Le filtre Univers permet d’afficher les scripts liés à un univers précis.
Exemples :
- Univ1 ;
- Univ2 - Sans CPU ;
- tout autre univers actif configuré dans la BAO.
L’option Tous affiche les scripts de tous les univers accessibles au joueur.
Ce filtre est important, car un script peut être adapté à un contexte de jeu spécifique. Un script utile sur un univers peut ne pas être pertinent sur un autre.
Filtre par catégorie
Le filtre Catégorie permet de classer les scripts selon leur usage.
Les catégories disponibles sont :
- Tri / Inventaire ;
- Maintenance ;
- Gestion Ressources ;
- Agriculture / Jardinage ;
- Information ;
- Affichage / UI ;
- Personnalisé.
La catégorie aide les joueurs à comprendre rapidement le rôle du script.
Recherche textuelle
Le champ Recherche permet de filtrer les scripts par texte.
La recherche porte notamment sur :
- le titre du script ;
- le créateur du script.
Ce champ est utile lorsqu’un joueur connaît déjà le nom du script ou le pseudo de la personne qui l’a créé.
Mes scripts uniquement
La case Mes scripts uniquement affiche uniquement les scripts créés par le joueur connecté.
Ce filtre est utile pour retrouver rapidement ses propres scripts.
Il permet aussi de gérer ses brouillons, ses scripts privés ou ses scripts déjà partagés avec la communauté.
Réinitialiser les filtres
Le bouton Réinitialiser remet la recherche à zéro.
Après réinitialisation :
- l’univers revient sur Tous ;
- la catégorie revient sur Toutes ;
- le champ de recherche est vidé ;
- la case Mes scripts uniquement est désactivée.
La liste des scripts est ensuite recalculée automatiquement.
Liste des scripts
La liste centrale affiche les scripts accessibles au joueur.
Chaque ligne correspond à un script.
Les informations affichées sont :
- Catégorie ;
- Titre ;
- Partage ;
- Univers ;
- Créateur ;
- Créé le ;
- Modifié le ;
- Actions.
La liste permet de comprendre rapidement à quoi sert un script, qui l’a créé, dans quel univers il s’applique et si le joueur peut le modifier.
Catégorie du script
La colonne Catégorie indique le type d’usage du script.
Elle permet de distinguer rapidement un script de tri, un script d’information, un script d’affichage ou un script personnalisé.
Un bon classement rend la bibliothèque plus lisible pour toute la communauté.
Titre du script
Le titre doit permettre d’identifier clairement le script.
Un bon titre indique l’usage réel du script.
Exemples :
- Tri automatique des ressources ;
- Affichage carburant base ;
- Tableau de statut du vaisseau ;
- Suivi des cultures ;
- Informations conteneurs cargo.
Un titre vague rend le script difficile à retrouver et moins utile pour les autres joueurs.
Statut de partage
La colonne Partage indique la visibilité du script.
Les statuts possibles sont :
- Privé ;
- Faction ;
- Communautaire.
Le statut de partage détermine qui peut voir et utiliser le script.
Script privé
Un script Privé est visible uniquement par son créateur.
Ce statut est adapté pour :
- un brouillon ;
- un test ;
- un script personnel ;
- une préparation avant partage ;
- une expérimentation non validée.
Un script privé n’est pas destiné à être utilisé directement par toute la communauté.
Script de faction
Un script Faction est destiné aux membres de la faction concernée.
Ce statut est adapté pour :
- une organisation interne ;
- une procédure propre à une faction ;
- un script lié à une base de faction ;
- un affichage réservé à un groupe ;
- une automatisation qui dépend d’une structure commune.
Ce statut permet de partager avec son groupe sans publier à toute la communauté.
Script communautaire
Un script Communautaire est visible par les joueurs ayant accès à la bibliothèque communautaire.
Ce statut est adapté pour :
- un script utile à plusieurs joueurs ;
- une aide générale ;
- un affichage standardisé ;
- une procédure validée ;
- un contenu réutilisable par la communauté.
Avant de publier un script en communautaire, il faut s’assurer que les instructions sont suffisamment claires.
Univers du script
Chaque script est lié à un univers.
L’univers permet de contextualiser le script.
Un script peut dépendre :
- des règles de l’univers ;
- du mode CPU ;
- du poids-volume ;
- des habitudes de la communauté ;
- de la progression des joueurs ;
- des structures utilisées sur cet univers.
Lors de la création, l’univers doit être choisi correctement. Il n’est pas prévu pour être modifié ensuite depuis l’écran d’édition.
Créateur du script
La colonne Créateur indique le joueur qui a créé le script.
Cette information permet :
- de savoir à qui demander des précisions ;
- d’identifier l’origine du script ;
- de distinguer un script personnel d’un script maintenu par un autre joueur ;
- de responsabiliser les publications communautaires.
Le créateur peut disposer de droits de modification selon les règles BAO.
Dates de création et de modification
La liste affiche la date de création et la date de dernière modification.
Ces informations permettent de savoir si un script est récent ou ancien.
Un script ancien peut encore fonctionner, mais il peut aussi nécessiter une vérification si Empyrion ou les règles de l’univers ont changé.
Droits de modification
La BAO vérifie les droits de modification pour chaque script affiché.
Un script peut apparaître comme :
- Modifiable ;
- Lecture seule.
Un script en lecture seule peut être consulté et copié, mais pas modifié.
Un script modifiable peut être ouvert en édition.
Script en lecture seule
Un script en lecture seule reste utilisable.
Le joueur peut :
- ouvrir le script ;
- lire les instructions ;
- copier le contenu ;
- l’utiliser en jeu.
En revanche, il ne peut pas modifier son titre, son contenu, ses instructions, sa catégorie ou son statut de partage.
Script modifiable
Un script modifiable peut être édité par le joueur.
Le joueur peut alors :
- corriger le titre ;
- modifier les instructions ;
- mettre à jour le contenu ;
- changer la catégorie ;
- changer le niveau de partage ;
- supprimer le script si l’action est autorisée.
La modification doit être faite avec prudence, surtout pour un script communautaire.
Actions disponibles depuis la liste
La liste propose deux actions principales.
Le bouton Ouvrir permet de consulter le script.
Le bouton Modifier permet d’ouvrir le script directement en mode édition si le joueur possède les droits nécessaires.
Un double-clic sur une ligne ouvre également le script en consultation.
Ouvrir un script
L’action Ouvrir affiche la fiche du script.
Cette vue permet de lire les instructions et de copier le contenu du script.
Elle est adaptée à l’usage normal d’un joueur qui veut simplement utiliser un script existant.
Fiche d’un script
La fiche d’un script contient plusieurs zones importantes.
Elle affiche :
- le titre ;
- le statut de partage ;
- la catégorie ;
- l’univers ;
- les instructions ;
- le contenu du script ;
- les informations de création ;
- les informations de modification ;
- les actions disponibles.
Cette fiche est le point central pour comprendre et utiliser correctement un script.
Instructions du script
La zone Explication / instructions est destinée au joueur.
Elle explique comment utiliser le script.
Elle peut préciser :
- le contexte d’utilisation ;
- les prérequis ;
- les blocs nécessaires ;
- les noms exacts à respecter ;
- les conteneurs attendus ;
- les limites connues ;
- les étapes d’installation ;
- les erreurs fréquentes.
Cette zone doit être lue avant de copier le script.
Importance des instructions
Les instructions sont aussi importantes que le contenu du script.
Un script peut être techniquement correct mais inutilisable si le joueur ne sait pas où le placer, quels écrans créer ou quels noms respecter.
Les instructions doivent donc expliquer le fonctionnement attendu en jeu.
Pour un script communautaire, des instructions insuffisantes créent de la confusion et des demandes inutiles au staff.
Mise en forme des instructions
La BAO Windows permet de mettre en forme les instructions.
Les options disponibles sont :
- gras ;
- italique ;
- souligné ;
- liste à puces ;
- nettoyage de la mise en forme.
Les instructions sont sauvegardées dans un format RTF compatible avec l’application BAO.
Cette mise en forme sert à rendre les explications plus lisibles pour les joueurs.
Contenu du script
La zone Contenu du script contient le code ou le texte technique à utiliser dans Empyrion.
C’est cette zone qui doit être copiée lorsque le joueur veut installer le script en jeu.
Elle peut contenir :
- du code brut ;
- des variables ;
- des instructions d’affichage ;
- des références à des conteneurs ;
- des règles de calcul ;
- des blocs de configuration.
Cette zone doit rester propre, complète et directement copiable.
Copier le script
Le bouton Copier le script copie le contenu principal du script dans le presse-papiers Windows.
Cette action copie la zone Contenu du script.
Elle ne copie pas forcément les instructions, le titre, les métadonnées ou les informations de partage.
Après copie, le joueur doit coller le contenu dans l’écran LCD ou l’emplacement prévu dans Empyrion.
Utilisation en jeu avec les LCD
Dans Empyrion, de nombreux scripts utilisent des écrans LCD.
Le principe général est d’utiliser deux écrans :
- un écran contenant le script ;
- un écran affichant le résultat.
Le joueur doit suivre les instructions du script pour connaître les noms exacts à donner aux écrans.
Nommage classique des écrans LCD
Le fonctionnement classique repose sur deux écrans LCD liés par leur nom.
Exemple courant :
- écran 1 : Script:NomDuScript ;
- écran 2 : NomDuScript.
Le premier écran contient le script.
Le second écran affiche le résultat.
Les noms doivent correspondre exactement.
Pourquoi le nommage est important
Le nommage des écrans est une condition essentielle.
Si un espace, une majuscule, un accent ou un caractère est différent, le script peut ne pas fonctionner.
Le jeu ne devine pas l’intention du joueur.
Il faut donc respecter exactement les noms indiqués dans les instructions du script.
Logique de fonctionnement en jeu
Le script est lu par Empyrion selon la logique prévue par le jeu et par les blocs installés.
L’écran nommé avec le préfixe Script: contient la logique du script.
L’écran sans ce préfixe sert généralement à afficher le résultat.
Les deux écrans doivent exister dans la structure concernée.
Conditions possibles d’utilisation
Certains scripts ne fonctionnent que si des conditions précises sont respectées.
Un script peut nécessiter :
- un conteneur avec un nom précis ;
- un bloc spécifique ;
- un écran LCD spécifique ;
- une structure particulière ;
- une alimentation active ;
- une configuration de base ou de vaisseau ;
- un équipage ;
- des ressources disponibles ;
- des crédits ou droits spécifiques selon l’usage.
Ces conditions doivent être indiquées dans les instructions.
Exemples de scripts utiles
Les scripts peuvent couvrir plusieurs usages.
Exemples :
- affichage de ressources ;
- suivi de carburant ;
- suivi d’oxygène ;
- tri d’inventaire ;
- information de maintenance ;
- affichage d’état d’une base ;
- aide visuelle pour les joueurs ;
- suivi agricole ;
- interface LCD personnalisée.
La catégorie du script doit correspondre à son usage principal.
Créer un nouveau script
Le bouton Nouveau script permet d’ajouter un script dans la bibliothèque BAO.
La création ouvre une fiche dédiée.
Lors de la création, le joueur doit renseigner les informations principales du script avant l’enregistrement.
Champs obligatoires à la création
Pour créer un script, il faut renseigner au minimum :
- le titre ;
- le contenu du script ;
- la catégorie ;
- le statut de partage ;
- l’univers.
Si le titre ou le contenu est vide, la BAO refuse l’enregistrement.
La BAO demande aussi de choisir une catégorie et un type de partage.
Choix de l’univers à la création
L’univers est choisi lors de la création du script.
Ce choix est important car il contextualise le script.
Une fois le script créé, l’univers n’est plus modifiable depuis l’écran d’édition.
Si un script est créé dans le mauvais univers, il peut être nécessaire de le recréer correctement.
Choix de la catégorie à la création
La catégorie doit refléter l’usage principal du script.
Il vaut mieux choisir une catégorie claire plutôt que de tout placer en Personnalisé.
Une bonne catégorisation aide les joueurs à retrouver le script et aide aussi ORIA à comprendre son usage dans la documentation.
Choix du partage à la création
Le niveau de partage doit être choisi avec prudence.
Un brouillon doit rester en privé.
Un script réservé à un groupe doit être placé en faction.
Un script utile à tous peut être placé en communautaire.
Un script communautaire doit être compréhensible et suffisamment documenté.
Modifier un script
Le bouton Modifier permet d’éditer un script existant.
La modification est disponible uniquement si le joueur possède les droits nécessaires.
Si les droits ne sont pas suffisants, le script reste en lecture seule.
Champs modifiables
Lorsqu’un script est modifiable, le joueur peut changer :
- le titre ;
- les instructions ;
- le contenu ;
- la catégorie ;
- le statut de partage.
L’univers n’est pas modifiable après la création.
Cette limitation évite de déplacer un script par erreur vers un autre univers.
Passer en mode édition
Depuis la fiche d’un script, le bouton Modifier permet de passer en mode édition lorsque les droits sont suffisants.
Le mode édition déverrouille les champs modifiables.
Le joueur peut ensuite enregistrer ses changements ou quitter l’édition.
Quitter le mode édition
Le bouton Quitter l’édition permet de revenir à la consultation du script.
Cette action est utile lorsqu’un joueur ouvre un script en édition mais ne souhaite finalement rien modifier.
Quitter l’édition ne remplace pas une sauvegarde.
Enregistrer un script
Le bouton Enregistrer sauvegarde la création ou la modification.
Avant l’enregistrement, la BAO vérifie les champs obligatoires.
La sauvegarde peut échouer si :
- la connexion BAO est absente ;
- le titre est vide ;
- le contenu est vide ;
- la catégorie est absente ;
- le partage est absent ;
- le serveur refuse la modification ;
- les droits ne sont plus valides.
Un message d’information ou d’erreur indique le résultat de l’action.
Supprimer un script
La suppression est disponible dans la zone dangereuse.
Elle est affichée uniquement si le joueur peut modifier le script.
Avant suppression, la BAO demande une confirmation.
La suppression retire le script de la bibliothèque visible.
Cette action doit être utilisée avec prudence, surtout pour un script partagé avec une faction ou avec la communauté.
Recharger un script
Le bouton Recharger récupère à nouveau les informations du script depuis les services BAO.
Cette action est utile si :
- le script vient d’être modifié ;
- l’affichage semble ancien ;
- les droits ont changé ;
- une autre personne a modifié le script ;
- le joueur veut annuler visuellement des changements non enregistrés.
Le bouton n’est pas affiché lors de la création d’un nouveau script.
Panneau Informations
Le panneau Informations résume les métadonnées du script.
Il affiche notamment :
- le créateur ;
- l’univers ;
- le statut de partage ;
- la catégorie ;
- la date de création ;
- la date de modification.
Ce panneau permet de comprendre rapidement d’où vient le script et dans quel contexte il doit être utilisé.
Messages affichés par la BAO
La page Scripts utilise des messages pour indiquer l’état des actions.
Exemples de messages possibles :
- scripts chargés ;
- contenu du script copié ;
- script mis à jour ;
- création échouée ;
- modification échouée ;
- suppression échouée ;
- connexion BAO introuvable.
Ces messages aident le joueur à comprendre immédiatement si l’action a réussi ou non.
Bonnes pratiques pour utiliser un script
Avant d’utiliser un script, il faut lire les instructions.
Il faut ensuite vérifier :
- les noms d’écrans LCD ;
- les noms de conteneurs ;
- les blocs nécessaires ;
- l’univers concerné ;
- les limites indiquées ;
- le contexte d’utilisation ;
- le contenu à copier.
Un script mal installé peut ne rien afficher même si le script lui-même est correct.
Bonnes pratiques pour créer un script
Pour créer un script utile à la communauté, il faut éviter de publier un simple bloc de code sans explication.
Un bon script doit contenir :
- un titre clair ;
- une catégorie adaptée ;
- un niveau de partage cohérent ;
- des instructions compréhensibles ;
- un contenu proprement copiable ;
- les prérequis éventuels ;
- les limites connues ;
- les noms exacts à utiliser en jeu.
Un script communautaire doit pouvoir être compris par un joueur qui ne connaît pas son créateur.
Bonnes pratiques pour les instructions
Les instructions doivent expliquer le contexte et l’installation.
Elles doivent répondre aux questions suivantes :
- à quoi sert le script ;
- où faut-il le coller ;
- quels écrans faut-il créer ;
- quels noms faut-il utiliser ;
- quels blocs sont nécessaires ;
- quels conteneurs sont attendus ;
- que faire si le script n’affiche rien.
Des instructions courtes mais précises valent mieux qu’un long texte vague.
Bonnes pratiques pour le contenu du script
Le contenu du script doit rester directement utilisable.
Il faut éviter :
- les lignes inutiles ;
- les commentaires trompeurs ;
- les morceaux incomplets ;
- les dépendances non expliquées ;
- les noms de conteneurs non documentés ;
- les scripts publiés sans test.
Si le script dépend d’un nom précis, ce nom doit être indiqué dans les instructions.
Limites connues
La page Scripts ne garantit pas qu’un script fonctionnera dans toutes les situations.
Un script peut échouer si :
- les écrans LCD sont mal nommés ;
- le contenu est collé au mauvais endroit ;
- un conteneur attendu n’existe pas ;
- la structure ne possède pas les blocs nécessaires ;
- le joueur utilise le script sur le mauvais univers ;
- le script est ancien ;
- les règles d’Empyrion ont changé.
La BAO centralise le script, mais le fonctionnement final dépend toujours de la configuration en jeu.
Problèmes fréquents
La liste des scripts ne se charge pas
Vérifiez que vous êtes connecté à la BAO Windows.
Si la session a expiré, retournez sur la page Connexion à la BAO Windows et reconnectez-vous.
Vous pouvez ensuite revenir sur la page Scripts et cliquer sur Actualiser.
Je ne trouve pas un script
Vérifiez les filtres actifs.
Un filtre par univers, par catégorie ou la case Mes scripts uniquement peut masquer certains scripts.
Cliquez sur Réinitialiser pour revenir à une liste plus large.
Je ne peux pas modifier un script
La modification dépend des droits associés au script.
Vous pouvez probablement consulter le script et copier son contenu, mais pas le modifier.
Si une correction est nécessaire, contactez le créateur du script ou le staff.
Le bouton Modifier est désactivé
Le bouton Modifier est désactivé lorsque la BAO considère que vous n’avez pas les droits d’édition.
Le script reste consultable en lecture seule.
Vous pouvez toujours copier son contenu si le script est visible.
Le contenu copié est vide
Le bouton Copier le script copie uniquement la zone Contenu du script.
Si cette zone est vide, rien d’utile ne peut être copié.
Il faut alors compléter le script ou prévenir son créateur.
Le script ne fonctionne pas en jeu
Vérifiez d’abord les instructions.
Contrôlez ensuite :
- le nom exact des écrans LCD ;
- le préfixe Script: ;
- le nom de l’écran d’affichage ;
- les conteneurs attendus ;
- les blocs nécessaires ;
- l’univers concerné ;
- les éventuelles conditions particulières.
Une faute dans un nom peut suffire à empêcher le fonctionnement.
Je ne peux pas choisir l’univers en modification
L’univers est choisi à la création du script.
Il n’est pas modifiable ensuite depuis l’écran d’édition.
Si un script a été créé dans le mauvais univers, il peut être nécessaire de le recréer dans le bon univers.
Ce que cette page permet
La page Scripts permet de centraliser des contenus utiles pour Empyrion.
Elle permet aussi :
- de partager des automatisations ;
- de documenter les usages ;
- d’améliorer l’expérience de jeu ;
- de diffuser des scripts fiables ;
- de rendre les scripts plus accessibles aux joueurs ;
- de conserver une bibliothèque commune côté serveur.
Ce que cette page ne permet pas
La page Scripts ne remplace pas les mécaniques du jeu.
Elle ne permet pas :
- d’exécuter automatiquement un script sur le PC ;
- d’installer automatiquement les écrans LCD ;
- de corriger une mauvaise configuration en jeu ;
- de garantir qu’un script ancien fonctionne toujours ;
- de contourner les règles d’Empyrion ;
- de modifier un script sans les droits nécessaires.
Le script dépend toujours de son installation correcte dans Empyrion.