« Ressources » : différence entre les versions

De Boite A Outils
Aller à la navigation Aller à la recherche
Aucun résumé des modifications
Ligne 1 : Ligne 1 :
= Ressources =
= Module Ressources =


== Concept ==
Le module '''Ressources''' permet à une faction de '''cartographier collectivement''' tout ce qu'elle découvre dans l'univers : gisements de minerais, vendeurs dans des POI, épaves, bases stratégiques, points d'intérêt.


Le module '''Ressources''' permet à une faction de cartographier collectivement tout ce qu'elle découvre dans l'univers : gisements de minerais, vendeurs dans des POI, épaves, bases stratégiques, points d'intérêt. Chaque membre peut consulter et enrichir la carte commune en temps réel.
Chaque membre peut '''consulter et enrichir la carte commune en temps réel'''.


Le module repose sur deux notions distinctes qu'il est important de comprendre avant de commencer :
== Concepts clés ==


* '''La ressource''' (ce qu'on trouve) : un élément que la faction a nommé et enregistré dans son référentiel. Exemples : Cuivre, Prométhium, Filtres, Kit de tourelle avancée. Cette liste est entièrement gérée par la faction.
Avant de commencer, comprendre deux notions distinctes :
* '''L'emplacement''' (où on l'a trouvé) : une occurrence concrète dans l'univers, avec le système, le playfield, le secteur ou nom de POI, la quantité et les informations terrain associées.


=== Exemples concrets ===
* '''[[Ressources/Concept|La ressource]]''' — Ce qu'on trouve (Cuivre, Prométhium, Filtres, Kit de tourelle)
* '''[[Ressources/Concept|L'emplacement]]''' — Où on l'a trouvé (système, playfield, secteur, quantité)


{| class="wikitable"
'''Exemple :''' Une ressource s'appelle "Cuivre". Un emplacement serait : "Cuivre trouvé sur planète Akua, système Alpha, Plaines du Nord".
|-
! Situation || Ressource || Système || Playfield || Secteur / POI
|-
| Gisement de cuivre sur une planète || Cuivre || Alpha || Akua || Plaines du Nord
|-
| Champ d'astéroïdes riche en prométhium || Prométhium || Beta || Beta Sector || –
|-
| Vendeur de kits de tourelle dans un POI || Kit de tourelle avancée || Beta || Beta Sector || Power Plant
|-
| Vendeur de filtres dans un POI || Filtres || Gamma || Omicron || Trading Post 7
|}


=== Workflow général ===
== Accès au module ==


Avant d'enregistrer un emplacement, la ressource concernée doit exister dans le référentiel de la faction. Si un joueur découvre un vendeur qui propose des '''Filtres''' et que Filtres n'est pas encore dans la liste de la faction, il faut d'abord l'y ajouter, puis saisir l'emplacement. Le bouton '''Type de ressources faction''' accessible depuis l'écran des emplacements ouvre directement ce référentiel sans quitter l'écran.
Le module est accessible depuis le menu '''Ressources''' de la barre de navigation principale.


== Accès ==
Les entrées disponibles :
* '''Ressources''' — Liste des emplacements découverts
* '''Type de ressources de faction''' — Référentiel des ressources nommées
* '''Nuancier''' — Palette de couleurs d'identification
* '''Bloc-notes''' — Notes internes
* '''Navigation''' — Outils de déplacement


Le module est accessible depuis le menu '''Ressources''' situé dans la barre de navigation principale.
== Sommaire ==


<br clear="all"/>
* '''[[Ressources/Acces|Accès au module]]''' — Localisation et menu
[[Fichier:Menu ressources.png|cadre|centre|Accès au module Ressources]]
* '''[[Ressources/Concept|Concept : Ressource vs Emplacement]]''' — Comprendre la structure
<br clear="all"/>
* '''[[Ressources/Gestion|Gestion du référentiel]]''' — Liste des ressources de la faction
* '''[[Ressources/Tableau|Tableau des emplacements]]''' — L'écran principal
* '''[[Ressources/Filtres|Filtres et distances]]''' — Rechercher intelligemment
* '''[[Ressources/Ajouter|Ajouter un emplacement (gisement)]]''' — Workflow minerais
* '''[[Ressources/Ajouter_vendeur|Ajouter un vendeur (POI)]]''' — Workflow vendeurs
* '''[[Ressources/Recolte|Gestion de récolte]]''' — Suivi de farming
* '''[[Ressources/Notes|Notes techniques]]''' — Comportement et connexion


Le menu propose plusieurs entrées : '''Ressources''' (emplacements), '''Type de ressources de faction''', '''Nuancier''', '''Bloc-notes''' et '''Navigation'''.
== Points importants ==


== Liste des ressources de la faction ==
✅ '''Deux concepts distincts''' — Ressource (quoi) vs Emplacement (où)


=== Présentation ===
⚠️ '''Sans enregistrement, les modifications du tableau ne sont pas sauvegardées'''


La liste des ressources est le référentiel nominatif de la faction : elle définit quelles ressources existent pour la faction, avec leur nom et leur couleur d'identification. C'est la liste dans laquelle les joueurs piochent lorsqu'ils enregistrent un emplacement. Elle est entièrement gérée par la faction et peut être enrichie à tout moment.
'''Ajouts/suppressions immédiatement persistés''' — Modifications du tableau nécessitent un clic "Enregistrer"


Une liste de ressources par défaut est générée automatiquement à la création de la faction (minerais courants d'Empyrion, ressources de commerce, matériaux spéciaux). Les factions peuvent compléter cette liste avec des ressources spécifiques à leur façon de jouer : un vendeur rare, un type de coffre particulier, un POI stratégique récurrent.
📍 '''Connexion BAO obligatoire''' — Ce module nécessite une connexion au serveur


<br clear="all"/>
== Voir aussi ==
[[Fichier:Ecran liste des ressources.png|cadre|centre|Liste des ressources de la faction]]
<br clear="all"/>


=== Colonnes du tableau ===
* [[Boîte à Outils]] — Interface principale
 
* [[Factions]] — Gestion des factions
* '''Nom''' : nom fonctionnel de la ressource tel qu'il apparaîtra dans les listes déroulantes des autres écrans. Utiliser des noms courts et sans ambiguïté (exemples : Cuivre, Filtres, Kit de tourelle avancée).
* '''Couleur''' : couleur d'identification visuelle. Elle est appliquée comme fond de ligne dans l'écran des emplacements pour identifier les ressources d'un coup d'œil. La liste des couleurs disponibles et leur rendu sont consultables depuis le '''Nuancier''' (menu Ressources).
 
=== Actions ===
 
* '''Ajouter''' : crée une nouvelle ligne dans le tableau avec le nom par défaut « Nouvelle ressource ». La ligne est immédiatement éditable dans la grille.
* '''Modifier''' : l'édition se fait directement dans le tableau, cellule par cellule, sans bouton dédié.
* '''Supprimer''' : supprime la ou les lignes sélectionnées. La suppression est définitive une fois enregistrée.
* '''Enregistrer''' : envoie toutes les modifications au serveur en une seule opération par lot. '''Sans clic sur Enregistrer, aucune modification n'est persistée''' : fermer la fenêtre avant d'enregistrer perd les changements.
 
=== Bonnes pratiques ===
 
Utiliser des noms courts et sans ambiguïté pour faciliter la sélection dans les listes déroulantes. Éviter les doublons : deux ressources portant un nom similaire créent de la confusion dans les emplacements. Choisir des couleurs cohérentes pour faciliter la lecture visuelle du tableau des emplacements — par exemple, tons métalliques pour les minerais, tons verts pour les ressources organiques, tons chauds pour les ressources de commerce.
 
== Emplacement des ressources ==
 
=== Présentation ===
 
L'écran des emplacements est l'outil principal de cartographie de la faction. Chaque ligne représente une ressource découverte à un endroit précis de l'univers. Cet écran permet d'ajouter de nouveaux emplacements, de modifier les informations existantes, de suivre l'état de récolte session après session, et de calculer les distances entre systèmes pour optimiser les trajets de farming.
 
<br clear="all"/>
[[Fichier:Ecran emplacement des ressources.png|cadre|centre|Emplacements des ressources]]
<br clear="all"/>
 
=== Structure de l'écran ===
 
L'écran est organisé en trois zones. En haut se trouve la barre de '''Filtres'''. À droite se trouve la zone '''Actions''', qui contient le formulaire d'ajout et les boutons de gestion. Au centre occupe le '''Tableau des emplacements'''.
 
=== Zone Filtres ===
 
Quatre critères de filtrage sont applicables simultanément :
 
* '''Territoire''' : filtre sur le territoire de rattachement (Neutre, Hostile, Allié, etc.).
* '''Ressource''' : filtre sur la ressource (Fer, Cuivre, Filtres...).
* '''Type de ressource''' : filtre sur la catégorie définie côté serveur (Astéroïde, Planète, Commerce...).
* '''Système (Distance)''' : sélection d'un système de référence pour afficher les distances et filtrer par proximité.
 
Le bouton '''Filtrer''' applique les critères. Le bouton '''Réinitialiser''' remet tous les filtres à « Tout ». Le filtrage s'effectue côté client, sans requête serveur.
 
=== Zone Distance ===
 
Dès qu'un système de référence est sélectionné dans cette zone, une colonne '''Distance (AL)''' apparaît dans le tableau et affiche la distance en années-lumière entre chaque emplacement et le système choisi. Les distances sont calculées à partir des coordonnées sectorielles (X, Y, Z) de chaque système. La colonne est triable. Le bouton '''Réinitialiser''' de cette zone masque la colonne et efface les distances.
 
=== Tableau des emplacements ===
 
Chaque ligne représente un emplacement de ressource enregistré par la faction. Les colonnes sont :
 
* '''Territoire''' : zone de l'univers (Neutre, Hostile, Allié...), sélectionnable parmi les territoires du référentiel.
* '''Système''' : nom du système stellaire. En lecture seule dans la grille, défini à l'ajout.
* '''Playfield''' : planète, lune ou secteur spatial au sein du système. En lecture seule dans la grille.
* '''Secteur / Nom POI''' : nom du secteur ou du Point d'Intérêt précis (exemple : « Power Plant », « Plaines du Nord »). Ce champ est essentiel pour localiser les vendeurs dans les POI. Éditable directement dans la grille.
* '''Ressource''' : ressource présente à cet emplacement, sélectionnable parmi les ressources du référentiel de la faction.
* '''Type de ressource''' : catégorie de l'emplacement, définie par une liste fixe côté serveur (Astéroïde, Planète, Commerce, etc.).
* '''Quantité''' : quantité estimée ou nombre de gisements. Valeur numérique libre.
* '''Description''' : informations complémentaires libres (exemple : « Champ dense, 3 astéroïdes visibles »).
* '''Commentaire''' : note interne libre (exemple : « Vendeur réapprovisionne toutes les 2h »).
* '''Vends''' : la faction vend cette ressource à cet emplacement.
* '''Achète''' : la faction achète cette ressource à cet emplacement.
* '''Récolté''' : la ressource a été récoltée lors de la session en cours. Utilisé pour le suivi de farming.
 
La couleur de fond de chaque ligne correspond à la couleur définie pour la ressource dans le référentiel de la faction.
 
=== Formulaire d'ajout ===
 
Le formulaire, situé dans la zone Actions à droite, contient les champs suivants :
 
* '''Territoire''' : sélection du territoire de l'emplacement.
* '''Est-ce que le système est répertorié ?''' : si '''Oui''', les champs Système et Playfield sont des listes déroulantes issues du référentiel de l'univers. Si '''Non''', ce sont des champs texte libres pour les systèmes non encore cartographiés dans la BAO.
* '''Système''' : liste déroulante ou texte libre selon le choix précédent.
* '''Playfield''' : liste déroulante chargée dynamiquement depuis le système sélectionné, ou texte libre.
* '''Secteur / Nom POI''' : champ texte libre. Pour un vendeur dans un POI, saisir ici le nom exact du POI (exemple : « Power Plant »).
* '''Ressource''' : liste déroulante des ressources du référentiel de la faction.
* '''Type de ressource''' : liste déroulante des types fixes (Astéroïde, Planète, Commerce...).
* '''Quantité''' : valeur numérique, minimum 1.
* '''Description''' et '''Commentaire''' : champs texte libres.
 
=== Ajouter un emplacement ===
 
==== Cas 1 : Gisement de minerai ====
 
Exemple : un astéroïde de cuivre repéré dans le secteur Akua Sector, système Alpha.
 
# Vérifier que '''Cuivre''' existe dans le référentiel de la faction. Sinon, l'ajouter via le bouton '''Type de ressources faction'''.
# Sélectionner le territoire (ex. : Neutre).
# Choisir '''Oui''' pour système répertorié.
# Sélectionner le système '''Alpha''', puis le playfield '''Akua Sector'''.
# Renseigner le secteur ou nom POI si connu.
# Sélectionner la ressource '''Cuivre''' et le type '''Astéroïde'''.
# Saisir la quantité et les éventuelles descriptions.
# Cliquer sur '''Ajouter'''.
 
==== Cas 2 : Vendeur dans un POI ====
 
Exemple : un vendeur qui propose des Kit de tourelle avancée dans le POI « Power Plant », système Beta.
 
# Vérifier que '''Kit de tourelle avancée''' existe dans le référentiel de la faction. Si ce n'est pas le cas, cliquer sur le bouton '''Type de ressources faction''', ajouter la ressource, enregistrer, puis revenir au formulaire.
# Sélectionner le territoire.
# Choisir '''Oui''' pour système répertorié (ou '''Non''' si Beta n'est pas encore cartographié).
# Sélectionner le système '''Beta''' et le playfield correspondant.
# Dans le champ '''Secteur / Nom POI''', saisir '''Power Plant'''.
# Sélectionner la ressource '''Kit de tourelle avancée''' et le type '''Commerce'''.
# Renseigner la quantité, une description (exemple : « Vendeur fixe ») et un commentaire si utile.
# Cliquer sur '''Ajouter'''.
 
=== Boutons d'action ===
 
* '''Ajouter''' : valide le formulaire et crée l'emplacement sur le serveur immédiatement.
* '''Supprimer''' : supprime le ou les emplacements sélectionnés dans le tableau après confirmation. La suppression est définitive.
* '''Initialiser la récolte''' : remet à zéro la colonne '''Récolté''' pour tous les emplacements (toutes les cases passent à « non récolté »), puis sauvegarde automatiquement. À utiliser en début de session de farming pour repartir d'un état propre.
* '''Enregistrer''' : sauvegarde en lot toutes les modifications effectuées directement dans le tableau (territoire, secteur, ressource, type, quantité, description, commentaire, cases Vends/Achète/Récolté). '''Sans clic sur Enregistrer, les modifications du tableau ne sont pas persistées.'''
* '''Actualiser''' : recharge les données depuis le serveur. Utile si un autre membre de la faction a modifié des emplacements récemment.
* '''Type de ressources faction''' : ouvre directement la liste des ressources de la faction pour ajouter une ressource manquante sans quitter l'écran.
 
=== Gestion de la récolte ===
 
La colonne '''Récolté''' permet de suivre l'état d'exploitation de chaque emplacement au fil d'une session. Cocher la case indique que la ressource a été récoltée. Le bouton '''Initialiser la récolte''' remet toutes les cases à non récolté et sauvegarde automatiquement, ce qui permet de recommencer un cycle de farming sans décocher chaque ligne manuellement.
 
=== Comportement de l'enregistrement ===
 
Le tableau fonctionne en mode édition locale : les modifications effectuées directement dans la grille ne sont envoyées au serveur qu'au clic sur '''Enregistrer'''. Les ajouts et suppressions, en revanche, sont immédiatement persistés côté serveur au moment de l'action. Lors d'un rechargement (bouton Actualiser ou réouverture de la fenêtre), le tableau reflète exactement l'état serveur.
 
=== Notes ===
 
Une connexion au serveur BAO est obligatoire pour utiliser ce module. Les systèmes et playfields disponibles dans les listes déroulantes proviennent du référentiel de l'univers sélectionné dans les paramètres. Si un système ou playfield n'y figure pas encore, utiliser le mode « Non répertorié » pour saisir les informations manuellement en attendant qu'il soit intégré au référentiel.

Version du 11 avril 2026 à 11:40

Module Ressources

Le module Ressources permet à une faction de cartographier collectivement tout ce qu'elle découvre dans l'univers : gisements de minerais, vendeurs dans des POI, épaves, bases stratégiques, points d'intérêt.

Chaque membre peut consulter et enrichir la carte commune en temps réel.

Concepts clés

Avant de commencer, comprendre deux notions distinctes :

  • La ressource — Ce qu'on trouve (Cuivre, Prométhium, Filtres, Kit de tourelle)
  • L'emplacement — Où on l'a trouvé (système, playfield, secteur, quantité)

Exemple : Une ressource s'appelle "Cuivre". Un emplacement serait : "Cuivre trouvé sur planète Akua, système Alpha, Plaines du Nord".

Accès au module

Le module est accessible depuis le menu Ressources de la barre de navigation principale.

Les entrées disponibles :

  • Ressources — Liste des emplacements découverts
  • Type de ressources de faction — Référentiel des ressources nommées
  • Nuancier — Palette de couleurs d'identification
  • Bloc-notes — Notes internes
  • Navigation — Outils de déplacement

Sommaire

Points importants

Deux concepts distincts — Ressource (quoi) vs Emplacement (où)

⚠️ Sans enregistrement, les modifications du tableau ne sont pas sauvegardées

Ajouts/suppressions immédiatement persistés — Modifications du tableau nécessitent un clic "Enregistrer"

📍 Connexion BAO obligatoire — Ce module nécessite une connexion au serveur

Voir aussi