« Scripts BAO Windows » : différence entre les versions

De Boite A Outils
Aller à la navigation Aller à la recherche
Page créée avec « 🛠️ '''BAO WINDOWS''' — Scripts = Scripts communautaires BAO Windows = La page '''Scripts''' permet de consulter, créer, modifier et partager des scripts utiles à la communauté OA. Un script peut contenir du texte exécutable, une commande, une procédure technique, une suite d’instructions ou tout autre contenu destiné à aider les joueurs et le staff. Le module sert notamment à : * centraliser les s... »
 
 
(2 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
🛠️ '''[[Boîte à Outils — Application Windows|BAO WINDOWS]]''' — Scripts
🛠️ '''[[Boîte à Outils — Application Windows|BAO WINDOWS]]''' — Scripts


= Scripts communautaires BAO Windows =
= Scripts communautaires =


La page '''Scripts''' permet de consulter, créer, modifier et partager des scripts utiles à la communauté OA.
La page '''Scripts''' est la bibliothèque communautaire de scripts Empyrion de la BAO Windows. Elle permet de '''consulter, copier, créer, modifier et partager''' des scripts (le plus souvent destinés aux écrans LCD : affichage de ressources, tri d’inventaire, suivi de base, etc.).


Un script peut contenir du texte exécutable, une commande, une procédure technique, une suite d’instructions ou tout autre contenu destiné à aider les joueurs et le staff.
Les scripts sont stockés '''côté serveur BAO''', pas seulement sur le PC du joueur. La BAO centralise, documente et copie le script : elle ne l’exécute pas et ne configure rien dans Empyrion à votre place.


Le module sert notamment à :
== Accéder à la page ==


* centraliser les scripts utiles à la communauté ;
Dans le menu latéral : '''Communauté''' → '''Scripts'''.
* partager des scripts par univers ;
* classer les scripts par catégorie ;
* distinguer les scripts privés, de faction ou communautaires ;
* consulter un script en lecture seule ;
* copier rapidement le contenu d’un script ;
* modifier un script lorsque l’utilisateur dispose des droits nécessaires.


== Accéder à la page Scripts ==
La connexion BAO est requise (SteamID + jeton de session). Si la session est absente ou expirée, un message « Connexion BAO introuvable » s’affiche : reconnectez-vous via la page [[Connexion à la BAO Windows]].
 
Dans le menu latéral de la BAO Windows, cliquez sur :
 
* '''Communauté'''
** '''Scripts'''
 
La page affiche la bibliothèque des scripts disponibles pour l’utilisateur connecté.


<br clear="all"/>
<br clear="all"/>
[[Fichier:BAO Windows - Scripts liste.png|vignette|centre|1000px|Bibliothèque des scripts communautaires dans la BAO Windows.]]
[[Fichier:BAO Windows - Scripts liste.png|vignette|centre|1000px|Bibliothèque des scripts communautaires.]]
<br clear="all"/>
<br clear="all"/>


== Pré-requis ==
== Vue d’ensemble ==


Pour utiliser la page Scripts, il faut être connecté à la BAO Windows.
La fonctionnalité repose sur deux écrans :


La connexion permet d’identifier :
* la '''liste''' des scripts (filtres + tableau) ;
* la '''fiche''' d’un script, qui sert à la fois à la consultation, à la création et à la modification.


* le joueur ;
Les droits de modification sont calculés par la BAO pour chaque script : un script est soit '''Modifiable''', soit en '''Lecture seule'''. Un script en lecture seule reste consultable et copiable.
* son SteamID ;
* son jeton BAO ;
* ses droits d’accès ;
* ses droits éventuels de modification.


Si la connexion BAO est absente ou expirée, la page ne peut pas charger correctement les scripts.
== La liste des scripts ==


== Principe général ==
=== Filtres ===


La page Scripts fonctionne comme une bibliothèque communautaire.
Les filtres sont cumulables et le bouton '''Réinitialiser''' les remet tous à zéro.


Chaque script possède :
{| class="wikitable"
! Filtre !! Effet
|-
| '''Univers''' || Limite l’affichage à un univers. « Tous » par défaut.
|-
| '''Catégorie''' || Filtre par type d’usage. « Toutes » par défaut.
|-
| '''Recherche''' || Recherche dans le '''titre''' et le '''créateur'''.
|-
| '''Mes scripts uniquement''' || N’affiche que vos propres scripts.
|}


* un titre ;
=== Colonnes du tableau ===
* un contenu ;
* des instructions complémentaires ;
* une catégorie ;
* un statut de partage ;
* un univers associé ;
* un créateur ;
* une date de création ;
* une date de modification.


Le contenu du script peut être copié rapidement pour être utilisé ailleurs.
{| class="wikitable"
! Colonne !! Description
|-
| '''Catégorie''' || Type d’usage du script.
|-
| '''Titre''' || Nom du script. La mention '''Modifiable''' / '''Lecture seule''' apparaît juste en dessous.
|-
| '''Partage''' || Privé, Faction ou Communautaire.
|-
| '''Univers''' || Univers auquel le script est rattaché.
|-
| '''Créateur''' || Joueur à l’origine du script.
|-
| '''Créé le''' / '''Modifié le''' || Dates de création et de dernière modification.
|-
| '''Actions''' || Boutons '''Ouvrir''' et '''Modifier'''.
|}


== Ce qu’est un script BAO ==
=== Actions ===


Un script BAO est une fiche partagée contenant un contenu réutilisable.
* '''Ouvrir''' : affiche la fiche en consultation.
* '''Modifier''' : ouvre la fiche directement en édition. Le bouton est '''désactivé''' si vous n’avez pas les droits (une infobulle indique la raison).
* '''Double-clic''' sur une ligne : ouvre la fiche en consultation.
* '''Nouveau script''' / '''Créer un script''' : ouvre une fiche vierge en création.
* '''Actualiser''' : recharge la liste depuis le serveur.


Cela peut être :
== Consulter un script ==
 
* une commande ;
* une procédure ;
* une aide de jeu ;
* une suite d’actions ;
* une note technique ;
* un modèle de texte ;
* un contenu personnalisé utile aux joueurs ou au staff.
 
Le module ne lance pas automatiquement le script. Il sert d’abord à stocker, documenter, retrouver et copier du contenu fiable.
 
== Ce que la page Scripts n’est pas ==
 
La page Scripts n’est pas un terminal d’exécution automatique.
 
Elle ne sert pas à :
 
* exécuter directement du code sur le PC ;
* modifier automatiquement les fichiers du jeu ;
* lancer des scripts système ;
* contourner les règles de sécurité Windows ;
* remplacer une validation staff lorsque celle-ci est nécessaire.
 
Le joueur reste responsable de l’usage du contenu copié.
 
== Vue générale ==
 
La page principale est composée de deux grandes zones :
 
* une zone de filtres ;
* une liste des scripts.
 
La zone de filtres permet de réduire la liste affichée.
 
La liste permet d’ouvrir un script en consultation ou en modification selon les droits disponibles.
 
== Chargement des scripts ==
 
Au chargement de la page, la BAO Windows récupère les scripts depuis les services BAO.
 
Elle récupère aussi la liste des univers actifs.
 
Pour chaque script, l’application vérifie ensuite si l’utilisateur connecté peut le modifier.
 
Lorsque le chargement est terminé, un message indique le nombre de scripts chargés.
 
== Filtres disponibles ==
 
La page propose plusieurs filtres.
 
Filtres disponibles :
 
* '''Univers''' ;
* '''Catégorie''' ;
* '''Recherche''' ;
* '''Mes scripts uniquement'''.
 
Ces filtres sont cumulables.
 
Ils permettent de retrouver rapidement un script précis dans la bibliothèque.
 
== Filtre Univers ==
 
Le filtre '''Univers''' permet d’afficher uniquement les scripts liés à un univers précis.
 
Exemples :
 
* Univ1 ;
* Univ2 - Sans CPU ;
* tout autre univers actif disponible dans la BAO.
 
L’option '''Tous''' affiche les scripts de tous les univers accessibles.
 
== Filtre Catégorie ==


Le filtre '''Catégorie''' permet de limiter l’affichage à un type de script.
La fiche affiche le titre, le partage, la catégorie, l’univers, les instructions, le contenu, et un panneau '''Informations''' (créateur, univers, partage, catégorie, dates).
 
Catégories disponibles :
 
* '''Tri / Inventaire''' ;
* '''Maintenance''' ;
* '''Gestion Ressources''' ;
* '''Agriculture / Jardinage''' ;
* '''Information''' ;
* '''Affichage / UI''' ;
* '''Personnalisé'''.
 
L’option '''Toutes''' affiche toutes les catégories.
 
== Recherche ==
 
Le champ '''Recherche''' permet de filtrer les scripts par texte.
 
La recherche porte notamment sur :
 
* le titre du script ;
* le créateur du script.
 
Elle sert à retrouver rapidement un script lorsque son nom ou son auteur est connu.
 
== Mes scripts uniquement ==
 
La case '''Mes scripts uniquement''' limite la liste aux scripts créés par le joueur connecté.
 
Ce filtre est utile pour retrouver rapidement ses propres scripts.
 
Il permet aussi de préparer une modification sans parcourir toute la bibliothèque communautaire.
 
== Réinitialiser les filtres ==
 
Le bouton '''Réinitialiser''' remet les filtres à leur état par défaut.
 
Après réinitialisation :
 
* l’univers revient sur '''Tous''' ;
* la catégorie revient sur '''Toutes''' ;
* la recherche est vidée ;
* le filtre '''Mes scripts uniquement''' est désactivé.
 
La liste est ensuite recalculée automatiquement.
 
== Liste des scripts ==
 
La liste centrale affiche les scripts accessibles à l’utilisateur.
 
Chaque ligne présente :
 
* la catégorie ;
* le titre ;
* le niveau de partage ;
* l’univers ;
* le créateur ;
* la date de création ;
* la date de modification ;
* les actions disponibles.
 
Un double-clic sur une ligne ouvre le script en consultation.
 
== État modifiable ou lecture seule ==
 
Chaque script indique si l’utilisateur peut le modifier.
 
Deux états peuvent apparaître :
 
* '''Modifiable''' ;
* '''Lecture seule'''.
 
Un script en lecture seule peut être consulté et copié.
 
Un script modifiable peut être ouvert en édition si l’utilisateur possède les droits nécessaires.
 
== Actions depuis la liste ==
 
Deux actions principales sont disponibles depuis la liste.
 
Le bouton '''Ouvrir''' permet de consulter le script.
 
Le bouton '''Modifier''' permet d’ouvrir directement le script en édition, uniquement si l’utilisateur dispose des droits nécessaires.
 
Si le bouton '''Modifier''' est désactivé, le script reste consultable en lecture seule.
 
== Créer un nouveau script ==
 
Le bouton '''Nouveau script''' ou '''Créer un script''' permet d’ajouter un script à la bibliothèque.
 
La création ouvre une page dédiée.


<br clear="all"/>
<br clear="all"/>
[[Fichier:BAO Windows - Script creation.png|vignette|centre|1000px|Création d’un nouveau script communautaire dans la BAO Windows.]]
[[Fichier:BAO Windows - Script consultation.png|vignette|centre|1000px|Consultation d’un script.]]
<br clear="all"/>
<br clear="all"/>


Lors de la création, l’utilisateur doit renseigner les informations principales du script.
; Explication / instructions
: Texte mis en forme (gras, italique, souligné, liste à puces) expliquant '''comment utiliser le script en jeu''' : prérequis, noms d’écrans LCD, conteneurs attendus, limites connues. Sauvegardé au format RTF. C’est la partie à lire avant de copier.


== Champs de création ==
; Contenu du script
: Le code à coller en jeu, en police à chasse fixe. Le bouton '''Copier le script''' copie '''uniquement ce contenu''' dans le presse-papiers (disponible même en lecture seule).


Pour créer un script, il faut renseigner :
== Créer un script ==


* un titre ;
Bouton '''Nouveau script'''. Champs '''obligatoires''' : titre et contenu (la catégorie et le partage doivent aussi être sélectionnés). La BAO refuse l’enregistrement si le titre ou le contenu est vide.
* un statut de partage ;
* une catégorie ;
* un univers ;
* des instructions ou explications ;
* le contenu du script.
 
Le titre et le contenu du script sont obligatoires.
 
L’univers est choisi à la création.
 
== Univers du script ==
 
L’univers du script est sélectionné lors de la création.
 
Une fois le script créé, l’univers n’est plus modifiable depuis l’écran d’édition.
 
Ce choix permet d’éviter qu’un script soit déplacé par erreur vers un autre univers après sa publication.
 
== Statuts de partage ==
 
Un script peut avoir plusieurs niveaux de partage.
 
Statuts disponibles :
 
* '''Privé''' ;
* '''Faction''' ;
* '''Communautaire'''.
 
Le statut détermine qui peut voir le script dans la bibliothèque.
 
== Script privé ==
 
Un script '''Privé''' est destiné à un usage personnel.
 
Usage typique :
 
* brouillon ;
* note personnelle ;
* test ;
* script en préparation.
 
Il 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.
 
Usage typique :
 
* procédure interne de faction ;
* organisation logistique ;
* consigne de groupe ;
* modèle réservé à un ensemble de joueurs.
 
Ce statut permet de partager sans rendre le script public à toute la communauté.
 
== Script communautaire ==
 
Un script '''Communautaire''' est visible par la communauté selon les règles BAO.
 
Usage typique :
 
* aide générale ;
* commande utile ;
* procédure validée ;
* modèle partagé ;
* script intéressant pour plusieurs joueurs.
 
C’est le statut recommandé pour les contenus réellement utiles à tous.
 
== Catégories de scripts ==
 
Les catégories servent à organiser la bibliothèque.
 
Elles évitent de mélanger tous les scripts dans une seule liste.
 
Un bon choix de catégorie rend le script plus facile à retrouver par les joueurs et par le staff.
 
== Instructions du script ==
 
La zone '''Explication / instructions''' permet d’expliquer comment utiliser le script.
 
Elle peut contenir :
 
* le contexte d’utilisation ;
* les prérequis ;
* les étapes à suivre ;
* les précautions ;
* les limites connues ;
* les conseils d’usage.
 
Cette zone est prévue pour documenter le script, pas seulement pour le stocker.
 
== Mise en forme des instructions ==
 
Les instructions peuvent être mises en forme depuis la barre d’outils.
 
Options disponibles :
 
* gras ;
* italique ;
* souligné ;
* liste ;
* nettoyage de la mise en forme.
 
La mise en forme est enregistrée dans un format compatible avec l’application BAO.
 
== Contenu du script ==
 
La zone '''Contenu du script''' contient le texte principal à copier ou réutiliser.
 
Cette zone est adaptée aux contenus techniques.
 
Elle utilise une présentation de type texte brut, plus lisible pour les commandes, scripts et blocs structurés.
 
== Copier le script ==
 
Le bouton '''Copier le script''' copie le contenu du script dans le presse-papiers Windows.
 
Cette action copie uniquement le contenu principal du script.
 
Elle ne copie pas forcément les instructions, les métadonnées ou les informations de partage.
 
== Consulter un script ==
 
Le bouton '''Ouvrir''' permet d’afficher un script en lecture.


<br clear="all"/>
<br clear="all"/>
[[Fichier:BAO Windows - Script consultation.png|vignette|centre|1000px|Consultation d’un script communautaire en lecture seule.]]
[[Fichier:BAO Windows - Script creation.png|vignette|centre|1000px|Création d’un script.]]
<br clear="all"/>
<br clear="all"/>


En consultation, l’utilisateur peut lire les instructions et copier le contenu du script.
Valeurs par défaut à la création :


Les champs sont verrouillés si l’utilisateur ne possède pas les droits de modification.
* '''Partage''' : Communautaire — pensez à le repasser en '''Privé''' tant que le script est un brouillon.
* '''Catégorie''' : reprend le filtre actif, sinon Personnalisé.
* '''Univers''' : reprend l’univers du filtre, sinon le premier univers actif.
 
{{Attention|L’'''univers''' est fixé à la création et n’est '''plus modifiable''' ensuite. En cas d’erreur, il faut recréer le script dans le bon univers.}}


== Modifier un script ==
== Modifier un script ==


Le bouton '''Modifier''' permet d’éditer un script existant.
Possible uniquement si le script est '''Modifiable''' pour vous. Depuis une fiche ouverte en consultation, le bouton '''Modifier''' bascule en édition ; '''Quitter l’édition''' revient à la consultation (sans enregistrer).


<br clear="all"/>
<br clear="all"/>
[[Fichier:BAO Windows - Script edition.png|vignette|centre|1000px|Modification d’un script communautaire dans la BAO Windows.]]
[[Fichier:BAO Windows - Script edition.png|vignette|centre|1000px|Modification d’un script.]]
<br clear="all"/>
<br clear="all"/>


La modification est possible uniquement si l’utilisateur dispose des droits nécessaires.
Champs modifiables : titre, instructions, contenu, catégorie, partage. L’univers reste figé.
 
Si l’utilisateur n’a pas les droits, la page reste en lecture seule.
 
== Champs modifiables ==
 
Lorsqu’un script est modifiable, l’utilisateur peut changer :
 
* le titre ;
* le contenu ;
* les instructions ;
* la catégorie ;
* le statut de partage.
 
L’univers n’est modifiable que lors de la création.
 
== Mode lecture seule ==
 
Le mode lecture seule protège les scripts contre les modifications non autorisées.
 
Dans ce mode :
 
* le titre n’est pas modifiable ;
* le contenu n’est pas modifiable ;
* les instructions ne sont pas modifiables ;
* les listes déroulantes sont désactivées ;
* le bouton d’enregistrement est désactivé.
 
Le bouton de copie reste disponible pour récupérer le contenu du script.
 
== Passer en mode édition ==
 
Si l’utilisateur possède les droits nécessaires, un bouton '''Modifier''' peut être affiché depuis la fiche du script.
 
Ce bouton active le mode édition.
 
Une fois les modifications terminées, l’utilisateur peut enregistrer ou quitter l’édition.
 
== Quitter l’édition ==
 
Le bouton '''Quitter l’édition''' permet de revenir à une consultation du script sans rester en mode modification.
 
Cette action est utile si l’utilisateur voulait seulement vérifier un contenu sans forcément le modifier.
 
== Enregistrer un script ==
 
Le bouton '''Enregistrer''' sauvegarde la création ou la modification du script.
 
Avant l’enregistrement, la BAO vérifie que :
 
* le titre est renseigné ;
* le contenu du script est renseigné ;
* une catégorie est sélectionnée ;
* un statut de partage est sélectionné.
 
Si un champ obligatoire manque, un message indique ce qui doit être corrigé.
 
== Informations du script ==
 
Le panneau '''Informations''' résume les métadonnées du script.


Il affiche notamment :
Autres boutons :


* le créateur ;
* '''Enregistrer''' : sauvegarde la création ou la modification (« Script mis à jour » en cas de succès).
* l’univers ;
* '''Recharger''' : récupère à nouveau le script depuis le serveur (utile si quelqu’un d’autre l’a modifié, ou pour annuler des changements non enregistrés). Masqué en création.
* le statut de partage ;
* la catégorie ;
* la date de création ;
* la date de modification.
 
Ce panneau permet de comprendre rapidement l’origine et le contexte du script.
 
== Recharger un script ==
 
Le bouton '''Recharger''' recharge les données du script depuis les services BAO.
 
Cette action est utile si :
 
* une modification vient d’être faite ;
* l’affichage semble ancien ;
* les droits ont changé ;
* une autre personne a modifié le script.
 
Le bouton n’est pas affiché lors de la création d’un nouveau script.


== Supprimer un script ==
== Supprimer un script ==


La suppression est disponible dans la zone dangereuse.
La '''Zone dangereuse''' n’apparaît que si vous pouvez modifier le script. Le bouton '''Supprimer le script''' demande une confirmation, puis retire le script de la bibliothèque. À utiliser avec prudence sur un script partagé en faction ou en communautaire.


Elle est affichée uniquement si l’utilisateur peut modifier le script.
== Statuts de partage ==


Avant suppression, une confirmation est demandée.
{| class="wikitable"
! Statut !! Visibilité !! Usage type
|-
| '''Privé''' || Vous seul || Brouillon, test, script personnel.
|-
| '''Faction''' || Membres de votre faction || Procédure ou affichage interne au groupe.
|-
| '''Communautaire''' || Tous les joueurs ayant accès à la bibliothèque || Script validé, réutilisable, bien documenté.
|}


La suppression retire le script de la bibliothèque visible.
== Catégories ==


== Droits de modification ==
Tri / Inventaire · Maintenance · Gestion Ressources · Agriculture / Jardinage · Information · Affichage / UI · Personnalisé.


Les droits de modification sont vérifiés pour chaque script.
Choisissez la catégorie la plus proche de l’usage réel plutôt que de tout placer en Personnalisé : cela aide la recherche et la documentation ORIA.


La BAO demande au serveur si l’utilisateur connecté peut modifier le script.
== Utiliser un script en jeu (LCD) ==


Si la modification est refusée, la raison peut être affichée dans l’interface.
La plupart des scripts reposent sur deux écrans LCD liés par leur nom :


Cela évite de laisser croire qu’un bouton est bloqué sans explication.
* écran 1, qui contient le script : '''Script:NomDuScript''' ;
* écran 2, qui affiche le résultat : '''NomDuScript'''.


== Messages et erreurs ==
Les noms doivent correspondre '''exactement''' (espaces, majuscules, accents compris). Un script techniquement correct n’affichera rien si un écran est mal nommé ou si un conteneur attendu n’existe pas — d’où l’importance des instructions de la fiche.
 
La page utilise des messages d’information pour indiquer l’état des actions.
 
Exemples :
 
* scripts chargés ;
* script mis à jour ;
* contenu copié ;
* erreur de chargement ;
* erreur d’enregistrement ;
* erreur de suppression.
 
Ces messages permettent de savoir rapidement si l’action a réussi.
 
== Bonnes pratiques ==
 
Pour publier un script utile :
 
* donnez un titre clair ;
* choisissez la bonne catégorie ;
* choisissez le bon univers ;
* expliquez le contexte dans les instructions ;
* mettez le contenu copiable dans la zone script ;
* évitez les scripts incomplets en partage communautaire ;
* gardez les scripts privés pour les brouillons ;
* indiquez les précautions si le script peut être mal utilisé.
 
== Bonnes pratiques pour le RAG ORIA ==
 
Pour aider ORIA à retrouver correctement les scripts dans la documentation :
 
* utilisez des titres explicites ;
* évitez les pages trop vagues ;
* décrivez clairement les actions des boutons ;
* séparez les usages joueur et staff ;
* indiquez les limites de chaque fonction ;
* gardez les sections courtes et autonomes.
 
Une section courte permet à ORIA de récupérer un morceau de documentation exploitable sans perdre le contexte.


== Problèmes fréquents ==
== Problèmes fréquents ==


=== La liste des scripts ne se charge pas ===
; La liste ne se charge pas
 
: Vérifiez votre connexion BAO ; reconnectez-vous si la session a expiré, puis cliquez sur '''Actualiser'''.
Vérifiez que vous êtes connecté à la BAO Windows.
 
Si la session a expiré, reconnectez-vous depuis la page '''Connexion'''.
 
=== 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.
 
Utilisez '''Réinitialiser''' pour revenir à la liste complète.
 
=== Je ne peux pas modifier un script ===
 
La modification dépend des droits associés au script.
 
Vous pouvez probablement consulter le script, mais pas le modifier.
 
Si la modification est nécessaire, contactez le créateur 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 accessible en consultation.
 
Vous pouvez toujours copier son contenu si celui-ci est visible.
 
=== Le contenu copié est vide ===
 
Le bouton '''Copier le script''' copie la zone '''Contenu du script'''.
 
Si cette zone est vide, rien d’utile ne peut être copié.


Il faut alors compléter le contenu ou prévenir le créateur du script.
; Je ne retrouve pas un script
: Un filtre (univers, catégorie ou « Mes scripts uniquement ») le masque probablement. Cliquez sur '''Réinitialiser'''.


=== Je ne peux pas choisir l’univers en modification ===
; Le bouton Modifier est désactivé
: Vous n’avez pas les droits d’édition sur ce script. Il reste consultable et copiable. Contactez le créateur ou le staff.


L’univers est choisi à la création du script.
; Le contenu copié est vide
: « Copier le script » ne copie que la zone '''Contenu du script'''. Si elle est vide, il n’y a rien à coller.


Il n’est pas modifiable ensuite depuis l’écran d’édition.
; Le script ne fonctionne pas en jeu
: Vérifiez le nom exact des écrans LCD (préfixe '''Script:'''), les conteneurs et blocs attendus, l’univers concerné, puis relisez les instructions de la fiche.


Si un script a été créé dans le mauvais univers, il peut être nécessaire de le recréer correctement.
; Je ne peux pas changer l’univers en modification
: L’univers est fixé à la création. Recréez le script dans le bon univers si nécessaire.


== Voir aussi ==
== Voir aussi ==
Ligne 586 : Ligne 172 :
* [[Boîte à Outils — Application Windows]]
* [[Boîte à Outils — Application Windows]]
* [[Connexion à la BAO Windows]]
* [[Connexion à la BAO Windows]]
* [[Workshop OA BAO Windows]]
* [[Paramètres de la BAO Windows]]
* [[Paramètres de la BAO Windows]]
* [[Workshop OA — BAO Windows]]


[[Boîte à Outils — Application Windows|← Retour à la documentation BAO Windows]]
[[Boîte à Outils — Application Windows|← Retour à la documentation BAO Windows]]

Dernière version du 26 mai 2026 à 12:02

🛠️ BAO WINDOWS — Scripts

Scripts communautaires

La page Scripts est la bibliothèque communautaire de scripts Empyrion de la BAO Windows. Elle permet de consulter, copier, créer, modifier et partager des scripts (le plus souvent destinés aux écrans LCD : affichage de ressources, tri d’inventaire, suivi de base, etc.).

Les scripts sont stockés côté serveur BAO, pas seulement sur le PC du joueur. La BAO centralise, documente et copie le script : elle ne l’exécute pas et ne configure rien dans Empyrion à votre place.

Accéder à la page

Dans le menu latéral : CommunautéScripts.

La connexion BAO est requise (SteamID + jeton de session). Si la session est absente ou expirée, un message « Connexion BAO introuvable » s’affiche : reconnectez-vous via la page Connexion à la BAO Windows.


Bibliothèque des scripts communautaires.


Vue d’ensemble

La fonctionnalité repose sur deux écrans :

  • la liste des scripts (filtres + tableau) ;
  • la fiche d’un script, qui sert à la fois à la consultation, à la création et à la modification.

Les droits de modification sont calculés par la BAO pour chaque script : un script est soit Modifiable, soit en Lecture seule. Un script en lecture seule reste consultable et copiable.

La liste des scripts

Filtres

Les filtres sont cumulables et le bouton Réinitialiser les remet tous à zéro.

Filtre Effet
Univers Limite l’affichage à un univers. « Tous » par défaut.
Catégorie Filtre par type d’usage. « Toutes » par défaut.
Recherche Recherche dans le titre et le créateur.
Mes scripts uniquement N’affiche que vos propres scripts.

Colonnes du tableau

Colonne Description
Catégorie Type d’usage du script.
Titre Nom du script. La mention Modifiable / Lecture seule apparaît juste en dessous.
Partage Privé, Faction ou Communautaire.
Univers Univers auquel le script est rattaché.
Créateur Joueur à l’origine du script.
Créé le / Modifié le Dates de création et de dernière modification.
Actions Boutons Ouvrir et Modifier.

Actions

  • Ouvrir : affiche la fiche en consultation.
  • Modifier : ouvre la fiche directement en édition. Le bouton est désactivé si vous n’avez pas les droits (une infobulle indique la raison).
  • Double-clic sur une ligne : ouvre la fiche en consultation.
  • Nouveau script / Créer un script : ouvre une fiche vierge en création.
  • Actualiser : recharge la liste depuis le serveur.

Consulter un script

La fiche affiche le titre, le partage, la catégorie, l’univers, les instructions, le contenu, et un panneau Informations (créateur, univers, partage, catégorie, dates).


Consultation d’un script.


Explication / instructions
Texte mis en forme (gras, italique, souligné, liste à puces) expliquant comment utiliser le script en jeu : prérequis, noms d’écrans LCD, conteneurs attendus, limites connues. Sauvegardé au format RTF. C’est la partie à lire avant de copier.
Contenu du script
Le code à coller en jeu, en police à chasse fixe. Le bouton Copier le script copie uniquement ce contenu dans le presse-papiers (disponible même en lecture seule).

Créer un script

Bouton Nouveau script. Champs obligatoires : titre et contenu (la catégorie et le partage doivent aussi être sélectionnés). La BAO refuse l’enregistrement si le titre ou le contenu est vide.


Création d’un script.


Valeurs par défaut à la création :

  • Partage : Communautaire — pensez à le repasser en Privé tant que le script est un brouillon.
  • Catégorie : reprend le filtre actif, sinon Personnalisé.
  • Univers : reprend l’univers du filtre, sinon le premier univers actif.

Modèle:Attention

Modifier un script

Possible uniquement si le script est Modifiable pour vous. Depuis une fiche ouverte en consultation, le bouton Modifier bascule en édition ; Quitter l’édition revient à la consultation (sans enregistrer).


Modification d’un script.


Champs modifiables : titre, instructions, contenu, catégorie, partage. L’univers reste figé.

Autres boutons :

  • Enregistrer : sauvegarde la création ou la modification (« Script mis à jour » en cas de succès).
  • Recharger : récupère à nouveau le script depuis le serveur (utile si quelqu’un d’autre l’a modifié, ou pour annuler des changements non enregistrés). Masqué en création.

Supprimer un script

La Zone dangereuse n’apparaît que si vous pouvez modifier le script. Le bouton Supprimer le script demande une confirmation, puis retire le script de la bibliothèque. À utiliser avec prudence sur un script partagé en faction ou en communautaire.

Statuts de partage

Statut Visibilité Usage type
Privé Vous seul Brouillon, test, script personnel.
Faction Membres de votre faction Procédure ou affichage interne au groupe.
Communautaire Tous les joueurs ayant accès à la bibliothèque Script validé, réutilisable, bien documenté.

Catégories

Tri / Inventaire · Maintenance · Gestion Ressources · Agriculture / Jardinage · Information · Affichage / UI · Personnalisé.

Choisissez la catégorie la plus proche de l’usage réel plutôt que de tout placer en Personnalisé : cela aide la recherche et la documentation ORIA.

Utiliser un script en jeu (LCD)

La plupart des scripts reposent sur deux écrans LCD liés par leur nom :

  • écran 1, qui contient le script : Script:NomDuScript ;
  • écran 2, qui affiche le résultat : NomDuScript.

Les noms doivent correspondre exactement (espaces, majuscules, accents compris). Un script techniquement correct n’affichera rien si un écran est mal nommé ou si un conteneur attendu n’existe pas — d’où l’importance des instructions de la fiche.

Problèmes fréquents

La liste ne se charge pas
Vérifiez votre connexion BAO ; reconnectez-vous si la session a expiré, puis cliquez sur Actualiser.
Je ne retrouve pas un script
Un filtre (univers, catégorie ou « Mes scripts uniquement ») le masque probablement. Cliquez sur Réinitialiser.
Le bouton Modifier est désactivé
Vous n’avez pas les droits d’édition sur ce script. Il reste consultable et copiable. Contactez le créateur ou le staff.
Le contenu copié est vide
« Copier le script » ne copie que la zone Contenu du script. Si elle est vide, il n’y a rien à coller.
Le script ne fonctionne pas en jeu
Vérifiez le nom exact des écrans LCD (préfixe Script:), les conteneurs et blocs attendus, l’univers concerné, puis relisez les instructions de la fiche.
Je ne peux pas changer l’univers en modification
L’univers est fixé à la création. Recréez le script dans le bon univers si nécessaire.

Voir aussi

← Retour à la documentation BAO Windows