Scripts BAO Windows
🛠️ 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 scripts utiles à la communauté ;
- 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
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é.
Pré-requis
Pour utiliser la page Scripts, il faut être connecté à la BAO Windows.
La connexion permet d’identifier :
- le joueur ;
- 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.
Principe général
La page Scripts fonctionne comme une bibliothèque communautaire.
Chaque script possède :
- un titre ;
- 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.
Ce qu’est un script BAO
Un script BAO est une fiche partagée contenant un contenu réutilisable.
Cela peut être :
- 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.
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.
Lors de la création, l’utilisateur doit renseigner les informations principales du script.
Champs de création
Pour créer un script, il faut renseigner :
- un titre ;
- 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.
En consultation, l’utilisateur peut lire les instructions et copier le contenu du script.
Les champs sont verrouillés si l’utilisateur ne possède pas les droits de modification.
Modifier un script
Le bouton Modifier permet d’éditer un script existant.
La modification est possible uniquement si l’utilisateur dispose des droits nécessaires.
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 :
- 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 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
La suppression est disponible dans la zone dangereuse.
Elle est affichée uniquement si l’utilisateur peut modifier le script.
Avant suppression, une confirmation est demandée.
La suppression retire le script de la bibliothèque visible.
Droits de modification
Les droits de modification sont vérifiés pour chaque script.
La BAO demande au serveur si l’utilisateur connecté peut modifier le script.
Si la modification est refusée, la raison peut être affichée dans l’interface.
Cela évite de laisser croire qu’un bouton est bloqué sans explication.
Messages et erreurs
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
La liste des scripts ne se charge pas
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 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 correctement.