Guide des mods de Pre-Warp Age

Créez votre premier mod, découvrez son fonctionnement et ajoutez vos propres technologies, bâtiments et événements au jeu.

Trouver un mot dans la référence

1. Par où commencer

Ce guide a été préparé pour Pre-Warp Age 1.0.23-pre. Le format des mods et les exemples ont été vérifiés le 7 novembre 2026.

Un mod se trouve dans un dossier distinct. Vous pouvez y définir un nouveau coût d’exploration, une technologie ou une corporation entière. Vos textes, images et sons s’y trouvent aussi. Il n’est pas nécessaire de programmer en C# : les règles du mod s’écrivent dans des fichiers texte JSON.

Commencez par « Premier mod » : vous créerez deux fichiers et vérifierez la modification dans le jeu. Les « Bases » expliquent ensuite chaque partie d’une entrée, puis les « Recettes » ajoutent du contenu. La référence détaillée se trouve à la fin du guide. Consultez-la pour une règle précise lorsque vous savez déjà ce que vous voulez réaliser.

Le langage des règles du jeu s’appelle Nexus. Il combine des possibilités existantes : une technologie peut, par exemple, augmenter l’extraction, débloquer un bâtiment ou apporter un revenu. Si le moteur ne prévoit pas du tout le mécanisme souhaité, un mod JSON ne suffira pas. Il faudra modifier le jeu lui-même.

Les mods sont disponibles dans la version complète du jeu sur ordinateur. Ils sont désactivés dans la démo. Les succès officiels ne sont pas attribués lorsque des mods sont activés ou que les fichiers Vanilla ont été modifiés.

2. Premier mod

Réduisons le coût de l’exploration en fixant son coût de base à un Minéral. Deux fichiers suffisent. Pour le moment, aucune image ni traduction n’est nécessaire. Si vous préférez essayer une version prête à l’emploi, téléchargez le ZIP « Exploration rapide » en haut de la page.

Dans le menu principal, ouvrez Jouer → Mods → Dossier des mods. Dans le dossier Mods qui s’ouvre, créez un dossier quick-survey, puis un sous-dossier Logic. Vous devez obtenir cette structure :

Mods/
  quick-survey/
    modinfo.json
    Logic/
      Explore.json

Le premier fichier, quick-survey/modinfo.json, contient le nom et la version du mod. Copiez-y l’intégralité du bloc suivant :

{
  "id": "quick-survey",
  "version": "1.0.0",
  "title": "Exploration rapide",
  "description": "Réduit le coût de base de l’exploration à un Minéral."
}

Le deuxième fichier, quick-survey/Logic/Explore.json, modifie le coût. Voici son contenu :

[
  ["Explore", "Cost.Minerals", 1]
]

La ligne intérieure se lit ainsi : « Le coût de base de l’exploration Explore en Minéraux est égal à 1 ». Les crochets extérieurs rassemblent les entrées du fichier dans une liste. Il n’y en a qu’une pour le moment. Nous verrons ensuite comment en ajouter.

  • Enregistrez les deux fichiers au format JSON et en UTF-8. Si vous décompressez l’archive fournie, vérifiez que modinfo.json se trouve directement dans Mods/quick-survey, sans dossier intermédiaire supplémentaire.
  • Retournez à l’écran des mods et activez « Exploration rapide ». Fermez l’écran : le jeu relit les fichiers et actualise le menu de nouvelle partie.
  • Créez une nouvelle partie. Choisissez le scénario « Système G », le mode « Méditation » et la corporation « Mineurs ». Évitez pour le moment le « Système solaire » du tutoriel, qui limite les actions disponibles.
  • Sélectionnez un corps inexploré et survolez l’action d’exploration. Vérifiez le coût dans l’infobulle. Le mod fixe une base de 1. La majoration liée à l’éloignement et les autres modificateurs actifs peuvent augmenter ou réduire le coût final.

Remplacez maintenant 1 par 2 dans Explore.json. Ouvrez puis fermez l’écran des mods et créez une nouvelle partie : la base sera de deux Minéraux. Pour comparer précisément, gardez la même graine, le même scénario, la même corporation et le même corps. Seule la base du coût change, la distance du corps reste identique.

Une partie déjà commencée continue d’utiliser ses anciennes données, même si les fichiers du mod ont changé. « Recommencer » conserve également l’ensemble de données de la partie en cours. Pour vérifier une modification, créez une nouvelle partie depuis le menu actualisé. Si le jeu signale une erreur dans un fichier, corrigez-la, puis ouvrez et fermez à nouveau l’écran des mods.

3. Bases du langage de faits

3.1. Sujet, prédicat et valeur

["Explore", "Cost.Minerals", 1]

Reprenons le coût d’exploration. Il comporte trois parties : Explore désigne l’exploration, Cost.Minerals son coût en Minéraux et 1 le nouveau coût de base. La ligne entière signifie : « L’exploration coûte un Minéral avant réductions et majorations ». Une entrée en trois parties s’appelle un triplet.

  • Le sujet indique ce dont on parle : Explore.
  • Le prédicat indique la propriété définie : Cost.Minerals.
  • La valeur indique son montant : 1. Dans la littérature, cette troisième partie s’appelle aussi l’objet du triplet.

Le sujet et le prédicat sont toujours des chaînes de caractères. La valeur peut être un nombre, une chaîne ou true/false. Une chaîne peut désigner un texte, une clé de traduction, le nom d’une option ou une référence à une entité. C’est le champ concerné qui détermine son sens, pas les guillemets. Les identifiants sont sensibles à la casse : Tech et tech sont deux mots différents.

Une entrée et un fichier complet sont deux choses différentes. Nous venons d’examiner une entrée. Voici le fichier Logic/Explore.json complet qui la contient. Vous pouvez le copier intégralement :

[
  ["Explore", "Cost.Minerals", 1]
]

Modifions aussi le coût de base d’un avant-poste. Remplacez le contenu du même fichier par ce qui suit. Il contient maintenant deux entrées :

[
  ["Explore", "Cost.Minerals", 1],
  ["Outpost", "Cost.Minerals", 8]
]

L’exploration a désormais un coût de base de 1 et l’avant-poste de 8. Regardez la fin de la première entrée : une virgule la sépare de la deuxième. Il n’y en a pas après la deuxième. Les crochets tout en haut et tout en bas délimitent la liste entière des entrées du fichier.

Plus loin, la référence présente de courts fragments contenant uniquement les nouvelles entrées, sans le reste du fichier. Leur destination est indiquée avant le code. Les fichiers complets, comme les deux exemples ci-dessus, sont toujours montrés intégralement.

Explore, Cost, Is et Tech sont déjà connus du jeu. Vous choisissez le nom de votre technologie, par exemple SurveyScience. Vous pouvez utiliser ce nouveau nom à gauche pour décrire l’objet, mais pas le mettre arbitrairement à la place du prédicat. L’article « Predicate » explique comment déclarer vos propres mots. Les propriétés existantes suffisent pour les premiers mods.

Pour vos premiers mods, choisissez des noms composés de lettres latines et, si nécessaire, de chiffres : SurveyScience, MyMiner2. Prenez des noms uniques, sans espace et différents des noms existants. Le point, le trait de soulignement et les deux-points ont des fonctions particulières : le point sépare une partie d’une définition, le trait de soulignement sert dans les noms d’instances et les deux-points dans les adresses des cellules de la carte. Ne les utilisez pas dans le nom d’une définition indépendante. Les clés de traduction peuvent aussi utiliser des lettres latines. Les noms visibles par le joueur s’écrivent en français dans le dictionnaire.

3.2. Définitions, instances et héritage

Les fichiers d’un mod décrivent généralement un type d’objet : une technologie, une corporation, un bâtiment ou un monde. C’est une définition. Pendant la partie, le jeu crée des objets concrets à partir de celle-ci : les instances. La description d’une technologie est ainsi commune, mais son état de recherche est propre à chaque joueur. Le jeu attribue les noms des instances. Inutile de copier depuis une sauvegarde un nom tel que SurveyScience_0 dans votre mod.

[
  ["MyMiner", "Is", "CorpMiner"],
  ["MyMiner", "Name", "MyMinerName"]
]

Cet exemple décrit une nouvelle corporation MyMiner à partir de CorpMiner. La première ligne lui donne les propriétés de « Mineurs », la deuxième change son nom. Recevoir les propriétés d’une autre définition s’appelle l’héritage. Les propriétés non précisées restent celles de CorpMiner. Une valeur propre, comme Name, remplace la valeur héritée.

Prenons maintenant les propriétés de deux corporations existantes. Dans cet exemple distinct, MyHybrid ne possède pas de Name propre. Voici le fichier Logic/MyHybrid.json complet :

[
  ["MyHybrid", "Is", "CorpMiner"],
  ["MyHybrid", "Is", "CorpColonist"]
]

Les propriétés des deux parents sont héritées. Mais ils définissent tous deux Name. Dans ce cas, le premier de la liste l’emporte : le nom sera ici celui de « Mineurs ». Inversez les deux lignes et le Name de « Colons » aura la priorité. Si vous ajoutez un Name propre à MyHybrid, il l’emportera sur les deux parents.

L’héritage est préparé à la création d’une partie. Créez donc une nouvelle partie après avoir modifié le fichier. Changer Is sur un objet en cours de partie ne recopie pas toutes ses propriétés. Les chaînes d’héritage ne doivent pas former de boucle : MyMiner ne peut pas hériter de CorpMiner si CorpMiner hérite de MyMiner.

Nous avons utilisé Is pour recevoir les propriétés d’un parent. Le champ Type a une autre fonction : choisir la désignation du type dans l’infobulle. L’article « Type - désignation du type d’objet » présente un exemple où ce choix produit une différence visible. Modifier Type seul n’hérite pas des propriétés du parent.

3.3. Prédicat composé et sous-sujet

Le point apparaît à différents endroits d’une entrée. Examinons-le d’abord dans une propriété, puis dans le nom de l’objet décrit. Ce sont deux cas distincts.

Dans le coût d’exploration déjà rencontré, Cost signifie le coût et Minerals précise la ressource de paiement :

["Explore", "Cost.Minerals", 1]

Cost.Minerals occupe entièrement la deuxième position du triplet. C’est un prédicat composé : une propriété s’écrit avec plusieurs mots séparés par un point. Pour définir un coût en Énergie, elle s’appellerait Cost.Energy. Le point précise ici le coût que nous décrivons.

Un sous-sujet isole un comportement du sujet de ses autres comportements. Une corporation peut, par exemple, recevoir un bonus quand elle dispose d’une importante réserve d’argent et un autre indépendamment de cette réserve. Chacun possède ses propres conditions et effets. La condition d’une partie ne doit pas activer ou désactiver la partie voisine. Les sous-sujets décrivent ainsi les comportements d’un même sujet dans différentes situations et différents états.

Voyons comment l’écrire. La corporation de « Magnats » CorpMagnate reçoit des intérêts sur sa réserve de Crédits. Ils sont décrits dans CorpMagnate.Interest : CorpMagnate est le sujet et Interest le nom d’un comportement distinct. Interest est un nom choisi par l’auteur. Ce mot ne verse pas, à lui seul, des intérêts et ne définit aucune condition.

Précisons d’abord la quantité utilisée pour calculer le revenu de cette partie. Voici une entrée de la définition de la corporation :

["CorpMagnate.Interest", "Per", "Credits"]

Per Credits signifie « pour chaque Crédit dans la réserve du joueur de cette corporation ». Le montant du revenu n’est pas encore défini. Cette ligne choisit une quantité sans rien attribuer à elle seule.

L’entrée suivante fixe le revenu à 0,03 Crédit par tour pour chaque unité de la quantité choisie :

["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]

Adds.Income.Credits signifie une augmentation du revenu de Crédits par tour. Les deux entrées réunies définissent la règle des intérêts. Elles se lisent comme une seule partie de la définition :

["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]

Avec une réserve de 100 Crédits, cette partie ajoute 100 × 0,03 = 3 Crédits de revenu par tour, avant les autres modificateurs. Les deux lignes concernent CorpMagnate.Interest. Il n’y a pas encore de condition : les intérêts sont calculés quelle que soit la réserve. Un sous-sujet n’est pas forcément conditionnel.

Modifions la règle pour cet exemple : les intérêts ne sont versés que si la réserve atteint au moins 100 Crédits. Ajoutons la condition précisément dans Interest :

["CorpMagnate.Interest", "Requires.Has.Credits.Min", 100]

Requires.Has.Credits.Min 100 vérifie que le joueur possède au moins 100 Crédits en réserve. Avec 50, cette partie ne produit aucun revenu. Avec 100, elle en donne 3, avec 200, elle en donne 6. La condition concerne les intérêts Interest, pas toutes les capacités de la corporation.

Ajoutons un deuxième comportement : un versement fixe de 2 Crédits par tour. Donnons-lui un autre sous-sujet, Support :

["CorpMagnate.Support", "Adds.Income.Credits", 2]

Support n’a ni condition propre ni calcul par Crédit : c’est un bonus fixe de +2. La condition et le Per d’Interest ne s’y appliquent pas. Avec une réserve de 50, Support verse toujours 2, même si Interest est désactivé. Avec 100, les deux parties fonctionnent : 3 Crédits d’intérêts et 2 de versement fixe donnent 5 Crédits supplémentaires par tour. Voici l’ensemble des entrées étudiées :

["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03],
["CorpMagnate.Interest", "Requires.Has.Credits.Min", 100],
["CorpMagnate.Support", "Adds.Income.Credits", 2]

Interest et Support sont des noms choisis par l’auteur. Le sens de chaque partie est donné par ses Requires, Per et Adds. Distinguez ces mots du langage des noms inventés par l’auteur. L’article Is explique séparément l’ajout et le remplacement de parties existantes.

Comparez les deux emplacements du point : dans Cost.Minerals, il apparaît dans le deuxième élément et précise la propriété. Dans CorpMagnate.Interest, il apparaît dans le premier et sépare le nom de la partie de celui de la corporation. Accéder à un objet lié par un point constitue encore un autre cas. Nous l’examinerons avec une condition portant sur le propriétaire dans « Source des conditions et ajustement d’un paramètre ». Une chaîne arbitraire de mots connus ne crée pas une nouvelle règle.

3.4. Rôles, ressources et effets

Créons la technologie « Exploration scientifique ». Déclarons d’abord que SurveyScience est une technologie. SurveyScience est notre nom, Tech une catégorie connue du jeu :

["SurveyScience", "Is", "Tech"]

Is Tech donne à l’objet le comportement d’une technologie : on peut la rechercher. Nous appellerons rôle une catégorie dotée d’un tel comportement. Building désigne un bâtiment, Event un événement et Corporation une corporation. Les catégories et définitions existantes sont répertoriées dans l’article Is.

Ajoutons maintenant la technologie à l’arbre du joueur :

["Player", "Has", "SurveyScience"]

Player Has SurveyScience signifie que la technologie appartient à l’ensemble du joueur. À la création de la partie, elle figurera dans son arbre sans être encore recherchée. Has n’attribue pas ici le bonus.

Définissons le bonus : une unité de Science par tour après la recherche :

["SurveyScience", "Adds.Income.Science", 1]

Income.Science est le revenu de Science par tour. Adds l’augmente du nombre indiqué. Le joueur ayant recherché SurveyScience reçoit ce supplément. Si son revenu était de 2, il passera à 3 en l’absence d’autres changements. Remplacer 1 par 2 donne un supplément de 2 par tour.

Donnons un nom à la technologie :

["SurveyScience", "Name", "SurveyScienceName"]

Name indique une clé de texte. SurveyScienceName renvoie au nom français dans le dictionnaire Text/frFR.json. Ce dictionnaire est présenté plus bas avec le fichier Logic complet. SurveyScience désigne la technologie elle-même et SurveyScienceName le texte de son nom.

Pour l’image, choisissons l’icône de fiole déjà disponible :

["SurveyScience", "Icon", "flask"]

Icon flask utilise une image existante du jeu. Aucun PNG supplémentaire n’est nécessaire. Indiquons enfin le premier niveau de l’arbre :

["SurveyScience", "Tier", 1]

Tier détermine la position du nœud. Le nombre 1 le place au premier niveau. Cette ligne ne définit ni coût ni technologie préalable.

Rassemblons les lignes étudiées. Dans le dossier du mod du premier exemple, créez Logic/Technology.json. Voici son contenu complet :

[
  ["SurveyScience", "Is", "Tech"],
  ["SurveyScience", "Name", "SurveyScienceName"],
  ["SurveyScience", "Tier", 1],
  ["SurveyScience", "Icon", "flask"],
  ["SurveyScience", "Adds.Income.Science", 1],
  ["Player", "Has", "SurveyScience"]
]

À la racine du mod, créez un dossier Text, puis un fichier frFR.json à l’intérieur. S’il existe déjà, ajoutez la clé au dictionnaire existant. Un fichier JSON ne peut pas contenir un deuxième objet extérieur. Voici le contenu complet d’un nouveau fichier :

{
  "SurveyScienceName": "Exploration scientifique"
}

Ouvrez puis fermez l’écran des mods, créez une nouvelle partie et ouvrez la fenêtre des technologies. Retrouvez « Exploration scientifique » au premier niveau. Avant la recherche, le revenu de Science ne change pas. Après, il augmente d’une unité par tour. Le coût de recherche dépend des paramètres de Research du jeu de base, c’est pourquoi il ne figure pas dans l’exemple. Si vous remplacez 1 par 2 dans Adds.Income.Science et lancez une nouvelle partie après relecture du mod, la recherche donnera deux unités par tour.

Nous avons modifié le revenu par tour. Les articles Income, Count et Production permettent de le comparer à la réserve et à l’extraction par Travailleur. Chaque grandeur y possède son propre exemple.

La recette de bâtiment plus bas utilise Income.Science sans Adds. Pour un bâtiment achevé, c’est son revenu propre, comptabilisé dans l’économie de son propriétaire. Pour la technologie, nous avons écrit Adds.Income.Science : un supplément au revenu du joueur après la recherche. Ces entrées ont des fonctions différentes. Enlever Adds de la technologie ou l’ajouter au bâtiment ne conserve pas le même résultat.

Dans Logic, définissez les règles et les données initiales du mod. N’y copiez pas le contenu d’une sauvegarde : le moteur conserve lui-même les réserves actuelles, les cartes déjà tirées, les résultats d’actions et les autres changements survenus pendant la partie. Les entrées internes nécessaires à sa poursuite ne sont pas des paramètres de mod.

4. Petites recettes

Voici plusieurs modifications indépendantes. Choisissez la recette qui vous intéresse et ajoutez ses fichiers au mod du premier exemple. Tous les chemins partent du dossier du mod. Chaque fichier complet est montré avec ses crochets extérieurs. Les lignes isolées sont signalées comme des fragments. Les noms des nouveaux objets sont rassemblés dans « Textes des exemples ». Les nombres servent ici à l’apprentissage et ne sont pas des recommandations d’équilibrage.

4.1. Coût et équilibrage

Conservons deux coûts dans un même fichier. Remplacez tout le contenu de Logic/Explore.json par ce tableau. Il n’est pas nécessaire de renommer le fichier :

[
  ["Explore", "Cost.Minerals", 1],
  ["Outpost", "Cost.Minerals", 8]
]

Le coût de base de l’exploration sera d’un Minéral et celui de l’avant-poste de huit. Une virgule sépare les entrées, mais il n’y en a pas après la dernière. Les autres propriétés de l’avant-poste, notamment ses conditions et sa durée, restent identiques. Les réductions et majorations actives modifient toujours le coût final. Vérifiez-le dans une nouvelle partie en survolant l’exploration ou la construction d’un avant-poste.

4.2. Corporation

Ajoutons une corporation distincte possédant les capacités de « Mineurs » et son propre nom. Créez Logic/Corporation.json :

[
  ["MyMiner", "Is", "CorpMiner"],
  ["MyMiner", "Name", "MyMinerName"],
  ["MyMiner", "Description", "MyMinerDesc"],
  ["MyMiner", "Order", 10]
]

MyMiner est notre nom pour la nouvelle définition. CorpMiner désigne les « Mineurs » existants. Grâce à Is, la nouvelle corporation reçoit leurs capacités et leur image. Name et Description remplacent son nom et sa description, tandis qu’Order détermine la position de sa carte dans la liste. Ajoutez MyMinerName et MyMinerDesc de « Textes des exemples » dans Text/frFR.json.

Relisez le mod depuis l’écran des mods et commencez la création d’une nouvelle partie. « Mes mineurs » apparaît parmi les corporations, tandis que les « Mineurs » d’origine restent disponibles. Sélectionnez la nouvelle carte : elle doit présenter les capacités héritées. Pour créer une corporation avec ses propres capacités, utilisez Is Corporation à la place d’Is CorpMiner et définissez ses effets séparément.

4.3. Technologie

Dans « Rôles, ressources et effets », nous avons ajouté SurveyScience sans prédécesseur. Faisons-en maintenant la suite de la technologie existante OutpostConstruction, la construction d’avant-postes. Remplacez entièrement Logic/Technology.json de cet exemple :

[
  ["SurveyScience", "Is", "Tech"],
  ["SurveyScience", "Name", "SurveyScienceName"],
  ["SurveyScience", "Tier", 2],
  ["SurveyScience", "Icon", "flask"],
  ["SurveyScience", "Requires", "OutpostConstruction"],
  ["SurveyScience", "Adds.Income.Science", 1],
  ["Player", "Has", "SurveyScience"]
]

Le dictionnaire des noms reste identique. Requires interdit la recherche tant qu’OutpostConstruction n’a pas été recherchée. Tier 2 déplace le nœud au deuxième niveau de l’arbre. Tier seul n’impose pas cette condition. Relisez le mod et créez une nouvelle partie. Avant la recherche du prédécesseur, « Exploration scientifique » est indisponible. Elle devient accessible ensuite. Une fois « Exploration scientifique » elle-même recherchée, le revenu de Science augmente d’une unité par tour. Tier et Order définissent la position, pas le coût de recherche.

4.4. Bâtiment

Créons une variante scientifique de l’avant-poste. Ses conditions de construction sont celles de l’avant-poste ordinaire, mais il apporte aussi de la Science. Voici le fichier Logic/Building.json complet :

[
  ["SurveyOutpost", "Is", "Outpost"],
  ["SurveyOutpost", "Name", "SurveyOutpostName"],
  ["SurveyOutpost", "Description", "SurveyOutpostDesc"],
  ["SurveyOutpost", "Income.Science", 1]
]

Is Outpost hérite du rôle de bâtiment, des technologies et emplacements requis, du coût, de la durée et de l’entretien de l’avant-poste. Le champ propre Income.Science ajoute un revenu de Science au bâtiment achevé. Pour ses textes, ajoutez les clés SurveyOutpostName et SurveyOutpostDesc de « Textes des exemples » dans Text/frFR.json.

Dans une nouvelle partie, recherchez OutpostConstruction et explorez un monde rocheux adapté à un avant-poste ordinaire. Sélectionnez-le et trouvez l’action de construction « Avant-poste scientifique ». Si vous disposez des ressources nécessaires, construisez-le. En « Méditation », la construction est instantanée. Dans un mode à tâches longues, attendez son achèvement. Le bâtiment ajoute alors une unité de Science par tour. Son entretien en Énergie reste celui d’un avant-poste ordinaire. Une pénurie d’Énergie peut perturber son fonctionnement.

Pour une définition créée de toutes pièces, Is Building ne suffit pas : il faut aussi préciser l’emplacement, les conditions, le paiement et le résultat. L’article « Building, Project, Upgrade » traite ces questions. Dans cette recette, ces informations viennent d’Outpost.

4.5. Événement

Créons un événement qui ajoute une seule fois des Minéraux à la réserve du joueur et vérifions-le au deuxième tour. Définissons d’abord la quantité de Minéraux, puis le moment de l’événement. Après vérification, nous l’intégrerons au tirage aléatoire. Suivez les étapes dans l’ordre.

Événement et récompense en Minéraux

Appelons l’événement SurveyGift. Une entrée déclare qu’il s’agit d’un événement :

["SurveyGift", "Is", "Event"]

Comme pour une technologie, Is définit le rôle. Mais Event désigne un incident produisant un résultat, pas un nœud à rechercher. Définissons maintenant son résultat :

["SurveyGift", "Adds.Minerals.Scaled", 1]

Cette ligne définit une récompense unique en Minéraux. Scaled relie la quantité à la population et aux recherches du joueur. Le nombre 1 est le coefficient. Prenons un cas simple : le joueur possède 10 Travailleurs et aucune technologie achevée. L’échelle économique vaut alors 10 et la récompense sera de 10 × 1 = 10 Minéraux. Une réserve de 30 passera à 40, sans tenir compte des autres changements du tour.

Remplacez uniquement le coefficient 1 par 2. Dans les mêmes conditions, l’événement ajoute 10 × 2 = 20 Minéraux. La récompense est unique : les tours suivants ne la répètent pas d’eux-mêmes. Nous verrons la formule complète incluant les technologies à la fin de la recette.

Vous connaissez déjà Name, Description et Icon grâce à la technologie. Rassemblons la définition de l’événement dans le fichier Logic/Event.json complet :

[
  ["SurveyGift", "Is", "Event"],
  ["SurveyGift", "Name", "SurveyGiftName"],
  ["SurveyGift", "Description", "SurveyGiftDesc"],
  ["SurveyGift", "Icon", "ore_iron"],
  ["SurveyGift", "Adds.Minerals.Scaled", 1]
]

Ajoutez SurveyGiftName et SurveyGiftDesc de « Textes des exemples » dans Text/frFR.json. L’événement est maintenant décrit, mais son moment de déclenchement n’est pas encore fixé. Activer le mod ne suffit pas à attribuer la récompense.

Déclenchement à un tour connu

Les événements du jeu sont tirés dans des groupes. Créons un groupe de vérification SurveyGiftCheck :

["SurveyGiftCheck", "Is", "Events"]

Events est le groupe dans lequel le jeu choisira un événement. Event, à l’étape précédente, était l’événement lui-même. N’ajoutons qu’une carte à notre groupe :

["SurveyGiftCheck", "Deck.SurveyGift", 1]

Deck.SurveyGift inclut une carte SurveyGift. Puisque le groupe n’en contient aucune autre, c’est elle qui sera choisie. Il reste à programmer le tirage :

["SurveyGiftCheck", "Turn.Starts", 2]

Turn.Starts 2 désigne le deuxième tour de la partie. Ce n’est pas une attente de deux tours à partir de l’installation du mod. Les trois entrées forment le fichier Logic/EventCheck.json complet :

[
  ["SurveyGiftCheck", "Is", "Events"],
  ["SurveyGiftCheck", "Deck.SurveyGift", 1],
  ["SurveyGiftCheck", "Turn.Starts", 2]
]

Le jeu trouve ces groupes grâce à Is Events. Aucun lien d’activation supplémentaire n’est nécessaire. Relisez le mod et lancez un nouveau Système G en « Méditation ». Terminez le premier tour : au deuxième, « Minéraux supplémentaires » apparaît et la réserve augmente du montant de la récompense. Avec 10 Travailleurs, aucune technologie achevée et un coefficient de 1, cela donne 10 Minéraux. Une population ou un nombre de recherches différent change ce montant. Ce groupe de vérification n’attribue pas une nouvelle récompense au troisième tour.

Choisir parmi plusieurs cartes

Modifions uniquement le contenu du groupe. Prenons l’événement existant SuppliesScience du jeu de base : il donne une seule fois de la Science au joueur. Ajoutez sa carte à EventCheck.json pour obtenir :

[
  ["SurveyGiftCheck", "Is", "Events"],
  ["SurveyGiftCheck", "Deck.SurveyGift", 1],
  ["SurveyGiftCheck", "Deck.SuppliesScience", 1],
  ["SurveyGiftCheck", "Turn.Starts", 2]
]

Le premier tirage choisit un des deux événements : SurveyGift, qui donne des Minéraux, ou SuppliesScience, qui donne de la Science. Les chances sont égales, car chaque carte est présente en un exemplaire. Ce tirage ne déclenche pas les deux événements à la fois.

Remplacez seulement le nombre de Deck.SurveyGift, de 1 à 2. Le paquet contient alors deux cartes SurveyGift et une SuppliesScience. La probabilité d’obtenir des Minéraux au premier tirage devient de 2 sur 3. Le montant de la récompense reste identique : c’est Adds.Minerals.Scaled dans Event.json qui le fixe, pas le nombre de cartes.

Pour une partie ordinaire, remplaçons la vérification du deuxième tour par l’ajout de SurveyGift au groupe existant RandomEvents. Voici un fichier distinct Logic/RandomGift.json complet :

[
  ["RandomEvents", "Deck.SurveyGift", 1]
]

Retirez ensuite EventCheck.json de Logic, relisez le mod et créez une nouvelle partie. Il reste Event.json et RandomGift.json. SurveyGift participe maintenant au tirage aléatoire habituel avec les autres événements, sans forcément apparaître au deuxième tour. Sa définition et sa récompense restent identiques.

Influence des recherches sur la récompense en Minéraux

Au début de la recette, le joueur n’avait aucune technologie achevée. Voyons ce qui change après des recherches. Gardons la même entrée de récompense :

["SurveyGift", "Adds.Minerals.Scaled", 1]

La formule complète de l’échelle est : population × (1 + nombre de technologies achevées × Rule.OutputPerTech). Avec une population de 10, deux technologies distinctes achevées et Rule.OutputPerTech égal à 0,05, on obtient 10 × (1 + 2 × 0,05) = 11. Avec un coefficient de récompense de 1, l’événement ajoute 11 Minéraux au lieu de 10. La valeur de cette règle se trouve dans Simulation.json du jeu de base.

L’auteur du mod choisit le coefficient de récompense. L’échelle dépend de la population et des recherches de la partie. Pour une vérification garantie, utilisez un groupe contenant uniquement SurveyGift. Les récompenses fixes via Adds.Minerals.Count s’utilisent dans les résultats d’actions et de choix de réponse. Une telle ligne sur un Event indépendant ne crée pas un événement attribuant des Minéraux. L’article EventChoice présente un exemple complet de réponse.

4.6. Scénario

Créons notre propre variante du Système G. Choisissons d’abord une base existante :

["SurveySystem", "Is", "ScenarioG"]

SurveySystem reçoit les paramètres de ScenarioG. Mais définir une carte de sélection et créer une étoile sont deux tâches distinctes. Le centre réel de la carte nécessite sa propre entrée :

["SurveySystem", "Orbit.Center", "ClassG"]

Elle choisit ClassG, une étoile jaune. Si vous remplacez uniquement ClassG par ClassK, une étoile orange de classe K apparaît au centre. Les paramètres hérités de ScenarioG ne deviennent pas pour autant ceux de ScenarioK.

Ajoutons le nom et la description de la carte, déjà familiers. Order définit sa position dans la liste. Voici Logic/Scenario.json complet :

[
  ["SurveySystem", "Is", "ScenarioG"],
  ["SurveySystem", "Name", "SurveySystemName"],
  ["SurveySystem", "Description", "SurveySystemDesc"],
  ["SurveySystem", "Orbit.Center", "ClassG"],
  ["SurveySystem", "Order", 10]
]

SurveySystem est le nom du nouveau scénario. Il hérite des paramètres de ScenarioG, tandis que Name et Description donnent ses propres textes à la carte de sélection. Ajoutez SurveySystemName et SurveySystemDesc dans Text/frFR.json. Après relecture du mod, retrouvez « Mon étoile jaune » dans les scénarios de nouvelle partie. Une étoile de classe G doit apparaître au centre du système sélectionné.

Comparez deux modifications du fichier. Remplacer l’entrée propre Orbit.Center ClassG par ClassK change l’étoile créée en classe K. Supprimer toute l’entrée propre Orbit.Center produit un autre résultat : la description du scénario peut encore lire ClassG chez son parent, mais l’étoile G elle-même ne sera pas créée dans cet exemple. Gardez donc une entrée explicite du centre pour un nouveau scénario fonctionnel.

Pour modifier les ressources initiales, tenez compte de l’héritage des parties. Cette recette reçoit les ressources de la partie Start du parent. Une partie propre SurveySystem.Start remplace celle-ci entièrement : énumérez-y toutes les réserves initiales nécessaires, pas seulement celle que vous changez. L’article Is donne les détails.

Pour vos premiers scénarios, une base de système aléatoire est plus pratique. Le « Système solaire » possède une carte prédéfinie et un tutoriel. Ce n’est pas un modèle vide auquel il suffirait de changer le nom de l’étoile.

4.7. Textes des exemples

Les recettes qui ajoutent des noms nécessitent un dictionnaire Text/frFR.json. Voici son contenu complet pour tous les exemples de cette section. Vous pouvez garder uniquement les clés de la recette choisie. Si le dictionnaire existe déjà, ajoutez les clés entre ses accolades en les séparant par des virgules. N’ajoutez pas un deuxième dictionnaire après l’accolade finale.

{
  "SurveyScienceName": "Exploration scientifique",
  "MyMinerName": "Mes mineurs",
  "MyMinerDesc": "Corporation fondée sur les mineurs.",
  "SurveyOutpostName": "Avant-poste scientifique",
  "SurveyOutpostDesc": "Avant-poste apportant un revenu scientifique supplémentaire.",
  "SurveyGiftName": "Minéraux supplémentaires",
  "SurveyGiftDesc": "Cet événement ajoute des Minéraux à votre réserve.",
  "SurveySystemName": "Mon étoile jaune",
  "SurveySystemDesc": "Scénario fondé sur une étoile jaune."
}

À gauche figurent les clés indiquées dans Name et Description, à droite les phrases visibles par le joueur. Vous pouvez réécrire ces phrases en conservant les clés. Pour renommer une clé elle-même, remplacez aussi toutes les références à celle-ci dans les règles du mod.

5. Fichiers et installation

Ouvrez Jouer → Mods → Dossier des mods. Placez le dossier de votre mod dans le dossier Mods qui s’ouvre.

Mods/
  quick-survey/
    modinfo.json
    Logic/
      Explore.json
    Text/          (si des traductions sont nécessaires)
    Art/           (si des images sont nécessaires)
    Sounds/        (si des sons sont nécessaires)
    preview.png    (aperçu pour le Workshop)

modinfo.json contient les informations du mod et Logic les modifications des règles. Ajoutez Text, Art et Sounds lorsque vous avez besoin de vos propres textes, images ou sons. Vous choisissez les noms des fichiers JSON dans Logic : le jeu retrouve les objets grâce aux noms utilisés dans les entrées. Vous pouvez ainsi modifier le coût d’Explore dans Explore.json comme dans Prices.json.

Enregistrez les JSON en UTF-8. Ils ne doivent contenir ni commentaires ni virgule après le dernier élément. Vérifiez l’extension : Explore.json.txt reste un simple fichier texte et ne sera pas chargé comme règle du jeu.

Tous les fichiers JSON de Logic, sous-dossiers compris, sont lus dans l’ordre de leurs chemins relatifs. Ainsi, 10-base.json est lu avant 20-prices.json. La comparaison est exacte et sensible à la casse, sans utiliser l’ordre alphabétique de la langue de l’interface. Utilisez des noms latins en minuscules et des préfixes numériques si l’ordre compte. Si un champ est redéfini, le fichier lu plus tard peut remplacer les valeurs du précédent. L’ordre des lignes de chaque fichier est conservé.

Les données du jeu de base sont des fichiers ouverts dans le dossier Vanilla. Dans Steam, ouvrez Propriétés du jeu → Fichiers installés → Parcourir, puis trouvez Vanilla dans le dossier du jeu. Logic contient les règles, Text les textes, Art les images et Sounds les sons et la musique. Ouvrez les JSON dans un éditeur de texte, les PNG dans une visionneuse d’images et les OGG dans un lecteur audio.

Les fichiers de Logic sont organisés par thème : Corporations.json pour les corporations, Techs.json pour les technologies, Builds.json pour les bâtiments, Events.json pour les événements, Scenarios.json pour les scénarios et Map.json pour les mondes. Prenez-les comme exemples. Gardez vos modifications dans un mod pour qu’une mise à jour du jeu ne les remplace pas.

Utilisez Vanilla comme référence à lire. Ne modifiez pas les fichiers du jeu installé : placez les entrées nécessaires dans votre propre dossier de mod. Pour modifier un coût défini dans Vanilla/Logic/Simulation.json, écrivez par exemple son nouveau montant dans Mods/quick-survey/Logic/Explore.json, comme pour le premier mod. Après une modification, ouvrez puis fermez l’écran des mods et créez une nouvelle partie.

5.1. Manifeste modinfo.json

Ce fichier décrit le mod pour la liste des mods et le Workshop. Son exemple complet figure dans « Premier mod ». Pour un nouveau mod, remplacez id, title et description par vos propres valeurs. Vous pouvez commencer avec la version 1.0.0.

  • id est l’identifiant unique du mod, par exemple quick-survey. Il commence par une lettre latine minuscule, suivie de lettres latines minuscules, de chiffres ou de traits d’union. Conservez cet id lors des mises à jour.
  • version est la version du mod, composée de trois nombres. Commencez par 1.0.0 et augmentez le numéro lorsque vous mettez le contenu à jour.
  • title et description sont le nom et la brève description que voit le joueur.

L’application crée les champs workshop lors de la publication. Ne renseignez pas manuellement l’itemId ou le SteamID d’un autre auteur. L’identifiant vanilla est réservé au jeu de base.

5.2. Textes

Pour modifier un texte ou en ajouter un, créez Text/frFR.json. C’est un dictionnaire : une clé unique à gauche et la phrase visible par le joueur à droite.

{
  "MyMinerName": "Mes mineurs",
  "MyMinerDesc": "Corporation d’explorateurs du sous-sol."
}

Dans les règles, Name indique la clé du nom et Description celle de la description. L’entrée ci-dessous relie, par exemple, MyMiner à la chaîne MyMinerName. En français, le joueur verra « Mes mineurs ». MyMiner et MyMinerName sont deux noms distincts : le premier désigne la corporation, le second sert à trouver son nom dans le dictionnaire.

["MyMiner", "Name", "MyMinerName"]

Text/frFR.json peut se limiter aux clés dont vous avez besoin. Pour remplacer un texte existant, reprenez sa clé dans le dictionnaire du jeu de base. Écrivez du texte ordinaire sans HTML ni balises de couleur. Si le texte source contient des paramètres {0}, {1}, conservez-les : le jeu les remplacera par des nombres ou des noms.

Pour chaque langue, créez un fichier distinct dont le nom correspond exactement à la liste ci-dessous. Le nom ne contient pas de trait d’union : frFR.json, pas fr-FR.json. Il n’est pas nécessaire d’ajouter toutes les langues à la fois.

  • ruRU.json - russe
  • enUS.json - anglais
  • ukUA.json - ukrainien
  • deDE.json - allemand
  • frFR.json - français
  • esES.json - espagnol
  • itIT.json - italien
  • ptBR.json - portugais du Brésil
  • plPL.json - polonais
  • csCZ.json - tchèque
  • roRO.json - roumain
  • trTR.json - turc
  • jaJP.json - japonais
  • koKR.json - coréen
  • zhCN.json - chinois simplifié
  • zhTW.json - chinois traditionnel
  • arSA.json - arabe
  • hiIN.json - hindi
  • idID.json - indonésien
  • thTH.json - thaï
  • viVN.json - vietnamien

Pour la langue choisie, le jeu fusionne les textes du jeu de base et des mods activés. Une chaîne d’un mod chargé plus tard remplace la même clé d’un mod précédent. Si vous ne traduisez pas une clé existante, sa traduction du jeu ou d’un autre mod reste disponible. Si la clé n’existe pas du tout dans la langue choisie, le jeu la cherche en anglais dans enUS. Si elle manque aussi en anglais, la clé elle-même s’affiche. Pour de nouvelles chaînes, il est donc utile d’ajouter Text/enUS.json. Le français ne remplace pas automatiquement l’anglais manquant.

5.3. Images

Les images PNG se trouvent dans Art. Pour un remplacement, utilisez le nom du fichier d’origine : Art/logo.png remplace par exemple le logo. Les autres images restent identiques. Les sous-dossiers internes servent à organiser les fichiers par thème, mais la recherche d’une icône utilise son nom sans extension.

Pour une nouvelle icône, créez Art/Icons/my_survey.png et écrivez ["MyMiner", "Icon", "my_survey"]. Utilisez un PNG à fond transparent et un nom unique : deux fichiers my_survey.png dans des sous-dossiers distincts ne sont pas deux icônes indépendantes. Le moteur n’impose pas de dimensions fixes au PNG. Pour une icône ordinaire, un carré de 256 × 256 pixels constitue un bon point de départ. N’écrivez pas l’extension .png dans Icon.

preview.png, à la racine du dossier du mod, est une image distincte pour la liste des mods et le Workshop. Elle ne remplace pas les icônes du jeu.

5.4. Sons et musique

Remplaçons d’abord le son d’une action. Enregistrez votre son au format OGG dans Sounds/FX/my_scan.ogg à l’intérieur du mod. Voici Logic/ExploreSound.json complet :

[
  ["Explore", "Sound", "my_scan"]
]

L’exploration utilisera my_scan.ogg. Sound prend le nom sans l’extension .ogg. Choisissez un nom unique : deux my_scan.ogg dans des sous-dossiers différents ne sont pas deux sons indépendants. Si vous reprenez le nom d’un son du jeu de base, votre fichier le remplace aussi partout où ce nom est utilisé.

Définissons séparément la musique de fond. Ajoutez votre fichier Sounds/Music/my_theme.ogg. Voici Logic/Music.json complet, avec une seule piste :

[
  ["Simulation", "Music", "my_theme"]
]

Music sur Simulation définit la liste musicale de la partie. Ici, elle contient uniquement my_theme.ogg. Sound sur Explore concernait seulement l’exploration. Music concerne le fond musical de toute la partie. L’article « Sound et Music » explique les variantes de sons et les autres paramètres.

Music peut contenir plusieurs pistes. Pour remplacer toute la liste par deux morceaux déjà présents dans le jeu, créez Logic/Music.json avec ce contenu. Cet exemple ne nécessite aucun fichier OGG supplémentaire.

{
  "set": [
    ["Simulation", "Music", "interstellar_waltz"],
    ["Simulation", "Music", "molten_core"]
  ]
}

Les deux lignes concernent la même paire Simulation + Music. set remplace l’ancienne liste par toutes les valeurs indiquées, dans l’ordre écrit. Placez la nouvelle liste entière dans un seul fichier : si vous répartissez les pistes entre deux fichiers, le dernier remplace la liste du premier. Pour vos propres morceaux, changez les noms et ajoutez les OGG correspondants dans Sounds.

6. Quand plusieurs mods sont activés

Un mod ne modifie que ce que vous y indiquez. L’exemple précédent change le coût d’exploration et conserve les autres règles du jeu. Ne copiez pas tout un fichier du jeu de base pour une seule modification de coût.

Si deux mods modifient le même coût, la valeur du dernier chargé s’applique. Au besoin, utilisez le champ facultatif order dans modinfo.json : un nombre plus grand signifie un chargement plus tardif. Les dépendances requires et les incompatibilités conflicts énumèrent les id d’autres mods. Ces champs ne sont pas nécessaires pour le premier mod.

Si le dossier local et les téléchargements du Workshop contiennent des mods ayant le même id, le jeu utilise le dossier local. Désactiver un mod rétablit les règles d’origine dans les nouvelles parties. Supprimer une ligne de votre mod ne supprime rien du jeu de base.

7. Workshop et sauvegardes

Un mod local fonctionne sans Steam : vous pouvez le partager sous forme de dossier ou d’archive ZIP. Pour une installation depuis le Workshop, abonnez-vous au paquet, attendez son téléchargement, puis retournez à l’écran des mods. L’abonnement n’écrase pas votre dossier de travail.

Pour publier, connectez-vous à Steam, ouvrez l’écran des mods et sélectionnez votre paquet local. Vérifiez le nom, la description, l’aperçu et version, puis cliquez sur « Publier ». La publication ne se fait pas automatiquement au lancement. Lors de la première publication, le jeu enregistre les informations Workshop dans modinfo.json. Une mise à jour vérifie le SteamID de l’auteur.

Avant de publier du contenu modifié, augmentez version manuellement. Une version inférieure à celle déjà publiée est refusée. Si Steam demande d’accepter l’accord Workshop, suivez le lien affiché par le jeu. En cas d’échec de mise à jour, conservez l’itemId existant : il relie le mod à sa publication. Le remplacer par un nombre arbitraire ne corrige pas l’erreur.

Une partie conserve son ensemble de mods et leur contenu. La sauvegarde contient leurs id, version et empreintes. Même une modification de traduction change la compatibilité : un numéro de version identique ne suffit pas. Il n’existe pas de migration automatique d’une ancienne partie vers de nouvelles versions des mods. Avant une mise à jour, conservez le dossier d’origine du paquet si vous voulez poursuivre l’ancienne partie.

Activer ou désactiver des mods et modifier leurs fichiers ne réécrit pas une partie commencée. « Recommencer » utilise l’ensemble de données fixé pour la session en cours. Pour vérifier une nouvelle version, actualisez l’écran des mods et créez une nouvelle partie depuis le menu actualisé.

8. Si le mod ne fonctionne pas

  • Le mod n’apparaît pas dans la liste. Vérifiez que modinfo.json se trouve directement dans son dossier, contient un JSON valide et son propre id. Assurez-vous que l’extension n’est pas devenue .json.txt. Rouvrez l’écran des mods et lisez le message d’erreur éventuel.
  • La modification n’apparaît pas dans le jeu. Vérifiez que le mod est activé, puis fermez l’écran des mods et créez une nouvelle partie. N’utilisez ni une ancienne partie ni « Recommencer » pour cette vérification. Si d’autres mods sont activés, vérifiez leur ordre : un paquet chargé plus tard peut modifier le même coût ou la même propriété.
  • Le jeu signale une erreur JSON. Ouvrez le fichier indiqué et cherchez la position mentionnée. Vérifiez les paires de crochets et d’accolades, les guillemets des chaînes et les virgules entre éléments. Chaque entrée de règle doit contenir exactement trois éléments.
  • Prédicat inconnu. Vérifiez la deuxième partie de l’entrée : la casse et tous les mots après le point doivent correspondre à une forme prise en charge dans la référence. Le nom de votre technologie est autorisé à gauche, mais ne devient pas une nouvelle propriété simplement parce que vous l’avez inventé.
  • Le bonus ne s’applique pas. Pour une technologie, vérifiez les deux entrées Is Tech et Player Has, puis recherchez-la dans une nouvelle partie. Pour un bonus conditionnel, vérifiez sur quel objet la condition est lue et si elle est remplie. N’attendez pas une récompense unique d’une entrée qui modifie le revenu par tour.
  • La quantité diffère de l’exemple. Précisez d’abord ce que vous comparez : la réserve, la production par Travailleur ou le revenu par tour. Vérifiez ensuite les réductions, majorations, Travailleurs affectés et conditions. Réduire le coût de base ne donne pas forcément le même nombre dans l’infobulle finale.
  • La sauvegarde ne s’ouvre plus après une mise à jour du mod. Rétablissez les anciens fichiers et l’ensemble de mods utilisés au début de la partie. Revenir au même numéro version ne suffit pas : le jeu compare aussi le contenu des fichiers.

Si vous utilisez la validation des données et voyez PARTIAL, cela signifie seulement qu’aucune erreur n’a été trouvée dans les règles vérifiées par le validateur. Ce résultat ne prouve pas que toute combinaison de mots est prise en charge et produit l’effet voulu. La vérification finale d’un mod consiste à créer une nouvelle partie et à exécuter l’action modifiée.

Pour qu’une autre personne puisse reproduire une erreur, transmettez-lui le dossier du mod, la graine de la partie, le scénario, le mode et la corporation choisis. Décrivez l’action, le résultat attendu et le résultat obtenu. Joignez le message d’erreur complet : le nom du fichier et la position indiquée aident à trouver la cause.

9. Autres possibilités des fichiers

Cette section est utile si votre mod dépend d’autres mods ou doit supprimer une partie d’une définition d’origine. Pour le premier mod, le simple tableau de faits présenté dans « Premier mod » suffit.

Champs facultatifs de modinfo.json

  • enabled vaut true ou false et indique si le mod est activé lors de sa première détection. La valeur par défaut est true. Les choix ultérieurs du joueur sont enregistrés séparément.
  • order est un entier, égal à 0 par défaut. Un nombre plus grand signifie un chargement plus tardif. À égalité, l’id détermine l’ordre.
  • requires est un tableau d’id de mods qui doivent être activés et chargés avant celui-ci. Exemple : ["my-library"]. Les plages de versions ne sont pas prises en charge.
  • conflicts est un tableau d’id de mods incompatibles. S’ils sont activés ensemble, le jeu exclut les paquets en conflit du chargement et en indique la raison dans l’écran des mods. Désactivez l’un d’eux et fermez l’écran pour relire l’ensemble restant.
  • titleKey et descriptionKey sont des clés du dictionnaire Text permettant de traduire le nom et la description du mod. La recherche utilise d’abord la langue courante, puis l’anglais, puis les champs ordinaires title et description.
  • tags est un tableau de chaînes pour le Workshop, par exemple ["Corporation"]. Il n’ajoute aucune propriété au jeu.

Le jeu remplit les champs workshop, avec itemId, account et author, lors de la publication. Ils décrivent la publication et son auteur. Ne copiez pas les valeurs d’un autre auteur pour un nouveau mod.

Remplacer, ajouter ou supprimer une entrée

Reprenons le coût déjà rencontré. Le jeu de base possède ses propres données d’exploration. Notre fichier Logic/Explore.json modifie uniquement son coût de base en Minéraux :

[
  ["Explore", "Cost.Minerals", 1]
]

Résultat : la propriété Cost.Minerals d’Explore prend la valeur 1. Le nom, le son et les autres propriétés de l’exploration restent identiques. Il n’est pas nécessaire de copier toute la définition d’Explore pour remplacer un coût.

Si vous supprimez cette ligne du mod, le coût du jeu de base revient dans une nouvelle partie. Retirer notre modification ne supprime pas le coût d’origine. Pour enlever réellement une propriété, il faut une opération remove, que nous verrons plus bas.

Certaines entrées énumèrent un contenu. Has ajoute par exemple une technologie à l’ensemble du joueur. Le fichier suivant suppose que SurveyScience est déjà définie, comme à la section 3.4 :

[
  ["Player", "Has", "SurveyScience"]
]

SurveyScience rejoint les technologies existantes. OutpostConstruction et les autres restent présentes. Is et Blocks se complètent de la même façon dans un tableau ordinaire. Répéter exactement la même entrée ne crée pas un deuxième élément identique.

Examinons les opérations permettant des modifications plus précises. La première, set, définit tout le nouvel ensemble de valeurs d’une propriété. Gardons par exemple uniquement deux morceaux dans la liste musicale. Voici Logic/Music.json complet :

{
  "set": [
    ["Simulation", "Music", "interstellar_waltz"],
    ["Simulation", "Music", "molten_core"]
  ]
}

Après set, Music contient exactement ces deux pistes, dans cet ordre. Les anciennes pistes qui ne figurent pas ici disparaissent de la nouvelle liste. C’est la différence avec un ajout : set remplace la liste entière au lieu d’y ajouter des lignes.

L’opération suivante, add, complète la liste. Gardez Music.json de l’exemple précédent et créez un autre fichier, Logic/zz-more-music.json. Il sera chargé après Music.json :

{
  "add": [
    ["Simulation", "Music", "interstellar_drift_1"]
  ]
}

Il y a maintenant trois pistes : interstellar_waltz, molten_core et la nouvelle interstellar_drift_1. Les deux premières n’ont pas disparu. Les trois morceaux existent déjà dans le jeu. Aucun OGG supplémentaire n’est nécessaire pour cet essai.

Pour l’essai suivant, désactivez zz-more-music.json en le retirant de Logic, puis créez Logic/zz-remove-music.json. Supprimons uniquement molten_core des deux pistes de Music.json :

{
  "remove": [
    ["Simulation", "Music", "molten_core"]
  ]
}

Ce remove comporte trois éléments : il ne supprime que l’entrée exacte. interstellar_waltz reste dans la liste. Pour vider toute la propriété Music, n’indiquez que deux éléments dans remove :

{
  "remove": [
    ["Simulation", "Music"]
  ]
}

La deuxième variante produit une liste musicale vide. N’appliquez pas les deux variantes simultanément : ce sont deux contenus différents pour un même fichier de vérification.

delete supprime une définition entière et non une propriété. Si vous avez créé MyMiner avec la recette « Corporation » et souhaitez retirer uniquement celle-ci, voici Logic/zz-delete-corporation.json complet :

{
  "delete": ["MyMiner"]
}

Dans une nouvelle partie, la carte MyMiner disparaît, mais les autres corporations restent. Ses parties nommées MyMiner.quelque-chose sont supprimées avec la définition. Le préfixe zz sert ici à exécuter cette suppression après le fichier qui déclare MyMiner.

Une fois les opérations comprises séparément, vous pouvez les combiner. Le fichier Logic/Music.json complet suivant vide d’abord Music, puis ajoute un seul morceau :

{
  "remove": [
    ["Simulation", "Music"]
  ],
  "add": [
    ["Simulation", "Music", "interstellar_waltz"]
  ]
}

Il ne reste finalement qu’interstellar_waltz. À l’intérieur d’un tel fichier, l’ordre des opérations est toujours delete → remove → set → add. L’ordre de ces clés dans le texte ne le change pas. Seules les opérations indiquées sont appliquées. Vous pouvez omettre les autres.

La valeur false ne supprime pas une entrée : elle lui attribue la valeur faux. Utilisez remove pour une suppression, pas false ni null. La valeur null n’est pas autorisée dans les triplets.

Faites ces essais l’un après l’autre : plusieurs fichiers de vérification actifs modifieraient simultanément la même liste musicale. Après avoir changé les fichiers, relisez le mod depuis l’écran des mods et créez une nouvelle partie. Pour un coût ordinaire, le tableau du premier exemple est plus pratique. L’objet à opérations sert aux ajouts, aux suppressions exactes et au remplacement d’une liste entière.

10. Référence des prédicats

La référence est organisée par tâche : relations, conditions, effets, économie, événements, mondes et présentation. Un index alphabétique se trouve en haut de la page. Chaque article décrit les formes acceptées et leur résultat. Les exemples précisent s’il s’agit d’un fichier complet ou d’un fragment de définition. Les champs d’état de la partie sont signalés séparément : vous n’avez pas à les écrire dans un mod.

Is - appartenance et héritage

Is indique ce qu’est un objet. Commençons par une nouvelle technologie :

["SurveyScience", "Is", "Tech"]

SurveyScience est un nom inventé, Tech la catégorie existante des technologies. Cette entrée donne à l’objet le comportement d’une technologie. Son ajout à l’arbre du joueur est montré séparément dans « Rôles, ressources et effets ».

À droite, vous pouvez aussi indiquer une définition concrète existante. Le nouvel objet reçoit alors ses propriétés. Le fichier Logic/MyMiner.json complet suivant crée une variante de « Mineurs » :

[
  ["MyMiner", "Is", "CorpMiner"],
  ["MyMiner", "Name", "MyMinerName"]
]

MyMiner hérite des propriétés de CorpMiner : son rôle de corporation, ses capacités et son image. Son propre Name ne remplace que le nom. La chaîne MyMinerName du dictionnaire fournit le nom visible. Un dictionnaire prêt à l’emploi est proposé dans la recette « Corporation ». Si vous remplacez CorpMiner par CorpColonist, la base devient celle de « Colons » et les capacités héritées changent.

Les parties d’une définition ont une règle d’héritage distincte. La section 3.3 étudiait les intérêts de CorpMagnate.Interest. Créons maintenant une variante de « Magnats » avec sa propre partie Interest. Voici Logic/MyMagnate.json complet :

[
  ["MyMagnate", "Is", "CorpMagnate"],
  ["MyMagnate", "Name", "MyMagnateName"],
  ["MyMagnate.Interest", "Adds.Income.Credits", 1]
]

Pour le nom de cette corporation, ajoutez la clé MyMagnateName à Text/frFR.json. Si le dictionnaire n’existe pas encore, voici son contenu complet :

{
  "MyMagnateName": "Mes magnats"
}

La partie Interest propre remplace toute la partie Interest du parent. Son Per Credits n’est donc pas conservé : la nouvelle partie donne un revenu fixe de 1 Crédit par tour. Pour ajouter une capacité aux intérêts sans les remplacer, choisissez un autre nom, par exemple ExtraIncome. La partie Interest du parent restera alors présente. La même règle s’applique aux parties initiales Start des scénarios.

Catégories et définitions existantes pour Is

Choisissez le nom à droite d’Is dans le groupe approprié. Une catégorie définit le genre d’objet. Une définition concrète fournit une base prête à l’emploi avec ses propriétés. Voici les principales possibilités de PreWarpAge. Lisez leurs définitions exactes dans les fichiers Vanilla/Logic indiqués et écrivez vos modifications dans votre mod.

  • Corporation avec ses propres capacités : Corporation. Corporations existantes : CorpMiner pour les « Mineurs », CorpColonist pour les « Colons », CorpMagnate pour les « Magnats » et CorpTechnocrat pour les « Technocrates ». Définitions : Corporations.json.
  • Technologie à rechercher : Tech. Pour hériter d’un bonus existant, prenez par exemple DeepExtraction ou ResearchAutomation. Toutes les technologies se trouvent dans Techs.json. La liste complète des noms figure ci-dessous.
  • Bâtiment : Building. Placement en surface : SurfaceBuilding, en orbite : Orbital. Bases existantes de Builds.json : SpaceStation, HQ, Metropolis, Outpost, Colony, City, DomeMegacity, GasExtractor, SkyExtractor, StellarFarm, DysonRing, WarpDrivePrototype.
  • Scénario : Scenario. Bases de Scenarios.json : ScenarioK, ScenarioG, ScenarioF, ScenarioM, ScenarioA, ScenarioBrownDwarf. ScenarioSol est le Système solaire du tutoriel, avec sa carte et son apprentissage propres.
  • Mode de partie : Rule. Modes existants de Modes.json : ModeMeditation, ModeClassic, ModeHardcore.
  • Ressource : Resource. Ressources existantes de Simulation.json : Workers, Water, Minerals, Science, Energy, Credits, Approval. Rôles supplémentaires : Workforce pour les Travailleurs, Currency pour une monnaie et Stat pour un indicateur affiché. Les articles sur les ressources expliquent leur fonction et leurs combinaisons.
  • Monde et caractéristiques : World pour un monde, Rocky pour rocheux, Icy pour glacé et Earthlike pour semblable à la Terre. Les mondes rocheux et glacés existants sont répertoriés ci-dessous. Définitions : Map.json.
  • Étoile : Star. Profils de Map.json : ClassK, ClassG, ClassF, ClassM, ClassA, Substellar, BrownDwarf. Sun est le Soleil prédéfini de Solar.json.
  • Géante : Giant. Modèles existants : HotJupiter, GasGiantSmall, IceGiantSmall, GasGiantMedium, IceGiantMedium, GasGiantLarge. Astéroïde : Asteroid, avec les modèles RockyAsteroid et IceAsteroid. Définitions : Map.json.
  • Événement : Event, choix de réponse : EventChoice, capacité conditionnelle : Trait, action : Action. Les exemples d’événements et de réponses se trouvent dans Events.json, les déclarations d’actions concrètes dans Simulation.json. Le rôle seul ne remplace pas la programmation, le contenu ou le résultat nécessaires à l’action.

Technologies existantes, dans Techs.json. Ces noms de définitions peuvent figurer à droite d’Is. Ils s’utilisent aussi dans Requires pour une condition de recherche :

  • OutpostConstruction, DeepExtraction, NuclearDrives, ResearchAutomation, AdvancedThermalInsulation, RegolithShielding, FrostTapping, FusionDrives, BlockchainGovernance, FusionWeapons.
  • CryoInsulation, RefractoryCeramics, ClosedBiosystems, CloudMining, StellarEnergy, MantleDrilling, QuantumComputing, QuantumInsulation, UltraCarbides, PlanetaryUrbanization.
  • DenseConstruction, SkyMining, CryoRefining, AntimatterDrives, AIManagement, AGI, SyntheticMaterials, Megaengineering, CoreExtraction, AdvancedGeoSurvey.
  • MindDigitization, ASI, WarpDrives, PostTechnologies, SpaceStations, AdvancedSpaceStations, ComplexSpaceStations.

Modèles de mondes existants, dans Map.json. Utilisez ces noms pour hériter d’un monde concret plutôt que de la catégorie générale World :

  • Très petits corps : TinyRock, TinySulfuric, TinyIce, TinyCryogenic.
  • Petits mondes : SmallLava, SmallRock, SmallIce, SmallCryogenic.
  • Mondes moyens : StandardLava, StandardChthonian, StandardHothouse, StandardOcean, StandardEarthlike, StandardAmmonia, StandardIce, StandardCryogenic.
  • Grands mondes : LargeLava, LargeChthonian, LargeHothouse, LargeOcean, LargeAmmonia, LargeIce.

Is TinyRock reprend par exemple la base existante d’un très petit monde rocheux, tandis qu’Is World ne reprend que la base générale d’un monde. Pour les planètes et lunes prédéfinies du Système solaire, consultez Solar.json. Les noms sont sensibles à la casse : TinyRock et tinyrock sont deux chaînes différentes.

Has - contenu et possession d’une quantité

Has signifie « possède » et énumère le contenu d’un objet. Un joueur possède par exemple un ensemble de technologies, et un événement des choix de réponse. À gauche figure l’objet dont on modifie le contenu, à droite le nom de la définition ajoutée. Une nouvelle ligne Has complète l’ensemble existant : il n’est pas nécessaire de réénumérer toutes les technologies du joueur.

["Player", "Has", "SurveyScience"]

Cette ligne inclut SurveyScience dans l’arbre technologique du joueur. La définition de la technologie doit exister, comme dans le tutoriel. Son bonus apparaît après la recherche. Sur un événement, une ligne Has indiquant un choix de réponse ajouterait un bouton. La même relation de contenu s’applique à différents objets, sans exécuter immédiatement l’élément ajouté.

Vérifier une réserve de ressource dans une condition est une autre tâche, détaillée pas à pas dans l’article Requires. Ici, Has servait à ajouter une technologie à l’ensemble du joueur.

Adds - ajout numérique

Commençons par un supplément au revenu de Science. L’entrée suivante complète la définition de SurveyScience de la section 3.4 :

["SurveyScience", "Adds.Income.Science", 1]

Après la recherche, le joueur reçoit un supplément de 1 au revenu scientifique par tour. Si son revenu était de 2, il passe à 3 sans autre modification. Tant que la technologie n’est pas recherchée, l’ajout ne s’applique pas. Dans Adds.Income.Science, Adds signifie « ajoute », Income le revenu par tour et Science la Science.

Pour réduire maintenant le revenu d’une unité, remplaçons uniquement le nombre dans la même entrée :

["SurveyScience", "Adds.Income.Science", -1]

Avec un revenu initial de 2, le résultat sera 1. Un ajout négatif réduit la même grandeur. Il s’agit toujours d’un changement du revenu de chaque tour, pas d’une perte unique de Science.

Autre tâche : donner des Minéraux une seule fois à la suite d’un choix du joueur. Dans l’exemple complet d’EventChoice, la réponse « Recycler les échantillons » mène au résultat OGSamplesRecycled. Le fragment suivant permet d’en changer la récompense :

["OGSamplesRecycled", "Adds.Minerals.Count", 20]

Après le choix « Recycler les échantillons », le résultat ajoute 20 Minéraux à la réserve. Le tour suivant ne donne pas 20 Minéraux supplémentaires pour le même choix. Count désigne la quantité en réserve, tandis qu’Income.Science désignait le revenu par tour. EventChoice montre comment relier le résultat à la réponse et celle-ci au message. Une ligne de récompense seule ne crée ni message ni bouton.

Troisième tâche : augmenter l’extraction par Travailleur. Voici un fragment de la technologie existante DeepExtraction :

["DeepExtraction", "Adds.Production.Minerals", 0.2]

Après la recherche, le taux d’extraction de Minéraux augmente de 0,2 par Travailleur. Un taux de 1 devient par exemple 1,2 avant les autres modificateurs. Trois Travailleurs affectés produisent 3,6 au lieu de 3. Sans Travailleur affecté, ce bonus ne produit pas de Minéraux à lui seul.

Plusieurs ajouts à une même propriété s’additionnent si leurs conditions sont remplies. Target sert à limiter les bénéficiaires d’un bonus et Per à le calculer par unité d’une autre grandeur. Les articles correspondants présentent des exemples des deux règles.

Nous avons examiné trois changements distincts : une réserve modifiée une fois, un revenu par tour et un taux d’extraction par Travailleur. L’article « Somme des effets, base et attribution unique » explique pas à pas l’addition de plusieurs bonus et l’application des multiplicateurs. Pour les nouveaux mods, utilisez les formes explicites Adds.propriété. Les anciennes entrées avec Target numérique et Adds seul ne servent pas de modèle.

Conditions et effets numériques

Commençons par trois tâches distinctes. Exigeons d’abord une technologie avant une autre. Donnons ensuite un revenu à une technologie recherchée. Puis augmentons ce revenu par un multiplicateur. Les articles suivants détaillent chaque règle.

Condition. Le jeu de base possède ResearchAutomation et OutpostConstruction. Le fichier Logic/Requirement.json complet suivant fait de la construction d’avant-postes le prédécesseur de ResearchAutomation :

[
  ["ResearchAutomation", "Requires", "OutpostConstruction"]
]

Requires signifie « exige ». Le joueur doit d’abord rechercher OutpostConstruction pour accéder à ResearchAutomation. Cette ligne n’attribue rien et ne termine pas elle-même la recherche.

Ajout. Un autre fichier complet, Logic/Bonus.json, définit le bonus de ResearchAutomation :

[
  ["ResearchAutomation", "Adds.Income.Science", 2]
]

Adds ajoute le nombre indiqué. Income.Science est ici le revenu de Science par tour. Après la recherche de ResearchAutomation, le joueur reçoit 2 unités supplémentaires par tour. Avant la recherche, le bonus est absent. Cela remplace le montant du bonus de la technologie existante, sans ajouter un deuxième montant à son ancienne valeur.

Multiplicateur. CloudMining est une technologie existante. Le fichier Logic/Multiplier.json complet change son bonus ainsi :

[
  ["CloudMining", "Multiplies.Income.Energy", 1.1]
]

Multiplies multiplie. Après la recherche de CloudMining, les apports positifs d’Énergie sont multipliés par 1,1 : un apport de 10 devient 11. Les dépenses indépendantes d’Énergie n’augmentent pas. Cet exemple n’exige pas les deux fichiers précédents : les trois tâches se vérifient séparément.

Les exemples ci-dessus montrent des fichiers Logic complets. Les petits blocs suivants peuvent ne montrer que les lignes modifiées d’une définition nommée avant le code. Si vous n’avez encore jamais ajouté de lignes à un fichier, consultez d’abord les exemples complets à une et deux entrées dans « Sujet, prédicat et valeur ».

Requires et Or - conditions

Commençons par une technologie requise. Ce fichier Logic/ResearchRequirement.json complet modifie ResearchAutomation existante :

[
  ["ResearchAutomation", "Requires", "OutpostConstruction"]
]

À gauche figure la technologie que le joueur souhaite rechercher, à droite son prédécesseur. Tant qu’OutpostConstruction n’est pas recherchée, ResearchAutomation est indisponible. Sélectionner le prédécesseur à la souris ne suffit pas : la recherche doit être achevée.

Définissons séparément le lieu d’une construction. Les lignes suivantes sont les conditions d’une nouvelle SurveyStation, pas encore une recette complète de bâtiment. Les deux Is la classent comme bâtiment orbital. La nouvelle ligne est Requires World :

["SurveyStation", "Is", "Building"],
["SurveyStation", "Is", "Orbital"],
["SurveyStation", "Requires", "World"]

World est la catégorie des mondes. La station doit maintenant être placée sur un monde. Une géante qui n’appartient pas à World ne convient pas. Requires vérifie ici le lieu de construction, alors que le premier exemple vérifiait les connaissances du joueur. La différence vient de la référence à droite : une catégorie de lieu ou une technologie.

Autorisons un autre lieu, une géante. Ajoutez cette ligne aux trois entrées de la station :

["SurveyStation", "Requires.Or", "Giant"]

Or signifie « ou ». Un monde ou une géante convient maintenant. Un Requires Giant ordinaire sans Or imposerait simultanément World et Giant au lieu, ce qui est une autre condition.

Combinons les deux règles : le lieu doit être un monde ou une géante et le joueur doit connaître la construction d’avant-postes. Voici toutes les conditions réunies. Un bâtiment complet exige aussi un nom, une icône et un coût, présentés dans Building.

["SurveyStation", "Is", "Building"],
["SurveyStation", "Is", "Orbital"],
["SurveyStation", "Requires", "OutpostConstruction"],
["SurveyStation", "Requires", "World"],
["SurveyStation", "Requires.Or", "Giant"]

Le joueur doit avoir recherché OutpostConstruction et le lieu doit appartenir à World ou Giant. Requires.Or ajoute une alternative aux conditions de même nature : l’un des deux lieux suffit, mais la technologie reste obligatoire. Sans Or, les deux catégories seraient requises. Requires.Corporation et Requires.Corporation.Or énumèrent de même les corporations admissibles.

Le jeu interprète une condition d’après sa référence. Une technologie vérifie la recherche de ce joueur. Une catégorie de monde vérifie le lieu. Pour une amélioration, un bâtiment vérifie sa base immédiate appartenant au joueur. Pour un trait, la condition vérifie la chose qui pourrait le recevoir. Requires Homeworld exige le monde natal. Mentionner un nom dans un autre champ ne suffit pas.

Deux conditions ordinaires de lieu peuvent aussi définir une intersection de catégories. Ce fragment impose à SurveyStation précisément un monde glacé :

["SurveyStation", "Requires", "World"],
["SurveyStation", "Requires", "Icy"]

Les deux appartenances sont nécessaires. Requires.Or Icy donnerait « tout World ou tout Icy ». Pour vérifier cette version, remplacez entièrement les anciennes conditions de lieu, sans laisser Requires.Or Giant. Ne déclarez pas une même définition comme technologie, base d’amélioration et catégorie de lieu à la fois : sa référence deviendrait ambiguë.

Une condition numérique vérifie une valeur précise. Ajoutez cette ligne à SurveyGift de la recette « Événement » pour que sa récompense unique en Minéraux n’apparaisse que si le joueur possède au moins 10 Minéraux :

["SurveyGift", "Requires.Has.Minerals.Min", 10]

Has.Minerals lit la réserve du destinataire de l’événement. Min 10 signifie « au moins 10 » : à 9, la condition est fausse, à 10 ou 11, vraie. La vérification précède la récompense. Elle ne consomme ni n’attribue de Minéraux.

Pour autoriser seulement une réserve de 10 à 20 inclus, il faut deux limites :

["SurveyGift", "Requires.Has.Minerals.Min", 10],
["SurveyGift", "Requires.Has.Minerals.Max", 20]

À 10 et 20, les deux lignes sont satisfaites, à 9 et 21, non. Or sur le lieu n’annule pas ces limites numériques, vérifiées séparément. Voici les autres comparaisons à titre de référence. F désigne le champ vérifié, V une valeur et N un seuil numérique.

  • Requires.F = V ou Requires.F.Equal = V : F est égal à V. Pour un champ multivalué, la présence de V suffit. Un champ absent n’est ni false ni un zéro numérique.
  • Requires.F.More = N : strictement supérieur à N. Less : strictement inférieur. AtLeast ou Min : au moins. Max : au plus. Les deux bornes d’un intervalle sans Or sont obligatoires.
  • Requires.F.Any = V : correspond à l’une des options énumérées pour ce champ. Requires.F.Not = V : exclut l’option indiquée. Préférez Or pour une alternative simple entre objets.
  • Requires.Not = Category : la chose vérifiée n’appartient pas à la catégorie et ne possède pas ce trait actif. Requires.Trait = TraitName : le trait indiqué est actif sur elle.
  • Requires.Has.R.Min = N : la réserve de R de la chose vérifiée est au moins N. Requires.Owner.Has.R.Min vérifie celle de son propriétaire. Pour le taux d’extraction d’un monde, utilisez Production.R. Requires.Production.Minerals.More 0 vérifie par exemple une extraction de Minéraux positive, pas leur réserve chez le joueur.
  • Certaines comparaisons acceptent un chemin vers un autre nombre à la place du seuil. Requires.Size.Less = Owner.Size compare par exemple la taille de la chose à celle de son propriétaire. Il faut un lien Owner réel et un Size sur ce propriétaire.

Les conditions de lieu propres d’un descendant remplacent les conditions héritées de lieu et leurs Or. Les exigences technologiques sont traitées séparément. Une seule liste ne représente pas deux groupes indépendants « A ou B » et « C ou D », ni « avec technologie A sur un monde et B sur un astéroïde ». Créez des variantes distinctes de bâtiment pour ces cas. L’ordre des lignes et les noms des parties ne créent pas de parenthèses dans une condition.

Un événement peut calculer son seuil une seule fois à son apparition. Examinons quatre versions alternatives dans HeadquartersQuest.Done. L’article Goal fournit le cadre fonctionnel complet : il choisit un monde et lance l’issue une fois l’objectif atteint. Ici, remplaçons seulement Goal.Has HQ par une condition de taille du monde cible. La condition ne modifie pas la taille. À l’apparition, supposons une taille de 12.5 et une échelle économique de 20. Chaque version remplace la précédente. Exigeons d’abord une taille multipliée par 1.4.

["HeadquartersQuest.Done", "Requires.Target.Size.Min.Mult", 1.4]

Target.Size lit la taille du monde choisi. Mult prend la valeur initiale entière au sens de complète : 12.5 × 1.4 = 17.5. Pour le seuil inférieur, le résultat s’arrondit au-dessus, à 18. À une taille de 17, la condition est fausse, à 18, vraie. Le seuil reste identique après un changement de taille.

À la place du multiplicateur, exigeons un ajout à la partie entière initiale.

["HeadquartersQuest.Done", "Requires.Target.Size.Min.Add", 3]

Add prend la partie entière de 12.5, soit 12, puis ajoute 3. Le seuil vaut 15, pas 15.5. À 14, la condition est fausse, à 15, vraie. C’est le même procédé que Track pour exiger trois nouveaux achèvements après attribution d’une tâche.

La version suivante n’utilise pas la taille initiale : l’échelle économique fixe le seuil.

["HeadquartersQuest.Done", "Requires.Target.Size.Min.Scaled", 0.5]

Avec une échelle de 20, le coefficient 0.5 donne un seuil de 10. La taille initiale de 12.5 le dépasse déjà : cette version convient immédiatement. Scaled ne signifie pas « ajouter la moitié de la taille ».

Combinons seulement maintenant l’ajout et l’échelle.

["HeadquartersQuest.Done", "Requires.Target.Size.Min.Add.Scaled", 0.5]

Add.Scaled additionne la partie entière initiale de 12 et l’ajout adapté de 20 × 0.5 = 10. Le seuil conservé vaut 22. À 21, la condition est fausse, à 22, vraie. Les quatre variantes concernent le seuil d’une tâche précise, pas un coût recalculé en permanence. Pour vérifier l’exemple, remplacez Goal.Has HQ par une seule de ces lignes. Le reste du cadre demeure identique.

Le seuil ne croît pas avec la valeur vérifiée. Pour une tâche ordinaire d’accumulation de ressources, utilisez Goal.R de l’article sur les objectifs. Ces suffixes fonctionnent là où le mécanisme d’événement conserve un seuil initial. Les ajouter à une condition arbitraire ne crée pas ce mécanisme.

Target - destinataire, lieu et filtre de cible

Choisissons d’abord les bénéficiaires d’un bonus technologique. RegolithShielding existe dans le jeu de base et augmente les places de travail. Target limite les mondes qui reçoivent ce bonus.

Modifions RegolithShielding existante, déjà présente dans l’arbre du joueur. Le fragment ajoute quatre places sur chacun de ses mondes rocheux après la recherche. Dans ce bonus numérique, World.Rocky signifie appartenir simultanément à World et Rocky.

["RegolithShielding", "Target", "World.Rocky"],
["RegolithShielding", "Adds.Workplaces", 4]

Avant la recherche, les places ne changent pas. Après, le bonus agit sur les mondes possédés appropriés, y compris ceux acquis plus tard. Target ne crée pas de mondes et ne remplace pas la recherche.

Choisissons maintenant le lieu d’un événement. SuppliesWater est la livraison d’Eau existante. Commençons par une seule restriction : son lieu doit appartenir à World. Cette modification s’écrit :

["SuppliesWater", "Target", "World"]

Le jeu cherche un monde adapté et lui relie le message lors de la livraison. World n’est pas encore une planète précise. Une sauvegarde d’événement déjà survenu peut contenir le lien vers le corps choisi à la place de la catégorie : le choix est alors terminé.

Exigeons que le monde choisi soit exploré. Ajoutons un filtre :

["SuppliesWater", "Target.Explored", true]

Explored true vérifie que le joueur connaît ce corps. Un monde inexploré n’est plus admissible. Target World reste exigé : il faut la catégorie de monde et l’exploration.

Excluons le monde natal par une entrée distincte :

["SuppliesWater", "Target.Not", "Homeworld"]

Not signifie l’exclusion. Le monde natal ne convient pas, même exploré. Les autres mondes explorés restent candidats. Rassemblons les trois lignes étudiées :

Modifions le lieu de la livraison d’Eau SuppliesWater existante. Le jeu de base définit déjà sa récompense, son image et son inclusion dans Supplies. Le fragment autorise un monde exploré sauf le monde natal. Il ne déclenche pas immédiatement la livraison.

["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Explored", true],
["SuppliesWater", "Target.Not", "Homeworld"]

Ajoutons une autre caractéristique de lieu, rocheux. Un événement exige une entrée Target.Is distincte :

["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Is", "Rocky"]

Un monde rocheux sera choisi. Ne transposez pas dans l’événement World.Rocky du bonus technologique : le bonus numérique y comprend deux catégories, mais l’événement cherche une catégorie portant ce nom entier. Sans catégorie World.Rocky explicitement déclarée, aucun lieu ne convient. Event et Mission choisissent leur lieu selon la même règle.

Un autre filtre vérifie la possibilité de construire. La ligne suivante ne garde par exemple que les lieux où le joueur peut actuellement construire HQ :

["SuppliesWater", "Target.Build", "HQ"]

Ce filtre ne construit rien et ne donne aucun « Siège social ». Il utilise les conditions actuelles du bâtiment. Ne combinez ces filtres que si vous voulez réellement les exiger tous ensemble.

Target.Has vérifie les biens liés du type indiqué, s’ils existent dans ce jeu. Les conditions de champs différents sont obligatoires ensemble. Les alternatives d’un champ utilisent Or, par exemple Target.Has et Target.Has.Or.

Dans une capacité numérique, Target PlacedAt choisit les objets placés sur la chose portant cette capacité : leur PlacedAt renvoie à elle. Target Target.PlacedAt choisit les objets placés sur sa cible. C’est une sélection inverse des objets placés, pas un accès au monde sous un bâtiment.

Dans l’issue d’un événement, Parent désigne le message qui l’a appelée et Parent.Target le corps de ce message. Les liens nécessaires doivent exister : une référence absente n’est pas remplacée par un corps aléatoire. Les filtres suivent directement Target. Le préfixe général Target.If n’existe pas.

Vous pouvez définir une préférence : chercher d’abord un monde rocheux, puis un glacé à défaut. Voici un autre fragment de SuppliesWater. A et B sont des noms de parties inventés. Les conditions générales restent présentes. Les parties sont examinées selon Order puis, à égalité, leur nom. Le jeu choisit la première partie trouvant des corps adaptés.

["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Explored", true],
["SuppliesWater.A", "Order", 1],
["SuppliesWater.A", "Target.Is", "Rocky"],
["SuppliesWater.B", "Order", 2],
["SuppliesWater.B", "Target.Is", "Icy"]

Pour une tâche d’accumulation, un corps peut être choisi d’après l’argent manquant à son exploration. Indiquons d’abord le coût à lire. Cette variante concerne SuppliesWater et conserve les restrictions Target ordinaires précédentes.

["SuppliesWater", "Target.Cost.Minerals.Count", "Explore"]

Pour chaque candidat, le jeu compare le coût actuel d’Explore en Minéraux à la réserve du joueur. Avec un coût de 50, une réserve de 10 et une échelle économique de 20, il manque 40 Minéraux, soit 40 / 20 = 2 unités d’échelle. Ce n’est pas une prévision du revenu du tour suivant.

Limitons d’abord ce manque par le bas.

["SuppliesWater", "Requires.Scaled.Min", 1.5]

Un manque de 2 convient, un manque de 1 non. Exactement 1.5 convient. Excluons ensuite les cibles trop chères par une limite supérieure.

["SuppliesWater", "Requires.Scaled.Max", 2.5]

Les deux bornes gardent un manque de 1.5 à 2.5 inclus. Notre corps de manque 2 reste candidat et un manque de 3 est exclu. Une définition ne peut posséder qu’une seule telle source de limites : les coûts de plusieurs ressources ne sont pas additionnés automatiquement.

Per - grandeur par unité

Per signifie « pour chaque unité ». Un revenu de 0,03 Crédit par Crédit accumulé donne 3 Crédits par tour avec une réserve de 100. Le nombre d’Adds définit le revenu unitaire et Per le nombre d’unités. L’action n’est pas répétée cent fois : un revenu total est calculé.

La corporation de « Magnats » CorpMagnate possède déjà des intérêts. Interest est une partie de sa définition. Regardons uniquement cette capacité :

Adds.Income.Credits définit 0,03 de revenu par unité. Per Credits nomme cette unité : un Crédit en réserve du joueur. Le total dépend donc de la réserve, pas du nombre de clics.

["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]

Avec 100 Crédits, on obtient 100 × 0,03 = 3 par tour, avec 200, 6. La réserve est lue sur le joueur ayant choisi les « Magnats » et n’est pas dépensée par ce calcul.

Un multiplicateur peut aussi se calculer par unité de taille. Le fragment indépendant suivant concerne SizeScale, une capacité existante des mondes :

["SizeScale", "Per", "Size"],
["SizeScale.Places", "Multiplies.Workplaces", 0.2]

Per Size lit la taille du monde. Avec une taille de 4, le multiplicateur vaut 4 × 0,2 = 0,8. Avec 5, il vaut 1. C’est 0,2 multiplié par la taille, pas élevé à sa puissance. Sans Size, il n’y a pas de contribution. Si Size existe et vaut zéro, le multiplicateur est nul : absence et zéro sont distincts.

Vous pouvez choisir la précision de lecture d’une ressource. Per Credits du premier exemple prend la partie entière de la réserve. Pour inclure la fraction, remplacez uniquement cette entrée de « Magnats » :

["CorpMagnate.Interest", "Per", "Credits.Count"]

Avec 100,5 Crédits, le calcul utilise maintenant 100,5 et non 100. Avant arrondi, le revenu vaut 100,5 × 0,03 = 3,015. WorkersFree à la place de Credits signifierait le nombre de Travailleurs libres. Per ne fait toujours que lire une grandeur.

La grandeur peut provenir d’un objet lié. Dans une partie d’effet d’un bâtiment, Per PlacedAt.Size lit par exemple la taille du monde qui le porte, pas celle du bâtiment. Il faut un lien PlacedAt réel. Owner.Size lit de même la taille du propriétaire, si celui-ci en possède une.

Un Per commun s’applique aussi aux parties d’une définition. Dans SizeScale, Places reçoit Per Size de son parent. Un Per propre à Places remplace celui du parent pour cette partie. L’objet vérifié par Requires ne change pas : Per choisit seulement la grandeur de calcul.

Multiplies - multiplicateur d’un champ ou d’une capacité

Multiplies multiplie une valeur. Un revenu de 10 avec un multiplicateur de 1.1 devient 11 : dix pour cent s’ajoutent, pas dix unités. Le multiplicateur reste actif tant que sa technologie, sa corporation ou son trait l’est.

Modifions uniquement CloudMining existante, sans la réintégrer dans l’arbre du joueur. La ligne suivante définit son bonus énergétique :

Income.Energy désigne les apports positifs d’Énergie par tour. 1.1 signifie une multiplication par 1,1. Le multiplicateur technologique ne commence à agir qu’après sa recherche.

["CloudMining", "Multiplies.Income.Energy", 1.1]

Un apport de 10 devient 11 et de 20 devient 22. Une dépense indépendante, comme l’entretien d’un bâtiment, reste identique. Un multiplicateur de 1 ne changerait rien, et 0 annulerait le résultat si la propriété accepte zéro.

Voici un exemple distinct pour une corporation. Cette ligne modifie CorpColonist, les « Colons » existants :

["CorpColonist", "Multiplies.Workplaces", 1.4]

Dans une partie avec les « Colons », les places de travail des objets possédés appropriés sont multipliées par 1,4. Une base de 10 devient 14 avant les autres modificateurs et arrondis. Le choix de corporation active ce bonus, pas la recherche de CloudMining.

Deux multiplicateurs sur un champ se multiplient : 1,1 et 1,2 donnent 1,32. Cela concerne les nombres. Multiplies ne modifie pas Name, Icon ni true/false. Target peut limiter les bénéficiaires, comme dans son article.

Faisons dépendre un multiplicateur de revenu de la population. Ce fragment indépendant ajoute une partie à DeepExtraction. PopulationIncome est son nom inventé :

["DeepExtraction.PopulationIncome", "Per", "Workers"],
["DeepExtraction.PopulationIncome", "Adds.Multiplies.Income.Science", 0.1]

Après recherche, Per Workers lit la population du joueur. Adds.Multiplies.Income.Science part de 1 et ajoute 0,1 par Travailleur. Avec 4, on obtient 1 + 0,1 × 4 = 1,4. Un revenu de Science de 2 devient 2,8, puis 3,2 avec 6 Travailleurs, sans autres flux scientifiques. Multiplies.Income.Science 0.1 ordinaire avec le même Per donnerait 0,4 avec quatre Travailleurs : Adds change ici la formule.

Le fragment suivant de NuclearDrives existante réduit à 80 % la force des majorations RemotenessTrait. Les distances du monde natal restent identiques. Le jeu de base relie déjà cette famille à Distance :

["NuclearDrives", "Multiplies.RemotenessTrait", 0.8]

C’est un multiplicateur de force du trait, pas de la distance ni d’un seul champ. À une force de 0,8, un ajout de 10 devient 8. Si le trait donne un multiplicateur de 2, seule la majoration au-delà de 1 est atténuée : 1 + (2 − 1) × 0,8 = 1,8. Le résultat n’est donc pas 2 × 0,8.

La même forme modifie la force d’une famille de traits reliés par Is. Ne donnez pas à la famille le nom du champ numérique modifié : l’entrée ne doit pas avoir deux interprétations. Chaque recherche achevée d’une technologie répétable ajoute encore son effet : les ajouts s’additionnent et les multiplicateurs se multiplient. Tech détaille la répétition.

Somme des effets, base et attribution unique

Examinons le revenu avec un seul exemple. Vérifiez-le dans un mod séparé avec la corporation « Mineurs », sans Travailleurs affectés aux Minéraux. Leur extraction ne se mélangera pas au revenu étudié. Créez d’abord Logic/MineralIncome.json complet :

[
  ["Minerals", "Income", 10]
]

Minerals possède maintenant un revenu propre de 10 par tour. C’est la valeur initiale, ou base du calcul. Dans cet exemple sans autres sources ni dépenses, le joueur reçoit 10 Minéraux par tour. Réserve et montant par tour sont distincts : l’entrée ne fixe pas le stock à 10.

Ajoutons un bonus technologique. Remplacez le fichier entier :

[
  ["Minerals", "Income", 10],
  ["DeepExtraction", "Adds.Income.Minerals", 2]
]

Après recherche de DeepExtraction, 2 s’ajoute à la base 10 : le revenu devient 12 Minéraux par tour. Avant recherche, seule la base 10 agit. L’entrée remplace l’ancien montant de ce bonus de DeepExtraction. Son ancienne valeur ne s’ajoute pas une deuxième fois. Son bonus d’extraction par Travailleur subsiste, d’où l’absence de Travailleurs sur les Minéraux pour cette vérification.

Introduisons le multiplicateur d’une deuxième technologie. Remplacez encore le fichier entier :

[
  ["Minerals", "Income", 10],
  ["DeepExtraction", "Adds.Income.Minerals", 2],
  ["CloudMining", "Multiplies.Income.Minerals", 1.5]
]

Une fois les deux technologies recherchées, le jeu additionne 10 et 2, puis multiplie par 1,5. Le revenu vaut (10 + 2) × 1,5 = 18. Le multiplicateur agit sur toute la somme positive, pas seulement sur l’ajout 2. L’ordre des lignes JSON ne change pas le résultat. Avec CloudMining seule parmi ces deux technologies, on obtient 10 × 1,5 = 15.

Plusieurs ajouts indépendants s’additionnent d’abord à la base. Les multiplicateurs sont ensuite multipliés. Un multiplicateur supplémentaire de 1,2 porterait par exemple 18 à 21,6. Une réserve peut conserver des fractions. « Min, Max et Round » explique les arrondis propres aux indicateurs.

Ici, Income 10 sur Minerals est la base. D’autres propriétés possèdent une forme Base distincte dont leur article décrit le sens. Ce n’est pas une ligne obligatoire de tout effet. Après le calcul numérique, le jeu respecte les limites et l’arrondi de la quantité modifiée.

Distinguons maintenant revenu et récompense unique. Reprenons SurveyGift de la recette « Événement ». Dans Logic/Event.json, changez seulement le coefficient de 1 à 2. Gardez les autres lignes :

["SurveyGift", "Adds.Minerals.Scaled", 2]

À une échelle économique de 10, l’événement ajoute une seule fois 10 × 2 = 20 Minéraux. Une réserve de 7 passe à 27. Le revenu par tour ne change pas. Utilisez EventCheck.json avec SurveyGiftCheck de la même recette pour lancer l’événement au deuxième tour. Ouvrir l’infobulle ou charger le résultat déjà sauvegardé n’attribue pas 20 Minéraux supplémentaires.

Comparez les entrées : Adds.Income.Minerals 2 sur une technologie recherchée donne 2 de plus à chaque tour suivant. Adds.Minerals.Scaled 2 sur SurveyGift donne une récompense unique dépendant de l’échelle économique. EventChoice montre séparément une récompense fixe Adds.Minerals.Count sur un résultat de choix. Minerals seul ne dit pas quand le joueur reçoit la ressource : il faut lire l’entrée entière et son contexte.

« Effets temporaires et Blocks » décrit le revenu temporaire, limité par la durée d’un événement. « Corporation, Rule et Scenario » présente les ressources initiales uniques d’un scénario. Ces cas utilisent les mêmes opérations numériques avec leurs propres moments d’application.

Un bâtiment peut aussi donner un revenu. Dans la recette « Bâtiment », SurveyOutpost Income.Science 1 définit le revenu propre de l’avant-poste achevé. Il commence à la fin de la construction. C’est une autre source : le bonus technologique commence après recherche, le revenu d’un bâtiment après son apparition. Workplaces et Production détaillent les places des bâtiments de surface et les affectations indépendantes des stations.

Un trait relié par Has peut modifier la chose elle-même ou les objets qu’elle possède. « Trait et Grants » explique ces cas et pourquoi Has sur un bâtiment ne signifie pas un bonus pour tous les mondes du joueur. Pour un ajout temporaire, utilisez la durée d’un événement plutôt qu’un rétablissement manuel de la base.

Per choisit la grandeur, Target les bénéficiaires. Changer Target ne fait pas automatiquement lire à Per les propriétés de la nouvelle cible. Per Size lit par exemple la taille de la chose qui porte la capacité. Pour la taille du lieu lié, utilisez le chemin pris en charge PlacedAt.Size. Voir Per.

Adds et Multiplies s’appliquent aux propriétés numériques prévues par le langage. Ils ne modifient ni noms, icônes, références, Is, Has, ni true/false. Un nouveau nom accompagné d’un nombre ne déclare pas seul une propriété numérique. Un nouveau matériau nécessite d’abord Is Resource. « Resource, Stat et Currency » explique la déclaration.

Certains nombres sont en lecture seule : Change.R, WorkersFree, Build.Cost, Explore.Cost, Researching.Steps et les compteurs Track. Le jeu crée aussi Completed. Les conditions autorisées peuvent les lire, mais Adds ne peut pas les réécrire.

D’autres tâches ont leurs propres formes : Cost pour les réductions, Upkeep pour l’entretien régulier, Price et Trade pour les prix et volumes commerciaux. Les réponses modifient les paramètres d’une offre de mission et Progress utilise ses propres opérations. Leurs articles précisent ces formes et limites. Un ajout général ne remplace pas leurs règles.

Trait et Grants - traits conditionnels

Un trait décrit un bonus une fois et l’attribue ensuite à différents objets. Déclarons seulement ExtraCapacity donnant deux places de travail. Trait est la catégorie existante et ExtraCapacity le nom choisi.

Le premier fragment décrit le bonus sans encore le relier à personne :

["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Adds.Workplaces", 2]

Is Trait déclare le trait et Adds.Workplaces son effet. Tant qu’il n’y a que la définition ExtraCapacity, rien ne change sur les mondes. Pour l’attacher en permanence à TinyRock existant, il faut une ligne :

["TinyRock", "Has", "ExtraCapacity"]

Chaque TinyRock reçoit deux places supplémentaires dans une nouvelle partie. Cela ne crée pas de Travailleurs : une place et son occupant sont distincts. Si le trait est retiré plus tard, seul son ajout disparaît, pas la capacité initiale du monde.

Passons à l’attribution conditionnelle. Retirez d’abord TinyRock Has ExtraCapacity : sinon cet attachement permanent conserverait le bonus indépendamment de la condition. Gardez la définition ExtraCapacity.

Vous pouvez regrouper les traits en famille : déclarez la famille avec Is Trait, puis chaque variante avec Is et le nom de famille. Une variante avec Requires est attribuée automatiquement aux choses satisfaisant ses conditions et retirée quand elles cessent. La famille elle-même et une variante sans conditions ne sont attribuées automatiquement à personne. Has attache en permanence et Marks attribue par événement.

["SmallWorldTrait", "Is", "Trait"],
["CompactWorld", "Is", "SmallWorldTrait"],
["CompactWorld", "Requires", "World"],
["CompactWorld", "Requires.Size.Max", 4],
["CompactWorld", "Multiplies.Cost.Build", 0.9]

CompactWorld accorde automatiquement 10 % de réduction de construction aux mondes de taille au plus 4. SmallWorldTrait est la famille et CompactWorld sa variante. Les familles différentes sont choisies indépendamment.

Une famille peut être reliée à une propriété pour présenter ses variantes dans l’étiquette et l’infobulle. Le jeu possède par exemple Distance et la famille RemotenessTrait. L’entrée « Distance Has RemotenessTrait » relie la description à cette famille. Elle ne donne pas tous les traits à tous les mondes : les conditions des variantes choisissent toujours la bonne.

Une autre méthode est une règle Grants distincte. Le fragment donne ExtraCapacity uniquement aux mondes de taille au moins 10. BigWorld est le nom de la règle. C’est une alternative au Has permanent du premier exemple. Ne conservez pas les deux si le bonus doit disparaître quand la taille baisse.

["BigWorld", "Grants", "Size"],
["BigWorld", "Requires", "World"],
["BigWorld", "Requires.Size.Min", 10],
["BigWorld", "Has", "ExtraCapacity"],
["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Adds.Workplaces", 2]

Grants Size relie la règle à la propriété de taille. Requires World limite aux mondes et Requires.Size.Min fixe le seuil. Has sur la règle énumère les traits attribués. Inutile de répéter ce Has sur le monde. Sous une taille de 10, le bonus disparaît. Retester la condition n’ajoute pas de nouvelles places : tant qu’elle est remplie, l’ajout reste de deux.

Grants avec un nom de propriété ou de famille sert à une règle indépendante qui n’est pas elle-même une variante de famille Trait. Une variante peut fournir ses propres propriétés et son Has des traits indépendants supplémentaires. Adds et Multiplies changent les nombres. Grants choisit seulement les capacités actives. Un Adds textuel ne déclare pas de classification. Requires à la racine du trait vérifie la chose recevant ce trait. Target et Requires d’une partie numérique peuvent restreindre davantage ses bénéficiaires.

Rendons ExtraCapacity aléatoire. Partons uniquement de BigWorld précédent et ajoutons un poids de 30. Aucun autre Grants Size aléatoire ne doit être présent pour cet essai.

["BigWorld", "Chance", 30]

Un monde approprié de taille 10 a 30/100, soit 30 %, de chances de recevoir ExtraCapacity. Les 70 % restants signifient l’absence de trait aléatoire. Le résultat est conservé : rouvrir l’infobulle ne donne pas une nouvelle tentative.

Ajoutons une deuxième variante appropriée au résultat distinct : une place au lieu de deux. BothWorlds est une règle distincte de la même propriété Size.

["ExtraPlace", "Is", "Trait"],
["ExtraPlace", "Adds.Workplaces", 1],
["BothWorlds", "Grants", "Size"],
["BothWorlds", "Requires", "World"],
["BothWorlds", "Requires.Size.Min", 10],
["BothWorlds", "Has", "ExtraPlace"],
["BothWorlds", "Chance", 20]

Pour un monde approprié, la somme vaut 30 + 20 = 50. Les probabilités sont 30 % pour ExtraCapacity, 20 % pour ExtraPlace et 50 % sans trait aléatoire. Aucun résultat ne donne les deux attributions à la fois.

Augmentons seulement le deuxième poids en remplaçant 20 par 90.

["BothWorlds", "Chance", 90]

La somme de 120 dépasse maintenant 100. ExtraCapacity est choisi avec 30/120 = 25 % et ExtraPlace avec 90/120 = 75 %. Il n’y a plus de résultat vide. Le dénominateur général est max(100, somme des poids appropriés). Chance est non négatif et une partie conditionnelle enfant peut le préciser. Adds.Weight et Adds.Chance ne servent pas à cela.

L’attribution déterministe fonctionne séparément du choix aléatoire. Pour comparer, retirez Chance de BothWorlds au lieu de lui donner zéro.

["BothWorlds", "Grants", "Size"],
["BothWorlds", "Requires", "World"],
["BothWorlds", "Requires.Size.Min", 10],
["BothWorlds", "Has", "ExtraPlace"]

Chaque monde approprié reçoit maintenant ExtraPlace indépendamment de BigWorld aléatoire. Il a toujours une place supplémentaire et 30 % de chances d’en avoir deux de plus par ExtraCapacity. Absence de Chance et Chance 0 diffèrent.

Qui reçoit l’ajout d’un trait attaché par Has ? Si la propriété est déclarée sur la classe de la chose ou un ancêtre Is, le trait modifie la chose elle-même. Un monde possède déjà Workplaces, donc un trait attaché Adds.Workplaces change ses places.

Si la propriété est déclarée sur d’autres classes mais absente de celle de cette chose, la capacité numérique peut viser ses objets possédés par Owner. Has avec un trait sur un bâtiment ne signifie donc ni bonus pour tous les mondes du joueur ni bonus pour le monde sous ce bâtiment. Pour votre trait local, déclarez une base sur la classe du bâtiment, comme Workplaces 0. Il est alors explicite que le trait modifie ce bâtiment.

Production.R à zéro est aussi un taux propre déclaré : un ajout peut le rendre positif. Cela diffère d’une production absente. Target PlacedAt sélectionne les objets placés sur la chose portant la capacité et ne mène pas au monde sous un bâtiment. L’article Target explique les bénéficiaires.

Examinons deux alternatives pour un même bonus. Cette version d’ExtraCapacity remplace l’ancien effet numérique. Ne gardez ni Grants aléatoires ni Has permanents des essais précédents.

["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Requires", "World"],
["ExtraCapacity", "Adds.Workplaces", 2],
["ExtraCapacity.Small", "Requires.Size.Max", 4],
["ExtraCapacity.Big", "Requires.Size.Min", 10]

Small et Big ne contiennent que des conditions. Ce sont des alternatives pour l’ajout commun de 2 : un monde de taille 3 reçoit +2 via Small, de taille 12 +2 via Big, de taille 6 rien. Requires World à la racine reste obligatoire. Plusieurs conditions d’une même partie sont toutes nécessaires.

Ajoutons une opération propre à Small. Relisons le résultat : c’est maintenant un autre modèle de bonus.

["ExtraCapacity.Small", "Adds.Workplaces", 1]

Small devient une capacité numérique indépendante : un monde de taille 3 reçoit son +1. Seule l’alternative purement conditionnelle Big reste pour l’ajout commun de +2. Un monde de taille 12 reçoit donc toujours +2 et de taille 6 rien. La condition d’une capacité propre ne doit pas désactiver sa voisine. Pour garder Small comme alternative commune, n’y ajoutez pas d’opération distincte.

Source des conditions et ajustement d’un paramètre

Un bonus peut concerner un monde alors que sa condition doit vérifier le propriétaire. Exemple : deux places de capacité supplémentaires tant que le joueur possède au moins 100 de Science. Requires.Owner.Has.Science.Min nomme directement la réserve vérifiée : la Science du propriétaire. Le monde reste bénéficiaire de l’ajout. Les autres multiplicateurs de capacité s’y appliquent normalement.

Ce fragment attache un trait à la catégorie World existante. WellFundedWorld est un nom inventé. Owner d’un monde possédé renvoie au joueur dont la réserve est vérifiée. Ajoutez le code dans le tableau d’un fichier Logic.

["World", "Has", "WellFundedWorld"],
["WellFundedWorld", "Is", "Trait"],
["WellFundedWorld", "Requires.Owner.Has.Science.Min", 100],
["WellFundedWorld", "Adds.Workplaces", 2]

À 99 de Science, l’ajout est désactivé. À 100, il s’active, puis disparaît après une dépense sous 100. Sans Owner dans Requires.Owner.Has.Science.Min, la réserve du monde lui-même serait vérifiée. Le trait suit la réserve courante : remplir une fois la condition ne fixe pas le bonus pour toujours. Conserver un seuil initial pour les événements Requires ou Goal est un autre mécanisme.

Les définitions existantes peuvent utiliser Adds.Source. Il choisit l’objet commun des vérifications Requires : un lien direct Owner, Parent, Target ou PlacedAt, ou le nom d’un objet existant. Un chemin arbitraire Owner.Size dans Adds.Source n’est pas accepté. Si la référence ne se résout pas, la vérification reste sur la chose d’origine. Une faute de frappe ne rend donc pas forcément la condition fausse.

Un Adds.Source propre à une partie remplace celui du parent. Il n’existe pas de prédicat Source indépendant. La version actuelle a une limite : modifier la réserve d’un objet lié par Adds.Source peut ne pas actualiser un bonus actif. Pour une condition sur le propriétaire, utilisez donc le chemin direct Requires.Owner.Has.Science.Min montré plus haut.

Ne confondez pas l’objet vérifié avec Per, la grandeur de calcul, ni Target, le bénéficiaire du changement.

L’exemple suivant change la force d’une capacité existante au fil du soulèvement RobotUprising. L’événement possède Progress et sa partie Cap réduit la contribution des bâtiments aux places du monde choisi. Target.PlacedAt sélectionne les bâtiments placés sur la cible de l’événement. Les places de base du monde ne sont pas réduites. Le fragment modifie le coefficient sans créer l’événement ni sa programmation.

Choisissons d’abord les contributions à réduire. C’est la première partie du réglage de la capacité Cap existante.

["RobotUprising.Cap", "Target", "Target.PlacedAt"],
["RobotUprising.Cap", "Multiplies.Workplaces", 1]

Target.PlacedAt trouve les bâtiments sur le monde ciblé par le soulèvement. Le multiplicateur 1 conserve encore leur contribution : un bâtiment donnant 8 places en donne toujours 8. Les places propres du monde ne participent pas à cette sélection.

Changeons le coefficient de la capacité selon la progression du soulèvement. Target prend ici une autre fonction précise : il vise Cap elle-même plutôt qu’un monde ou ses bâtiments.

["RobotUprising.Cap.Adjustment", "Target", "RobotUprising.Cap"],
["RobotUprising.Cap.Adjustment", "Per", "Progress"],
["RobotUprising.Cap.Adjustment", "Adds.Multiplies.Workplaces", -0.2]

À Progress 1, Cap vaut 1 − 0.2 = 0.8 : une contribution de 8 devient 6.4 avant arrondi. À Progress 2, le coefficient vaut 0.6 et la contribution 4.8. La base propre du monde reste présente. C’est l’ajout au multiplicateur déjà étudié, mais son destinataire est le paramètre existant d’une capacité numérique permanente. Cela ne permet pas de modifier des champs arbitraires par adresse textuelle. Voici les deux parties réunies.

["RobotUprising.Cap", "Target", "Target.PlacedAt"],
["RobotUprising.Cap", "Multiplies.Workplaces", 1],
["RobotUprising.Cap.Adjustment", "Target", "RobotUprising.Cap"],
["RobotUprising.Cap.Adjustment", "Per", "Progress"],
["RobotUprising.Cap.Adjustment", "Adds.Multiplies.Workplaces", -0.2]

Le paramètre modifié doit déjà appartenir à une opération numérique permanente. Cette forme ne définit pas les paramètres des récompenses uniques ni des choix aléatoires. Elle ne doit pas créer un cycle de modifications sans fin entre capacités, ni utiliser un même nom pour une catégorie de bénéficiaires et un paramètre de capacité. Un bonus ordinaire nécessite seulement Adds.F, Multiplies.F et Per directs.

Min, Max et Round - limites et arrondi

Commençons par une limite inférieure de réserve. Cette ligne autorise une dette allant jusqu’à mille Minéraux sur Minerals existant :

["Minerals", "Count.Min", -1000]

La réserve peut atteindre −200 ou −1000 sans descendre sous −1000. Count.Min 0 interdit la réserve négative. C’est une limite de quantité, pas un test de condition ni un don gratuit. Un achat volontaire exige toujours le paiement disponible.

Choisissons séparément l’arrondi de la limite supérieure des Travailleurs. Ceil arrondit au-dessus et Floor en dessous. Un maximum calculé de 3,2 devient 4 avec Ceil ou 3 avec Floor. Voici l’arrondi supérieur :

["Workers", "Count.Max.Round", "Ceil"]

Round concerne ici précisément le maximum calculé Count.Max. Il n’ordonne pas d’arrondir tous les nombres de Travailleurs du jeu. Une règle propre remplace l’héritée. Pour arrondir vers le bas, remplacez Ceil par Floor dans la même ligne.

Après ces deux explications séparées, les paramètres indépendants peuvent figurer dans un même fichier :

["Minerals", "Count.Min", -1000],
["Workers", "Count.Max.Round", "Ceil"]

Min et Max dépendent de la construction : Count.Min limite la réserve, Requires.F.Min vérifie « au moins », Random.Min définit une borne d’intervalle et Goal.R.Min un gain minimal d’objectif. Toute propriété numérique n’accepte pas une limite arbitraire : Weight.Max seul ne plafonne pas la masse. Un champ textuel Icon ne devient pas numérique avec .Max.

Adds.Round et Multiplies.Round arrondissent le changement d’une opération unique, pas son coefficient ni la réserve restante. Multiplies.Workers.Count 0.9 réduit par exemple une réserve de 11 de 1.1. Avec Multiplies.Round Floor, −1.1 s’arrondit vers le bas à −2 : il reste 9 Travailleurs. Sans Round, il n’y a pas de prélèvement minimal obligatoire. Trade.Max possède son propre arrondi supérieur. Trade.Max.Round n’est pas nécessaire.

Ressources, population et économie

Resource, Stat et Currency - rôles d’une ressource

Créons une ressource nommée Alloy, l’alliage. Déclarons d’abord seulement que c’est une ressource :

["Alloy", "Is", "Resource"]

Resource donne à Alloy les règles de quantité. La ressource est seulement décrite : cette ligne ne la donne pas au joueur et ne crée pas de gisements. Relions maintenant sa réserve au joueur :

["Player", "Has", "Alloy"]

Dans une nouvelle partie, le joueur possède une réserve Alloy indépendante. Sans Count, elle commence à zéro. Fixons la quantité initiale :

["Alloy", "Count", 10]

La réserve commence maintenant à 10 unités. C’est une valeur initiale unique, pas une production de 10 par tour. Un autre objet avec Has Alloy possède sa propre réserve indépendante.

Pour afficher la quantité dans la barre des indicateurs, ajoutons le rôle distinct Stat :

["Alloy", "Is", "Stat"]

Stat affiche le nombre sans créer de production ni faire d’Alloy une monnaie. Credits possède en plus le rôle Currency dans le jeu de base :

["Credits", "Is", "Currency"]

C’est l’organisation existante du jeu, pas une entrée pour une deuxième monnaie. Un ensemble de données accepte une seule Currency. Alloy reste ici une ressource ordinaire.

Une ressource n’exige pas Stat et un Stat n’exige pas Resource. Le jeu chargé accepte une seule Currency. Is Predicate autorise le nom de ressource lui-même comme prédicat. Sans cette déclaration, il peut toujours suivre Cost ou Production et être la valeur d’Has, mais pas devenir un mot indépendant au milieu d’un triplet.

Variante A : ce fragment donne 10 unités d’alliage Alloy au joueur, sans production ni gisement. Alloy est un nom inventé et ore_iron une icône existante.

["Alloy", "Is", "Resource"],
["Alloy", "Is", "Stat"],
["Alloy", "Is", "Predicate"],
["Alloy", "Icon", "ore_iron"],
["Alloy", "Count", 10],
["Player", "Has", "Alloy"]

Count fixe la réserve initiale. Sans lui, une nouvelle Resource commence à zéro. Has sur une autre chose lui crée une réserve indépendante. Is Resource seul ne suffit pas à la production, aux gisements ni au commerce, qui exigent des règles distinctes. Le nom de ressource ne doit pas comporter de point. Un mot intégré ne peut pas être redéclaré comme votre prédicat. Son emploi comme argument dépend des constructions qui l’autorisent.

Ajoutons séparément la production. Dans la variante B, les Travailleurs du monde natal fabriqueront l’alliage. Examinons d’abord le taux dans Factory, partie d’une nouvelle corporation :

["NewAlloyCorp.Factory", "Production.Alloy", 0.5]

Production.Alloy 0.5 signifie une demi-unité par Travailleur affecté et par tour. Deux en produisent 1 et quatre 2. Sans affectation, la production est nulle. Pour demander une matière première, définissons la consommation du même Travailleur :

["NewAlloyCorp.Factory", "Cost.Minerals", 1]

Chaque Travailleur actif ici nécessite 1 Minéral. Deux produisent donc 1 Alloy et dépensent 2 Minerals. C’est une consommation de production par tour, pas le coût de recrutement. Indiquons leur lieu de travail et assemblons la variante B complète. Elle remplace A : Count commence à 0, pas à 10.

NewAlloyCorp hérite de « Mineurs » CorpMiner. Choisissez-la pour une nouvelle partie, sélectionnez le monde natal et affectez deux Travailleurs libres. Factory est une partie de corporation et Target World.Homeworld dirige sa capacité vers le monde natal possédé. Avec assez de matière première, chaque Travailleur affecté y produit 0.5 alliage supplémentaire et consomme 1 Minéral par tour.

Deux Travailleurs donnent 1 Alloy et consomment 2 Minerals en plus des flux ordinaires du monde. En cas de manque de matière première, seules les opérations entièrement approvisionnées s’exécutent. Price permet le commerce de l’alliage contre la monnaie existante. La section sur la génération traite les gisements naturels et le choix à l’exploration.

Enregistrez le tableau complet suivant dans Logic/Alloy.json du mod. Définissez le nom du mod et modinfo.json comme dans le premier exemple. Ajoutez le dictionnaire Text/frFR.json présenté après le tableau pour les noms de ressource et de corporation.

[
  ["Alloy", "Is", "Resource"],
  ["Alloy", "Is", "Stat"],
  ["Alloy", "Is", "Predicate"],
  ["Alloy", "Name", "AlloyName"],
  ["Alloy", "Icon", "ore_iron"],
  ["Alloy", "Count", 0],
  ["Alloy", "Price", 4],
  ["Player", "Has", "Alloy"],
  ["NewAlloyCorp", "Is", "CorpMiner"],
  ["NewAlloyCorp", "Name", "NewAlloyCorpName"],
  ["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
  ["NewAlloyCorp.Factory", "Production.Alloy", 0.5],
  ["NewAlloyCorp.Factory", "Cost.Minerals", 1]
]

Voici Text/frFR.json pour la variante B :

{
  "AlloyName": "Alliage",
  "NewAlloyCorpName": "Producteurs d’alliage"
}

Après avoir lancé une partie avec « Producteurs d’alliage », « Alliage » apparaît dans la barre de ressources. Avant l’affectation, la production est nulle. Affectez deux Travailleurs au monde natal, vérifiez le revenu d’alliage et la consommation de Minéraux, puis terminez le tour. Remplacer Production.Alloy 0.5 par 1 donne 2 alliages par tour avec ces deux Travailleurs, pour la même consommation de 2 Minéraux.

Is Resource autorise le nouveau matériau dans Income.Alloy, Production.Alloy, Upkeep.Alloy, Cost.Alloy, Growth.Alloy et Alloy.Count. Ces formes composées n’exigent pas d’Is Predicate distinct. Celui-ci est nécessaire uniquement quand Alloy lui-même occupe la position centrale d’un triplet.

Count - quantité et limites

Count définit le nombre d’unités en réserve. Continuons Alloy de l’article précédent et remplaçons sa quantité initiale de 10 par 12.

["Alloy", "Count", 12]

La réserve Alloy du joueur commence à 12 dans une nouvelle partie. La définition conserve la valeur initiale et chaque propriétaire sa propre réserve modifiable. Quand le premier dépense de l’alliage, le deuxième n’en perd pas. Les récompenses initiales de scénario s’appliquent séparément : Start peut par exemple ajouter des ressources à l’Eau initiale. Notre scénario ne donne pas d’Alloy.

Count sur la définition d’une ressource fixe la quantité initiale, éventuellement fractionnaire. Count.Min et Count.Max en donnent les limites. Resource a par défaut un minimum nul. Chaque propriétaire a sa réserve, lue dans une condition comme Requires.Has.Minerals.Min et modifiée ponctuellement avec Adds.Minerals.Count. Ces formes ne définissent pas le taux d’extraction d’un monde.

["Water", "Count", 12],
["Minerals", "Count.Min", -1000],
["Credits", "Count.Max", 100000],
["Player", "Has", "Water"]

Un minimum négatif autorise une dette forcée, pas un achat volontaire sans fonds. Pertes et attributions respectent les limites et le message montre le changement réel. Distinguez Count.Max, qui limite la quantité elle-même, de R.Max, la capacité de cette ressource sur une chose. Workers.Max du joueur plafonne sa population totale et Workplaces du monde ses Travailleurs affectés.

Count existe aussi pour une quantité indépendante non Resource. Pour en doter un objet, ajoutez sa définition avec Count dans son Has. Le jeu crée son instance propre de quantité. Cela n’en fait ni un bien marchand, ni une production, ni une monnaie. Deux définitions sans lien d’une même quantité héritée ne peuvent être incluses ensemble, car la lecture serait ambiguë.

Production.Minerals sur un monde donne l’extraction d’un Travailleur par tour. Minerals.Count du joueur est son stock accumulé. Modifier Count ne crée pas d’extraction et n’affecte pas de Travailleurs.

Les anciens exemples ou les formes courtes peuvent utiliser Adds.Minerals sans Count. Cela subsiste pour une ressource existante, mais Adds.Minerals.Count exprime plus clairement le stock. Une action, le départ d’un scénario ou une issue de choix applique une attribution unique. Cette ligne seule dans un effet permanent de technologie ne remplit pas la réserve. « Events et Event » détaille les récompenses adaptées à l’échelle des événements indépendants.

Workforce et FreeWorkers - Travailleurs et affectations

Les Travailleurs appartiennent au joueur dans un groupe commun. Avec 10 Travailleurs et trois affectés à un monde, il en reste sept libres. Affectez-en un de plus et il en reste six. Déplacer le curseur change l’occupation de la population existante.

Is Workforce s’ajoute à une seule ressource de Travailleurs. La réserve commune appartient au joueur. Les affectations aux mondes, bâtiments ou tâches occupent des Travailleurs entiers, sans créer une deuxième population. La fraction de réserve reste présente sans être affectée. Une diminution de population retire les affectations dépassant l’effectif disponible.

Workers est la ressource commune existante et WorkersFree le reliquat libre calculé. Le fragment montre l’organisation du jeu de base. Ne créez pas un autre Resource/Count pour les Travailleurs libres.

["Workers", "Is", "Resource"],
["Workers", "Is", "Predicate"],
["Workers", "Is", "Workforce"],
["WorkersFree", "Is", "FreeWorkers"],
["WorkersFree", "Is", "Predicate"],
["WorkersFree", "Is", "Stat"]

WorkersFree affiche la partie entière de la population totale moins les Travailleurs occupés. Dans le jeu ordinaire, le commerce n’occupe pas de Travailleurs. Rule.TradeWorker, détaillé dans les règles de partie, peut changer cela. WorkersFree n’exige ni Has, Resource ni Count : il est en lecture seule. Appliquons-le au revenu connu avec une capacité supplémentaire de DeepExtraction active après recherche.

["DeepExtraction.FreeScience", "Per", "WorkersFree"],
["DeepExtraction.FreeScience", "Adds.Income.Science", 1]

Avec 10 Travailleurs et trois affectés à un monde, la capacité ajoute 7 de Science par tour. Un revenu de base de 2 devient 9. Affectez un Travailleur libre de plus : l’ajout passe à 6 et le total à 8. La production des Travailleurs affectés se calcule séparément.

Workplaces - capacité d’affectation

Les places limitent les affectations sans ajouter de Travailleurs. Une base mondiale de 3 et un avant-poste ajoutant 8 donnent 11 places avant les autres multiplicateurs et limites.

Définissons d’abord les places propres du monde. Cette ligne fixe la base de World :

["World", "Workplaces", 3]

Un monde possédant cette base a trois places avant les autres règles. Ajoutons celles d’un avant-poste achevé :

["Outpost", "Adds.Workplaces", 8]

Construire l’avant-poste ajoute 8 places à son monde : base 3 et bâtiment donnent 11. La population n’augmente pas. Seule la possibilité d’affecter les Travailleurs existants change. Choisissons ensuite le multiplicateur distinct de « Colons » :

["CorpColonist", "Multiplies.Workplaces", 1.4]

Cette somme n’est multipliée par 1,4 que dans une partie avec CorpColonist. On obtient 11 × 1,4 = 15,4 avant arrondi. Le contrôle ou une autre limite d’affectation peut réduire le nombre disponible. L’infobulle et le curseur utilisent la même limite effective.

World est la catégorie existante des mondes, Outpost l’avant-poste constructible Building/SurfaceBuilding et CorpColonist la corporation de « Colons ». Le fragment modifie des définitions existantes. L’avant-poste doit être réellement construit et le multiplicateur exige de choisir la corporation.

["World", "Workplaces", 3],
["Outpost", "Adds.Workplaces", 8],
["CorpColonist", "Multiplies.Workplaces", 1.4]

Adds.Workplaces sur l’avant-poste ajoute des places au monde qui le porte. Cela ne crée pas de Travailleurs et chaque bâtiment de surface n’a pas son propre curseur. Un multiplicateur sans places initiales n’en crée pas. Blocus, contrôle et maximum Workers peuvent encore réduire les affectations. Lorsque plusieurs plafonds s’appliquent, le plus petit est utilisé.

Sans quantité Workers propre au bâtiment, ses places s’ajoutent au monde, où les Travailleurs sont affectés. Avec Workers propre, les affectations sont indépendantes et ses places ne s’ajoutent pas une deuxième fois au monde. Un avant-poste de surface et une station avec ses propres Travailleurs ne doivent donc pas compter deux fois une contribution.

Production - production par le travail

Production est le résultat du travail des Travailleurs affectés. Un taux de 0.5 signifie une demi-unité de produit par Travailleur et par tour. Cost de la capacité productrice définit la matière première par Travailleur occupé, pas le prix d’achat de l’usine.

Reprenons la variante B de Resource : l’alliage supplémentaire du monde natal de NewAlloyCorp. Lisons d’abord seulement le taux. Cette partie de la définition figure en entier plus bas.

["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
["NewAlloyCorp.Factory", "Production.Alloy", 0.5]

Factory agit sur le monde natal possédé. Chaque Travailleur affecté y produit 0.5 alliage supplémentaire par tour : deux donnent 1, quatre 2. Sans affectation, il n’y a pas de production. Production compte déjà les Travailleurs : n’ajoutez pas Per Workers pour les mêmes Travailleurs.

Ajoutons un coût en matière première à cette production.

["NewAlloyCorp.Factory", "Cost.Minerals", 1]

Cost est ici la consommation par Travailleur et par tour. Deux dépensent 2 Minéraux pour 1 alliage. Si Production.Alloy passe de 0.5 à 1, deux produisent 2 alliages mais consomment toujours 2 Minéraux : le coût est par Travailleur, pas par unité d’alliage. Voici la variante B complète. Si vous l’avez déjà ajoutée depuis Resource, ne répétez pas le fichier.

[
  ["Alloy", "Is", "Resource"],
  ["Alloy", "Is", "Stat"],
  ["Alloy", "Is", "Predicate"],
  ["Alloy", "Name", "AlloyName"],
  ["Alloy", "Icon", "ore_iron"],
  ["Alloy", "Count", 0],
  ["Alloy", "Price", 4],
  ["Player", "Has", "Alloy"],
  ["NewAlloyCorp", "Is", "CorpMiner"],
  ["NewAlloyCorp", "Name", "NewAlloyCorpName"],
  ["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
  ["NewAlloyCorp.Factory", "Production.Alloy", 0.5],
  ["NewAlloyCorp.Factory", "Cost.Minerals", 1]
]

Enregistrez le tableau entier dans Logic/Alloy.json. Resource fournit le dictionnaire Text/frFR.json pour AlloyName et NewAlloyCorpName. Choisissez la nouvelle corporation et affectez deux Travailleurs au monde natal. Avec assez de matière première, ils ajoutent 1 alliage et consomment 2 Minéraux par tour. Vérifiez les infobulles et les réserves après un tour. Le curseur du monde affecte les Travailleurs.

Production.R de valeur K signifie K unités de R par Travailleur affecté et par tour. La ressource doit être déclarée. Sur un monde, c’est son taux d’extraction. Dans une capacité d’usine, c’est une production supplémentaire. Sans Travailleurs, elle est nulle. Income arrive sans affectation, tandis qu’Adds.R.Count change une seule fois la réserve.

Cost d’une capacité de production définit la dépense par Travailleur, pas par produit. Doubler Production.Alloy double donc la production, sans changer la consommation minérale. Production.R sur un monde fixe le taux et Production.R.Base lui ajoute une base.

Un bâtiment possédant ses propres Travailleurs est un autre cas. Voyons d’où vient son taux. Nous comparons les paramètres de MyLab, dont Building montre la déclaration et la construction. Dans les deux essais suivants, le monde a un taux Minéral de 2, le bâtiment deux Travailleurs propres, sans autre bonus.

["MyLab", "Has", "Workers"],
["MyLab", "Workplaces", 2]

Sans Production.Minerals propre, MyLab utilise le taux mondial de 2 : ses deux Travailleurs produisent 4 Minéraux par tour. Ce sont bien les Travailleurs du bâtiment, pas un deuxième comptage de ceux du monde. La base propre du monde participe au taux hérité si elle est déclarée.

Donnons maintenant explicitement un taux propre au bâtiment.

["MyLab", "Production.Minerals", 0.5]

Le taux propre de 0.5 remplace celui de 2 du monde. Les deux mêmes Travailleurs de MyLab donnent 1 Minéral par tour, pas 5. Zéro est aussi un taux propre déclaré : l’absence diffère de zéro. Adds.Production.R et Multiplies.Production.R changent le taux sans affecter de Travailleurs. Production.R.Name, Description et Hide règlent son explication et son affichage.

Essai distinct : un ajout de surface sans Travailleurs propres. Retirez MyLab Has Workers de la variante précédente. Gardez deux Travailleurs affectés au monde.

["MyLab", "Is", "SurfaceBuilding"],
["MyLab", "Production.Minerals", 0.5]

MyLab n’a maintenant pas de production indépendante. Son 0.5 s’ajoute au taux mondial de 2 : les deux Travailleurs du monde donnent 2 × (2 + 0.5) = 5 Minéraux par tour au lieu de 4. Rendre Workers propre à MyLab sépare de nouveau les producteurs, sans conserver l’ajout tout en le recevant séparément. Aucun Per supplémentaire ne doit recompter les mêmes Travailleurs.

Jusqu’ici, le bonus agissait avec sa source. Un autre mécanisme modifie une fois les taux existants. Pour l’essai, remplacez la récompense unique de SuppliesMinerals par un changement de sa cible explicite. Ne gardez pas les deux effets.

["SuppliesMinerals", "Target.Adds.Production.Minerals", 1]

Si la cible possédait un taux Minéral de 2, l’application unique le porte à 3. L’indicateur du corps lui-même change. Ce n’est pas un revenu temporaire du joueur. L’événement doit conserver un lancement et une sélection de cible valides.

Illustrons séparément le parcours des ressources existantes au démarrage d’un scénario. MyScenario hérite de ScenarioG dans l’article sur les scénarios. Ajoutons un changement initial unique réduisant seulement les taux strictement supérieurs à 1.

["MyScenario.Poor", "Target.Adds.Production.Resource", -1],
["MyScenario.Poor", "Requires.Production.Resource.More", 1]

Le corps créé produisait 3 Minéraux et 1 Eau par Travailleur et par tour, sans extraction de Science. Les Minéraux passent à 2. L’Eau reste à 1, car la condition est strictement supérieure à 1. Aucune Science n’apparaît. Resource parcourt ici les taux existants et Requires vérifie chacun séparément. Target.Adds.Resource court parcourt aussi l’extraction existante sans cette condition. Un bonus permanent ne prend pas Adds.Production.Resource : indiquez une ressource précise.

Income - apport indépendant par tour

Income est un apport par tour sans affectation de Travailleurs. Voici un paramètre indépendant du revenu de Science existant :

["Science", "Income", 2]

Chaque propriétaire d’une réserve Science reçoit 2 par tour. Avec 10 au départ et aucun autre flux, il aura 12 après un tour et 14 après deux. Aucune affectation de Travailleurs n’est nécessaire.

Income.R définit le changement propre de R par tour sans Travailleurs affectés. Le nombre peut être positif ou négatif. Sur la définition d’une ressource, utilisez Income sans R : Science Income 2 donne 2 de Science par tour à chaque propriétaire de cette réserve. Income seul sur une chose arbitraire ne remplace pas Income.R.

Science appartient déjà aux ressources du joueur. Le premier fragment définit son revenu indépendant. Le deuxième change les intérêts de CorpMagnate : Interest est sa partie et Per Credits lit l’argent du joueur ayant choisi les « Magnats ». Aucune propriété planétaire n’est nécessaire.

["Science", "Income", 2],
["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]

Per Credits et Adds.Income.Credits calculent le revenu sur la partie entière de la réserve. Multiplies.Income.Credits multiplie les apports positifs. Un Income propre négatif et un entretien Upkeep distinct se traitent différemment. Comparons avec 100 Crédits, des intérêts de 0.03 et un multiplicateur de revenu de 1.1, sans autre flux.

  • Cas A : le joueur lui-même possède Income.Credits −2. Il s’ajoute aux intérêts 100 × 0.03 = 3, donnant un flux propre +1. Ce résultat positif est multiplié par 1.1 : (−2 + 3) × 1.1 = +1.1 Crédit par tour.
  • Cas B : aucun Income.Credits négatif, mais un entretien distinct Upkeep.Credits 2. Le revenu de 3 est multiplié par 1.1 puis l’entretien 2 est soustrait : 3 × 1.1 − 2 = +1.3 Crédit par tour. Le multiplicateur de revenu n’augmente pas l’entretien.

Un Income négatif est donc un terme du flux propre et Upkeep une dépense d’entretien distincte. Choisissez selon le sens de la règle, pas seulement le signe. Chaque capacité garde ses conditions et retirer une source ne doit pas supprimer les autres.

Upkeep - entretien par tour

Upkeep est la dépense d’entretien de chaque tour. Prenons d’abord uniquement un avant-poste achevé :

["Outpost", "Upkeep.Energy", 2]

Chaque avant-poste en fonctionnement demande 2 unités d’Énergie par tour. Le nombre est positif, car Upkeep signifie déjà une dépense. Ce n’est pas le coût unique de construction, défini par Cost. Sans Énergie suffisante, l’avant-poste s’arrête.

Upkeep.R de valeur N exige N unités de R par tour. Le nombre est non négatif, sans signe moins. Sur un bâtiment, sa dépense conditionne le fonctionnement. Sur le joueur, c’est son entretien obligatoire. Pour une dépense par Travailleur, utilisez Per Workers et Adds.Upkeep.Water.

La consommation d’Eau de la population est une règle distincte. Player.WaterUpkeep est une partie existante du joueur. Per Workers lit son nombre de Travailleurs et Adds.Upkeep.Water définit l’Eau par Travailleur. Avec 10 Travailleurs et 0,4, la demande vaut 4 par tour avant les autres règles. Comparez avec l’entretien fixe du bâtiment :

["Outpost", "Upkeep.Energy", 2],
["Player.WaterUpkeep", "Per", "Workers"],
["Player.WaterUpkeep", "Adds.Upkeep.Water", 0.4]

Starvation est la réaction existante à la pénurie d’Eau, dont la définition fixe la perte de Travailleurs. Blocks Upkeep.Water retire la consommation elle-même et Blocks Starvation empêche seulement la perte due à la faim. Hide masque la ligne dans l’interface sans retirer dépense ni conséquences.

Growth, Change et Threshold - croissance et accumulation

Commençons par la croissance de population. Dans ModeHardcore existant, la partie Natural s’en charge. Vous connaissez déjà la lecture exacte de Workers.Count par Per :

["ModeHardcore.Natural", "Per", "Workers.Count"],
["ModeHardcore.Natural", "Adds.Growth.Workers", 0.01]

Avec ce mode et 100 Travailleurs, la croissance vaut 100 × 0,01 = 1 Travailleur par tour avant les limites. Avec 50, elle vaut un demi-Travailleur, conservé dans la réserve commune. Growth décrit la croissance, pas le nombre de Travailleurs déjà affectés.

Autre variante : une ressource croît à partir du flux d’une autre. Ces deux lignes du joueur relient par exemple la croissance scientifique à son flux propre de Minéraux :

["Player", "Growth.Science.Source", "Minerals"],
["Player", "Growth.Science.PerUnit", 0.1]

Source nomme la ressource source et PerUnit le coefficient. Un flux propre de 10 Minéraux donne une croissance de Science de 1 avant les autres règles. Les deux ressources doivent appartenir au joueur. N’incluez pas automatiquement le commerce : le calcul lit le flux propre, pas tout le bilan du tour.

ModeHardcore est un mode sélectionnable existant et Natural sa partie de croissance. Une fois choisi, Per Workers.Count prend la population exacte : 100 et 0.01 donnent une croissance initiale de 1 par tour avant limites. Pour un flux dépendant, Growth.Science.Source et PerUnit sont définis sur l’objet possédant les deux ressources.

["ModeHardcore.Natural", "Per", "Workers.Count"],
["ModeHardcore.Natural", "Adds.Growth.Workers", 0.01]

Change.R affiche le changement total par tour, commerce et tâches compris. Une condition ou le texte d’apprentissage peut le lire. Il ne se définit pas directement et Adds ne le change pas : le jeu calcule ce résultat. Le prévisionnel inclut toute la demande, tandis que le tour n’exécute que le travail approvisionné. En cas de pénurie, le changement réel peut donc différer.

Autre tâche : accumuler le milieu nutritif Nutrients puis le dépenser pour de nouveaux Travailleurs. Il faut d’abord déclarer la ressource, la réserve du joueur et son apport. Le fragment ne contient que cette préparation :

["Nutrients", "Is", "Resource"],
["Nutrients", "Is", "Stat"],
["Nutrients", "Count", 0],
["Player", "Has", "Nutrients"],
["Player", "Income.Nutrients", 1]

Nutrients est un nouveau nom de ressource. Il commence à zéro et reçoit une unité par tour, donc 2 après deux tours. Aucune de ces lignes ne crée encore de Travailleurs. Deux autres échangent le stock contre un Travailleur :

["Player", "Threshold.Nutrients", 3],
["Player", "Threshold.Nutrients.Grows", "Workers"]

Threshold fixe le seuil à 3 et Grows nomme Workers. Quand 3 Nutrients sont accumulés, le jeu les dépense et ajoute un Travailleur. Le surplus reste en réserve. Tant qu’elle suffit, la vérification se répète sans dépasser le maximum Workers.

Après chaque franchissement, le seuil vaut max(ancien + 1, floor(ancien × Increasing)). Increasing vaut 1 par défaut, donc les seuils augmentent même avec 1 : 3, 4, 5… Ce n’est ni un coût ni un Goal. Il faut Resource déclaré, sa quantité chez le joueur et un flux. N’utilisez pas une réserve négative de cet accumulateur pour inventer des sanctions : Shortage traite le maintien vital.

["Nutrients", "Is", "Resource"],
["Nutrients", "Is", "Stat"],
["Nutrients", "Count", 0],
["Player", "Has", "Nutrients"],
["Player", "Income.Nutrients", 1],
["Player", "Threshold.Nutrients", 3],
["Player", "Threshold.Nutrients.Grows", "Workers"],
["Player", "Threshold.Nutrients.Increasing", 1]

Dans une partie ordinaire avec des Travailleurs, sans autre flux Nutrients ni limite de croissance, le troisième tour ajoute un Travailleur et ramène Nutrients à zéro. Le suivant exige quatre unités. Name et Icon suivent les règles ordinaires. La traduction ne change pas la mécanique.

Price et Trade - cours et commerce

Définissons d’abord le prix de base d’un bien. Minerals existe déjà et Credits est la monnaie du jeu :

["Minerals", "Price", 1]

Le prix de base d’un Minéral est un Crédit. Cette ligne n’achète rien. Un coefficient général modifie en plus le prix d’achat :

["Trade", "Price.Buy", 1.2]

Sans réduction personnelle, un Minéral coûte 1 × 1,2 = 1,2 Crédit à l’achat. La vente possède un coefficient distinct :

["Trade", "Price.Sell", 0.8]

Vendre un Minéral rapporte 0,8 Crédit. Des cours distincts font donc perdre de l’argent en vendant puis rachetant immédiatement. Price sur une autre ressource définirait sa propre base.

Pour une transaction réelle, le joueur donne un ordre à l’écran de commerce. « Acheter 2 Minéraux » se répète chaque tour et demande 2,4 Crédits à un prix de 1,2. Quantité d’ordre et prix sont indépendants. Si l’argent ou la marchandise manque, seule la partie approvisionnée s’exécute.

Price sur une ressource donne son prix unitaire de base en monnaie. Sans Price, elle ne se commerce pas. Un prix de 0 autorise encore le commerce. Trade.Price.Sell et Trade.Price.Buy définissent les coefficients généraux. Price.R et Price.R.Sell ou Price.R.Buy précisent le prix d’une ressource pour le joueur. Si une ressource s’appelle Buy ou Sell, ce nom reste une ressource là où la construction attend une ressource.

Limitons maintenant le volume d’une ligne de marchandise. Les calculs suivants supposent assez de biens et de monnaie. Nous traiterons ensuite les limites de réserve.

["Trade", "Count.Max", 4]

Avec un plafond de 4, acheter six Minéraux par tour est impossible : l’ordre est limité à quatre. Au cours de 1.2, la ligne achète 4 Minéraux pour 4.8 Crédits. Modifier le plafond ne change pas le prix unitaire.

Augmentons le plafond grâce à un avant-poste réellement construit du joueur.

["Outpost", "Adds.Trade.Max", 3]

Un Outpost possédé donne un plafond de 4 + 3 = 7. Le joueur peut alors redéfinir l’ordre à 6 Minéraux, achetés pour 7.2 Crédits. Un avant-poste non construit dans le menu n’accorde rien. Augmenter le plafond ne restaure pas forcément un ancien ordre réduit.

Changeons séparément le cours d’achat de « Magnats », sans toucher au plafond.

["CorpMagnate", "Adds.Trade.Price.Buy", -0.24]

Pour un joueur CorpMagnate, le coefficient d’achat passe de 1.2 à 0.96. À prix Minéral de base 1, sans autre correction, six Minéraux coûtent 6 × 0.96 = 5.76 Crédits au lieu de 7.2. C’est une réduction du cours, pas trois unités supplémentaires de capacité commerciale. Voici les paramètres réunis.

["Minerals", "Price", 1],
["Trade", "Price.Sell", 0.8],
["Trade", "Price.Buy", 1.2],
["Trade", "Count.Max", 4],
["Outpost", "Adds.Trade.Max", 3],
["CorpMagnate", "Adds.Trade.Price.Buy", -0.24]

Le cours vaut le prix de base multiplié par le coefficient général d’achat ou de vente et le coefficient personnel de cette marchandise. Le volume est distinct : Trade.Count.R du joueur est son ordre par tour. Positif signifie achat, négatif vente et zéro arrêt. Modifier Price seul n’achète rien. Le joueur donne ses ordres dans l’écran de commerce.

Count.Max sur Trade plafonne une ligne de marchandise. Trade.Max le combine aux contributions personnelles et arrondit au-dessus. Sans plafond, cette limite ne restreint pas le volume. L’ordre est converti en entier et limité. Perdre le monde natal n’interdit pas en soi le commerce. Les anciens Trade.R et Trade.Sell/Buy.Mult ne s’utilisent plus.

Reste le paiement de plusieurs lignes. Pour un essai séparé, prenons deux biens à prix de base 1 et les cours généraux étudiés. C’est une hypothèse de calcul, pas une modification de tous les biens. Dans le commerce, vendons trois unités du premier et achetons-en deux du deuxième.

["Trade", "Price.Sell", 0.8],
["Trade", "Price.Buy", 1.2]

Sans correction personnelle, vendre trois rapporte 2.4 Crédits. Les ventes sont traitées avant les achats. Même avec zéro Crédit initial, ces 2.4 paient les deux unités à 1.2. Avec seulement deux unités à vendre, 1.6 Crédit entre : il paie une unité entière, pas deux. Seule la partie approvisionnée de l’ordre s’exécute.

Control - part des places accessibles

Control.Here limite la part des places de travail accessibles. Prenons le trait OccupiedSector :

["OccupiedSector", "Is", "Trait"],
["OccupiedSector", "Control.Here", 0.5]

Quand un objet reçoit ce trait, la moitié de ses places reste accessible. Sur 11, il en reste 5 après arrondi inférieur. Les Travailleurs ne disparaissent pas : le nombre d’affectations permises diminue. Retirer le trait restaure l’accès normal. Relions-le plus bas à TinyRock existant.

Control.Here donne une fraction entre 0 et 1. Avec plusieurs restrictions, la plus petite fraction s’applique et le nombre de places s’arrondit en dessous. Zéro ferme le travail et 1 conserve toutes les places. Sur un trait, la restriction affecte la chose qui porte le trait.

OccupiedSector est le trait déclaré ici et TinyRock la classe existante de mondes rocheux. Has le relie aux nouveaux corps de cette classe. Sans Has ou attribution Marks par événement, Is Trait seul ne change aucun contrôle.

["OccupiedSector", "Is", "Trait"],
["OccupiedSector", "Control.Here", 0.5],
["TinyRock", "Has", "OccupiedSector"]

Control.Rating est une évaluation distincte de 0 à 6, pas une part de places. Control seul ne définit ni score ni fraction. Is Trait déclare seulement le trait, qui doit être relié par Has ou attribué par une règle. Après retrait de la dernière restriction, la capacité se rétablit d’elle-même.

Approval et Expectations - Approbation et attentes

Examinons l’Approbation du conseil. Approval est une ressource existante et Count fixe la réserve de confiance initiale :

["Approval", "Count", 3]

Le joueur commence avec trois unités d’Approbation. Atteindre la limite inférieure déclenche la défaite prévue. C’est une réserve modifiée par les résultats des tâches, pas le nombre de tâches achevées. Définissons séparément les attentes du conseil :

["Approval", "Expectations", 1]

Les attentes se conservent sur la quantité Approval et commencent à 1. Elles fixent la sévérité du prochain jugement. Après un succès, l’issue existante BoardPleased peut les augmenter :

["BoardPleased", "Approval.Judgment", 0.5]

Avec des attentes de 1, ce succès les porte à 1,5. Le gain d’Approbation lui-même est défini séparément. Pour un échec, prenons une autre ligne :

["BoardDispleased", "Approval.Judgment", -1]

L’échec retire d’abord l’Approbation selon les attentes courantes puis les réduit de 1, avec un minimum de 1. À des attentes de 2, le joueur perd 2 unités d’Approbation et les nouvelles attentes valent 1. Nous pouvons rassembler les quatre paramètres indépendants ci-dessous.

Approval est la ressource d’Approbation du conseil. Sa valeur initiale et ses bornes suivent les autres quantités. Atteindre sa borne inférieure chez le joueur déclenche la défaite par Defeat dans son Has. Expectations sur la quantité Approval est un nombre fini d’au moins 1, avec un minimum de 1 par défaut.

BoardPleased et BoardDispleased sont les issues existantes des tâches du conseil. Judgment 0.5 augmente les attentes après succès, par exemple de 1 à 1.5. Avec Judgment −1, l’échec retire d’abord l’Approbation selon les attentes courantes puis les réduit de 1, minimum 1. À 2, il retire 2 unités d’Approbation et ramène les attentes à 1. Le gain d’Approval après succès se définit séparément.

["Approval", "Count", 3],
["Approval", "Expectations", 1],
["BoardPleased", "Approval.Judgment", 0.5],
["BoardDispleased", "Approval.Judgment", -1]

Approval.Judgment positif augmente les attentes futures. Une issue négative retire l’Approbation selon les attentes courantes puis les réduit du montant déclaré sans descendre sous 1. Cela diffère d’Adds.Approval.Count : l’ajout change la réserve, Judgment décrit l’évaluation du conseil. Chaque propriétaire possède ses attentes indépendantes. Un Expectations arbitraire sur le joueur ne remplace pas celui de sa quantité Approval.

TechLevel - niveau technologique d’un lieu

Commençons par une description numérique du monde. Pour Earth prédéfinie dans « Système solaire », elle s’écrit :

["Earth", "TechLevel", 8]

La Terre reçoit le niveau descriptif 8, sans rechercher les technologies du joueur. Tier place une technologie dans l’arbre et Level concerne les recherches répétées. Ajoutons ensuite une étiquette traduisible à TechLevel.

TechLevel = N donne le niveau technologique d’un établissement ou d’un autre objet portant cette propriété. Tier est la position d’une technologie dans l’arbre et Level compte ses recherches répétées achevées. Changer TechLevel ne recherche pas les technologies du joueur et ne débloque pas automatiquement tous les bâtiments.

Dans ce fragment, Earth reçoit le niveau 8. Elle existe dans « Système solaire », mais le fragment ne la crée pas sur une carte aléatoire. MyDigitalAge est une règle d’étiquette inventée pour un niveau d’au moins 8. Ajoutez MyDigitalAgeName avec « Ère numérique » dans Text/frFR.json. C’est une description du monde, pas une attribution de technologies.

["Earth", "TechLevel", 8],
["MyDigitalAge", "Grants", "TechLevel"],
["MyDigitalAge", "Requires.TechLevel.Min", 8],
["MyDigitalAge", "TechLevel.Text", "MyDigitalAgeName"]

La variante conditionnelle ajoute l’étiquette traduite au niveau. Sans trait adapté, seul le nombre s’affiche. Plusieurs étiquettes actives sont énumérées. Le nombre et ses conséquences descriptives doivent rester des faits séparés. Pour modifier un coût de recherche, utilisez Cost.Research. Pour sa répétition, Repeatable et Level, pas TechLevel.

Ordre du calcul du tour et pénuries

Au début du tour, 4 Minéraux sont extraits. Un ordre commercial en vend ensuite 2 contre de l’argent. Après le commerce, entretien et contribution à une tâche sont payés. Si une ressource manque pour la contribution, la tâche attend. Une « opération approvisionnée » désigne ici la part du travail ou du commerce réellement payable.

L’ordre général est : apport de toutes les ressources, commerce, entretien, processus, maintien vital. Les ventes voient l’extraction du tour et l’entretien le résultat du commerce. La dépense propre obligatoire du joueur est réservée avant les consommateurs désactivables. Le manque d’une ressource de paiement peut bloquer tout un pas de tâche sans prélèvement partiel des autres ressources. Production des Travailleurs et commerce exécutent des unités approvisionnées.

Le prévisionnel donne la différence entre tous les apports et toutes les dépenses prévus, même si une partie du travail ne peut pas être payée. Un nombre négatif signale une pénurie sans garantir une réserve négative : une dette interdite n’apparaît pas. L’histoire et les messages montrent les changements réellement appliqués. Il n’est pas nécessaire d’ajouter des copies de revenus et dépenses pour corriger cette différence.

Actions, construction et recherche

Cost - coût et échelle

Commençons par le coût d’une action dans une ressource. Voici Logic/ExplorePrice.json complet :

[
  ["Explore", "Cost.Minerals", 5]
]

Cost.Minerals est le coût en Minéraux. La base de l’exploration vaut 5, avant les réductions et majorations du lieu. C’est un paiement d’action, distinct du cours Price et de l’entretien par tour Upkeep. Le coût ne peut pas être négatif.

Une action définie par les données peut demander deux ressources à la fois. Prenons ExchangeWater déjà créé dans Action et définissons d’abord seulement l’Eau :

["ExchangeWater", "Cost.Water", 20]

L’échange exige alors 20 unités d’Eau. Une ligne supplémentaire demande aussi de l’Énergie :

["ExchangeWater", "Cost.Energy", 5]

Il faut maintenant 20 unités d’Eau et 5 unités d’Énergie simultanément. Elles ne sont pas interchangeables. Cela concerne les actions définies par les données et les choix d’événements. Les actions natives Build, Research, Explore, Colonize, GeoSurvey et Probe lisent une seule ressource de coût direct. Ne leur transposez pas automatiquement ExchangeWater à deux ressources.

Le coût peut augmenter à chaque réutilisation. Cette ligne concerne la même action :

["ExchangeWater", "Cost.Multiplies", 1.5]

Le premier échange demande 20 unités d’Eau et 5 unités d’Énergie. Après la tentative, le suivant passe à 30 unités d’Eau et 7.5 unités d’Énergie avant l’arrondi applicable. La tentative suivante multiplie encore le coût par 1.5. Cela ne bonifie pas les Minéraux reçus. Le jeu conserve l’historique des utilisations. Une nouvelle carte de choix d’événement commence son histoire au coût initial. Examinons séparément le pourcentage d’Invest.

Invest est un choix existant d’investissement dans une expérience. Regardons seulement sa part minérale : le choix conserve aussi son prix en Crédits. Pour l’essai, gardez uniquement dix pour cent de Minéraux. Retirez les parts minérales directes ou adaptées à l’échelle que vous auriez modifiées.

["Invest", "Cost.Minerals.Percent", 10]

Avec 100 Minéraux à l’apparition de l’offre, sa part proportionnelle vaut 10. Avec 20, elle vaut 2. Ces nombres restent fixés dans l’offre : gagner ensuite des Minéraux ne les augmente pas. Un pourcentage positif exige au moins une unité même si le calcul est inférieur. Les Crédits d’Invest se paient séparément.

Ajoutons un minimum explicite de trois Minéraux.

["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]

Avec 20 au départ, le pourcentage donnerait 2, mais Min porte la part minérale à 3. Avec 100, le pourcentage donne 10 et le minimum ne change rien. C’est une borne inférieure, pas un paiement supplémentaire. Le coût en Crédits reste présent.

Ajoutons une part ordinaire de cinq Minéraux au même pourcentage.

["Invest", "Cost.Minerals", 5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]

Avec une réserve initiale de 20, le jeu additionne 5 et 2 pour obtenir 7, puis applique Min 3. La part minérale reste donc 7. Le minimum limite la somme, pas chaque terme séparément. Les Crédits restent à payer séparément.

Une autre part dépend de l’échelle économique. La version suivante remplace le coût direct Cost.Minerals 5 par une part adaptée à l’échelle, tout en gardant pourcentage et minimum.

["Invest", "Cost.Minerals.Scaled", 0.5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]

Avec une échelle de 20 et une réserve de 20, la part adaptée vaut 10 Minéraux et le pourcentage 2. Le total de 12 dépasse le minimum 3. Garder aussi le coût direct 5 l’ajouterait à la somme, pour 17. Les Crédits restent présents. Voici ensuite l’échange et la version proportionnelle initiale d’Invest réunis. Cela n’impose pas de garder toutes les variantes d’apprentissage à la fois.

Le coût de l’exploration existante se définit sur Explore avec Cost.Minerals. L’exemple utilise aussi ExchangeWater, l’action de l’article Action, et Invest, l’investissement existant dans une expérience. Ajoutez d’abord la définition complète d’ExchangeWater dans l’article suivant : les coûts seuls ne créent pas le bouton.

Cost.R de valeur N exige N unités de la ressource déclarée R. Le coût est non négatif. Zéro signifie explicitement gratuit. Une absence de coût n’est pas toujours équivalente : certaines actions deviennent indisponibles. Les actions définies par les données et les choix d’événements peuvent demander plusieurs ressources ensemble. Build, Research, Explore, Colonize, GeoSurvey et Probe lisent une seule ressource de coût direct.

Ce fragment remplace le coût d’ExchangeWater : 20 unités d’Eau et 5 unités d’Énergie, avec chaque tentative suivante 1.5 fois plus chère. Invest reçoit un coût Minéral proportionnel avec minimum 3. Ces valeurs concernent des opérations déjà définies.

["ExchangeWater", "Cost.Water", 20],
["ExchangeWater", "Cost.Energy", 5],
["ExchangeWater", "Cost.Multiplies", 1.5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]
  • Cost.R.Scaled K : coût K × échelle économique de l’événement. Cost.R.Percent N : N pour cent du stock à l’apparition, au moins une unité pour un pourcentage positif. Cost.R.Min borne par le bas la somme des coûts ordinaire, proportionnel et adapté d’une même ressource.
  • Cost.Target = Parent : le choix paie le coût déclaré de sa carte d’origine. Celui-ci doit exister sur l’événement, sans être déduit du nom de réponse.
  • Cost.R.PerTurn N : dépense régulière dans un contexte pris en charge. Pour l’entretien permanent d’un bâtiment, utilisez Upkeep.R. Cost.R près de Production est la matière première par Travailleur, pas le prix d’achat.
  • Cost.R.PerValue K : coût par unité de cargaison ajoutée pour un choix avec Contains.Target et ajout déclaré. Sans cet ajout, cette forme est interdite.
  • Cost.Multiplies K : coefficient de l’utilisation suivante d’une action ou d’une réponse. Le porteur réel de l’application conserve son histoire. Une nouvelle carte repart du coût initial. Ce n’est pas un multiplicateur unique de revenu.

Une réduction utilise un multiplicateur : Multiplies.Cost.Build concerne la construction, Multiplies.Cost.Research la recherche, Multiplies.Cost.Building les bâtiments et Multiplies.Cost.Outpost les avant-postes. Ces ensembles d’achats diffèrent. Cost.Build.Hot et Cost.Build.Distance concernent les majorations de température et d’éloignement. Le multiplicateur de coût ne réduit pas la durée. Si ressource et action portent le même nom, le contexte distingue paiement avec cette ressource et bonus au coût de cette action.

Action - action définie par les données

Créons « Échanger de l’Eau ». Déclarons d’abord l’action :

["ExchangeWater", "Is", "Action"]

ExchangeWater est un nouveau nom et Action un rôle existant. Nous n’avons encore précisé ni où proposer l’action ni son résultat. Donnons-la aux mondes :

["World", "Able", "ExchangeWater"]

Able est la capacité d’exécuter l’action. Quand le joueur sélectionne un World adapté, le jeu peut proposer ExchangeWater. Définissons ensuite le coût et l’attribution unique déjà étudiés :

["ExchangeWater", "Cost.Water", 5],
["ExchangeWater", "Adds.Minerals.Count", 3]

Le joueur paie 5 unités d’Eau et reçoit 3 Minéraux. C’est une opération unique, sans modifier le revenu par tour. Dans un mode à actions longues, le résultat arrive après la tâche. Sa durée de base est définie plus bas par Processing.Duration. Assemblons l’action avec son nom et son icône.

ExchangeWater est le nom inventé de l’action. Ajoutez le fragment suivant au tableau d’un fichier Logic et associez ExchangeWaterName à « Échanger de l’Eau » dans Text/frFR.json. ore_iron existe déjà. Si vous avez ajouté le coût de l’article Cost, choisissez le coût voulu sans le laisser involontairement dans deux fichiers.

Une nouvelle action nécessite au moins un coût ou une attribution unique non nulle. Is Action seul n’explique pas son résultat. Able définit où son bouton apparaît et Requires quand l’utiliser. Requires.Corporation limite une corporation. N’attachez pas l’action avec Corporation Has : le lieu fournit l’action et une condition vérifie la corporation.

["World", "Able", "ExchangeWater"],
["ExchangeWater", "Is", "Action"],
["ExchangeWater", "Name", "ExchangeWaterName"],
["ExchangeWater", "Icon", "ore_iron"],
["ExchangeWater", "Cost.Water", 5],
["ExchangeWater", "Adds.Minerals.Count", 3],
["ExchangeWater", "Processing.Duration", 1]

Créez une nouvelle partie, choisissez un monde et trouvez l’échange. Après exécution, le joueur a 5 unités d’Eau de moins et 3 Minéraux de plus si les limites le permettent. Processing.Duration fixe la durée de base. Le mode peut rendre l’action instantanée. Pour un bouton sans sélection de monde, donnez l’action au joueur plutôt qu’au lieu.

Requires.Corporation CorpRobots la réserverait aux robots. Chance facultatif fixe le risque d’échec, nul par défaut. Une issue défavorable est incluse via Has et marquée Failure. Même un échec peut augmenter le coût suivant.

Augmentons seulement la récompense minérale après chaque tentative. Repartons de l’échange initial : 5 unités d’Eau, 3 Minéraux, sans autre coefficient de répétition. Ajoutons une ligne.

["ExchangeWater", "Adds.Minerals.Count.Multiplies", 2]

La première réussite donne 3 Minéraux, la deuxième 6 et la troisième 12 avant limites. Chacune coûte toujours 5 unités d’Eau : la croissance de récompense n’augmente pas le coût. Le multiplicateur avance après la tentative, donc la première récompense n’est pas encore doublée.

Pour distinguer un multiplicateur d’une seule ressource du multiplicateur commun, ajoutons une deuxième récompense.

["ExchangeWater", "Adds.Energy.Count", 1]

Avec le multiplicateur Minéral précédent, la première donne 3 Minéraux et 1 Énergie, la deuxième 6 Minéraux et toujours 1 Énergie. Adds.Minerals.Count.Multiplies ne nomme pas l’Énergie, qui ne croît donc pas.

Remplaçons le multiplicateur Minéral par un commun : retirez Adds.Minerals.Count.Multiplies 2 et utilisez cette ligne à sa place.

["ExchangeWater", "Adds.Multiplies", 2]

La première réussite donne encore 3 Minéraux et 1 Énergie. La deuxième donne 6 Minéraux et 2 unités d’Énergie : le coefficient commun augmente les deux attributions. Il prend un nombre, pas un intervalle Random.

Reste la différence entre tentative et réception réussie. Pour un essai d’échec distinct, ajoutons une issue défavorable et un risque de 100 %. C’est une variante d’apprentissage, pas un échange utile pour la partie.

["ExchangeWater", "Chance", 100],
["ExchangeWater", "Has", "ExchangeFailed"],
["ExchangeFailed", "Is", "Event"],
["ExchangeFailed", "Is", "Failure"],
["ExchangeWater", "Cost.Multiplies", 2]

La première tentative coûte 5 unités d’Eau et échoue sans récompense. Malgré cela, la deuxième coûte 10 unités d’Eau et sa récompense potentielle vaut déjà 6 Minéraux et 2 unités d’Énergie. Au même risque, elle échoue encore. Si la tentative suivante est rendue réussie pour le test, elle attribue ces quantités. Les histoires de coût et de récompense avancent après une tentative, quel que soit son succès. Pour revenir à l’échange fixe, retirez toutes les lignes de cet essai au lieu de les accumuler dans la recette permanente.

Building, Project, Upgrade - choses constructibles

Déclarons d’abord MyLab comme bâtiment :

["MyLab", "Is", "Building"]

Building classe l’objet comme bâtiment et lui donne les règles générales de construction. Cette ligne ne précise encore ni lieu, coût ni résultat. Indiquons ensuite un laboratoire de surface :

["MyLab", "Is", "SurfaceBuilding"]

SurfaceBuilding est un bâtiment de surface. Un orbital utiliserait Orbital à sa place. Ajoutons les lieux et technologies de Requires, le paiement de Cost, puis revenu et entretien du laboratoire achevé. L’exemple complet rassemble ces parties.

MyLab est un nouveau laboratoire de surface. World est une planète et OutpostConstruction la technologie existante des avant-postes. Après recherche, le laboratoire se construit en Minéraux. Achevé, il donne de la Science et demande de l’Énergie. Cette recette ne crée pas de Travailleurs. Traduisez MyLabName par « Laboratoire ».

SurfaceBuilding signifie surface et Orbital orbite. Requires indique la technologie, les catégories de lieux et, pour Upgrade, la base immédiate. La technologie est vérifiée chez le joueur et le lieu sur le corps sélectionné. World, Giant, Asteroid, Earthlike et les autres catégories déclarées sont possibles.

["MyLab", "Is", "Building"],
["MyLab", "Is", "SurfaceBuilding"],
["MyLab", "Name", "MyLabName"],
["MyLab", "Icon", "outpost"],
["MyLab", "Requires", "World"],
["MyLab", "Requires", "OutpostConstruction"],
["MyLab", "Cost.Minerals", 15],
["MyLab", "Duration", 2],
["MyLab", "Income.Science", 1],
["MyLab", "Upkeep.Energy", 1]

Dans une nouvelle partie, recherchez OutpostConstruction et sélectionnez un monde : le laboratoire devient constructible. Il coûte 15 Minéraux puis donne 1 Science par tour et demande 1 Énergie. Duration 2 définit deux tours de construction de base, pas la durée de vie du bâtiment. Le mode détermine la durée réelle. Les actions ordinaires utilisent Processing.Duration, mais cette recette utilise Duration. Avant recherche, le laboratoire est visible mais indisponible. Définissez explicitement un coût zéro si nécessaire.

Project est un autre résultat de projet de construction. La classification d’un MyProject pourrait commencer ainsi :

["MyProject", "Is", "Project"]

C’est un fragment de classification, pas un projet complet. Project utilise aussi coût et processus de construction, sans être Building : une réduction ciblant Building ne doit pas forcément le concerner. Le laboratoire reste Is Building.

Is Unique supplémentaire limite les instances simultanées. SpaceStation est une famille de stations orbitales dont les variantes peuvent être proposées séparément. Player Has MyLab n’est pas nécessaire pour afficher le laboratoire parmi les constructions. Blocks MyLab sur le lieu, ou un blocage de sa catégorie, interdit la construction même si les exigences de lieu par Or sont satisfaites.

Les conditions peuvent lire Build, l’ensemble des constructions disponibles ici, et Build.Cost, le coût de la moins chère quand une seule ressource de coût existe. Explore.Cost lit le coût actuel d’exploration. Ce sont des résultats calculés, pas des réglages de prix. Target.Build HQ choisit par exemple les lieux où le « Siège social » est réellement constructible, sans répéter ses conditions.

Prenons une amélioration du jeu de base : HQ est le « Siège social » et Metropolis son amélioration en métropole. Metropolis possède déjà Building/SurfaceBuilding, technologie, coût et effet. Les deux entrées illustrent seulement sa base obligatoire, sans créer un nouveau bâtiment vide :

["Metropolis", "Is", "Upgrade"],
["Metropolis", "Requires", "HQ"]

Le joueur doit posséder un HQ achevé au même lieu. L’amélioration remplace une telle base, pas un « Siège social » adverse ni un objet précédent quelconque. MyLab ordinaire sans Upgrade ne remplace rien.

Tech, Researching et Repeatable - recherche

Déclarons MyStudy comme technologie puis ajoutons-la à l’arbre du joueur. Ce sont deux entrées distinctes :

["MyStudy", "Is", "Tech"],
["Player", "Has", "MyStudy"]

Is Tech définit le rôle et Player Has ajoute la technologie à l’ensemble de chaque joueur. L’un peut la rechercher et l’autre la laisser inconnue. Ajoutons un bonus actif uniquement après achèvement :

["MyStudy", "Adds.Income.Science", 1]

La première recherche ajoute 1 Science par tour. Une entrée distincte autorise une deuxième recherche de la même technologie :

["MyStudy", "Repeatable", true]

Le deuxième niveau achevé ajoute maintenant encore 1, soit 2 unités de Science par tour au total. Pendant sa recherche, le premier niveau reste actif. L’ensemble complet suivant ajoute nom, icône et prédécesseur, sans remplacer Repeatable.

Ajoutons MyStudy, « Études de terrain ». Il faut d’abord rechercher OutpostConstruction existante. Chaque niveau achevé ajoute ensuite 1 Science par tour. Ajoutez le fragment dans Logic et MyStudyName avec « Études de terrain » dans Text/frFR.json.

Is Tech déclare le type de chose et Player Has l’intègre à l’arbre de chaque joueur. Chacun possède sa propre instance et son état de recherche. Requires définit les prédécesseurs, Or les alternatives et Tier/Order la position. Adds et Multiplies permanents agissent après recherche, y compris sur les futures possessions adaptées. Cela ne donne pas de récompense unique.

["MyStudy", "Is", "Tech"],
["MyStudy", "Name", "MyStudyName"],
["MyStudy", "Icon", "flask"],
["MyStudy", "Tier", 2],
["MyStudy", "Requires", "OutpostConstruction"],
["MyStudy", "Adds.Income.Science", 1],
["MyStudy", "Repeatable", true],
["Player", "Has", "MyStudy"]

Researching est l’état d’instance InProgress ou Done. Son absence signifie que la première recherche n’a pas commencé. Ne mettez pas Done sur une définition pour simuler une technologie initiale. Repeatable autorise logiquement la répétition et false propre l’emporte sur true hérité. Level conserve les recherches achevées. Les niveaux précédents restent actifs pendant la répétition. Annuler la première retire le statut et annuler une répétition garde les niveaux achevés.

Une technologie peut ne posséder aucun Adds ni Multiplies numérique. Is Tech, son inclusion dans Player.Has, son nom, son icône, sa position et son coût suffisent. Son seul résultat peut être l’accès à un événement ou une mission : indiquez Requires.Researched avec cette technologie sur la carte débloquée. Avec un Name sur celle-ci, le résumé technologique affiche automatiquement « Débloque un événement » et son nom. Un paquet imbriqué sans nom ne produit pas cette ligne. Aucun faux bonus ni liste d’accès dupliquée n’est nécessaire.

Le coût par défaut vient de Cost.R sur Research et sa croissance de Cost.Multiplies. Après chaque recherche du joueur, répétitions comprises, un coefficient supérieur à 1 multiplie la base déjà arrondie. Avec une base 10 et 1.23, on obtient 10, 13, 16, 20. Les réductions personnelles s’appliquent ensuite sans réduire la base suivante. Cost.R et Cost.Multiplies propres à la technologie remplacent les réglages correspondants de Research. Sans croissance ou avec un coefficient au plus 1, la base reste identique. Tier ne change pas le coût.

Rule.AccumulatedResearch true active le paiement par réserve accumulée : la technologie choisie attend le coût de Science courant puis le prélève entièrement. L’annulation conserve la réserve. En mode ordinaire, Research paie et termine immédiatement. Researching.Steps est le nombre minimal calculé de recherches jusqu’à la cible, elle-même et ses prérequis communs compris. Il ne se définit pas à la main. Then relie un événement après recherche, pas une récompense unique dans Tech.

Processing et Duration - tâches et durées

Réglons d’abord la durée d’ExchangeWater déjà créé dans Action. Cette ligne donne trois tours de base :

["ExchangeWater", "Processing.Duration", 3]

Dans un mode à actions longues, l’échange crée une tâche dont le résultat arrive après achèvement. Un mode instantané peut ramener la durée réelle à zéro. Cost définit toujours le prix. Processing.Duration ne le modifie pas.

Une fois la tâche créée, son lieu de travail reçoit le lien Processing. Le bloc suivant est uniquement un exemple de lecture de partie. Ne l’écrivez pas dans le mod :

["Earth_0", "Processing", "Construction_0"],
["Construction_0", "Progress", 2]

La première ligne dit qu’Earth_0 porte la tâche Construction_0. La deuxième qu’elle a effectué 2 pas de travail. Ce ne sont ni deux nouvelles durées ni deux bâtiments. Processing est le lien, Progress le travail accompli et Duration la durée requise. Les noms d’instances peuvent varier entre parties.

Progress compte les pas accomplis d’une tâche longue. Les ressources payées sont conservées séparément. Une tâche à Travailleurs peut suivre une ressource accumulée et son seuil. Les tours écoulés ne sont pas du travail accompli : sans paiement, elle attend. Progress a aussi des usages de confrontation sur les événements, détaillés séparément.

La fin du décompte dépend de l’objet. Duration d’un bâtiment est la durée de construction, sans disparition du bâtiment achevé. Processing.Duration d’une action est la durée de sa tâche. Duration d’un événement temporaire est le délai d’expiration du message et de son effet.

La tâche est payée par contributions après chaque pas réussi. À prix fixe de 12 Minéraux sur 3 pas, chaque contribution vaut 4. Après deux pas, 8 sont payés. Si une ressource manque pour le troisième, tout le pas attend sans prélèvement partiel ni résultat. Travail et paiement persistent après chargement. Une modification du coût ou de la durée tient compte des paiements déjà faits. Si le nouveau coût tombe sous le montant payé, le surplus n’est pas rendu.

L’annulation supprime la tâche et libère ses Travailleurs. Les contributions déjà payées ne reviennent pas, la construction inachevée ne donne pas de bâtiment et l’exploration ne révèle pas le corps. La recherche accumulée est différente : elle attend toute la réserve sans contributions intermédiaires, donc l’annulation conserve le stock.

Un JSON ne peut pas déclarer un Cancel.Refund arbitraire ni un gestionnaire de fin par son nom. Démolir un bâtiment achevé est l’action Demolish et son remboursement propre, pas une annulation. Duration d’un Event ordinaire est la vie de l’effet, pas des contributions financières. Une Mission lancée possède son propre achèvement selon Duration.

Processing.Duration d’une action définit le nombre de tours de base, 1 sans entrée. L’action détermine le résultat : construction d’un bâtiment, révélation d’un corps ou attribution de ressource. Un nom de tâche inventé seul ne définit pas ce résultat.

ExchangeWater est l’échange d’Action avec Is Action, coût, récompense unique et World Able ExchangeWater. Explore est l’exploration existante et NuclearDrives la technologie existante de propulsion nucléaire. Ce bloc change seulement la durée des opérations existantes ou déjà déclarées.

["ExchangeWater", "Processing.Duration", 3],
["Explore", "Processing.Duration", 1],
["NuclearDrives", "Adds.Explore.Duration", -1]

L’exploration combine durée de base, distance orbitale du monde natal et ajouts Explore.Duration, avec arrondi supérieur et minimum d’un tour. Une réduction de coût ne raccourcit pas la durée. Multiplies.Action.Duration 0 désactive les actions temporisées. Construction et exploration suivent ensuite Rule.ProgressTasks. Ce sont des modes existants, pas une méthode générale pour faire de tout événement une tâche.

Processing sur un objet en cours de partie renvoie à la tâche créée. Progress conserve les tours accomplis et ses quantités de ressources les paiements réels. Processing.Accumulates concerne un processus accumulatif créé. Ces entrées appartiennent au jeu. Ne les ajoutez pas au mod à la place d’une action. Une tâche de travail utilise les Travailleurs affectés et les unités approvisionnées. Un nouveau nom de type de tâche ne crée pas sa fin.

Duration seul sur un événement, effet ou entité en cours de partie donne sa durée de vie en tours. L’absence signifie durée illimitée. Le tour de naissance ne la réduit pas. À expiration, l’issue déclarée s’exécute, puis l’entité et ses contributions temporaires sont retirées. Une résolution anticipée ou destruction n’est pas une expiration. Pour Mission, Duration est le voyage et Expires la durée de l’offre. Duration.Turn est une marque interne, pas un paramètre d’auteur.

Creates et Then - résultat et continuation

Un travail achevé doit souvent poursuivre le récit : un bâtiment terminé fait choisir une fin, une recherche ouvre un autre groupe d’événements. Then relie un résultat existant à cette suite. Creates nomme ce que doit créer un mécanisme qui le prend en charge, sans rien exécuter seul.

Poursuivons une vraie construction. WarpDrivePrototype est le prototype existant et WarpVictories son groupe de fins :

["WarpDrivePrototype", "Then", "WarpVictories"]

Le jeu ne transmet la suite à WarpVictories qu’après achèvement du prototype. Le groupe choisit le résultat disponible. Then ne construit pas le prototype et n’annule pas son coût. Une transmission ordinaire respecte Turn.Pause du groupe.

Then.Now sur un événement lance une suite immédiate. TutorialContinue et Quests sont la continuation existante du tutoriel et le groupe de tâches.

["WarpDrivePrototype", "Then", "WarpVictories"],
["TutorialContinue", "Then.Now", "Quests"]

Quand le prototype s’achève réellement, Then passe le choix au groupe de fins. Then.Now exécute immédiatement la continuation. Then ordinaire d’un groupe respecte Turn.Pause. Une référence seule ne fait pas d’un nom arbitraire un événement.

Creates utilise aussi le tutoriel existant : Tut29 est son étape déclarée, TutorialAsteroid l’événement d’astéroïde créé et Europa un corps du scénario.

["Tut29", "Creates", "TutorialAsteroid"],
["Tut29", "Creates.Target", "Europa"]

L’astéroïde est créé quand le tutoriel solaire atteint Tut29. Ces lignes n’activent pas l’apprentissage dans un autre scénario et ne créent rien au chargement du fichier. Une étape personnalisée exige Is TutorialStep, son inclusion, son ordre et ses conditions de transition, expliqués dans Tutorial.

Toggle - choix de politique d’un indicateur

Les politiques basculantes via Is Toggle et Stat ne font pas partie des possibilités de mod prises en charge par la Pre-Warp Age actuelle. Ces entrées ne créent pas de boutons de politique et une ligne avec le prédicat Stat échoue au chargement.

Pour un bonus scientifique permanent après recherche, utilisez une technologie avec Adds.Income.Science. « Tech, Researching et Repeatable » explique son intégration complète. Ce sera un bonus à rechercher, pas un sélecteur avec deux boutons de politique.

Événements, choix, missions et tâches

Events et Event - groupe et événement de jeu

Créons un événement qui donne une seule fois des Minéraux au joueur et ajoutons-le aux événements aléatoires. Déclarons d’abord l’événement lui-même. Nous appellerons son message d’interface une carte. La définition du fichier et son apparition précise dans la partie sont distinctes.

["MySupply", "Is", "Event"],
["MySupply", "Adds.Minerals.Count.Scaled", 1]

Event déclare l’événement et Adds.Minerals.Count.Scaled 1 définit l’attribution unique selon l’échelle économique du joueur. À une échelle de 11, il reçoit 11 Minéraux avant les limites de réserve. Charger la définition ne donne encore rien : l’événement doit se produire.

Ajoutons MySupply au groupe RandomEvents existant.

["RandomEvents", "Deck.MySupply", 1]

Deck.MySupply 1 ajoute une carte au paquet. Le groupe Events choisit selon sa programmation Turn. Le joueur reçoit les Minéraux quand MySupply est choisi et lancé, pas à l’activation du mod. Has n’est pas nécessaire pour l’inclusion au paquet. Ajoutons sa présentation.

Is Events déclare un groupe ou un paquet imbriqué, Is Event un événement. Nom, description, icône, lieu et conséquences en définissent le résultat : attribuer une ressource, activer un effet, proposer des choix, attendre ou lancer une mission. Is Event seul, sans contenu, ne suffit pas.

Le fragment ajoute MySupply avec des Minéraux uniques à RandomEvents. Deck.MySupply définit l’inclusion, sans Has. Ajoutez MySupplyName, par exemple « Minéraux supplémentaires », et MySupplyDescription expliquant la réception dans Text/frFR.json.

["MySupply", "Is", "Event"],
["MySupply", "Name", "MySupplyName"],
["MySupply", "Description", "MySupplyDescription"],
["MySupply", "Icon", "ore_iron"],
["MySupply", "Adds.Minerals.Count.Scaled", 1],
["RandomEvents", "Deck.MySupply", 1]

L’événement apparaît quand RandomEvents le choisit, pas à l’installation. Scaled calcule les Minéraux selon l’échelle économique. Une attribution unique utilise ici Scaled : Adds.Minerals.Count fixe seul sur un Event indépendant ne donne pas la ressource de la même façon. L’article suivant montre la récompense fixe sur une issue de choix. Requires.Turn.Min limite le tour d’apparition, Requires.Researched vérifie une technologie et Target choisit séparément le lieu. Une carte temporairement indisponible retourne au paquet.

Pour un événement qui reste ouvert, vous pouvez interdire une deuxième carte simultanée. Ajoutons cette restriction à la comète existante.

["CometMinerals", "Is", "Unique"]

Tant que le joueur possède CometMinerals, une deuxième comète identique n’apparaît pas. Une fois la première fermée, un nouveau tirage redevient possible. Une autre catégorie interdit toute répétition après un tirage réussi.

["MySupply", "Is", "Once"]

Avec Once, MySupply ne peut survenir qu’une fois par partie. Après avoir donné ses Minéraux, il ne les redonne plus. Ce n’est pas une limite de fenêtres ouvertes simultanément. L’incompatibilité entre deux événements est encore indépendante.

["MySupply", "Conflicts", "CometMinerals"]

Tant que la comète CometMinerals est ouverte, MySupply n’apparaît pas. Le lien fonctionne aussi en sens inverse. Utilisez ces restrictions séparément selon le besoin. Events.Level, Held et les compteurs de tirage sont des états de partie. Ne les écrivez pas dans le mod.

Autre limite : la pause du tutoriel. Elle n’est pas nécessaire pour un paquet personnalisé ordinaire.

Events.Hold true sur Simulation active la pause générale de programmation utilisée par le tutoriel. Les échéances des groupes sont repoussées des tours écoulés. Ni cartes régulières ni branches conditionnelles des groupes ne sont tirées. Les événements existants ne peuvent pas non plus se résoudre tôt par des Requires/Goal enfants, y compris à une borne de Progress.

Après retrait de la pause, les branches appropriées sont de nouveau vérifiées lors des changements d’état. N’utilisez donc pas Hold seulement pour neutraliser un paquet gênant : modifiez le contenu du groupe précis.

Events.Hold n’arrête pas le temps du monde : Duration et les pas Progress des cartes existantes continuent. L’expiration autorise son issue et les branches de pas Progress déclenchées avec leurs Has peuvent donner des conséquences directes. Les événements créés explicitement par une action ou une continuation ne deviennent pas automatiquement interdits.

Dans vos scénarios, laissez Events.Hold absent ou false sauf si cette pause partielle est voulue. Ne gardez pas true en permanence en espérant conserver les résolutions anticipées Goal/Progress.

Pour une récompense unique, Adds.Minerals.Count.Scaled et Adds.Minerals.Scaled court donnent la quantité selon l’échelle économique. L’ancien Adds.Minerals.Percent n’est pas pris en charge pour une récompense : Contains.Percent décrit la part de réserve dans une cargaison d’événement. « EventChoice, Failure et issues de choix » montre Adds.Minerals.Count fixe.

EventChoice, Failure et issues de choix

EventChoice est une décision dans la fenêtre d’événement. Le joueur choisit, paie son coût et reçoit une issue Event. Une issue défavorable porte aussi Failure. Des échantillons peuvent par exemple être recyclés en Minéraux ou étudiés pour un revenu scientifique temporaire. Un choix exclut l’autre.

Commençons par un seul bouton du futur exemple : recycler les échantillons. C’est un fragment de préparation, pas un événement indépendant.

["OGSampleDilemma", "Has", "OGRecycleSamples"],
["OGRecycleSamples", "Is", "EventChoice"]

Has relie l’offre OGSampleDilemma au bouton OGRecycleSamples et EventChoice lui donne son rôle. Cela n’attribue encore aucun Minéral : le bouton n’a pas de résultat.

Donnons-lui une unique issue réussie.

["OGRecycleSamples", "Has", "OGSamplesRecycled"],
["OGSamplesRecycled", "Is", "Event"],
["OGSamplesRecycled", "Adds.Minerals.Count", 8]

Le deuxième Has va cette fois du bouton au résultat. Après choix, l’issue ajoute une fois 8 Minéraux : une réserve de 10 devient 18 si la limite le permet. La récompense appartient au résultat, pas au bouton. Nous assemblerons ensuite cette décision avec la deuxième et la présentation. Un même choix peut figurer dans plusieurs événements : il agit sur la carte où il est sélectionné.

Pour le deuxième bouton, reprenons le revenu scientifique connu et ajoutons une durée.

["OGSampleResearch", "Is", "Event"],
["OGSampleResearch", "Adds.Income.Science", 2],
["OGSampleResearch", "Duration", 3]

Si ce choix lance l’issue, le joueur reçoit 2 unités de Science supplémentaires sur chacun des trois tours suivants. Ensuite, seul cet ajout disparaît. Un revenu permanent de 5 passe temporairement à 7, puis revient à 5. Duration appartient à l’issue qui donne le bonus.

Une issue réussie possède Is Event. Une défavorable ajoute Is Failure. Nous reviendrons au risque après l’exemple fonctionnel sans hasard.

Enregistrez le tableau complet dans Logic/Samples.json et son dictionnaire dans Text/frFR.json. Si ce fichier existe, ajoutez les clés dans son objet en gardant les traductions présentes. Activez le mod, créez une nouvelle partie et attendez « Échantillons géologiques » dans RandomEvents. Le premier choix donne 8 Minéraux, le deuxième 2 unités de Science par tour sur trois tours.

[
  ["OGSampleDilemma", "Is", "Event"],
  ["OGSampleDilemma", "Name", "OGSampleDilemmaName"],
  ["OGSampleDilemma", "Description", "OGSampleDilemmaDesc"],
  ["OGSampleDilemma", "Icon", "ore_iron"],
  ["OGSampleDilemma", "Has", "OGRecycleSamples"],
  ["OGSampleDilemma", "Has", "OGStudySamples"],
  ["RandomEvents", "Deck.OGSampleDilemma", 1],
  ["OGRecycleSamples", "Is", "EventChoice"],
  ["OGRecycleSamples", "Name", "OGRecycleSamplesName"],
  ["OGRecycleSamples", "Description", "OGRecycleSamplesDesc"],
  ["OGRecycleSamples", "Icon", "ore_iron"],
  ["OGRecycleSamples", "Order", 1],
  ["OGRecycleSamples", "Cost.Credits", 0],
  ["OGRecycleSamples", "Has", "OGSamplesRecycled"],
  ["OGSamplesRecycled", "Is", "Event"],
  ["OGSamplesRecycled", "Name", "OGSamplesRecycledName"],
  ["OGSamplesRecycled", "Description", "OGSamplesRecycledDesc"],
  ["OGSamplesRecycled", "Icon", "ore_iron"],
  ["OGSamplesRecycled", "Adds.Minerals.Count", 8],
  ["OGStudySamples", "Is", "EventChoice"],
  ["OGStudySamples", "Name", "OGStudySamplesName"],
  ["OGStudySamples", "Description", "OGStudySamplesDesc"],
  ["OGStudySamples", "Icon", "flask"],
  ["OGStudySamples", "Order", 2],
  ["OGStudySamples", "Cost.Credits", 0],
  ["OGStudySamples", "Has", "OGSampleResearch"],
  ["OGSampleResearch", "Is", "Event"],
  ["OGSampleResearch", "Name", "OGSampleResearchName"],
  ["OGSampleResearch", "Description", "OGSampleResearchDesc"],
  ["OGSampleResearch", "Icon", "flask"],
  ["OGSampleResearch", "Duration", 3],
  ["OGSampleResearch", "Adds.Income.Science", 2]
]

Contenu de Text/frFR.json pour cet exemple :

{
  "OGSampleDilemmaName": "Échantillons géologiques",
  "OGSampleDilemmaDesc": "Les échantillons peuvent être recyclés ou étudiés.",
  "OGRecycleSamplesName": "Recycler les échantillons",
  "OGRecycleSamplesDesc": "Récupérer les Minéraux de la roche collectée.",
  "OGSamplesRecycledName": "Échantillons recyclés",
  "OGSamplesRecycledDesc": "Les matières premières ont été mises en réserve.",
  "OGStudySamplesName": "Étudier les échantillons",
  "OGStudySamplesDesc": "Mener un programme de recherche temporaire.",
  "OGSampleResearchName": "Étude des échantillons",
  "OGSampleResearchDesc": "Les échantillons contribuent aux recherches en cours."
}

Les deux choix sont gratuits : Cost.Credits 0 signifie explicitement zéro, pas un Crédit. Un seul résultat est choisi. Le premier donne exactement huit Minéraux avant limites de réserve. Le deuxième crée +2 de revenu scientifique sur les trois tours suivants, puis retire seulement son bonus. Duration appartient à l’issue temporaire, pas au choix gratuit ni à l’offre.

Repérez la récompense : Adds.Minerals.Count est sur OGSamplesRecycled, pas sur OGRecycleSamples. Choisir lance l’attribution fixe. Déplacer cette ligne vers un Event indépendant vide ne donne pas les Minéraux de la même manière. Pour un événement sans choix, utilisez Scaled de l’article précédent.

Requires d’un choix vérifie le joueur, pas le corps cible de la carte. Une réponse indisponible reste grise sans prélèvement. Ne comptez pas sur l’héritage Requires d’une réponse descendante : définissez sa condition explicitement. Order détermine l’ordre des choix.

L’offre sans Duration attend une réponse et bloque la fin du tour. Avec Duration positif, le joueur peut différer jusqu’à expiration, sans que l’attente attribue la récompense. Si une issue possède ses propres choix ou un effet long, elle devient un événement distinct et reçoit la cible admissible de l’offre d’origine.

Un événement peut avertir puis donner son résultat après attente. Aucune nouvelle catégorie n’est nécessaire : Is Event suffit et Has sur l’événement vise des issues Is Event au lieu de boutons Is EventChoice. Duration fixe l’attente. À expiration, le jeu choisit une issue appropriée et, en présence de risque, distingue succès et Failure selon celui-ci.

Sans Duration, un événement avec ces issues détermine son résultat dès l’apparition. Si un choix défensif retire l’avertissement avant expiration, l’issue différée ne se produit pas. Ne transposez pas Has avec des résultats à la racine de l’offre d’échantillons : cela changerait la méthode et le moment de réception.

Après un choix ordinaire, ajoutons du risque. RiskTest est une alternative à le dilemme simple, pas un complément obligatoire. L’exemple possède déjà rôles, Has et inclusion dans RandomEvents.

Définissons d’abord un unique pourcentage de risque pour la future carte RiskTest. C’est une partie de l’exemple distinct ci-dessous.

["RiskTest", "Chance.Deck.25", 1]

Chance.Deck choisit le pourcentage d’échec à la naissance. L’unique carte 25 donne un risque de 25 % et un succès de 75 %. Ce n’est pas la probabilité d’apparition de RiskTest.

Autorisons deux risques possibles avec un nombre égal de cartes.

["RiskTest", "Chance.Deck.25", 1],
["RiskTest", "Chance.Deck.50", 1]

À l’apparition de la carte précise, le risque devient 25 % ou 50 %. Il reste ensuite conservé : afficher la fenêtre ne le relance pas. L’ensemble complet donne au bouton un succès et deux échecs.

Distinguons enfin un échec léger et un lourd. Les deux doivent être déclarés Failure et appartenir au Has du bouton.

["AttemptRiskTest", "Deck.RiskLostSmall", 1],
["AttemptRiskTest", "Deck.RiskLostLarge", 1]

Ce Deck choisit la gravité uniquement après un échec. À risque conservé de 25 %, le succès vaut 75 % et chaque échec 12.5 %. À risque 50 %, le succès vaut 50 % et chaque échec 25 %. Voici tous les rôles, liens et récompenses réunis.

Les pourcentages d’auteur vont de 0 à 100. À droite de Chance.Deck figurent des nombres finis de cartes, éventuellement fractionnaires. Un reliquat positif participe et un tirage dépense min(1, reliquat). Les cartes non positives sont exclues.

Deck sur EventChoice utilise des poids finis pour un choix proportionnel unique. Seuls les poids positifs participent, fractions comprises. Ce choix ne diminue pas le reliquat d’un paquet ordinaire.

["RiskTest", "Is", "Event"],
["RiskTest", "Name", "RiskTestName"],
["RiskTest", "Icon", "flask"],
["RiskTest", "Chance.Deck.25", 1],
["RiskTest", "Chance.Deck.50", 1],
["RiskTest", "Has", "AttemptRiskTest"],
["AttemptRiskTest", "Is", "EventChoice"],
["AttemptRiskTest", "Name", "AttemptRiskTestName"],
["AttemptRiskTest", "Cost.Credits", 0],
["AttemptRiskTest", "Has", "RiskWon"],
["AttemptRiskTest", "Has", "RiskLostSmall"],
["AttemptRiskTest", "Has", "RiskLostLarge"],
["AttemptRiskTest", "Deck.RiskLostSmall", 1],
["AttemptRiskTest", "Deck.RiskLostLarge", 1],
["RiskWon", "Is", "Event"],
["RiskWon", "Name", "RiskWonName"],
["RiskWon", "Adds.Science.Count", 5],
["RiskLostSmall", "Is", "Event"],
["RiskLostSmall", "Is", "Failure"],
["RiskLostSmall", "Name", "RiskLostSmallName"],
["RiskLostSmall", "Adds.Minerals.Count", -1],
["RiskLostLarge", "Is", "Event"],
["RiskLostLarge", "Is", "Failure"],
["RiskLostLarge", "Name", "RiskLostLargeName"],
["RiskLostLarge", "Adds.Minerals.Count", -5],
["RandomEvents", "Deck.RiskTest", 1]
  • Un succès Has sans Failure : choix sûr. Le risque général de la carte n’invente pas un échec absent.
  • Un succès et un Failure dans Has : test ordinaire selon le risque de la carte. Aucun échec n’est inventé sans risque.
  • Plusieurs Failure : Deck obligatoire sur la réponse. Chaque carte doit être aussi une issue Has de celle-ci et Is Failure. Le paquet ne choisit pas entre résultats réussis.
  • Plusieurs Has réussis ne s’exécutent pas tous. Le premier approprié est choisi selon Order puis l’identifiant de définition en comparaison ordinale, pas selon Name traduit. Gardez un seul succès ou des conditions disjointes pour éviter l’ambiguïté.
  • Chance.Add avec Chance.Target Parent.Part améliore une chance de branche Progress, comme plus bas, pas le risque d’échec conservé de RiskTest. Mission et Risk servent à un risque général modifiable. Chance.Target Parent sur Event ordinaire n’est pas pris en charge.

Le risque est conservé sur la carte précise de mission ou de paquet risqué. Has relie succès et échecs et Deck du choix peut répartir plusieurs échecs. Ce n’est pas un ordre d’appels JSON. Dégâts, changement Progress, cargaison ou amélioration de mission peuvent laisser la carte d’origine active. Le résultat vient de l’opération précise, pas du nom de réponse.

Effets temporaires et Blocks

Un effet temporaire agit pendant le nombre de tours indiqué puis est retiré. Une saison peut par exemple donner 20 % d’Énergie en plus sur cinq tours. Blocks interdit une construction, action, croissance ou autre notion prise en charge. Durée et interdiction sont des propriétés indépendantes.

Définissons seulement le bonus temporaire. MyEnergySeason est un nom d’événement inventé. Le multiplicateur connu reçoit ici une durée.

["MyEnergySeason", "Is", "Event"],
["MyEnergySeason", "Multiplies.Income.Energy", 1.2],
["MyEnergySeason", "Duration", 5]

Après apparition, un revenu énergétique de 10 devient 12 pendant cinq tours suivants. Le multiplicateur disparaît ensuite et le revenu revient à 10 si rien d’autre n’a changé. Ajoutons nom, icône et inclusion dans RandomEvents pour l’afficher. L’ensemble figure plus bas. Traduisez MyEnergySeasonName dans Text/frFR.json, par exemple « Saison énergétique ».

Autre tâche : interdire les pénalités de missions en « Méditation ». La durée du bonus n’est pas nécessaire.

["ModeMeditation", "Blocks", "QuestPenalty"]

ModeMeditation est le mode existant et QuestPenalty la catégorie existante de pénalités de tâches. Blocks l’interdit pour une partie avec ce mode. Cela ne change pas l’Énergie et ne limite pas l’interdiction à cinq tours. Les deux réglages indépendants sont simplement écrits côte à côte.

Sans Duration, l’effet numérique persiste après le message. Ses répétitions cumulent les ajouts ou réappliquent les multiplicateurs. Duration le rend temporaire. À la fin, seule sa contribution disparaît. Les autres bonus et la base restent présents. Fermer le message ne remplace pas l’expiration de la capacité.

["MyEnergySeason", "Is", "Event"],
["MyEnergySeason", "Name", "MyEnergySeasonName"],
["MyEnergySeason", "Icon", "energy"],
["MyEnergySeason", "Duration", 5],
["MyEnergySeason", "Multiplies.Income.Energy", 1.2],
["ModeMeditation", "Blocks", "QuestPenalty"],
["RandomEvents", "Deck.MyEnergySeason", 1]

Sur une corporation choisie, Blocks interdit la notion ou le flux à son joueur. Sur un mode, il devient règle de partie. Blocks Growth.Workers désactive la croissance naturelle et Blocks Upkeep.Water la consommation d’Eau d’entretien. Il faut une catégorie déclarée ou un champ pris en charge. L’interdiction ne s’étend pas à tout ce qui porte un lien indirect avec ce nom.

Sur un événement, Blocks World ou Blocks Icy désigne des catégories de lieux pour un blocus. Duration positif est obligatoire. Un lieu précis est choisi à l’apparition, puis ses consommateurs et places de travail sont désactivés. Après le dernier blocus, le travail redevient permis. Cela diffère d’Earthlike Blocks Outpost, qui interdit un avant-poste sur un monde terrestre.

Ne combinez pas la carte de blocus elle-même avec Adds.Minerals.Scaled unique ou une modification unique Target.Adds. Le tirage ordinaire la traiterait comme un changement unique sans activer le blocus. Définissez une issue distincte pour une récompense après la fin du blocus.

Resource - choix de ressource à l’exploration

Après exploration, un corps propose parfois plusieurs ressources. Le joueur en choisit une à extraire et la fenêtre montre d’avance chaque taux. Resource d’un tel choix est la ressource du monde, sans attribution à la réserve.

WorkFocus est la fenêtre existante du choix d’extraction et FocusMinerals son option minérale. Le fragment montre le lien complet avec cette fenêtre. Parent.Target est le corps exploré de WorkFocus.

Resource avec une ressource déclarée nomme le choix d’exploration, pas le stock. EventChoice exige Resource.Target avec un chemin explicite au corps, comme Parent.Target. Le rendement est tiré à la naissance de l’offre, affiché et appliqué au corps après choix. Une ressource incompatible n’est pas proposée.

["WorkFocus", "Has", "FocusMinerals"],
["FocusMinerals", "Is", "EventChoice"],
["FocusMinerals", "Name", "Minerals"],
["FocusMinerals", "Resource", "Minerals"],
["FocusMinerals", "Resource.Target", "Parent.Target"]

Explore ouvre WorkFocus quand plusieurs candidats sont compatibles. Si les paquets du corps n’acceptent pas de Minéraux, l’option n’apparaît pas. Le fragment ne rend pas chaque monde minéral. Une nouvelle ressource exige sa déclaration, la réserve du joueur, les paquets compatibles du corps et cet EventChoice relié. L’exemple complet de cryominerai figure dans la génération des ressources.

Find - découverte et sonde

Une découverte est un objet inconnu ou une cache sur un corps révélé. Une distribution distincte la place et le joueur peut la sonder avec Probe en payant. Son résultat est un événement, pas l’ouverture automatique d’une ressource en réserve.

MyCache est une nouvelle découverte et MyFinds son paquet pour ScenarioG existant. Rocky est la catégorie de lieu rocheux. Le résultat utilise SuppliesMinerals existant, qui possède déjà Event, récompense, nom et présentation.

Déclarons la découverte et le coût de sa sonde.

["MyCache", "Is", "Find"],
["MyCache", "Cost.Minerals", 5]

MyCache devient une découverte. Probe paie une base de 5 Minéraux, avec un coût final soumis aux multiplicateurs d’exploration. C’est un prix d’étude, pas sa récompense.

Indiquons les lieux admissibles et le résultat de la sonde.

["MyCache", "Target", "Rocky"],
["MyCache", "Deck.SuppliesMinerals", 1]

Cette partie concerne les corps rocheux. Après paiement, SuppliesMinerals donne une seule fois des Minéraux. L’événement définit leur quantité et Cost de la découverte ne la change pas. Pour plusieurs catégories de lieux, utilisez des parties distinctes de découverte avec leurs Target et Deck. Deux contenus de résultats différents pour un même contexte sont ambigus.

Il reste à répartir les découvertes sur les nouveaux corps révélés du scénario.

["MyFinds", "Deck.MyCache", 1],
["MyFinds", "Deck.None", 3],
["ScenarioG", "Has", "MyFinds"]

Le paquet contient une découverte et trois cartes vides. Sur quatre corps adaptés tirés sans remise, une carte donne MyCache et trois aucune découverte. Voici les liens et la présentation réunis. N’écrivez pas Find None sur un corps vivant : cela marque une distribution déjà effectuée.

["MyCache", "Is", "Find"],
["MyCache", "Name", "MyCacheName"],
["MyCache", "Icon", "question"],
["MyCache", "Cost.Minerals", 5],
["MyCache", "Target", "Rocky"],
["MyCache", "Deck.SuppliesMinerals", 1],
["MyFinds", "Deck.MyCache", 1],
["MyFinds", "Deck.None", 3],
["ScenarioG", "Has", "MyFinds"]

À la première révélation des corps adaptés du scénario, le paquet distribue découverte ou None sans remise. SuppliesMinerals est déjà défini dans le jeu de base. La découverte et son contexte de cible concernent ici les corps rocheux. None est une carte vide du paquet. Sur un corps prédéfini sans découverte, n’écrivez pas Find None : ce fait marquerait une distribution déjà passée.

BodyClass Find MyCache fixe une découverte d’auteur, prioritaire sur le tirage. Probe utilise les multiplicateurs d’exploration et le mode choisi. Après étude, la découverte est retirée et son issue apparaît sur le même corps. Si le résultat augmente l’extraction d’une ressource choisie, cette ressource doit être définie, sinon l’étude est indisponible. Le paquet des issues appartient à la découverte, pas à Find.MyCache.Deck sur le corps.

Contains - cargaison d’un événement

La cargaison appartient à l’offre active avant que le joueur la récupère. Une comète contient par exemple un nombre conservé de Minéraux, transféré en réserve après collecte réussie. Une autre réponse peut augmenter la cargaison de cette carte sans la prendre ni fermer l’offre.

Choisissons le contenu de CometMinerals existante. Son nom, son icône et ses choix n’ont pas à être répétés.

["CometMinerals", "Contains", "Minerals"]

Contains nomme la ressource de cargaison, ici les Minéraux. Ce n’est pas encore un apport au stock du joueur. Sans quantité distincte, le jeu la calcule avec une échelle économique de 1 à l’apparition et conserve le résultat.

Définissons la cargaison comme fraction de réserve. CometMinerals possède déjà Contains.Scaled, mais Contains.Percent est prioritaire. Il n’est pas nécessaire de supprimer l’ancienne entrée pour cet exemple.

["CometMinerals", "Contains", "Minerals"],
["CometMinerals", "Contains.Percent", 10]

Avec 100 Minéraux à l’apparition, la cargaison vaut 10. Si la réserve passe à 200 ensuite, elle reste de 10, car elle a été conservée. Une cargaison positive a un minimum de 1. La ressource doit être déclarée. L’exemple suivant utilise Contains.Scaled 2.5 pour multiplier l’échelle économique par 2.5. Retirez Contains.Percent, sinon le pourcentage reste prioritaire.

CometMinerals est la comète minérale existante, CometCollect son choix de collecte et CometReturn son succès. Tous trois sont déjà déclarés et reliés. Le fragment montre la chaîne obligatoire :

["CometMinerals", "Contains", "Minerals"],
["CometMinerals", "Contains.Scaled", 2.5],
["CometMinerals", "Has", "CometCollect"],
["CometCollect", "Has", "CometReturn"],
["CometReturn", "Contains.Target", "Parent"]

À une échelle économique de 10, la cargaison vaut 10 × 2,5 = 25 Minéraux, fixés à l’apparition. Avec 100 en réserve avant une collecte réussie, CometReturn transfère les 25 conservés et donne 125. L’apparition seule ne change pas la réserve. Le risque existant de CometCollect reste présent : Contains ne l’annule pas.

Pour augmenter une cargaison, prenons la chaîne existante SpaceFashion, flux de Travailleurs souhaitant immigrer, et SpaceFashionBoost, sa promotion payante. C’est un exemple distinct de la comète :

["SpaceFashion", "Has", "SpaceFashionBoost"],
["SpaceFashionBoost", "Contains.Target", "Parent"],
["SpaceFashionBoost", "Contains.Percent", 5]

La cargaison est Workers, défini par Contains sur SpaceFashion. 5 signifie 5 % de la population du joueur, pas de la cargaison actuelle. Avec 100 Travailleurs, un clic payé ajoute 5 volontaires. Si la fenêtre en contenait 10, elle passe à 15. La population reste 100 et la fenêtre ouverte.

Utilisez ensuite SpaceFashionAccept. Son issue SpaceFashionAcceptDone ne contient que Contains.Target Parent et prend les 15 de la carte. Sans autre changement de population, le total passe de 100 à 115. Le même Parent sert donc à deux opérations : Percent sur une réponse augmente la cargaison, alors qu’une issue sans quantité propre transfère la cargaison conservée au joueur. Avec Scaled au lieu de Percent sur la promotion, l’ajout dépendrait de l’échelle économique, comme pour la comète.

Une issue avec seulement Contains.Target Parent récupère la cargaison conservée de sa carte. Une réponse avec le même chemin et une quantité déclarée augmente cette cargaison, est répétable et garde la carte ouverte. Elle ne doit pas avoir d’issues indépendantes ni d’effet masquant sa répétition. Contains.Name donne l’étiquette. Contains.Count.R est le résultat conservé, pas une déclaration à écrire. Cost.R.PerValue peut payer chaque unité ajoutée.

Mission, Expires, Risk, Reward et Launched

Une mission apparaît d’abord comme offre. Si le joueur paie le lancement à temps, le voyage commence. Au retour, le risque détermine succès ou échec. Le succès donne la récompense calculée d’avance. L’échec ne rembourse pas automatiquement. Expires fixe l’attente permise avant lancement et Duration le voyage lancé.

MyExpedition est une nouvelle expédition scientifique. L’échelle économique dépend de la population et des technologies achevées. Reward.Scaled multiplie cette échelle. Le montant est fixé à l’offre : la croissance ultérieure ne l’augmente pas automatiquement. Conservez les deux premiers blocs dans un même tableau Logic. L’un déclare l’offre, l’autre son lancement et ses issues.

Commençons par le temps de décision. Cette première partie de MyExpedition n’a pas encore de bouton de lancement. Mission est déjà Event dans le jeu, donc un deuxième Is Event est inutile.

["MyExpedition", "Is", "Mission"],
["MyExpedition", "Expires", 8]

Expires 8 laisse huit tours pour décider. Une offre apparue au tour 10 peut être acceptée aux tours 10 à 17. Le passage à 18 la retire si le lancement n’a pas été payé. Ces huit tours ne décrivent pas le voyage.

Définissons séparément la durée du voyage déjà payé.

["MyExpedition", "Duration", 4]

Duration 4 commence un nouveau décompte au lancement. Un départ au tour 12 donne le résultat au tour 16. Le temps d’offre inutilisé ne change pas ce voyage.

Ajoutons le risque de retour sans récompense.

["MyExpedition", "Risk", 30]

Risk 30 signifie 30 % d’échec et 70 % de succès. Ce pourcentage appartient à l’offre précise et son chargement ne le relance pas. Le lancement n’est pas automatiquement remboursé après échec.

La dernière partie de l’offre est la récompense du voyage réussi.

["MyExpedition", "Reward", "Science"],
["MyExpedition", "Reward.Scaled", 2]

Reward choisit Science et Reward.Scaled 2 le double de l’échelle économique à l’apparition. À une échelle de 11, 22 unités de Science sont promises. Elles ne croissent pas avec la population ensuite. La formule exacte suit plus bas. Risk, Reward, Expires et Launched sont déjà déclarés Is Predicate. Ne les redéclarez pas. Rassemblons les paramètres puis relions lancement et issues.

["MyExpedition", "Is", "Mission"],
["MyExpedition", "Name", "MyExpeditionName"],
["MyExpedition", "Expires", 8],
["MyExpedition", "Duration", 4],
["MyExpedition", "Risk", 30],
["MyExpedition", "Reward", "Science"],
["MyExpedition", "Reward.Scaled", 2]

L’offre exige un choix de lancement dont les Has énumèrent les issues. Duration, Risk et Reward seuls ne les déclarent pas. Duration et Risk acceptent un nombre ou un intervalle entier .Random.Min/.Random.Max. Les deux limites sont obligatoires : 0 ≤ Min ≤ Max ≤ 2147483647, avec minimum 1 pour Duration. Ne combinez pas nombre et intervalle, ni bornes textuelles ou fractionnaires. Expires accepte Random ordinaire. Reward nomme une ressource déclarée, pas un intervalle aléatoire.

["MyExpedition", "Has", "LaunchMyExpedition"],
["LaunchMyExpedition", "Is", "EventChoice"],
["LaunchMyExpedition", "Name", "LaunchMyExpeditionName"],
["LaunchMyExpedition", "Cost.Minerals", 10],
["LaunchMyExpedition", "Has", "MyExpeditionSuccess"],
["LaunchMyExpedition", "Has", "MyExpeditionFailure"],
["MyExpeditionSuccess", "Is", "Event"],
["MyExpeditionSuccess", "Name", "MyExpeditionSuccessName"],
["MyExpeditionFailure", "Is", "Event"],
["MyExpeditionFailure", "Is", "Failure"],
["MyExpeditionFailure", "Name", "MyExpeditionFailureName"],
["RandomEvents", "Deck.MyExpedition", 1]

Avec le bloc précédent, l’offre dure huit tours. Le paiement lance quatre tours de voyage puis le risque conservé choisit succès ou échec. Le succès attribue Reward. Ne doublez pas cette récompense par Adds sur l’issue réussie. Les noms se traduisent dans Text ordinaire.

Reward = Science et Reward.Scaled = K donnent une récompense scientifique, pas un champ Reward.Science. À l’apparition, le jeu lit population P et nombre T de technologies achevées. L’échelle vaut P × (1 + T × Rule.OutputPerTech). La récompense initiale est max(1, floor(|K| × échelle)), avec K = 1 sans Reward.Scaled. Les niveaux répétés d’une technologie ne sont pas des technologies distinctes dans T. Avec 10 Travailleurs, deux technologies, règle 0.05 et Reward.Scaled 3, on obtient 33 unités de Science.

Ce montant est fixé à l’apparition, pas au lancement ni au retour. Population, recherche et commerce ultérieurs ne le modifient pas seuls. Une amélioration payée change la récompense de cette carte si Adds.Reward.Count ou Multiplies.Reward.Count le déclare.

Le succès attribue la récompense en respectant les limites de Science et le message indique le gain réel. L’échec ne donne pas Reward et ne rembourse pas le lancement seul. Un remboursement ou une pénalité supplémentaire doit figurer dans les faits de l’issue.

Une offre apparue au tour B avec Expires entier E est acceptable aux tours B…B+E−1 inclus. Le passage à B+E supprime l’offre non acceptée. Expires 6 au tour 10 autorise les tours 10…15, puis l’offre disparaît au tour 16. Un Expires positif fractionnaire expire au premier épuisement, soit B+ceil(E). Sans lancement, aucune issue de lancement ni aucun paiement ne se produit. Une histoire d’expiration distincte doit être déclarée explicitement.

Le lancement au tour L remplace le reliquat de l’offre par D tours de processus et repart à zéro. Le résultat survient au passage à L+D : quatre tours lancés au tour 12 finissent au tour 16. Le tour de lancement ne consomme pas le premier tour. Le type d’événement traite la suppression ou transformation de sa cible, sans supposer la poursuite du chronomètre. Des Expires et Duration entiers facilitent le calendrier.

Ajoutons à MyExpedition un bouton payant réduisant le risque. C’est un choix distinct du lancement : il modifie la carte ouverte sans lancer un nouveau voyage. Traduisez ReduceMyRiskName dans Text.

["MyExpedition", "Has", "ReduceMyRisk"],
["MyExpedition", "Risk.Min", 10],
["ReduceMyRisk", "Is", "EventChoice"],
["ReduceMyRisk", "Name", "ReduceMyRiskName"],
["ReduceMyRisk", "Cost.Credits", 1],
["ReduceMyRisk", "Adds.Risk", -10]

Avec un risque initial de 30, le premier clic payé donne 20 et le deuxième 10. La limite est atteinte : le bouton devient gris sans prélèvement. L’offre reste ouverte, sans voyage lancé. Risk.Min appartient à la mission, pas à une condition Requires du bouton.

Un multiplicateur peut aussi réduire le risque. Pour cet essai alternatif, remplacez Adds.Risk −10 par cette ligne en gardant coût et inclusion.

["ReduceMyRisk", "Multiplies.Risk", 0.5]

Le risque de 30 devient 15, puis le clic suivant atteint le minimum 10 plutôt que 7.5. Le risque est conservé à 0.1 point de pourcentage près. C’est le risque d’échec : le succès passe donc de 70 % à 85 %, puis 90 %.

Une autre variante réduit la durée du voyage. Gardez le cadre de ReduceMyRisk, changez son nom traduit et remplacez seulement l’opération de risque par celle de durée. Vous pouvez renommer le bouton pour clarifier. Voici l’opération et sa borne sur la mission.

["ReduceMyRisk", "Multiplies.Duration", 0.5],
["MyExpedition", "Duration.Min", 1]

Avec quatre tours, le premier clic donne 2, le deuxième 1. Le troisième est indisponible et ne prélève rien. C’est le futur voyage qui change, pas Expires de l’offre. La durée reste entière, avec minimum 1. Adds.Duration ajoute ou retire des tours fixes à la place de Multiplies.Duration.

Enfin, la récompense conservée peut changer de même. Pour une variante distincte, remplacez l’opération de durée par celle-ci. Ne gardez pas les deux sur un même bouton d’apprentissage.

["ReduceMyRisk", "Multiplies.Reward.Count", 2]

Les 22 unités de Science promises deviennent 44 puis 88 avant les limites de l’attribution future. Reward.Count change la quantité, pas la ressource Reward choisie. La récompense est arrondie à l’unité. Adds.Reward.Count donne un ajout fixe : +3 transforme 22 en 25. La borne inférieure est Reward.Count.Min sur la mission, pas Reward.Min. Une amélioration n’est payée que tant qu’elle peut réellement modifier son paramètre.

Launched true lance la mission à sa naissance. Il faut alors Duration et les Has d’issues sur l’événement lui-même, sans Expires ni choix de lancement distinct. Les améliorations disponibles peuvent rester dans la fenêtre. Un lancement d’offre ordinaire la transforme en processus et masque les choix jusqu’à l’issue. Notifies Started dans son Has définit le nom et la présentation du message de départ. Le chargement ne relance ni récompense ni risque.

Risk.Show = Success affiche 100 − risque, sans changer le tirage. Aucun autre Show n’est accepté. Failure.Description est la clé d’une conséquence d’échec explicite. Visual = Departure choisit l’effet de départ pris en charge. Hors mission, Multiplies.Risk améliore un risque existant de carte sans créer de mission. Mission.Duration, Mission.Risk, Mission.Reward et Reward.Count sur la carte sont des résultats historiques, pas des paramètres d’auteur initiaux.

Pour débloquer le voyage de l’exemple par une recherche distincte et sa programmation propre, remplacez son inclusion dans RandomEvents par le bloc suivant. Gardez les autres faits de MyExpedition et de son lancement. Cette technologie n’a volontairement pas de bonus numérique.

["MyCartography", "Is", "Tech"],
["MyCartography", "Name", "MyCartographyName"],
["MyCartography", "Icon", "flask"],
["MyCartography", "Tier", 1],
["MyCartography", "Cost.Science", 9],
["Player", "Has", "MyCartography"],
["MyDispatches", "Is", "Events"],
["MyDispatches", "Turn.Starts", 3],
["MyDispatches", "Turn.Every", 7],
["MyDispatches", "Deck.MyExpedition", 1],
["MyExpedition", "Requires.Researched", "MyCartography"],
["MyExpedition", "Target", "World"],
["MyExpedition", "Target.Is", "Rocky"],
["MyExpedition", "Target.Explored", true],
["MyExpedition", "Target.Not", "Homeworld"]

L’offre est vérifiée aux tours 3, 10, 17 et suivants tant que la partie continue. Elle exige MyCartography recherchée et un monde rocheux exploré autre que le monde natal. Rechercher après une vérification manquée ne donne pas l’offre immédiatement : attendez l’échéance suivante. Ajoutez Is Unique pour interdire les offres simultanées de cette mission. MyCartographyName se traduit dans le dictionnaire ordinaire.

Progress - avancement et échelles

Progress conserve l’avancement ou l’état d’un processus précis. Ce mécanisme numérique général compte les pas accomplis d’une tâche Processing et peut servir d’échelle de confrontation pour un événement. La confrontation est un exemple, pas le sens obligatoire de Progress.

Processing relie la tâche à l’objet et l’action gère paiement et achèvement. Progress conserve une valeur sans créer seul construction, récompense ou victoire. Duration fixe le délai pendant lequel Progress peut monter, descendre ou rester stable. Un mécontentement peut augmenter par tour, une concession le réduire et une borne mener à une issue. Voici cet usage d’événement. « Processing et Duration » explique les tâches de travail.

Examinons PressureTest par parties. Définissons le point initial et les limites. Le fichier complet reliera les autres éléments.

["PressureTest", "Progress", 2],
["PressureTest", "Progress.Min", 0],
["PressureTest", "Progress.Max", 5]

La nouvelle carte commence à 2 et peut atteindre 0 ou 5 sans dépasser ces bornes. Atteindre un bord n’attribue encore rien : il faut définir les issues.

Ajoutons un bouton qui réduit l’échelle de l’événement ouvert.

["PressureRelief", "Progress.Target", "Parent"],
["PressureRelief", "Progress.Gain", -1]

Parent du bouton est la carte où il est utilisé. Un premier clic change 2 en 1, un deuxième 1 en 0. L’opération ne ferme pas elle-même l’offre. Dans l’exemple complet, la borne basse la résout. Rôle, coût et Has du bouton figurent plus bas.

L’écoulement du temps peut remplacer le clic. Définissons un pas défavorable aléatoire.

["PressureTest.Drift", "Progress.Add", 1],
["PressureTest.Drift", "Chance", 30]

Drift est une partie de l’événement. À chaque tour suivant, elle ajoute 1 avec 30 % de chances, passant par exemple de 2 à 3. Sinon, 2 reste 2. Aucun pas au tour de naissance. Sans Chance, l’ajout aurait lieu chaque tour.

Attribuons enfin une issue à la borne basse.

["PressureTest.Lower", "Requires.Progress", 0],
["PressureTest.Lower", "Has", "PressureWon"]

Lower vérifie exactement 0 et lance PressureWon à cette valeur. Dans le fichier complet, l’issue donne 5 unités de Science. Avant cette branche, zéro n’était qu’un nombre. Il signifie maintenant réussite. Upper reliera 5 à l’échec. L’option Insurance n’est ajoutée qu’après l’étude de la confrontation complète.

Voici une confrontation autonome de douze tours. Duration est nécessaire pour passer librement les tours : Progress seul ne lève pas le blocage d’un choix obligatoire. Vous pouvez fermer la fenêtre, ne pas choisir Relief et terminer le tour. Drift effectue alors son test à 30 %.

Relief est gratuit, réduit l’échelle de 1 et garde l’événement ouvert jusqu’au résultat. Deux clics depuis 2 atteignent zéro et le succès. La borne basse donne de la Science et la haute retire des Minéraux. Une branche appropriée résout tôt l’événement même avec Duration. Si aucune borne n’est atteinte à la fin, Has à la racine définit l’échec.

[
  ["PressureTest", "Is", "Event"],
  ["PressureTest", "Name", "PressureTestName"],
  ["PressureTest", "Icon", "flask"],
  ["PressureTest", "Duration", 12],
  ["PressureTest", "Progress", 2],
  ["PressureTest", "Progress.Min", 0],
  ["PressureTest", "Progress.Max", 5],
  ["PressureTest", "Has", "PressureRelief"],
  ["PressureTest", "Has", "PressureLost"],
  ["PressureTest.Drift", "Progress.Add", 1],
  ["PressureTest.Drift", "Chance", 30],
  ["PressureTest.Lower", "Requires.Progress", 0],
  ["PressureTest.Lower", "Has", "PressureWon"],
  ["PressureTest.Upper", "Requires.Progress", 5],
  ["PressureTest.Upper", "Has", "PressureLost"],
  ["PressureRelief", "Is", "EventChoice"],
  ["PressureRelief", "Name", "PressureReliefName"],
  ["PressureRelief", "Cost.Credits", 0],
  ["PressureRelief", "Progress.Target", "Parent"],
  ["PressureRelief", "Progress.Gain", -1],
  ["PressureWon", "Is", "Event"],
  ["PressureWon", "Name", "PressureWonName"],
  ["PressureWon", "Adds.Science.Count", 5],
  ["PressureLost", "Is", "Event"],
  ["PressureLost", "Is", "Failure"],
  ["PressureLost", "Name", "PressureLostName"],
  ["PressureLost", "Adds.Minerals.Count", -5],
  ["RandomEvents", "Deck.PressureTest", 1]
]

Progress = N est la valeur initiale de l’échelle. Progress.Min et Progress.Max sont les bornes, avec minimum zéro par défaut. Toute modification est limitée à l’intervalle. Progress.Name et Progress.Hide règlent l’étiquette et l’affichage. Une partie enfant Progress.Add ajoute chaque tour et Progress.Set fixe la valeur. Sa Chance donne la probabilité du pas, sans elle la branche agit chaque tour.

PressureRelief réduit immédiatement l’échelle de sa carte en la gardant active. Progress.Set avec Progress.Target Parent fixe une valeur exacte. Les branches sont ordonnées par Order puis nom stable. La première atteignant réellement une borne termine le pas, sans tirer les suivantes. Aucun pas au tour de naissance.

Les résolutions utilisent les conditions ordinaires Requires.Progress et Has d’issues sur la partie concernée. Un minimum ou maximum seul ne désigne pas une victoire. Une branche adaptée peut résoudre la carte à un changement d’état avant le délai, même avec Duration.

Sans Duration, une carte interactive bloque la fin du tour. Cela convient à une décision immédiate obligatoire, pas à une dérive entre tours. Progress.Turn et Progress.Fired sont des faits internes conservés, à ne pas écrire dans le mod. Le mécanisme numérique est commun à Processing, mais les issues d’échelle ne remplacent pas le paiement et le travail des tâches.

Après l’exemple principal, une assurance payante peut protéger contre Drift. Ajoutez ce fragment au même tableau Logic. Ce n’est pas un nouvel événement autonome.

Le choix suivant règle la probabilité de PressureTest.Drift. Chaque clic coûte un Crédit et réduit de 10 points le pas défavorable de cet événement précis. La carte reste ouverte et le clic ne lance pas le pas. La chance est limitée à 0..100. À zéro, plus aucune réduction n’est possible.

Chance.Target accepte Parent.<nom de partie>, pas une adresse arbitraire. Chance.Max sur la partie fixe la limite supérieure pour Chance.Add positif, 100 par défaut. Cette opération change la chance d’une branche Progress, pas le risque général d’un Event ordinaire sans échelle.

["PressureTest", "Has", "PressureInsurance"],
["PressureInsurance", "Is", "EventChoice"],
["PressureInsurance", "Name", "PressureInsuranceName"],
["PressureInsurance", "Cost.Credits", 1],
["PressureInsurance", "Chance.Target", "Parent.Drift"],
["PressureInsurance", "Chance.Add", -10]

Goal - objectif d’une tâche

Une tâche demande au joueur un résultat avant une échéance. Goal vérifie ce résultat et Event avec ses branches définit réussite et issue de retard.

HQ est le « Siège social » existant. Avant attribution, le joueur doit réellement pouvoir le construire : technologie recherchée, lieu adapté et aucune interdiction. Target.Build HQ vérifie cette possibilité. Sans ce droit de construction, la carte est indisponible.

Commençons par l’objectif : attendre un « Siège social » achevé possédé au lieu choisi. Target a déjà choisi le lieu. Voici uniquement la vérification.

["HeadquartersQuest.Done", "Goal.Has", "HQ"],
["HeadquartersQuest.Done", "Has", "HeadquartersBuilt"]

Goal.Has HQ exige le « Siège social » achevé du joueur sur le monde de la tâche. Ni chantier, « Siège social » adverse ni bâtiment ailleurs ne convient. Dès satisfaction, Done lance HeadquartersBuilt, qui donne 8 unités de Science dans le fichier complet. Goal ne construit pas lui-même.

Limitons l’attente et définissons l’issue de repli.

["HeadquartersQuest", "Duration", 12],
["HeadquartersQuest", "Has", "HeadquartersLate"]

Duration donne 12 tours. Si Done ne convient pas à la fin, Has à la racine lance HeadquartersLate, qui retire ici 3 Minéraux. Le succès peut terminer la tâche plus tôt. Voici déclaration, cible, branches et issues dans un fichier complet. Les noms utilisent Text ordinaire.

[
  ["HeadquartersQuest", "Is", "Event"],
  ["HeadquartersQuest", "Name", "HeadquartersQuestName"],
  ["HeadquartersQuest", "Icon", "flask"],
  ["HeadquartersQuest", "Duration", 12],
  ["HeadquartersQuest", "Target", "World"],
  ["HeadquartersQuest", "Target.Explored", true],
  ["HeadquartersQuest", "Target.Build", "HQ"],
  ["HeadquartersQuest", "Has", "HeadquartersLate"],
  ["HeadquartersQuest.Done", "Goal.Has", "HQ"],
  ["HeadquartersQuest.Done", "Has", "HeadquartersBuilt"],
  ["HeadquartersBuilt", "Is", "Event"],
  ["HeadquartersBuilt", "Name", "HeadquartersBuiltName"],
  ["HeadquartersBuilt", "Adds.Science.Count", 8],
  ["HeadquartersLate", "Is", "Event"],
  ["HeadquartersLate", "Is", "Failure"],
  ["HeadquartersLate", "Name", "HeadquartersLateName"],
  ["HeadquartersLate", "Adds.Minerals.Count", -3],
  ["RandomEvents", "Deck.HeadquartersQuest", 1]
]

Une branche adaptée peut résoudre la carte tôt après un changement du monde. Duration fixe une échéance sans interdire le succès anticipé. À la dernière vérification, le succès adapté est prioritaire sur l’échec de repli. Si plusieurs branches conviennent, la première selon le nom complet en comparaison ordinale est choisie. Nommez les branches prioritaires A…, B… et évitez les conditions qui se chevauchent.

Perdre ou détruire le lieu choisi ne reporte pas Goal.Has sur le joueur : l’objectif reste inachevé et l’échec d’échéance survient. Une issue spéciale pour la perte du lieu exige sa propre branche vérifiable et Has. La disparition ne l’invente pas. Si les conditions générales cessent ou si la partie est finie, nettoyer la carte n’attribue pas automatiquement récompense ou sanction.

Goal.F vérifie l’état requis avec les mêmes comparaisons que Requires. Goal.Has HQ demande le « Siège social » achevé possédé au monde de la carte. Ennemi, chantier ou autre lieu ne convient pas. Une cible absente n’est pas remplacée par le joueur. Sans choix de lieu déclaré, l’état concerne le propriétaire de la tâche.

Goal.R = N demande un gain supplémentaire après attribution, pas une réserve courante de N. Goal.R.Percent utilise un pourcentage du stock initial, Goal.R.Scaled l’échelle économique et Goal.R.Min un gain minimal. Le seuil est fixé à la naissance sans suivre la réserve actuelle.

Pour une croissance de population, remplacez Goal.Has HQ par un autre objectif. Définissons d’abord le pourcentage seul. C’est une variante de Done, pas un ajout au « Siège social ».

["HeadquartersQuest.Done", "Goal.Workers.Percent", 40]

Avec une population de 20 à l’attribution, il faut 8 Travailleurs de plus, soit 28 au total. Les 20 présents ne remplissent pas l’objectif. Le seuil reste fixé malgré les changements de population.

Si huit Travailleurs sont insuffisants, ajoutons un gain minimum.

["HeadquartersQuest.Done", "Goal.Workers.Percent", 40],
["HeadquartersQuest.Done", "Goal.Workers.Min", 15]

Avec les mêmes 20, il faut désormais 15 de plus, soit 35. Avec 100 au départ, les 40 % exigent 40 et dépassent le minimum, soit une cible de 140. Le reste de la tâche, échéance, issues et groupe, reste identique.

La quantité d’objectif est positive. Min accepte zéro et exige une grandeur principale de même ressource. Les branches ont des seuils indépendants. Goal nomme le succès et Requires les circonstances générales, comme la perte de cible. Une tâche complète exige Event, durée, branches de succès/échec reliées par Has et inclusion dans un groupe existant. Goal nu, ancien Request et Goal.*.Required technique ne sont pas des formes d’auteur.

Notifies - réaction et message

Notifies relie un message à un cas : exploration terminée, tâche sans ressources ou Travailleurs perdus. Has sur l’action ou la ressource énumère les réactions et Notifies sur chacune nomme le cas. Name et Icon ordinaires fixent le nom et l’image. Le message suit un résultat réel, pas la simple présence de champs.

Explore est l’exploration existante et ExploreDone sa réaction de réussite déjà traduite. C’est une relation active, pas un nouvel événement :

["Explore", "Has", "ExploreDone"],
["ExploreDone", "Notifies", "Completed"],
["ExploreDone", "Name", "ExploreDone"]

Après exploration réellement terminée, ExploreDone notifie le joueur. Aucune catégorie Event supplémentaire n’est nécessaire. Explore possède l’opération et son résultat.

Has sur Explore inclut ExploreDone. Notifies Completed sur celle-ci signifie « signaler l’achèvement », pas une référence de traduction. Une réaction peut avoir Name, Description, Icon, Color, Popup et Sound. Is Notification ou Is Event supplémentaires sont inutiles pour un message ordinaire. Name, Has ou Adds ne le déclenchent pas seuls.

  • Completed : achèvement réussi d’une action, d’un résultat ou d’une récompense. Started : lancement du processus d’une mission. Unlocked : déblocage d’une possibilité.
  • Shortage : manque de ressource et effet causal. Offline : consommateur arrêté par une pénurie. Stopped : tâche suspendue.
  • Destroyed : destruction d’objet. Spread : propagation. Defeat : cause de défaite.
  • Casualties : pertes réelles de Travailleurs. Withdrawn : retrait d’affectations. Notifies seul ne déclare pas d’autres noms de cas arbitraires.

Une réaction Shortage peut aussi appliquer la conséquence d’une pénurie. Remplaçons la faim hydrique par notre règle. Enregistrez l’objet entier dans Logic/WaterShortage.json : remove retire Starvation et add inclut MyWaterShortage. Aucun autre retrait préalable de Has n’est nécessaire.

Le jeu consomme l’Eau par Upkeep.Water avec mesure Workers. Si le tour devrait porter la réserve sous zéro, elle est ramenée à zéro et la perte de Travailleurs de la réaction s’applique une fois. Un reliquat exactement nul sans manque ne provoque pas de perte. La taille de la pénurie ne multiplie pas la sanction. Si elle continue, le tour suivant vérifie la population déjà réduite. La réaction n’exige pas Is Event : le maintien vital l’appelle.

{
  "remove": [
    ["Water", "Has", "Starvation"]
  ],
  "add": [
    ["Water", "Has", "MyWaterShortage"],
    ["MyWaterShortage", "Notifies", "Shortage"],
    ["MyWaterShortage", "Name", "MyWaterShortageName"],
    ["MyWaterShortage", "Icon", "cosmo_helmet_minus"],
    ["MyWaterShortage", "Multiplies.Workers.Count", 0.9],
    ["MyWaterShortage", "Multiplies.Round", "Floor"]
  ]
}

Ajoutez MyWaterShortageName, par exemple « Pénurie d’Eau », dans Text/frFR.json. Avec 11 Travailleurs, 0.9 donne un changement de −1.1. Multiplies.Round Floor arrondit la perte vers le bas à −2, laissant 9 Travailleurs. Blocks MyWaterShortage annule cette conséquence. L’absence de Popup ne change que l’affichage.

Une nouvelle ressource vitale nécessite plus qu’une réaction Has : Upkeep avec mesure Per S.Count indique quelle quantité S elle soutient. Une dépense fixe sans mesure ne le définit pas. Une réaction Shortage change exactement une quantité.

Les réactions s’héritent avec l’action ou la ressource qui les inclut. Blocks peut interdire le message commun pour le remplacer sans double notification. Shortage appartient à la ressource manquante, comme Water Has Starvation, tout en modifiant une autre quantité, comme Workers.Count. Un message caché applique toujours sa conséquence. Un événement déjà Is Event n’a pas besoin de Notifies supplémentaire pour son nom.

Marks et Unmarks - trait permanent d’une cible

Après capture, un état peut rester sur un monde malgré la fermeture du message. Marks l’attache et Unmarks le retire après libération. Trait convient à un état avec propriétés et comportement propres. Un simple tag Is n’indique qu’une catégorie.

Utilisons le « Soulèvement des robots » existant. Lisons d’abord l’état du monde capturé.

["RobotHeldTrait", "Is", "Trait"],
["RobotHeldTrait", "Control.Here", 0]

RobotHeldTrait existe déjà : le monde qui le porte perd son territoire accessible au travail. Définir le trait ne le place encore nulle part.

Attachons-le lors de la véritable issue défavorable du soulèvement.

["WorldLost", "Target", "Parent.Target"],
["WorldLost", "Marks", "RobotHeldTrait"]

WorldLost reçoit le monde de l’événement d’origine par Parent.Target. Marks y laisse RobotHeldTrait pour le joueur concerné. Les places auparavant accessibles deviennent indisponibles. Fermer le message ne retire pas le trait.

La libération exige l’opération inverse dans un vrai résultat de mission de reconquête.

["RetakeDone", "Target", "Parent.Target"],
["RetakeDone", "Unmarks", "RobotHeldTrait"]

RetakeDone retire précisément ce trait du monde repris. Les autres interdictions restent. Voici la chaîne complète existante, dont événements, mission et lancement appartiennent déjà au jeu.

["RobotHeldTrait", "Is", "Trait"],
["RobotHeldTrait", "Control.Here", 0],
["WorldLost", "Target", "Parent.Target"],
["WorldLost", "Marks", "RobotHeldTrait"],
["RetakeDone", "Target", "Parent.Target"],
["RetakeDone", "Unmarks", "RobotHeldTrait"]

WorldLost laisse la restriction de travail sur le monde. La fermeture de carte ne l’efface pas : la reconquête correspondante la retire. Les autres restrictions subsistent. Une chaîne personnalisée exige des issues Event déclarées, leur lancement réel et une cible transmise. Marks seul sur un nom arbitraire ne capture rien.

Marks = Definition attache la définition à la cible explicite à la naissance ou à la résolution de l’issue. Unmarks la retire. Une catégorie ordinaire devient un tag Is du corps. Si la définition possède Is Trait, la cible reçoit ce trait de façon permanente pour le joueur concerné. L’événement ou son issue doit avoir Target et la définition doit exister.

La perte du secteur interdit le travail jusqu’à une reconquête explicite. La disparition du message ne retire pas le trait permanent. Retirer une présence ne supprime pas celle d’autrui ni d’une autre source. Aucun tag technique intermédiaire ni règle devinant son nom n’est nécessaire. Un effet numérique temporaire est plus simple avec Duration et les opérations ordinaires.

Turn - tour et programmation

Chaque tour terminé avance le temps du monde d’une unité. Un groupe Events tente un tirage selon son calendrier. Un début 3 et un intervalle 7 donnent par exemple les tours 3, 10, 17.

Simulation Turn conserve le numéro du tour. Un auteur d’événement règle généralement le calendrier du groupe plutôt que cet état. Commençons par une tentative unique avec MyEvents. Nous y relierons plus bas l’événement existant de Minéraux.

["MyEvents", "Is", "Events"],
["MyEvents", "Turn.Starts", 3]

Turn.Starts 3 programme la première tentative au tour 3 ordinaire. Sans intervalle, elle est unique. Si aucune carte ne convient à ce tour, il n’y a pas de nouvelle tentative automatique au tour 4.

Pour poursuivre les tentatives, donnons un intervalle.

["MyEvents", "Turn.Every", 7]

Every 7 espace les tentatives de sept tours : après 3 viennent 10, 17, etc. Une carte indisponible ne reporte pas l’essai au prochain tour. Relions l’événement Minéral et rassemblons le calendrier. Turn.Max et Then suivent ensuite.

MyEvents est un nouveau groupe autonome. SuppliesMinerals est l’événement existant qui ajoute une fois des Minéraux. Il s’affiche sous le nom traduit de Supplies, « Provisions trouvées ». Le fragment lui donne un calendrier sans redéfinir sa récompense :

["MyEvents", "Is", "Events"],
["MyEvents", "Turn.Starts", 3],
["MyEvents", "Turn.Every", 7],
["MyEvents", "Deck.SuppliesMinerals", 1]

Turn.Starts 3 et Turn.Every 7 programment 3, 10, 17, etc. La préparation initiale du monde ne tire pas de carte. Si Starts ne dépasse pas le tour initial, la première possibilité est la vérification ordinaire suivante après avancée du temps. Starts sans Every donne un essai unique. Every sans Starts calcule la première échéance depuis la première vérification du groupe, sans promettre un tirage à sa création. Définissez Starts pour un premier tour précis.

Le jeu détecte lui-même un groupe Is Events à calendrier propre. Aucun deuxième pointeur Events ni Deck d’événements sur Simulation n’est nécessaire. Une partie enfant avec Requires et Deck est une branche conditionnelle, pas un minuteur indépendant. Une branche sans Requires est interdite. Un calendrier sur un sujet arbitraire sans consommateur d’événements ne crée pas d’exécution. Random standard règle début et pause aléatoires. Turn.Next est une échéance interne, pas un paramètre initial.

L’échéance suivante est fixée avant le choix de carte. Une carte indisponible pour technologie, conflit, Unique actif ou absence de cible retourne au paquet et n’est pas retirée dans le même tirage. Le jeu essaie les autres cartes de ce contenu. Sans carte adaptée, rien n’apparaît mais le calendrier reste fixé.

Avec Starts 3 et Every 7, un essai manqué au tour 3 ne se répète pas au tour 4 : le suivant est au 10. Une recherche ou exploration entre ces tours ne contourne pas l’intervalle.

Sans Every, un essai unique ne se répète pas, même si toutes les cartes étaient indisponibles. Then peut transmettre une nouvelle échéance par Turn.Pause. Les branches conditionnelles et objectifs réactifs ont leur contexte explicite et ne sont pas une répétition implicite du calendrier manqué. Le tutoriel suspend les horloges et reporte les échéances : cet exemple concerne une partie ordinaire sans pause.

Then peut reprogrammer un groupe, ce qui diffère de ses essais périodiques indépendants.

Turn.Pause du groupe est le délai de transmission Then, pas un ajout à chaque Every. Then ordinaire programme tour courant + Pause, sans précéder Starts, et remplace l’ancienne échéance. Si le résultat dépasse strictement Turn.Max, il est supprimé et aucun essai n’a lieu à Max. L’égalité avec Max autorise un essai.

À l’échéance effective, l’essai programme le suivant par Every depuis son tour réel. Une transmission au tour 10, Pause 3, Starts 20 et Every 5 donne 20 puis 25, 30… Sans Starts, ce serait 13. Then.Now ignore Pause et tire immédiatement, puis Every repart du tour courant.

Le démarrage indépendant Starts et une transmission ultérieure au même groupe peuvent reprogrammer son horloge. Déclarez deux groupes pour deux calendriers narratifs indépendants.

Turn.Max sur Simulation ou le mode choisi est la limite de partie et Turn.Ending la définition de l’événement final. Tenter de dépasser le dernier tour le résout à la place du calcul ordinaire. Requires.Turn.Max N compare au contraire numéro de tour ≤ N sans fixer d’échéance. Ces deux usages de Max diffèrent.

Choix de partie, tutoriel et résultats

Corporation, Rule et Scenario - définitions choisies

Avant une partie, le joueur choisit corporation, mode et scénario. La corporation lui donne ses capacités. Le mode fixe les règles, comme le paiement des actions. Le scénario détermine carte et conditions initiales. Ce sont trois définitions distinctes.

MyCorporation est une nouvelle corporation avec bonus d’extraction. MyScenario est une variante de ScenarioG existant, l’étoile jaune avec départ ordinaire. L’héritage conserve Travailleurs et réserves de base. ExtraStart ajoute des Minéraux. Les nouvelles clés de noms se traduisent dans Text/frFR.json.

Commençons par la capacité. La carte complète aura sa présentation plus bas. Voici seulement la déclaration et le bonus.

["MyCorporation", "Is", "Corporation"],
["MyCorporation", "Adds.Production.Minerals", 0.2]

Choisir MyCorporation ajoute 0.2 au taux d’extraction minérale du joueur. Avec une base de 1, chaque Travailleur minier affecté donne 1.2 plutôt que 1. La corporation ne crée ni Travailleurs ni Minéraux avant leur travail.

Créons indépendamment un scénario avec une réserve initiale supplémentaire.

["MyScenario", "Is", "ScenarioG"],
["MyScenario.ExtraStart", "Adds.Minerals.Count", 20]

MyScenario hérite de la carte et du départ entier de ScenarioG. ExtraStart ajoute une fois 20 Minéraux : un départ M devient M + 20. Son nom distinct conserve la partie Start du parent. Les cartes complètes ci-dessous ajoutent noms, icônes et paramètres nécessaires.

Pendant la partie, la corporation choisie est sur le joueur et Rule/Scenario sur Simulation. Un Default true fixe le choix initial, mais celui du joueur prime. Name, Icon et Description présentent la carte. InputName définit le nom propre de la corporation du joueur, pas un remplacement du Name de la carte.

["MyCorporation", "Is", "Corporation"],
["MyCorporation", "Name", "MyCorporationName"],
["MyCorporation", "Icon", "corp_miner"],
["MyCorporation", "Color", "orange"],
["MyCorporation", "Adds.Production.Minerals", 0.2],
["MyScenario", "Is", "ScenarioG"],
["MyScenario", "Name", "MyScenarioName"],
["MyScenario", "Icon", "star_yellow00"],
["MyScenario", "Difficulty", "DifficultyNormal"],
["MyScenario", "Orbit.Center", "ClassG"],
["MyScenario.ExtraStart", "Adds.Minerals.Count", 20]

La corporation exige nom et icône. Si les variantes utilisent Color, elles doivent toutes en avoir un. InputName pour le nom du joueur appartient à la corporation. Une technologie initiale peut figurer dans son Has, mais une action appartient au lieu et se limite par Requires.Corporation. Un scénario exige Name, Icon et Difficulty. Orbit.Center choisit structurellement l’étoile explicitement.

Définissez Orbit.Center explicitement même sur un descendant de scénario. Les attributions de départ s’appliquent une fois au joueur. Start remplace tout le contenu principal, tandis qu’ExtraStart indépendant ajoute au contenu hérité.

Is ScenarioG conserve tout ScenarioG.Start tant que le descendant n’a pas sa propre partie Start. Les Travailleurs et réserves actuels s’héritent ainsi. Un champ ordinaire propre remplace celui de l’ancêtre. Pour une partie, une seule ligne MyScenario.Start remplace tout le bloc parent Start, pas une seule ressource. L’exemple utilise donc ExtraStart pour un ajout.

["MyYellowScenario", "Is", "ScenarioG"],
["MyYellowScenario", "Name", "MyYellowScenarioName"],
["MyYellowScenario", "Orbit.Center", "ClassG"],
["MyYellowScenario.ExtraStart", "Adds.Science.Count", 3]

Le départ ordinaire de ScenarioG est conservé et ExtraStart ajoute trois unités de Science. Pour remplacer tout le départ, créez votre Start et déclarez-y l’ensemble complet. Un seul fait MyScenario.Start Adds.Minerals.Count ne préserve pas les autres lignes parentales. Partie de définition et prédicat composé restent distincts. Vérifiez durée, lieu, exigences et conséquences du scénario dans une nouvelle partie.

Un mode Rule exige Name, Icon et Description. Ses effets ordinaires utilisent Multiplies, Adds, Blocks, Has et les durées. Rule.Audience est une clé facultative décrivant le public adapté. Un bonus permanent n’exige pas de nouveau drapeau Rule si durée ou effet existant suffit. Le choix du menu devient un fait à la création sans modifier rétroactivement une partie commencée.

Rule.* - paramètres pris en charge de partie et de scène

Rule.* définit les réglages de partie ou de scène prévus par le jeu. Sur un mode, ils agissent après son choix. Sur Simulation, ils sont généraux au monde. Un nouveau mode exige Is Rule, Name, Description et Icon. Un nom inventé après Rule ne crée pas de loi. Voici les paramètres acceptés.

Distinguez monde et scène affichée. Simulation ou le mode choisi porte les règles de partie. La scène courante porte les réglages d’affichage et carte/menu peuvent différer. Changer une étiquette de menu ne modifie donc pas forcément celle de la partie commencée.

Exécution et paiement. Un exemple observable choisit un mode où la construction paie immédiatement plutôt que par contributions.

Retirons d’abord les durées des actions du nouveau mode. MyInstantMode n’est encore qu’une préparation. Sa carte complète suit plus bas.

["MyInstantMode", "Multiplies.Action.Duration", 0]

Le multiplicateur donne une durée effective nulle. Cela ne rend pas encore la construction instantanée : avec Rule.ProgressTasks true ordinaire, une tâche à Travailleurs remplace le chronomètre.

Désactivons maintenant cette méthode de travail.

["MyInstantMode", "Rule.ProgressTasks", false]

Combinée à une durée nulle, elle fait payer construction et exploration intégralement et les termine immédiatement. Un bâtiment de 12 Minéraux avec 20 en stock apparaît aussitôt et laisse 8. Avec une durée positive, une tâche paie toujours par tour : ProgressTasks false seul ne l’annule pas. Voici les deux paramètres dans un mode sélectionnable complet.

Rule.AccumulatedResearch est distinct : la recherche attend tout le stock sans contributions ni Travailleurs. Tous ces chemins utilisent le même coût effectif et gardent le sens du travail payé et de l’annulation.

["MyInstantMode", "Is", "Rule"],
["MyInstantMode", "Name", "MyInstantModeName"],
["MyInstantMode", "Description", "MyInstantModeDescription"],
["MyInstantMode", "Icon", "gear"],
["MyInstantMode", "Multiplies.Action.Duration", 0],
["MyInstantMode", "Rule.ProgressTasks", false]
  • Rule.AccumulatedResearch : true/false, false par défaut. true choisit la recherche par accumulation du coût effectif entier. Les autres actions ne deviennent pas accumulatives.
  • Rule.ProgressTasks : true/false, true en l’absence du champ. Choisit tâche à Travailleurs ou paiement instantané de construction/exploration après vérification de leur durée temporisée. Cela ne remplace pas la durée d’un événement ordinaire.
  • Rule.TradeWorker : référence à une ressource déclarée. Chaque unité d’ordre commercial occupe une unité de cette ressource. Workforce utilise son groupe libre. Sans règle, le commerce n’occupe pas de Travailleurs.

Autre tâche : autoriser une partie sans Travailleurs. Ajoutez ce paramètre à MyInstantMode déjà déclaré. Il ne concerne pas la vitesse de construction.

["MyInstantMode", "Rule.ExtinctionEnds", false]

Passer sous un Travailleur ne termine plus la partie pour extinction. Zéro laisse par exemple la partie active, mais une défaite du conseil ou une autre fin déclarée reste possible. Voici les paramètres d’événements et de fin. OutputPerTech affecte les nouvelles récompenses sans changer une offre conservée.

  • Rule.OutputPerTech : nombre, 0.05 en l’absence du champ. L’échelle économique d’événement vaut population × (1 + nombre de technologies achevées × coefficient). Ce n’est pas un multiplicateur direct d’extraction. L’échelle d’une carte née reste conservée.
  • Rule.ExtinctionEnds : true/false, true en l’absence du champ. false désactive seulement la défaite sous un Travailleur, sans retirer les autres fins.
  • Rule.SuppressNotifications : true/false, false par défaut. true supprime les notifications ordinaires. C’est un réglage d’affichage, pas l’annulation des conséquences.

Pour une nouvelle carte, vous pouvez révéler le voisinage du monde natal à l’avance. Le réglage s’applique à la création de partie.

["MyInstantMode", "Rule.StartExplore", 2]

StartExplore 2 révèle gratuitement les corps dans un rayon initial de 2 selon les distances de la simulation : orbites et imbrication des satellites, pas pixels d’écran. Sans réglage, seul le monde natal est révélé. Modifier ce champ ne révèle pas à nouveau une carte existante. Voici les paramètres de génération.

  • Rule.StartExplore : rayon de révélation initiale gratuite. Sans fait, seul le monde natal est révélé. La distance tient compte des orbites et de l’imbrication des satellites, pas des pixels.
  • Rule.FlankOrbit : numéro d’anneau. Les corps de cet anneau ou au-delà se placent sur les arcs horizontaux, sans changer les orbites circulaires. Aucune telle restriction en l’absence du champ.
  • Rule.SatelliteMinSize : limite inférieure du Size typique d’un satellite créé. Zéro sans champ, donc aucun rejet. Le calcul utilise Size explicite de classe ou le milieu de son intervalle déclaré. Les unités suivent Size de la simulation. Ne supposez pas des kilomètres universels : PreWarpAge utilise le territoire.

Dernière tâche distincte : afficher les noms des corps sur la carte de jeu. Simulation possède ici les paramètres du monde.

["Simulation", "Rule.MapNames", true]

MapNames true active les étiquettes de la scène de jeu affichée. Réserves, extraction et contenu de la carte restent identiques. Un réglage de scène du menu ne remplace pas celui du monde. Voici les autres paramètres visuels et d’entrée, chacun avec sa fonction.

  • Rule.Language : codes de langues disponibles répétés, comme frFR et enUS. Sans liste, toutes les langues chargées sont disponibles. Le code n’est pas le nom affiché de la langue.
  • Rule.Zoom : entier positif d’orbites visibles dans le cadrage initial. Sans valeur positive, le contenu entier est cadré.
  • Rule.Zoom.Target : Center ou Home. Center montre le centre du système et Home le monde natal du joueur. Avec plusieurs valeurs, Center prime, et c’est aussi la valeur par défaut. S’utilise avec Rule.Zoom.
  • Rule.MapNames : true/false, false sans champ. Active les étiquettes de la scène affichée.
  • Rule.OrbitMotion : true/false, false sans champ. true ajoute une révolution visuelle à tous les corps orbitaux, même sans période physique. false n’arrête pas toutes les animations physiques.
  • Rule.OrbitPauseOnSelect : true/false, false sans champ. Suspend le mouvement orbital pendant la sélection.
  • Rule.WorkersSlider : true/false, false sans champ. Active les curseurs et l’affichage associé des Travailleurs. Ne crée ni ressource de population, ni affectations, ni places.
  • Rule.GuiSkin : nom de présentation générale, steel par défaut. classic est l’alternative générale prise en charge. Ce n’est ni un chemin de CSS libre ni un nouveau composant.
  • Rule.NoSubMaps : true/false, false sans champ. Désactive les sous-cartes hors mode décoratif. Dans Decorative, concerne le secteur plat mais conserve les compagnes d’un système radial distinct.

Pour vérifier une génération, créez une nouvelle partie. Modifier taille minimale des satellites ou placement ne régénère pas la carte. Les réglages d’interface ne changent pas non plus les ressources ni le sens des conditions.

Tutorial et TutorialStep - apprentissage

Le tutoriel se compose d’étapes : choisir le monde natal, affecter un Travailleur, terminer un tour. Tutorial relie le scénario à l’ensemble et Is TutorialStep déclare une étape. Elle possède texte, objet d’ancrage et condition de fin. Aucune nouvelle interface distincte n’est nécessaire.

Enregistrez le tableau complet dans Logic/Training.json et le dictionnaire suivant dans Text/frFR.json. Choisissez « Système d’apprentissage » et CorpMiner pour une nouvelle partie. SmallTutorial est le nom inventé d’un ensemble de trois étapes. Homeworld désigne le monde natal existant du joueur.

Examinons la première étape seule. Le fichier complet reliera scénario et ensemble.

["SelectHome", "Is", "TutorialStep"],
["SelectHome", "Order", 1],
["SelectHome", "Text", "SelectHomeText"],
["SelectHome", "Target", "Homeworld"],
["SelectHome", "Tutorial.Awaits", "Select"]

Order 1 place l’étape en premier. Text indique la clé d’instruction, Target le monde natal et Tutorial.Awaits Select attend sa sélection par le joueur. Afficher l’instruction seul ne termine pas l’étape. La sélection mène à la deuxième.

La deuxième attend un nombre de Travailleurs affectés, pas une simple sélection.

["StaffHome", "Target", "Homeworld"],
["StaffHome", "Tutorial.Awaits", "Workers.Count"],
["StaffHome", "Tutorial", 1],
["StaffHome", "Tutorial.Unlocks", "Workers.Count"]

Tutorial 1 signifie ici exactement un Travailleur du joueur sur le monde natal. Zéro ou deux ne convient pas. Unlocks autorise l’affectation à cette étape. Les places restent celles du monde. Rôle, numéro et texte de StaffHome figurent plus bas. La troisième attend le passage du tour avec Requires.Turn : Unlocks EndTurn ne remplace pas cette vérification.

Rassemblons les étapes avec le scénario. La carte hérite de ScenarioG. CorpMiner dans Has de l’ensemble limite le tutoriel aux « Mineurs ». Une autre corporation n’est pas remplacée et n’active pas le tutoriel. Options reste accessible en permanence et Workers.Count change à la deuxième étape.

[
  ["TrainingScenario", "Is", "ScenarioG"],
  ["TrainingScenario", "Name", "TrainingScenarioName"],
  ["TrainingScenario", "Orbit.Center", "ClassG"],
  ["TrainingScenario", "Tutorial", "SmallTutorial"],
  ["SmallTutorial", "Has", "CorpMiner"],
  ["SmallTutorial", "Tutorial.Unlocks", "Options"],
  ["SmallTutorial", "Has", "SelectHome"],
  ["SmallTutorial", "Has", "StaffHome"],
  ["SmallTutorial", "Has", "PassTurn"],
  ["SelectHome", "Is", "TutorialStep"],
  ["SelectHome", "Order", 1],
  ["SelectHome", "Text", "SelectHomeText"],
  ["SelectHome", "Target", "Homeworld"],
  ["SelectHome", "Tutorial.Awaits", "Select"],
  ["StaffHome", "Is", "TutorialStep"],
  ["StaffHome", "Order", 2],
  ["StaffHome", "Text", "StaffHomeText"],
  ["StaffHome", "Target", "Homeworld"],
  ["StaffHome", "Tutorial.Awaits", "Workers.Count"],
  ["StaffHome", "Tutorial", 1],
  ["StaffHome", "Tutorial.Unlocks", "Workers.Count"],
  ["PassTurn", "Is", "TutorialStep"],
  ["PassTurn", "Order", 3],
  ["PassTurn", "Text", "PassTurnText"],
  ["PassTurn", "Target", "EndTurn"],
  ["PassTurn", "Requires.Turn.More", 1],
  ["PassTurn", "Tutorial.Unlocks", "EndTurn"]
]

Le bloc suivant est Text/frFR.json complet. Si le fichier existe, ajoutez ces clés dans son objet sans retirer les traductions présentes.

{
  "TrainingScenarioName": "Système d’apprentissage",
  "SelectHomeText": "Sélectionnez le monde natal.",
  "StaffHomeText": "Laissez un Travailleur sur le monde natal.",
  "PassTurnText": "Terminez le tour."
}

Tutorial = TutorialName sur un scénario relie le tutoriel. L’ensemble énumère ses étapes par Has. Chaque étape possède Is TutorialStep, un Order unique d’au moins 1 et Text avec clé d’instruction. Target est l’ancrage et l’objet de vérification. Sans Tutorial.Awaits ni Requires, une étape narrative attend le clic sur son instruction.

Voici après l’exemple les cibles d’interface prises en charge. Un « ancrage » est un objet ou bouton existant auquel s’attache l’instruction :

Target est une définition existante dont l’interface déduit l’ancrage : Homeworld ou une classe de corps donne une instance de carte, un nom Action comme Technologies/EndTurn un bouton, EventChoice un choix, ressource/indicateur comme Science un indicateur du joueur, Tech sa carte propre, Event sa carte active et Building une option de construction.

Un nom arbitraire ne crée pas d’ancrage. Pour Trade, la ressource cible désigne un ordre commercial. Pour Workers.Count, l’ancrage alterne entre corps et curseur. Pour Build.Class, entre corps et bouton de construction. Tutorial.Marks Panel sélectionne une interface existante sans la créer.

  • Tutorial.Awaits Select : cible sélectionnée. Deselect : fenêtres et sélection fermées. Tooltip : infobulle de la cible affichée.
  • Explore : cible explorée. Research : technologie cible recherchée. Build.ClassName : bâtiment achevé possédé de cette classe sur la cible.
  • Workers.Count avec Tutorial N : exactement N Travailleurs propres sur la cible. Trade avec Tutorial N : ordre commercial de la ressource cible égal à N. Tutorial est ici un nombre sur l’étape, mais une référence sur le scénario.
  • Nom Event dans Tutorial.Awaits : la carte de cette classe est apparue pour le joueur. Unaffordable : le choix cible n’est plus abordable.
  • Requires.Turn et les autres conditions d’étape vérifient le monde. Creates crée un événement à l’entrée et Creates.Target choisit son lieu.
  • Tutorial.Unlocks d’une étape autorise en plus action, champ ou catégorie. L’ensemble définit les autorisations permanentes. Le verrou dépend de l’étape actuelle. Les permissions précédentes ne s’accumulent pas.
  • Tutorial.Marks Panel sélectionne le panneau de l’ancrage. Tutorial.Side accepte Above ou Below. Sans côté explicite, le client place l’instruction selon l’espace disponible.

Has de l’ensemble peut limiter les choix des axes sélectionnés, par exemple à une corporation. Les horloges des événements aléatoires sont suspendues pendant l’apprentissage. Des attentes réversibles peuvent revenir à l’étape précédente si l’état recule. Tutorial.Step et Tutorial.Done courants sont l’état de partie, pas un moyen d’ignorer l’apprentissage. Les paramètres Text lisent les valeurs actives : {Workers.Count}, {Change.Water}, {Cost}, {Damage}, {Target.Size}, {ClassName.Cost}, {ChoiceName.Shortfall}. Ne recopiez pas les nombres à la main dans une traduction.

History et Statistics - chronique et compteurs

History définit une entrée de chronique après un résultat : bâtiment achevé, cargaison livrée, offre expirée. Statistics compte actions et apports de toute la partie. La chronique conserve des phrases et les statistiques des nombres. Elles ne se remplacent pas.

Modifions le texte d’une vraie récupération de comète. CometReturn est son succès existant.

["CometReturn", "History", "MyCargoReceivedHistory"]

History renvoie à MyCargoReceivedHistory. Si Text/frFR.json lui donne « Cargaison de comète reçue. », cette phrase apparaît après collecte réussie. History seul ne crée pas de comète et ne donne pas de cargaison.

Autre tâche : ne raconter que le premier avant-poste de la partie.

["Outpost", "History", "MyLabBuiltHistory"],
["Outpost", "History.OnlyFirst", true]

Le premier Outpost achevé ajoute une phrase, les suivants de même classe non. OnlyFirst règle la chronique sans interdire un deuxième avant-poste. Rassemblons les entrées et une phrase distincte d’expiration pour SpaceFashion.

["CometReturn", "History", "MyCargoReceivedHistory"],
["Outpost", "History", "MyLabBuiltHistory"],
["Outpost", "History.OnlyFirst", true],
["SpaceFashion.Ignored", "Requires.Duration", 0],
["SpaceFashion.Ignored", "History", "MyOfferIgnoredHistory"]

Ce sont des textes remplacés de résultats existants, pas des événements créés par History seul. Voici Text/frFR.json :

{
  "MyCargoReceivedHistory": "Cargaison de comète reçue.",
  "MyLabBuiltHistory": "{subject} construit sur {target}.",
  "MyOfferIgnoredHistory": "L’offre d’immigration a expiré."
}

History conserve une clé Text. History.OnlyFirst true ne garde que le premier achèvement de la classe. History.Independent true commence une séquence distincte et History.Begin sur Simulation définit l’événement initial de fondation. {subject} prend le nom conservé du bâtiment ou de la chose décrite et {target} celui de la cible. Ces noms persistent après disparition du corps.

SpaceFashion.Ignored ajoute ici la phrase d’expiration sans créer d’événement distinct ni d’effet. Fermeture de fenêtre, suppression et expiration diffèrent. Plusieurs textes History simultanément appropriés sont une erreur. Sans History, un résultat achevé utilise son Name ou celui de l’événement principal. Un nom seul ne met pas toute offre inachevée dans la chronique.

Les statistiques s’activent indépendamment des phrases. Cette ligne concerne le joueur.

["Player", "Statistics", true]

Pour un essai distinct, partez d’une ressource à réserve nulle sans réception antérieure. Une vraie récompense ajoute 5 : réserve 5, Received 5. Une action dépense ensuite 3 : réserve 2, Received toujours 5. Le total reçu diffère du stock restant. Le jeu change le compteur après réception réelle, pas une ligne de mod donnant le total souhaité.

Le jeu actualise Seconds, Loads, Explored, Built, Studied, Received, Mined, Bought et Sold. Les cours déclarés et la monnaie déterminent les ressources commerciales, sans liste Statistics.Resource.R distincte. History.Entry/Turn/Source et Statistics.Run ne sont pas des commandes d’auteur ni un moyen de gonfler la progression.

Completed et Track - résultats confirmés

Track compte les actions et résultats accomplis. Il peut compter des avant-postes achevés, même démolis ensuite, mais pas un chantier. Le jeu conserve pour cela Completed, confirmation d’achèvement avec contexte. Track la lit sans rien construire ni exécuter.

Completed peut décrire fin d’action, création d’objet, production, changement de population ou résultat final. Requires.Completed lit le résultat actuellement vérifié. Requires.Completed.Credits.Min compare les Crédits au moment de l’achèvement, même dépensés ensuite. Ne créez pas ces confirmations dans Logic : elles doivent correspondre à un vrai résultat.

Track avec un nom d’action ou de chose déclare son compteur d’achèvements, descendants Is compris. Choisissez un nom simple, distinct des champs natifs, prédicats et opérateurs. Il se lit directement dans une condition sans Is Predicate. Requires du compteur ajoute des conditions de résultat sans répéter ce que Track nomme déjà.

Comptons les avant-postes achevés. MyBuiltOutposts est notre nom de compteur et Outpost existe déjà.

["MyBuiltOutposts", "Track", "Outpost"]

Après trois avant-postes achevés, MyBuiltOutposts vaut 3. En démolir un ne le réduit pas : il compte les achèvements, pas les bâtiments restants. Un chantier ne compte pas. Player Has et Is Predicate sont inutiles.

Pour l’exploration, il faut parfois compter des lieux différents. Déclarons Explore puis la façon de distinguer ses résultats.

["MyExploredPlaces", "Track", "Explore"],
["MyExploredPlaces", "Track.Key", "Completed.Target"]

Completed.Target conserve l’identifiant du corps exploré. MyExploredPlaces donne le nombre d’achèvements et MyExploredPlaces.Unique le nombre de clés distinctes. Deux résultats avec la même cible donneraient 2 et 1. Cela explique les compteurs sans promettre une exploration répétable. Une carte complète nécessite aussi une liste fixe, étudiée après les avant-postes.

["MyBuiltOutposts", "Track", "Outpost"],
["MyExploredPlaces", "Track", "Explore"],
["MyExploredPlaces", "Track.Key", "Completed.Target"]

Utilisons le compteur dans CensusTask : achever trois avant-postes dans la partie. Les lignes forment un exemple à mettre dans un tableau Logic commun. Ajoutez CensusTaskName, CensusWonName et CensusLateName à Text/frFR.json.

Exigeons d’abord trois avant-postes achevés sur toute la partie. C’est la vérification d’une branche de CensusTask futur.

["CensusOutposts", "Track", "Outpost"],
["CensusTask.Done", "Requires.CensusOutposts.Min", 3]

À deux achèvements, la condition est fausse, à trois vraie. Les avant-postes antérieurs à la tâche comptent aussi, ainsi que les descendants d’Outpost. Le fichier complet utilise cette version.

Pour trois nouveaux avant-postes après apparition, remplacez la condition par celle-ci. Ne gardez pas les deux versions.

["CensusTask.Done", "Requires.CensusOutposts.Min.Add", 3]

Avec deux achèvements initiaux, le seuil devient une seule fois 2 + 3 = 5. Le troisième et le quatrième ne suffisent pas, le cinquième oui. Le seuil ne suit pas la croissance du compteur. On exige ainsi du nouveau travail en gardant le total de partie.

["CensusWon", "Name", "CensusWonName"],
["CensusLate", "Name", "CensusLateName"],
["CensusOutposts", "Track", "Outpost"],
["CensusTask", "Is", "Event"],
["CensusTask", "Name", "CensusTaskName"],
["CensusTask", "Icon", "outpost"],
["CensusTask", "Duration", 20],
["CensusTask", "Has", "CensusLate"],
["CensusTask.Done", "Requires.CensusOutposts.Min", 3],
["CensusTask.Done", "Has", "CensusWon"],
["CensusWon", "Is", "Event"],
["CensusWon", "Adds.Science.Count", 10],
["CensusLate", "Is", "Event"],
["CensusLate", "Is", "Failure"],
["RandomEvents", "Deck.CensusTask", 1]

Pour vérifier toute la carte, Track.Key Completed.Target conserve chaque corps exploré. Track.Required Owner.Explored.Required compare aux corps qui nécessitaient une exploration au début. Requires.ChartedBodies.Covers true exige ce contenu initial entier et non vide. ChartedBodies.Unique compte seulement les corps distincts sans prouver la couverture.

Le jeu forme Explored.Required à la création du monde et Researching.Required pour les technologies exigées. Ce ne sont pas des déclarations libres. N’y placez pas manuellement des noms de classes à la place d’identifiants stables d’instances. Pour un ensemble arbitraire de tâches, utilisez conditions ordinaires ou Goal. Il n’existe pas d’auteur universel de liste Required.

["ChartedBodies", "Track", "Explore"],
["ChartedBodies", "Track.Key", "Completed.Target"],
["ChartedBodies", "Track.Required", "Owner.Explored.Required"],
["CensusTask.Done", "Requires.ChartedBodies.Covers", true]

La dernière ligne CensusTask.Done Requires.ChartedBodies.Covers true ajoute la condition obligatoire d’explorer tous les corps initiaux requis. Ne l’ajoutez pas pour vérifier seulement les trois avant-postes. ChartedBodies peut servir à une autre tâche indépendamment de CensusTask.

Track.Required désigne une liste fixe d’identifiants comme Explored.Required ou Researching.Required. nom.Covers = true vérifie la couverture et le nom seul reste un nombre de correspondances. Count ne remplace pas la liste. Sum, Streak, Max et Track.Operation arbitraires ne sont pas pris en charge. Le jeu remplit compteurs et listes. Relire ou charger ne compte pas à nouveau une action. Une histoire incomplète ne prouve pas zéro violation.

  • Champs numériques lisibles de confirmation : Completed.Turn, BirthTurn, Duration, Age, Mission.Risk, Amount, Workers, Rate et Distance, lorsque le résultat les publie réellement.
  • Completed.From, In, Previous, Target, Corporation, Scenario, Mode et Resource : références ou ensembles de références du contexte de fin. Elles ne sont pas obligatoires sur tous les résultats. Une absence n’est ni zéro ni succès.
  • Completed.R et Completed.R.Count : réserve de R conservée au moment du résultat. Completed.R.Delta : changement du tour conservé. Requires.Completed.Science.Min 20 compare par exemple la Science historique, pas celle d’aujourd’hui.
  • Completed.EpisodeClosed et HistoryComplete : indicateurs de fiabilité. EpisodeKey, Sequence, Batch et Run : identifiants internes et ordre des enregistrements. Pouvoir les lire n’autorise pas à fabriquer des confirmations dans Logic.

Un compteur peut être limité à un épisode si l’achèvement publie réellement ce contexte. SpaceFashionBoost, promotion payante existante, augmente la cargaison d’une offre et conserve une confirmation. Ce fragment observe ses résultats sur un épisode :

["MyEpisodeBoosts", "Track", "SpaceFashionBoost"],
["MyEpisodeBoosts", "Track.Scope", "Episode"]

Comparons-le avec la même opération sur toute la partie.

["MyRunBoosts", "Track", "SpaceFashionBoost"],
["MyRunBoosts", "Track.Scope", "Run"]

Supposons deux promotions payées sur la première offre SpaceFashion et une sur la deuxième. Dans la vraie confirmation de la deuxième, MyRunBoosts lit 3 achèvements et MyEpisodeBoosts 1 pour cet épisode. Les deux clics précédents appartiennent à une autre carte. Cette comparaison exige une vraie confirmation avec lien d’épisode. Une tâche active ordinaire ne reçoit pas ce contexte.

Track.Scope accepte Run, la partie par défaut, ou Episode, une carte. Track.Key nomme la clé stable d’un résultat confirmé. Le nom lit les correspondances et nom.Unique les clés distinctes. Requires.MyBuiltOutposts.Min 3 exige par exemple trois avant-postes. Une vérification d’épisode utilise les confirmations de sa carte, pas la somme des anciennes.

Scope Episode limite le compteur sans faire de CensusTask ordinaire une observation de sa carte. Il peut se lire lors d’un vrai achèvement dont Completed.Evidence transmet l’identifiant Completed.EpisodeKey.

Une tâche active ordinaire n’a pas cette confirmation lors de Requires. La lecture retourne une absence de valeur. N’écrivez pas Completed.Evidence dans le mod pour falsifier le lien. Utilisez Run avec seuil .Add ou Goal pour une nouvelle tâche. Episode convient aux résultats dont le jeu conserve réellement l’appartenance.

Un compteur d’épisode terminé reste jusqu’au prochain lot de confirmations. La confirmation elle-même reste le résultat durable.

Dans PreWarpAge, les succès officiels sont hors Vanilla modifiable et les mods activés désactivent leur attribution. Ne copiez ni Achievement.Eligible, Completed.HistoryComplete, numéros internes ni compteurs Track dans Logic. Completed expose les champs d’un vrai résultat, comme Completed.From, Completed.Target, Completed.In, Completed.Age et Completed.R. L’absence de preuve n’est pas un succès.

Pour une tâche personnalisée, Goal, Requires et les issues d’événements suffisent généralement. Les mods utilisent histoire, statistiques et actions réelles sans ajouter de récompenses officielles au profil. Cet autre système est hors du constructeur de tâches modifiées.

GameOver et Victory - fin de partie

Un événement Is GameOver termine la partie. Une victoire ajoute Is Victory. Après construction d’un prototype, Then peut lancer un groupe de fins victorieuses. Une icône de récompense seule ne termine rien.

WarpDrivePrototype est le prototype existant avec Building, technologie, coût et lieu. MyPrototype en hérite et possède donc déjà une construction fonctionnelle. Then remplace sa suite par MyWinDeck, dont MyWin est l’unique résultat déclaré.

Déclarons d’abord le résultat victorieux. Cette partie de l’exemple complet ne peut pas encore être appelée.

["MyWin", "Is", "Event"],
["MyWin", "Is", "GameOver"],
["MyWin", "Is", "Victory"]

MyWin réellement lancé arrête la partie et marque la victoire. GameOver termine et Victory qualifie le résultat. Déclarer ces rôles ne lance pas la fin au chargement.

Relions maintenant le résultat au véritable achèvement du prototype.

["MyWinDeck", "Is", "Events"],
["MyWinDeck", "Deck.MyWin", 1],
["MyPrototype", "Then", "MyWinDeck"]

MyWinDeck contient seulement MyWin. Après construction, MyPrototype transmet la suite à ce groupe par Then, qui lance la victoire. Le prototype hérite de WarpDrivePrototype et garde coût et conditions. Nous réglerons séparément la présentation finale.

["MyPrototype", "Is", "WarpDrivePrototype"],
["MyWin", "Is", "Event"],
["MyWin", "Is", "Victory"],
["MyWin", "Is", "GameOver"],
["MyWin", "Name", "MyWinName"],
["MyWin", "Icon", "godtech"],
["MyWinDeck", "Is", "Events"],
["MyWinDeck", "Deck.MyWin", 1],
["MyPrototype", "Then", "MyWinDeck"]

Après achèvement réel de MyPrototype, MyWin lance le résultat victorieux. Conditions et prix hérités restent présents. Then seul ne construit pas gratuitement. Traduisez MyWinName dans Text/frFR.json. La présentation du résultat peut ensuite être modifiée séparément.

Un profil héritant de FinalMenu et inclus au Has du résultat peut personnaliser la fenêtre finale. Il donne ses textes, tandis qu’actions et statistiques viennent du menu commun. Des noms de boutons sans actions ne créent pas de commandes. Le fragment complète MyWin : MyResultScreen donne titre et description et MyExplorersMedal la catégorie de récompense avec nom et icône. Traduisez MyResultTitle, MyResultDescription et MyExplorersMedalName dans Text/frFR.json.

["MyWin", "Has", "MyResultScreen"],
["MyResultScreen", "Is", "FinalMenu"],
["MyResultScreen", "Name", "MyResultTitle"],
["MyResultScreen", "Description", "MyResultDescription"],
["MyWin", "Is", "MyExplorersMedal"],
["MyExplorersMedal", "Name", "MyExplorersMedalName"],
["MyExplorersMedal", "Icon", "award_gold"]

GameOver = MyWin sur une récompense notifiée la relie à ce résultat existant sans créer un sélecteur de récompenses. Une fin de mod ordinaire exige Event + Is GameOver et Is Victory pour gagner. Pour or/argent selon le temps, créez deux Event à Requires.Turn disjoints dans le paquet Then. Les cartes sont choisies par leur applicabilité ordinaire, pas un langage de récompenses distinct. Aucun succès officiel de profil n’est ajouté.

GameOver sur une récompense la relie au résultat et GameOver.Evacuation choisit une variante d’évacuation. Sur Simulation, GameOver conserve la cause d’arrêt. true autorise un arrêt sans cause et false aucun arrêt. GameOver.Continued et GameOver.Plaque sont des états de fenêtre, pas des commutateurs d’auteur. Seule une victoire prise en charge de la version complète sans délai d’évacuation autorise la poursuite du temps.

FinalMenu du Has du résultat peut donner Name et Description distincts, avec au plus un profil approprié. Le menu existant énumère aussi actions et statistiques par Has. Completed dans Has du résultat notifie une fois. Fermer la fenêtre ne répète ni son, récompense ni histoire. Une défaite après victoire poursuivie peut remplacer la cause et rouvrir le résultat.

Mots et relations

Cette section rassemble les mots qui décrivent les objets et leurs relations. Owner indique par exemple le propriétaire et PlacedAt l’emplacement d’un bâtiment. Les exemples utilisent les définitions du jeu de base. Vérifiez-les dans une nouvelle partie. Les nombres servent à expliquer les règles.

Les fichiers complets sont accompagnés de leur chemin, par exemple Logic/Orbit.json. Vous pouvez les copier intégralement. Un exemple court peut ne montrer qu’une seule entrée à modifier. Le texte qui le précède indique quelle définition elle complète. La section « Sujet, prédicat et valeur » montre, avec deux fichiers complets, comment ajouter une telle entrée à un fichier existant.

Réalisez les grands exemples de scénarios indépendants un par un, dans des mods distincts : ils peuvent modifier les règles communes de Player. Désactivez le mod précédent avant de passer au suivant. Si vous combinez volontairement des modifications et que Text/frFR.json existe déjà, ajoutez les nouvelles clés à l’intérieur de son objet sans remplacer tout le dictionnaire.

Predicate - votre propre mot

Supposons que vous souhaitiez exprimer numériquement la qualité du minerai. Appelons cette nouvelle propriété OreGrade. Indiquons d’abord au jeu que ce nom peut s’utiliser comme prédicat :

["OreGrade", "Is", "Predicate"]

OreGrade est ici un nom de votre choix. Is Predicate déclare un mot propre au langage. Il ne définit encore la qualité d’aucun monde.

Donnons maintenant une qualité de minerai de 2 aux très petits mondes rocheux. Le fichier Logic/OreGrade.json complet contient la déclaration du mot et son attribution :

[
  ["OreGrade", "Is", "Predicate"],
  ["TinyRock", "OreGrade", 2]
]

TinyRock est la définition existante d’un très petit monde rocheux. La deuxième ligne signifie : « La qualité du minerai de TinyRock vaut 2 ». Remplacer 2 par 5 change l’évaluation enregistrée. L’extraction n’augmente pas automatiquement : relier cette évaluation à un revenu nécessite une règle distincte.

Choisissez un nom simple et libre, sans point ni numéro d’instance. Un deuxième mot personnalisé nécessite sa propre déclaration Is Predicate : cette autorisation ne s’hérite pas. Même pour un mot désignant une ressource, Is Resource seul ne suffit pas. Le nom ne doit pas non plus correspondre à un prédicat natif ni désigner simultanément des types de valeurs incompatibles.

Type - désignation du type d’objet

Un objet peut avoir pour nom « Ma station » et présenter en dessous, dans l’infobulle, le type « Station d’exploration ». Type choisit cette deuxième ligne. Définissons par exemple ceci pour le marqueur MyTypeMarker :

["MyTypeMarker", "Type", "SurveyStation"]

Le jeu prend la traduction de la clé SurveyStation pour la ligne de type. Ce n’est pas le nouveau nom propre du marqueur : Name continue de définir « Ma station ». Modifier Type change la désignation du type, pas l’image Icon ni les propriétés de la catégorie choisie.

L’exemple complet suivant crée sur Terre un marqueur appartenant à deux catégories : station d’exploration et station de recherche. Type choisit laquelle sera nommée comme type dans l’infobulle. Tous les noms commençant par My, ainsi que SurveyStation et ResearchStation, sont inventés pour cet exemple. Enregistrez le premier bloc dans Logic/Type.json et le deuxième dans Text/frFR.json, puis créez une nouvelle partie « Système solaire ».

[
  ["SurveyStation", "Is", "Building"],
  ["ResearchStation", "Is", "Building"],
  ["MyTypeMarker", "Is", "SurveyStation"],
  ["MyTypeMarker", "Is", "ResearchStation"],
  ["MyTypeMarker", "Type", "SurveyStation"],
  ["MyTypeMarker", "Name", "MyTypeMarkerName"],
  ["MyTypeMarker", "Icon", "outpost"],
  ["MyTypeMarker", "PlacedAt", "Earth"],
  ["MyTypeMarker", "Owner", "Player"]
]
{
  "SurveyStation": "Station d’exploration",
  "ResearchStation": "Station de recherche",
  "MyTypeMarkerName": "Ma station"
}

Un objet illustré par un avant-poste apparaît sur Terre. Son nom propre est « Ma station » et sa ligne de type « Station d’exploration ». Remplacez uniquement la valeur de Type par ResearchStation et créez une nouvelle partie : la ligne de type devient « Station de recherche ». Le nom et l’image restent identiques. Pour cette ligne, le jeu traduit la valeur Type elle-même, ici les clés SurveyStation et ResearchStation, pas le Name de la catégorie choisie.

Pour un corps sur la carte, il est parfois possible d’omettre le type. Prenons une simple variante de monde rocheux :

["MyRock", "Is", "TinyRock"]

Si vous créez MyRock sur la carte, le jeu pourra choisir TinyRock comme type : c’est sa classe appropriée la plus proche. Une ligne Type TinyRock distincte n’est pas nécessaire. Ce choix automatique s’applique aux corps placés dans une cellule de la carte. Dans l’état de la partie, le lien avec la cellule s’appelle Cell. Pour un bâtiment sans ce lien, comme MyTypeMarker ci-dessus, l’infobulle lit le Type explicite.

Ajoutons maintenant une deuxième catégorie indépendante au même corps. SurveyedRock est une catégorie de monde inventée :

["SurveyedRock", "Is", "World"],
["MyRock", "Is", "TinyRock"],
["MyRock", "Is", "SurveyedRock"]

MyRock possède maintenant deux branches Is indépendantes. Aucune ne précise l’autre, donc le jeu ne peut pas déduire un type unique. Choisissons TinyRock explicitement :

["MyRock", "Type", "TinyRock"]

La ligne de type affiche la traduction de TinyRock. Les deux catégories Is restent présentes : Type ne supprime pas SurveyedRock.

Une autre méthode consiste à n’utiliser SurveyedRock que comme catégorie accompagnée d’une étiquette. Pour cette variante, supprimez le Type propre de MyRock et ajoutez une étiquette à la catégorie :

["SurveyedRock", "Tag", "SurveyedRockTag"]

Ajoutez au dictionnaire la clé SurveyedRockTag avec le texte « Exploré ». Une catégorie portant Tag est exclue du choix automatique du type. Le type du MyRock placé est donc de nouveau déduit comme TinyRock, tout en conservant ses deux relations Is. « Exploré » est une étiquette de catégorie distincte qui ne remplace pas le type. L’article Tag présente d’autres usages.

Dans l’exemple « Système fixe et limite de Plane », l’étoile MyFixedSun hérite uniquement de la catégorie générale Star. L’entrée Type MyFixedSun choisit explicitement sa propre définition à la place de Star. Le dictionnaire contient donc une clé MyFixedSun pour la ligne de type et une clé distincte MyFixedSunName pour le nom de l’étoile. C’est le choix d’une désignation, pas une commande recréant l’étoile ou recopiant ses propriétés.

Able - action disponible

Autorisons la prospection géologique sur un très petit monde rocheux. Ajoutez une entrée à la définition de TinyRock :

["TinyRock", "Able", "GeoSurvey"]

Ce fragment se lit : « La prospection géologique est autorisée sur un très petit monde rocheux ». TinyRock et GeoSurvey sont déjà définis dans le jeu. Les mondes rocheux héritent de cette autorisation depuis Rocky. Ajouter cette ligne répète donc une règle existante. Elle illustre l’écriture d’Able, sans créer un deuxième bouton.

Able autorise la proposition d’une action sans annuler ses conditions. La prospection géologique exige par exemple la technologie MantleDrilling. Cette condition figure sur GeoSurvey elle-même :

["GeoSurvey", "Requires", "MantleDrilling"]

Sans cette technologie, Able seul ne permet pas de réaliser la prospection géologique. Il faut aussi un corps adapté exploré et des ressources pour le paiement. Le coût et le résultat appartiennent à la définition de l’action. L’article Action explique comment créer votre propre action.

Les objets héritent d’Able par Is. Un trait actif peut également accorder cette autorisation. Has et Able ont des fonctions distinctes : Has inclut un objet dans le contenu d’un autre, Able autorise une action.

Imports - bibliothèque d’une autre simulation

Imports utilise les définitions d’une autre simulation installée, par exemple ses classes de mondes. C’est une dépendance supplémentaire du mod. Le jeu lit des données, sans installer une simulation absente, une extension ni du code exécutable. Un mod ordinaire de PreWarpAge n’a pas besoin d’import : les définitions du jeu de base sont déjà disponibles.

Indiquez le nom de la simulation ou un chemin « Simulation/Fichier » sans l’extension .json. Le fragment suivant ne convient qu’à une installation possédant StarGenerator et son fichier Worlds. Leur présence n’est pas garantie parmi les fichiers de PreWarpAge.

["Simulation", "Imports", "StarGenerator/Worlds"]

Le jeu charge les définitions de Logic/Worlds.json de cette simulation, puis ses propres imports. Si le fichier manque, la nouvelle partie n’est pas créée et le chargeur signale une erreur. Les paramètres de scène principale du jeu importé ne doivent pas remplacer la scène de PreWarpAge.

Avant d’utiliser une bibliothèque, vérifiez que les images, traductions et règles nécessaires sont disponibles dans la version installée. Charger ses définitions ne transforme pas PreWarpAge en un autre mode de jeu.

Owner - propriétaire

Owner répond à la question « À qui appartient cet objet ? ». Supposons que MyMarker existe déjà sur Terre. Attribuons-le au joueur :

["MyMarker", "Owner", "Player"]

PreWarpAge ne possède qu’un joueur, donc Player désigne sans ambiguïté le bénéficiaire du marqueur. Cette ligne indique le propriétaire. Pour faire aussi apparaître le marqueur sur la carte, il faut préciser séparément son emplacement.

Le fragment suivant crée sur Terre un objet illustré par un avant-poste et l’attribue à l’unique joueur. Vérifiez-le dans une nouvelle partie du scénario « Système solaire », où Earth est définie. MyMarker est un nom inventé. Building, Player et outpost existent déjà.

["MyMarker", "Is", "Building"],
["MyMarker", "Icon", "outpost"],
["MyMarker", "PlacedAt", "Earth"],
["MyMarker", "Owner", "Player"]

PlacedAt crée l’objet sur la Terre existante, Icon lui donne son image et Owner le relie au joueur créé. Sans PlacedAt, ces lignes ne produisent aucun marqueur sur la carte. La construction ordinaire attribue le propriétaire par l’action Build.

Owner peut désigner un objet existant précis ou sa définition. Notre exemple nomme la définition Player : le jeu retrouve le joueur créé à partir de celle-ci. Avec plusieurs joueurs, cette référence ne signifie plus « courant » ou « le plus proche ». Un numéro arbitraire Player_0 copié depuis une autre sauvegarde ne résout pas cette ambiguïté.

Le propriétaire attribué permet de vérifier sa réserve. Par exemple, le trait WellFundedWorld donne un bonus au monde si son propriétaire possède assez de Science. Sa condition s’écrit ainsi :

["WellFundedWorld", "Requires.Owner.Has.Science.Min", 100]

Owner mène ici du monde au joueur, Has.Science à la Science possédée par celui-ci et Min 100 à la limite inférieure. Sans Owner, la réserve du monde lui-même serait vérifiée. L’article « Source des conditions et ajustement d’un paramètre » explique la définition complète de WellFundedWorld et l’activation du bonus.

Pour que chaque joueur possède sa propre technologie, utilisez Player Has <technologie>. Un objet partagé avec Owner Player ne remplace pas la création de ces instances distinctes.

Parent - entité à l’origine de la création

L’événement d’un astéroïde possède un bouton de bombardement Bombard. Quand le joueur l’utilise, l’astéroïde lui-même doit subir les dégâts. Le lien Parent, « parent », mène du bouton à l’événement qui le contient.

Bombard est un choix existant de bombardement d’astéroïde. Le joueur clique sur son bouton dans la carte d’événement de l’astéroïde. Pour ce choix, Parent désigne la carte elle-même. Le fragment suivant la définit donc comme destinataire des dégâts.

["Bombard", "Damage.Target", "Parent"]

Cette ligne figure déjà dans la définition du bombardement et illustre un mécanisme existant, pas une attaque indépendante. Pour changer la puissance du bombardement, modifiez Damage. Parent seul ne suffit pas à créer une arme.

On a parfois besoin de la cible du parent, plutôt que du parent. Le résultat d’expérience NanobotsEscaped utilise alors Parent.Target :

["NanobotsEscaped", "Transforms.Target", "Parent.Target"]

Parent mène du résultat à l’événement de l’expérience, puis Target de cet événement au monde choisi. C’est donc le monde de l’expérience qui se transforme, pas son message. L’article Transforms explique ce cas en détail.

Si la chaîne existante comporte un autre parent, Parent.Parent parcourt deux liens successifs. Le jeu crée ces relations lors de l’apparition des événements et résultats. Ni le nom d’une partie de définition ni un numéro d’objet d’une autre partie ne remplace ce lien. Parent ne désigne pas non plus l’héritage Is ni la propriété Owner.

PlacedAt - emplacement de l’objet

PlacedAt répond à la question « Où se trouve l’objet ? ». Vous pouvez définir la Terre comme emplacement du marqueur MyMarker :

["MyMarker", "PlacedAt", "Earth"]

Dans une nouvelle partie « Système solaire », le jeu crée le marqueur décrit sur Earth. C’est un placement initial : le joueur ne clique pas sur « Construire » et ne paie aucun coût. La construction ordinaire, qui demande une action du joueur, utilise Build.

Définissons maintenant le marqueur entièrement. Les lignes suivantes s’ajoutent à un fichier Logic du mod : Is Building indique son rôle, Icon choisit une image existante et Owner attribue son propriétaire.

["MyMarker", "Is", "Building"],
["MyMarker", "Icon", "outpost"],
["MyMarker", "PlacedAt", "Earth"],
["MyMarker", "Owner", "Player"]

Ce fragment utilise Earth, la Terre du scénario « Système solaire ». MyMarker est le nom du nouvel objet, Building son rôle et outpost le nom d’une image existante. PlacedAt place le marqueur sur Terre et Owner l’attribue au joueur. Dans un scénario sans Earth, ces lignes ne créent ni la Terre ni un marqueur sur celle-ci.

PlacedAt peut concerner plusieurs lieux. Prenons une variante distincte : deux mondes prédéfinis, MyHostA et MyHostB, sont déjà placés sur la carte et appartiennent à notre catégorie MyMarkerHost. MyMarkerHost lui-même n’y est pas placé. Positionnez les mondes avec Orbit, comme dans l’article correspondant. La règle du marqueur s’écrit alors :

["MyMarkerHost", "Is", "World"],
["MyHostA", "Is", "MyMarkerHost"],
["MyHostB", "Is", "MyMarkerHost"],
["MyMarker", "PlacedAt", "MyMarkerHost"]

Le jeu ne trouve aucun corps créé directement à partir de MyMarkerHost et passe à ses descendants. Un marqueur apparaît sur chacun des deux mondes placés. Un seul PlacedAt ne signifie pas « choisir un monde au hasard ». Les champs propres Owner, Name et Icon du marqueur restent identiques à ceux de l’exemple complet ci-dessus.

Modifions seulement le contenu de la carte : plaçons aussi la définition MyMarkerHost elle-même. Dans une variante distincte du Système solaire, ajoutons-lui par exemple un centre et un anneau explicites :

["MyMarkerHost", "Orbit.Center", "Sun"],
["MyMarkerHost", "Orbit", 3]

Lorsqu’un exemplaire de MyMarkerHost lui-même est placé, la recherche le choisit. MyHostA et MyHostB ne sont plus ajoutés comme solution de repli : le marqueur apparaît sur le lieu direct, pas sur les trois mondes. C’est la priorité de la définition exacte sur ses descendants. Pour distinguer les mondes, ajoutez leurs Name et Icon ordinaires. Ces lignes montrent uniquement le changement de placement.

L’emplacement doit déjà se trouver sur la carte. Si une variante indique un monde futur qui n’a pas encore été créé, le marqueur n’apparaît pas encore :

["MyMarker", "PlacedAt", "MyLateHost"]

Quand MyLateHost sera créé et recevra une cellule Cell, le placement différé pourra créer le marqueur. Une simple définition MyLateHost Is World sans apparition du corps ne suffit pas. C’est l’attente d’un emplacement pendant la création de la carte, pas une fabrique permanente de marqueurs sur tous les mondes futurs : répéter le placement peut recréer les objets. Ne l’utilisez pas pour accumuler des instances à chaque répétition.

Indiquez Owner séparément si l’objet doit appartenir au joueur. PlacedAt n’est pas non plus transféré par l’héritage Is ordinaire : une nouvelle définition doit préciser explicitement son placement. Lors de la construction par Build, l’action attribue elle-même l’emplacement et le propriétaire.

Carte et placement

Center - centre de la scène

La carte d’un système stellaire se compose d’anneaux autour d’un corps central. Center désigne ce corps, généralement une étoile. La carte et l’étoile sont décrites séparément : la carte conserve la disposition des cellules, l’étoile ses propriétés et le nombre d’anneaux. L’article « Système fixe et limite de Plane » explique comment intégrer un tel système à une nouvelle partie.

Indiquons d’abord directement le centre. MyMap est le nom de notre carte et Sun la définition existante du Soleil. Center relie la carte au corps central :

["MyMap", "Center", "Sun"]

Ce n’est pas encore le nombre d’anneaux. Les anneaux appartiennent à l’étoile elle-même. Ajoutons-en huit dans une entrée distincte. Les deux entrées donnent :

["MyMap", "Center", "Sun"],
["Sun", "Orbits", 8]

MyMap est un nom de carte inventé. Sun devient son centre et reçoit huit anneaux. Ces lignes n’ajoutent pas de scénario au menu. Il faut pour cela MyFixedSystem et les autres définitions de l’exemple complet.

Dans PreWarpAge, le scénario choisit l’étoile centrale. Le nouveau SurveySystem utilise par exemple ClassG :

["SurveySystem", "Orbit.Center", "ClassG"]

Ce choix du scénario est prioritaire sur le paquet Center.Deck. La recette « Scénario » montre comment ajouter SurveySystem au menu. Une entrée Center sur une carte distincte ne crée pas une carte de scénario.

Le générateur accepte aussi des étoiles compagnes facultatives. L’intervalle suivant autorise par exemple de zéro à deux compagnes :

["MyMap", "Center.Companions.Min", 0],
["MyMap", "Center.Companions.Max", 2]

Sans Center.Companions.Max, aucune compagne n’est créée. Avec ces limites, il peut y en avoir zéro, une ou deux. Pour favoriser une compagne, gardons les limites et ajoutons Peak :

["MyMap", "Center.Companions.Min", 0],
["MyMap", "Center.Companions.Max", 2],
["MyMap", "Center.Companions.Peak", 1]

La valeur un devient privilégiée, mais la limite reste deux : Peak ne garantit pas exactement une compagne.

La taille du système proche d’une compagne est un paramètre distinct. Celui-ci lui réserve d’un à deux anneaux :

["MyMap", "Center.Companions.Reach.Min", 1],
["MyMap", "Center.Companions.Reach.Max", 2]

Sans ces deux paramètres, la limite est de trois anneaux. Les deux exemples décrivent la génération. Ils n’ajoutent pas à PreWarpAge un bouton de déplacement entre systèmes.

Orbits - anneaux, zones et satellites

Définissons d’abord le nombre d’anneaux d’une étoile. ClassK en possède huit :

["ClassK", "Orbits", 8]

Il s’agit des huit anneaux du système stellaire où sont placées les planètes. Cette ligne ne définit pas le nombre de lunes de chaque planète.

Définissons maintenant les satellites d’une planète. Pour GasGiantMedium, le même Orbits concerne les lunes. Un intervalle donne aux géantes des nombres différents :

["GasGiantMedium", "Orbits.Random.Min", 0],
["GasGiantMedium", "Orbits.Random.Max", 2]

Une nouvelle géante gazeuse moyenne possédera zéro, une ou deux lunes. Orbits.Random.Peak peut favoriser un nombre dans ces limites. L’article Random explique le choix des nombres aléatoires.

La composition des lunes se définit séparément de leur nombre. Dans Orbits.Deck, la classe du satellite suit le dernier point. Cette carte autorise par exemple un satellite rocheux TinyRock :

["GasGiantMedium", "Orbits.Deck.TinyRock", 1]

Le nombre 1 est le nombre de cartes TinyRock dans le paquet. Il ne remplace pas la limite de deux lunes. Les limites communes à toutes les lunes du système se définissent sur l’étoile centrale par Orbits.Moons.Min et Orbits.Moons.Max.

Revenons aux anneaux de l’étoile. Ils sont répartis entre les zones climatiques. Le poids de la zone habitable de ClassK s’écrit par exemple ainsi :

["ClassK", "Orbits.Habitable.Weight", 2]

Ce poids est comparé à ceux des autres zones. Avec huit anneaux et quatre poids identiques de 2, chaque zone reçoit deux emplacements. Chaque zone reçoit Orbits × son poids / somme des poids positifs, arrondi à l’entier, avec les demi-unités arrondies vers le haut. La somme des valeurs arrondies séparément peut différer d’Orbits.

Chez un descendant, le poids agit comme un ajout. Supposons que la zone habitable de ClassK ait un poids de 2, comme ci-dessus. Ajoutons notre variante d’étoile :

["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Weight", 1]

Pour MyStar, la zone habitable reçoit un poids de 2 + 1 = 3. C’est son poids avant la répartition des anneaux, pas la promesse de trois planètes. Remplaçons uniquement cet ajout par zéro :

["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Weight", 0]

Le poids reste 2 + 0 = 2 : zéro ne supprime pas la zone héritée. Sans contribution héritée, un poids nul exclut la zone. Après un changement des poids, vérifiez qu’il reste un emplacement pour le monde natal.

Après le nombre d’emplacements, choisissons les mondes de la zone habitable. Ces deux cartes lui donnent un monde terrestre et un monde océanique :

["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 1],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]

Avec deux emplacements, le paquet distribue les deux types dans un ordre aléatoire. Avec un seul, un seul des deux apparaît. L’héritage d’un paquet fonctionne autrement : il est remplacé entièrement. Gardons les deux cartes ci-dessus sur ClassK et donnons à MyStar une carte propre :

["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Deck.StandardEarthlike", 1]

Le paquet habitable de MyStar ne contient plus que StandardEarthlike. Le StandardOcean du parent ne s’y ajoute pas. Contrairement au poids de zone, un paquet propre n’est pas un ajout à l’ancien. Supprimer cette entrée rend de nouveau accessible tout le contenu de ClassK.

Pour le modèle physique, une limite de température peut décrire la zone. Voici par exemple la limite inférieure de la zone habitable :

["ClassK", "Orbits.Habitable.Temperature.Min", 240]

Le nombre est exprimé en kelvins. Si vous utilisez des limites de température, définissez-les pour toutes les zones de poids positif. La limite intérieure du système entier est un paramètre distinct :

["ClassK", "Orbits.UltraHot.Temperature.Max", 4000]

Cette ligne fixe la limite intérieure du système à 4000 K au lieu des 5000 K d’origine. C’est précisément UltraHot.Temperature.Max qui sert à cela. Le Max d’une autre zone ne remplace pas cette limite intérieure commune.

Sans limites de température, les zones sont disposées de l’intérieur vers l’extérieur dans leur ordre de déclaration. PreWarpAge utilise UltraHot, Hot, Habitable, Snow et Outer. Une zone personnalisée peut définir le placement des corps sans recevoir automatiquement les effets économiques des zones climatiques existantes. Orbits.Seeded et les résultats des distributions conservent la génération déjà effectuée. Ne les écrivez pas dans un mod.

Orbit - position sur un anneau

Ajoutons à la Terre un satellite MyMoon fondé sur TinyRock. Indiquons d’abord le corps autour duquel il doit apparaître :

["MyMoon", "Orbit.Center", "Earth"]

Earth est la Terre existante du scénario « Système solaire ». Dans un autre scénario sans Earth, cette ligne ne crée pas la Terre. Un nouvel objet doit déclarer Orbit.Center explicitement : l’héritage Is ordinaire ne le transmet pas.

Choisissons maintenant l’anneau. La ligne suivante place le satellite sur le premier anneau autour de la Terre :

["MyMoon", "Orbit", 1]

Orbit prend un numéro entier. Zéro désigne le centre lui-même. Le premier anneau possède six cellules. Sans cellule précise, le jeu en choisit une libre.

Choisissons la cellule du haut, de numéro 0. Orbit.Index détermine la cellule :

["MyMoon", "Orbit.Index", 0]

La numérotation commence en haut et tourne dans le sens horaire. L’anneau 2 possède 12 cellules, l’anneau 3 en possède 18 : leur nombre vaut six fois le numéro de l’anneau. Un indice trop grand fait le tour de l’anneau. Rassemblons le rôle du satellite et ces trois paramètres :

["MyMoon", "Is", "TinyRock"],
["MyMoon", "Orbit.Center", "Earth"],
["MyMoon", "Orbit", 1],
["MyMoon", "Orbit.Index", 0]

MyMoon apparaît sur le premier anneau de la Terre, dans la cellule du haut. Si le scénario choisi ne possède pas Earth, ce fragment ne la crée pas.

Le déplacement par tour se règle séparément de la cellule initiale. Donnons par exemple aux corps un pas d’une cellule :

["Simulation", "Orbit.Step", 1]

Les corps se déplacent d’une cellule par tour. Zéro ou l’absence d’Orbit.Step désactive ce mouvement. Le champ initial Orbit.Index ne devient pas une vitesse pour autant.

Un autre paramètre de la carte désactive la dérive décorative lors du placement :

["MyMap", "Orbit.Static", true]

MyMap est ici la carte de l’article Center. Orbit.Static désactive sa dérive décorative, sans annuler le pas par tour défini sur Simulation. Orbit.Zone conserve la zone d’un corps déjà créé. Orbit.Distance.Max et Orbit.Star.Type.Not ne sont pas des filtres pris en charge par la PreWarpAge actuelle. Ne les utilisez pas pour interdire des emplacements. Orbit.Center, Orbit et Orbit.Index servent au placement fixe. Le champ physique Distance.Max de l’article Distance est une autre grandeur, pas une contrainte du générateur.

OrbitFill - remplissage d’une ceinture

Une ceinture occupe plusieurs cellules d’un même anneau. OrbitFill définit la fraction de l’anneau à remplir, sans placer chaque rocher séparément. Dans ce fragment, MyBelt est le nom d’une nouvelle ceinture et RockyAsteroid la classe existante des astéroïdes rocheux. Vérifiez-le dans une nouvelle partie « Système solaire », où Sun est déjà défini.

Les champs déjà rencontrés Orbit.Center et Orbit définissent le centre et l’anneau. La nouvelle entrée OrbitFill 0.6 remplit 60 % des cellules de l’anneau. Rassemblons ces paramètres avec la définition des rochers :

["MyBelt", "Is", "RockyAsteroid"],
["MyBelt", "Orbit.Center", "Sun"],
["MyBelt", "Orbit", 4],
["MyBelt", "OrbitFill", 0.6]

Dans une nouvelle partie « Système solaire », la ceinture occupe les cellules disponibles du quatrième anneau autour du Soleil, soit environ 60 % s’il y a assez de place. En cas de manque, elle n’occupe que les cellules libres. OrbitFill vaut généralement de 0 à 1. Une valeur de 1 remplirait tout l’anneau disponible.

Pour que tous les rochers constituent une ceinture unique avec des ressources et actions communes, ajoutez ce paramètre à MyBelt :

["MyBelt", "OrbitFill.Lead", true]

La ceinture possède désormais un objet principal. Les autres rochers en sont les fragments représentés. Sélectionner n’importe quel fragment ouvre les ressources communes. Les rochers dessinés n’ont pas de réserves distinctes. Le jeu crée lui-même les liens entre eux.

Trojans et TrojansOf - essaims troyens

Les troyens sont deux groupes de petits corps sur l’orbite d’une planète : l’un environ 60° devant elle et l’autre derrière. Donnons d’abord aux géantes une chance d’en recevoir :

["Giant", "Trojans.Chance", 20]

Chaque nouvelle géante a 20 % de chances de recevoir la caractéristique Trojans. Cela décide seulement de la présence des troyens, sans décrire les rochers de l’essaim.

Décrivons maintenant les rochers. GiantTrojan est un nouveau type fondé sur les astéroïdes rocheux RockyAsteroid. TrojansOf Giant relie ce type aux géantes. Voici la probabilité et la définition de l’essaim réunies :

["Giant", "Trojans.Chance", 20],
["GiantTrojan", "Is", "RockyAsteroid"],
["GiantTrojan", "TrojansOf", "Giant"]

Certaines géantes créées reçoivent des essaims GiantTrojan devant et derrière elles sur le même anneau. Cela ne crée pas de géantes absentes. Pour un système prédéfini, TrojansOf peut nommer une planète précise à la place de la catégorie Giant. Placez TrojansOf sur le nouveau type d’essaim, pas sur RockyAsteroid en général, sinon la règle affecterait tous ces astéroïdes. TrojansOf.Seeded marque un placement déjà effectué. Ce fait interne n’est pas nécessaire dans le mod.

Plane - carte rectangulaire

Plane décrit un champ rectangulaire de cellules hexagonales. C’est une possibilité du moteur général pour laquelle PreWarpAge ne propose pas encore de recette de partie complète avec étoiles et monde natal. Cet article explique donc seulement le format. Pour un scénario jouable, utilisez le système d’anneaux de « Système fixe et limite de Plane ». Remplacer Orbit.Center par Plane.Cols et Rows ne crée pas un tel scénario.

La taille du champ est la première partie de sa description. Ces deux lignes définissent neuf colonnes et cinq lignes :

["MySector", "Plane.Cols", 9],
["MySector", "Plane.Rows", 5]

Le champ obtenu comporte 9 × 5 cellules hexagonales. Les deux nombres doivent être des entiers positifs. Sans Plane.Rows, la hauteur devient égale à la largeur : ici, le champ sera de 9 × 9.

La partie suivante est le paquet d’étoiles remplissant les cellules libres. Ajoutons une carte de l’étoile existante ClassG, avec un poids de 4, à la taille déjà définie :

["MySector", "Plane.Cols", 9],
["MySector", "Plane.Rows", 5],
["MySector", "Plane.Deck.ClassG", 4]

Le nombre 4 est le poids de ClassG dans le paquet, pas la largeur du champ ni un nombre garanti d’étoiles. Les systèmes natals déclarés sont placés d’abord, puis le paquet remplit les cellules restantes. Cette description règle la géométrie et la distribution. Elle ne lance pas une nouvelle partie de PreWarpAge et ne crée pas de transitions entre cartes. Plane.Homed, Scattered et ColonyMinted marquent les objets déjà créés. Ne transférez pas ces champs internes dans le mod.

Spawn - monde natal du joueur

Spawn choisit le monde natal du joueur. Vous pouvez nommer un corps déterminé à l’avance ou demander au jeu de choisir parmi les mondes adaptés. Ces mondes doivent réellement apparaître sur la carte. Earthlike est la catégorie des mondes semblables à la Terre. Homeworld est le lien vers le monde natal déjà choisi pour un joueur précis. StandardOcean n’appartient pas à Earthlike et ne remplace pas un départ sur un monde terrestre.

Pour un monde natal choisi à l’avance, indiquez-le avec Spawn. Dans « Système solaire », le joueur peut commencer sur la Terre existante :

["Player", "Spawn", "Earth"]

C’est le choix d’une définition précise, adapté uniquement à une carte où Earth est réellement créée. Spawn seul ne crée pas une planète absente.

Pour une carte aléatoire, remplacez le nom de planète par une catégorie adaptée dans Spawn.Random :

["Player", "Spawn.Random", "Earthlike"]

Le joueur reçoit un monde aléatoire de catégorie Earthlike parmi ceux déjà créés sur la carte. Homeworld désigne ensuite ce monde natal. StandardOcean n’appartient pas à Earthlike, donc un monde océanique seul ne convient pas à ce départ.

false désactive le choix aléatoire. Dans une définition distincte de Player avec un Spawn Earth explicite, annulez par exemple le choix aléatoire hérité ainsi :

["Player", "Spawn.Random", false]

Spawn.Random accepte un nom de catégorie ou false, mais ni true ni un nombre. Si Spawn et Spawn.Random sont tous deux définis, Spawn explicite est prioritaire. Ces paramètres initiaux s’appliquent à une nouvelle partie. Modifier le fichier ne déplace pas le monde natal d’un joueur en cours de partie.

Pour garantir un départ dans un système aléatoire, créez au moins un Earthlike. Donner un poids élevé à sa carte ne garantit pas de monde natal s’il n’y a qu’un emplacement et que StandardOcean reste dans le paquet. Voir l’exemple complet « Votre étoile avec un monde natal garanti ». Spawn.Lost et OriginKey conservent l’histoire de la partie. Ne les copiez pas depuis une sauvegarde.

Grid et AutoSelect - présentation de la carte

Grid choisit l’aspect d’une carte déjà créée. Gardons la représentation habituelle des corps célestes de PreWarpAge :

["Simulation", "Grid", "Decorative"]

Remplacer Decorative par Hex affiche une grille de cellules hexagonales. Cela change l’aspect, pas le nombre d’anneaux, toujours défini par Orbits. La géométrie rectangulaire relève de Plane.

La sélection à la souris est un paramètre distinct. Supposons que MyMarker, de l’article PlacedAt, soit déjà sur Terre. Pour qu’un clic sur la planète ne sélectionne pas automatiquement le marqueur, indiquez :

["MyMarker", "AutoSelect", false]

Le marqueur conserve son emplacement et son propriétaire. Seule sa sélection automatique au clic change. Sans AutoSelect, le comportement ordinaire s’applique.

Le même false produit un autre résultat sur la carte. Dans une variante distincte, définissez-le sur Simulation :

["Simulation", "AutoSelect", false]

Un clic sélectionne la cellule elle-même plutôt que le corps dessiné. Dans l’exemple précédent, la carte sélectionnait toujours le corps, mais le marqueur n’interceptait plus le clic. La différence dépend du sujet de l’entrée : Simulation ou MyMarker.

Par exemple, MyMarker de l’article PlacedAt est installé sur une planète. Le fragment suivant conserve l’aspect décoratif de la carte et empêche le marqueur d’intercepter un clic sur la planète. Le marqueur doit être placé séparément. AutoSelect ne change pas son propriétaire et n’autorise pas la construction.

["Simulation", "Grid", "Decorative"],
["MyMarker", "AutoSelect", false]

Si plusieurs objets occupent un même lieu, il est possible de privilégier celui que contrôle le joueur :

["Simulation", "AutoSelect.Controllable", true]

Cette priorité s’applique à la sélection automatique. Elle ne donne pas au joueur le droit de contrôler un objet appartenant à quelqu’un d’autre.

Cell et OrbitSlot - position d’un monde en cours de partie

Cell conserve la cellule d’un corps créé. C’est un lien interne à la partie. Dans le mod, indiquez le centre, l’anneau et la position voulus avec Orbit. Le jeu écrit lui-même l’adresse exacte de Cell. Le mod ne dépend ainsi pas des numéros d’objets attribués dans une autre partie.

Cell est une référence à une cellule d’une scène précise. Elle apparaît au placement du monde et ne définit pas sa classe. OrbitSlot.* conserve les informations calculées de l’emplacement orbital dont provient le corps. Ne copiez pas ces adresses et résultats depuis une partie arbitraire. Pour une position prédéfinie, utilisez Orbit/Orbit.Center/Orbit.Index. Pour la génération, utilisez Orbits ou Plane.

["MyMoon", "Is", "TinyRock"],
["MyMoon", "Orbit.Center", "Earth"],
["MyMoon", "Orbit", 1]

Dans le scénario du Système solaire, ce fragment déclare un nouveau satellite rocheux de la Terre existante. Le jeu lui attribue Cell lors de son placement sur le premier anneau. Aucun numéro de cellule ou d’instance issu d’une autre sauvegarde n’est nécessaire. Dans un scénario sans Earth, le fragment ne crée pas la Terre absente.

Choix aléatoires

Seed - graine de la partie

La graine est le nombre à partir duquel le jeu produit les résultats aléatoires. Elle permet de reproduire une partie : il faut les mêmes fichiers du jeu et des mods, la même graine et la même suite d’actions. C’est utile pour tester un mod : en changeant un seul paramètre, vous comparez les résultats sur un départ identique. Après une modification des règles, la même graine ne garantit pas la même carte.

Seed se définit sur Simulation avec un entier compris entre 0 et 2147483647. Le menu propose des valeurs jusqu’à 99999. Le fichier accepte toute la plage. Sans graine choisie, le jeu en attribue une au hasard. Le fragment suivant propose la graine 42.

["Simulation", "Seed", 42]

À la création d’une nouvelle partie, le joueur peut choisir une autre graine et remplacer ainsi l’entrée du mod. Les champs Seed.Rng.<clé> permettent aux développeurs de contrôler certains résultats aléatoires pendant les vérifications. Ils ne sont pas nécessaires pour un changement d’équilibrage ordinaire.

Random - nombre aléatoire

Donnons aux nouveaux mondes MyRock des tailles différentes, de 1 à 3. Définissons les deux limites de Size.Random sur la nouvelle définition :

["MyRock", "Is", "TinyRock"],
["MyRock", "Size.Random.Min", 1],
["MyRock", "Size.Random.Max", 3]

Chaque MyRock créé reçoit son propre nombre dans cet intervalle. Le choix est conservé : rouvrir l’infobulle ne le change pas. Pour voir cette nouvelle classe, placez-la séparément sur la carte ou ajoutez-la à un paquet de mondes.

Les limites doivent être numériques et Min ne doit pas dépasser Max. Les deux sont nécessaires, mais l’une ou les deux peuvent déjà exister sur le parent. Remplacer Size par un autre champ numérique rend ce champ aléatoire si ses règles acceptent Random.

Définissons maintenant des valeurs précises : 1, 2 et 3. Ajoutez un pas de 1 à cet exemple :

["MyRock", "Size.Random.Step", 1]

Sans autre paramètre de distribution, les trois valeurs sont équiprobables. Le pas doit être positif. Sans Step, des limites entières provoquent l’arrondi du nombre tiré. Cette autre méthode ne garantit pas la même probabilité à chaque valeur. Écrire 1.0 au lieu de 1 ne change rien.

Pour obtenir plus souvent une taille proche de 2, définissez le pic de la distribution :

["MyRock", "Size.Random.Peak", 2]

Peak 2 favorise la zone proche de deux. Peak true choisit le milieu de l’intervalle et Peak false conserve une distribution uniforme. Avec un pic et Step, le résultat est arrondi aux valeurs définies par le pas.

Une distribution en loi de puissance est disponible pour les grands intervalles. Dans cette variante indépendante MyWeightedRock, les petites tailles sont plus fréquentes que les grandes :

["MyWeightedRock", "Is", "TinyRock"],
["MyWeightedRock", "Size.Random.Min", 1],
["MyWeightedRock", "Size.Random.Max", 100],
["MyWeightedRock", "Size.Random.PowerLaw", 1]

Pour un intervalle positif, un PowerLaw positif favorise les petits nombres, un négatif les grands, et zéro donne une distribution uniforme. La densité est proportionnelle au nombre élevé à l’opposé de l’exposant. Avec un exposant de 1, des rapports de valeurs égaux sont équiprobables. PowerLaw est prioritaire sur Peak. N’ajoutez donc pas de pic à cet exemple.

Enfin, vous pouvez énumérer les valeurs acceptées plutôt que donner un intervalle. Par exemple, le corps ne doit avoir qu’une taille de 1 ou de 3 :

["MyListedRock", "Is", "TinyRock"],
["MyListedRock", "Size.Random", 1],
["MyListedRock", "Size.Random", 3]

Les deux valeurs énumérées sont équiprobables. Cette liste ne peut pas être combinée aux Min et Max propres du même champ.

Certains champs ont leur propre règle de discrétisation : une durée en tours reste par exemple entière. Un intervalle fractionnaire n’annule pas cette règle. Les valeurs infinies ou non numériques ne sont pas autorisées dans Min et Max. Rassemblons le MyRock initial avec son pas :

["MyRock", "Is", "TinyRock"],
["MyRock", "Size.Random.Min", 1],
["MyRock", "Size.Random.Max", 3],
["MyRock", "Size.Random.Step", 1]

Chaque MyRock créé reçoit une taille de 1, 2 ou 3 avec des probabilités égales. Pour le voir, ajoutez MyRock à un paquet de mondes ou placez-le avec Orbit. Un Size fixe sur une nouvelle définition, sans intervalle propre, remplace la taille aléatoire héritée. Random.Prior, Drawn et Source conservent le choix déjà réalisé. Ne les définissez pas dans le fichier du mod.

Chance - probabilité d’une caractéristique ou d’une issue

Chance définit une probabilité. Commençons par une caractéristique de monde : une géante gazeuse moyenne peut posséder un essaim troyen. Fixons sa probabilité à 20 % :

Dans ce premier exemple, Trojans est la caractéristique « possède des troyens » et Chance sa probabilité d’apparition. Le nombre doit être compris entre 0 et 100.

Dans le fragment suivant, GasGiantMedium est la classe existante des géantes gazeuses moyennes. Seule la probabilité de Trojans change. L’article Trojans et TrojansOf explique le placement de l’essaim. Pour modifier le risque d’un événement, utilisez l’exemple EventChoice avec Failure : Chance.Target y désigne une issue précise.

["GasGiantMedium", "Trojans.Chance", 20]

Chaque nouvelle géante reçoit indépendamment cette caractéristique avec une probabilité de 20 %. Un échec conserve false. Un succès exactement sur cinq n’est pas garanti. Si la caractéristique est déjà définie, elle n’est pas retestée.

Dans un événement, une probabilité peut être un paramètre distinct. La partie Capture de RobotUprising choisit par exemple parmi trois chances de capture :

["RobotUprising.Capture", "Chance.Deck.20", 1],
["RobotUprising.Capture", "Chance.Deck.30", 1],
["RobotUprising.Capture", "Chance.Deck.40", 1]

Cette partie reçoit 20 %, 30 % ou 40 %. Le nombre après Chance.Deck est le pourcentage possible lui-même. Le troisième élément, 1, est le nombre de cartes correspondantes. Chance.Name définit l’étiquette du paramètre, par exemple CaptureChance pour cette partie du soulèvement.

Le joueur peut améliorer un autre paramètre du même soulèvement : la probabilité de reprendre le secteur capturé. Le bouton existant UprisingTroops l’écrit ainsi :

["UprisingTroops", "Chance.Add", 15],
["UprisingTroops", "Chance.Target", "Parent.Retake"]

Cliquer ajoute 15 points de pourcentage à Retake de l’événement parent : 20 % devient par exemple 35 %. Chance.Target est obligatoire, car il nomme la chance modifiée. Le résultat est limité entre zéro et Chance.Max, qui vaut par défaut 100 %. Chance.Add doit être non nul. C’est une action sur un paramètre d’événement, pas un nouveau tirage de caractéristique de monde.

Changes - choix d’un type

Changes choisit pour l’objet une des variantes définies à l’avance. Son image et ses propriétés peuvent ainsi changer tout en conservant l’objet lui-même. La variante choisie devient Type. Transforms sert à remplacer entièrement le corps par une autre classe, ce qui peut détruire ses anciens bâtiments.

Définissons un nouveau très petit monde MyBody et une variante d’apparence SurveyVariant. Changes relie la variante à la classe du monde et son Icon définit la nouvelle image :

["MyBody", "Is", "TinyRock"],
["SurveyVariant", "Changes", "MyBody"],
["SurveyVariant", "Changes.Chance", 100],
["SurveyVariant", "Icon", "earth"]

L’unique variante possède un poids Changes.Chance de 100. À la création de MyBody, elle sera donc choisie comme Type et donnera l’image earth. Pour voir le monde sur la carte, placez MyBody avec Orbit ou ajoutez-le à un paquet de mondes. Les autres classes de planètes ne changent pas.

Autorisons maintenant l’absence de variante : seule une partie des mondes doit la recevoir dans une nouvelle partie. Remplacez son poids par 25 :

["SurveyVariant", "Changes.Chance", 25]

S’il n’existe aucune autre variante adaptée, SurveyVariant aura 25 % de chances au premier choix, et 75 % resteront sans elle. Sans entrée explicite, le poids vaut 100. Remplaçons maintenant l’absence par un choix entre deux apparences du même MyBody :

["SurveyVariant", "Changes", "MyBody"],
["SurveyVariant", "Changes.Chance", 100],
["SurveyVariant", "Icon", "earth"],
["OtherVariant", "Changes", "MyBody"],
["OtherVariant", "Changes.Chance", 100],
["OtherVariant", "Icon", "ice"]

La somme des poids vaut 200 : chacune des deux variantes adaptées reçoit la moitié des chances, pas une garantie indépendante de 100 %. Un nouveau MyBody reçoit une seule apparence. Des conditions peuvent exclure une variante du choix. Une variante déjà choisie reste en place tant que ses conditions sont remplies.

Pour choisir ces apparences sans remise, vous pouvez donner à MyBody un paquet Type.Deck à la place du choix pondéré :

["MyBody", "Type.Deck.SurveyVariant", 1],
["MyBody", "Type.Deck.OtherVariant", 1]

Ce paquet est utilisé avant les poids Changes.Chance ordinaires. Il contient une carte de chacune des deux variantes déclarées. La carte choisie est consommée selon Deck, expliqué dans l’article suivant. Type devient le nom de la variante et ses propriétés s’appliquent à l’objet existant. Transforms sert au remplacement complet du corps par une autre classe. Ni Changes ni le paquet Type ne remplacent l’héritage Is.

Deck - choix sans remise

Un paquet permet un tirage sans remise. Une carte tirée disparaît du contenu. Lorsque le paquet est épuisé, son contenu est rétabli. Avec deux cartes de mondes différentes, deux tirages donnent ainsi les deux types. Deux tests Chance indépendants pourraient donner deux fois le même. Deck décrit les cartes et la règle qui l’utilise fixe le moment du tirage.

Plaçons une carte terrestre et une carte océanique dans le paquet de la zone habitable de ClassK :

["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 1],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]

Dans le jeu de base, ClassK possède deux emplacements dans cette zone. Le premier tirage choisit un type au hasard, le deuxième prend l’autre. Ces deux cartes ne peuvent pas donner deux fois de suite le même type. Une fois les cartes épuisées, le paquet est rétabli si le mécanisme demande un autre tirage.

Le nombre d’exemplaires d’une carte peut augmenter. Voici par exemple un nouveau paquet avec trois cartes terrestres et une océanique :

["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 3],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]

Au premier tirage, une carte terrestre est trois fois plus probable que l’océanique. Après son choix, il reste deux cartes terrestres et une océanique. Les deux emplacements de la zone reçoivent toujours deux mondes seulement : le nombre de cartes ne crée pas d’emplacements supplémentaires.

Pour un paquet indépendant, l’entrée commence directement par Deck. Pour le paquet d’une propriété, cette propriété précède Deck. Deck.Supplies concerne par exemple le paquet d’événements aléatoires, et Orbits.Habitable.Deck.StandardOcean la distribution des mondes de la zone habitable. La règle utilisant le paquet détermine quand tirer une carte.

Les paquets ordinaires d’événements et de corps acceptent des poids fractionnaires. Modifions par exemple ce paquet :

["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 0.5],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1.5]

Le premier tirage compare les poids 0,5 et 1,5. Si StandardOcean est choisi, son poids diminue de 1 : il reste 0,5 et 0,5. Si StandardEarthlike est ensuite choisi, tout son reliquat de 0,5 est retiré : seule la carte océanique, de poids 0,5, reste. Un poids fractionnaire ne crée pas un demi-monde. Le paquet se rétablit après épuisement.

Les cartes de poids nul ou négatif ne participent pas. Une valeur négative ne supprime pas une carte héritée : il faut un patch de suppression. L’article Orbits compare le paquet d’un parent et celui de son descendant : un contenu propre remplace l’ancien entièrement. Cette règle diffère de l’addition des poids de zones.

Une carte de ressource décrit l’extraction, pas le type du monde. Deck.Energy.2.1 signifie par exemple une carte de production d’Énergie de 2,1 par Travailleur. Le troisième nombre indique le nombre d’exemplaires dans le paquet. Pour ces cartes, le nombre doit être un entier non négatif et l’extraction positive. Le lien Deck.Energy choisit le paquet commun et Deck.Resource, à l’intérieur, une des ressources admissibles du corps. Voir l’exemple pas à pas « Nouvelle ressource exploitable et exploration différée ». L’ordre Energy.Deck.* n’est pas pris en charge.

Si une carte d’événement ne remplit temporairement pas ses conditions, elle reste dans le paquet. Le jeu conserve les cartes restantes et le nombre de tirages dans Deck.Pool et Deck.Drawn. Ne transférez pas ces entrées internes dans le mod.

Taille et propriétés physiques et descriptives des mondes

Dans PreWarpAge ordinaire, la taille, les places de travail et l’extraction sont des grandeurs de jeu. Un modèle physique complet de planète n’est pas nécessaire. Un mod peut toutefois décrire la masse, la pression, la composition et la rotation sans importer une autre simulation. L’article « Champs physiques sans bibliothèque externe » présente les données nécessaires. Ces caractéristiques ne créent pas automatiquement de nouvelles règles de peuplement ou d’extraction. Ne dupliquez pas par des nombres fixes les valeurs que le jeu calcule lui-même.

Size - territoire ou diamètre

La taille définit l’importance d’un corps sur l’échelle de jeu de PreWarpAge et participe à sa capacité. C’est une échelle ludique, pas des kilomètres. Lors d’une destruction, elle peut diminuer jusqu’au seuil déclaré, après quoi le corps disparaît ou est remplacé par des débris.

Donnons à un très petit monde rocheux une taille de jeu de 3 :

["TinyRock", "Size", 3]

Les nouveaux TinyRock auront une taille de trois unités de l’échelle du jeu. Ce nombre ne signifie pas trois kilomètres.

Pour distinguer une limite inférieure de la destruction, prenons MySizeBody fondé sur CelestialBody, sans le rôle World. Les mondes ordinaires héritent déjà de leur règle de destruction depuis World, donc TinyRock ne montrerait pas la différence. Donnons au corps d’essai une taille et seulement une limite inférieure :

["MySizeBody", "Is", "CelestialBody"],
["MySizeBody", "Size", 3],
["MySizeBody", "Size.Min", 0]

Après sa création, la taille du corps ne peut descendre sous zéro. Min seul ne signifie pas la destruction : cette variante n’a pas de Size.Dead. Ajoutons précisément la destruction à zéro :

["MySizeBody", "Size.Dead", 0]

La limite inférieure Size.Min s’applique d’abord, puis Size.Dead est vérifié. À une taille de zéro, MySizeBody est maintenant détruit. C’est le seuil de destruction qui a changé, pas la manière de limiter le nombre.

Des débris peuvent subsister après la destruction. Size.Dead.Transforms le définit. Un TinyRock ordinaire reçoit déjà de World la limite, la destruction et la transformation. Nous les répétons ici avec notre taille pour lire le résultat entier en un seul endroit :

["TinyRock", "Size", 3],
["TinyRock", "Size.Min", 0],
["TinyRock", "Size.Dead", 0],
["TinyRock", "Size.Dead.Transforms", "Debris"]

Dans ce fragment, TinyRock est la classe existante des très petits mondes rocheux et Debris désigne les débris. Les nouveaux TinyRock reçoivent une taille de 3. À zéro, le monde est remplacé par des débris. Size.Max définit la borne supérieure de la plage affichée, sans interdire toute augmentation de taille.

Pour une description physique, définissez Size.Measure Kilometers sur le corps, sa classe ou Simulation. Size devient alors le diamètre en kilomètres, Size.Area calcule la surface relative et le seuil de destruction par taille du jeu ne s’applique plus. Toutefois, les capacités ludiques peuvent toujours lire ce même Size pour la capacité. Un diamètre de 12742 ne se convertit pas automatiquement en territoire ordinaire de PreWarpAge. Activer les kilomètres exige donc une vérification séparée de l’économie et ne convient pas à un changement cosmétique.

Weight, Density et Gravity - masse, densité et gravité

Commençons par la masse de la Terre. Dans une description physique, Weight la définit en kilogrammes :

["Earth", "Weight", 5.972e24]

5.972e24 signifie 5,972 × 10²⁴ kilogrammes. Le champ s’appelle Weight. Le mot Mass ne le remplace pas. Les bornes Weight.Min et Weight.Max, si nécessaires, concernent la plage de masse affichée.

Pour calculer la densité et la gravité à partir de la masse, il faut aussi le diamètre. Dans cet exemple physique, Size s’exprime en kilomètres. Ajoutons le diamètre terrestre de 12742 km à sa masse :

["Earth", "Size.Measure", "Kilometers"],
["Earth", "Size", 12742],
["Earth", "Weight", 5.972e24]

Le jeu peut maintenant calculer Density en g/cm³ et Gravity en g terrestres. Un corps terrestre aura un Gravity proche de 1. C’est un exemple physique : convertir le Size du jeu en kilomètres change aussi la grandeur lue par les règles de capacité. Ce changement est inutile pour modifier seulement une image.

Une autre manière de définir le même modèle consiste à fournir le diamètre et la densité pour calculer la masse. Au lieu d’un Weight distinct, gardez Size avec l’unité Kilometers et définissez par exemple :

["Earth", "Density", 5.51]

C’est une densité de 5,51 g/cm³. Le jeu calcule la masse manquante à partir de cette valeur et du diamètre. De même, masse et densité permettent de retrouver le diamètre manquant. Si masse et diamètre sont déjà définis, ils déterminent la densité. N’imposez pas trois nombres indépendants contradictoires. Le modèle physique peut transformer un très petit corps extrêmement massif en trou noir.

Distance - distances et orbite physique

Il existe ici deux distances distinctes. La distance physique Distance sépare le corps de son étoile ou de sa planète et sert au chauffage et au mouvement. La distance de jeu Distance.Home mesure l’éloignement du monde natal du joueur en anneaux et peut modifier le coût des actions. Ne remplacez pas l’une par l’autre.

Définissons d’abord la distance physique de la Terre au Soleil. Par défaut, le nombre s’exprime en kilomètres et CentralBody désigne le point de référence :

["Earth", "Distance", 149597870.7],
["Earth", "Distance.CentralBody", "Sun"]

On obtient environ 149,6 millions de kilomètres de Sun. Ce n’est pas un numéro d’anneau du plateau. Distance.Min et Distance.Max affichent au besoin une plage de distances.

Décrivons maintenant la durée d’une révolution. Ajoutons Distance.OrbitalPeriod à la distance et au centre déjà définis :

["Earth", "Distance", 149597870.7],
["Earth", "Distance.CentralBody", "Sun"],
["Earth", "Distance.OrbitalPeriod", 8766]

8766 est la période en heures. Un Distance.OrbitalPeriod positif permet une révolution décorative. Zéro ou l’absence de période laisse l’image immobile. Ces paramètres ne créent pas le corps : Earth et Sun sont ici déjà définis.

L’allongement d’une orbite physique se définit séparément, en pourcentage. Pour un calcul lisible, prenons une distance de 100000 km et une excentricité de 10 % :

["MyOrbitBody", "Distance", 100000],
["MyOrbitBody", "Distance.Eccentricity", 10]

Si Min et Max ne sont pas définis à l’avance, le modèle obtient Distance.Min 90000 et Distance.Max 110000 km : la distance moyenne moins et plus 10 %. À une excentricité de 0, l’orbite est circulaire et ce calcul n’ajoute pas de Min/Max distincts. Les bornes explicites sont prioritaires et ne sont pas recalculées à partir de l’excentricité.

Pour l’étiquette d’une distance géocentrique, vous pouvez choisir les rayons terrestres. Cet exemple descriptif distinct ne convertit pas le modèle physique depuis les kilomètres :

["MyGeocentricMoon", "Distance", 60],
["MyGeocentricMoon", "Distance.Measure", "Earths"]

La description affiche 60 rayons terrestres au lieu de 60 km. Pour décrire la même distance physique avec cette unité, l’auteur doit diviser lui-même les kilomètres par le rayon terrestre : environ 382260 km correspondent à 60 rayons de 6371 km. Mais Distance.Measure change l’étiquette et les calculs physiques continuent de lire le nombre Distance en kilomètres. N’utilisez donc pas ce fragment avec le calcul du chauffage ou de la masse comme conversion automatique des unités.

Des champs descriptifs distincts existent pour les modèles géocentriques. Distance.Epicycle est le rayon d’un cercle de mouvement supplémentaire et Distance.Epicycle.Period sa période en heures. Distance.Eccentric donne le décalage du centre du cercle principal par rapport au point d’observation. Distance.Equant est la distance du point depuis lequel le mouvement paraît uniforme. Ces trois distances utilisent Distance.Measure. Dans PreWarpAge, ces champs sont descriptifs et ne constituent pas une recette complète de carte géocentrique. Ils sont inutiles pour un mod ordinaire.

L’éloignement de jeu est un autre calcul. PreWarpAge en déclare ainsi l’origine et les unités :

["Simulation", "Distance.From", "Homeworld"],
["Simulation", "Distance.Home.Measure", "Orbits"]

L’origine est le monde natal du joueur et l’unité l’anneau. Le jeu calcule lui-même Distance.Home. Un satellite utilise la position de sa planète. Il n’est donc pas nécessaire d’écrire le résultat pour chaque classe. La règle est prévue pour un seul monde natal, pas plusieurs mondes nataux indépendants.

Temperature - température

Dans PreWarpAge, Temperature relie un monde aux caractéristiques ludiques de chaleur et de froid. Dans le modèle physique, le même mot désigne une température en kelvins. Son sens dépend des règles employées. Ne lisez donc pas un nombre de la PreWarpAge ordinaire comme une température physique.

Commençons par PreWarpAge ordinaire. La valeur ludique initiale de StandardEarthlike est zéro :

["StandardEarthlike", "Temperature", 0]

Ce zéro n’est pas le zéro absolu : les traits du jeu de base relient cette propriété à la zone orbitale. Les majorations liées au chaud et au froid restent des règles de jeu.

Pour une description physique, vous pouvez au contraire fixer directement la température terrestre en kelvins :

["Earth", "Temperature", 288]

288 K correspondent à environ 15 °C. Le jeu conserve des kelvins et affiche des degrés Celsius. Sans données de calcul du chauffage, la valeur explicite reste en place. L’article « Champs physiques sans bibliothèque externe » présente un exemple complet et distinct.

Calculons maintenant la température. Définissons une luminosité stellaire de 1 sur l’échelle solaire, une distance de 149600000 km pour le monde et un lien vers cette étoile :

["MyWarmStar", "Luminosity", 1],
["MyWarmWorld", "Distance", 149600000],
["MyWarmWorld", "Distance.CentralBody", "MyWarmStar"]

Après la création de ce monde physique, le modèle écrit Temperature 278 K, environ 4,85 °C. C’est un calcul simplifié du chauffage stellaire sans correction atmosphérique, pas une prévision du climat terrestre. Les noms commençant par My sont vos définitions. Orbit et l’exemple physique complet expliquent le placement.

Augmentons précisément ce résultat calculé de 10 %. Ajoutons une ligne aux mêmes trois données :

["MyWarmWorld", "Temperature.Modifier", 1.1]

On obtient 278 × 1,1 = 305,8 K, environ 32,65 °C. Le multiplicateur s’applique aux kelvins, pas aux degrés Celsius. Il doit être positif. Sans lui, la valeur 1 s’applique.

Le centre d’une lune est sa planète, mais sa source de chaleur reste l’étoile. Ajoutons une lune à la variante initiale sans Modifier :

["MyWarmMoon", "Distance", 100000],
["MyWarmMoon", "Distance.CentralBody", "MyWarmWorld"]

La chaîne mène de la lune à MyWarmWorld, puis à MyWarmStar. Son chauffage utilise la distance de la planète à l’étoile, 149600000 km, pas les 100000 km jusqu’à la planète. Sans Modifier propre, la lune reçoit les mêmes 278 K. Temperature.Min et Temperature.Max décrivent une plage et ne remplacent ni distance ni luminosité.

Age - âge

Age indique l’âge d’un corps en années. Il peut servir dans la description et les conditions des traits. Les calculs physiques de géologie et de marées lisent aussi l’âge de l’étoile si les autres caractéristiques nécessaires sont définies.

L’âge solaire de 4,6 milliards d’années s’écrit ainsi :

["Sun", "Age", 4.6e9]

4.6e9 est une écriture abrégée de 4 600 000 000. Age désigne les années écoulées, pas la durée d’un événement en tours. L’âge n’augmente pas automatiquement à la fin d’un tour.

Les échéances de l’évolution stellaire sont des informations distinctes. L’âge de fin de séquence principale peut par exemple s’écrire avec Age.LifeSpan :

["Sun", "Age.LifeSpan", 1e10]

C’est un âge de dix milliards d’années depuis la naissance de l’étoile, pas depuis le tour courant. Age.WhiteDwarfBirth conserve de la même façon l’âge de formation d’une naine blanche. Une transition réelle entre stades nécessite des règles distinctes. Geology et Rotation expliquent l’usage de l’âge dans les calculs physiques.

Luminosity et Metallicity - luminosité et métallicité

Luminosity décrit la puissance du rayonnement stellaire par rapport au Soleil. La valeur solaire est 1 :

["Sun", "Luminosity", 1]

Dans le modèle physique, cette grandeur participe au chauffage des planètes et au positionnement des zones de température. Une luminosité de 2 signifie une puissance double de celle du Soleil. Ce n’est pas l’extraction de la ressource Energy.

Metallicity est une autre propriété : la teneur relative en éléments lourds. La valeur 1 représente aussi le niveau solaire, mais concerne la composition, pas le rayonnement. Ces deux propriétés indépendantes s’écrivent ensemble ainsi :

["Sun", "Luminosity", 1],
["Sun", "Metallicity", 1]

Sun reçoit une luminosité et une métallicité égales à celles du Soleil. Ces champs sont facultatifs pour les étoiles ordinaires de PreWarpAge : sans Luminosity positive, le générateur utilise la valeur solaire uniquement pour placer les zones, sans l’inscrire comme propriété de l’étoile.

Atmosphere - atmosphère et nuages

Commençons par la qualité de l’air. Pour une atmosphère terrestre respirable, écrivons :

["Earth", "Atmosphere", "Breathable"]

Breathable est la désignation existante d’une atmosphère respirable. Suffocating décrit au contraire un air irrespirable sans protection. C’est une qualité du milieu, pas une réserve de ressource.

La pression se définit séparément de la respirabilité. Une atmosphère terrestre s’écrit :

["Earth", "Atmosphere.Pressure", 1]

Une valeur de 2 signifierait une pression de deux atmosphères. Une pression de 1 ne suffit pas à rendre l’air respirable : la composition et les qualités ont leurs propres faits.

Indiquons la composition. Le symbole chimique du gaz suit Atmosphere.Gas et le troisième nombre est son pourcentage :

["Earth", "Atmosphere.Gas.N2", 78],
["Earth", "Atmosphere.Gas.O2", 21]

La description présente 78 % d’azote N2 et 21 % d’oxygène O2. Le jeu ne complète pas automatiquement la somme à 100 % et ne recalcule pas les pourcentages. Rassemblons qualité, pression et composition pour Earth existante :

["Earth", "Atmosphere", "Breathable"],
["Earth", "Atmosphere.Pressure", 1],
["Earth", "Atmosphere.Gas.N2", 78],
["Earth", "Atmosphere.Gas.O2", 21]

Ces quatre entrées concernent une seule atmosphère, mais répondent à des questions distinctes : peut-on respirer, à quelle pression et quels gaz sont présents ? Les étiquettes des qualités utilisent des clés comme AtmosphereBreathable.

Au lieu d’une pression explicite, le modèle physique peut la calculer à partir de la masse atmosphérique. Avec le diamètre et la gravité terrestres, définissez par exemple :

["Earth", "Atmosphere.Mass", 1]

C’est la masse d’une atmosphère terrestre, pas une fraction de la masse planétaire. Sans Atmosphere.Pressure, avec un diamètre de 12742 km et Gravity 1, le résultat est une pression d’une atmosphère. Sur la même planète, Atmosphere.Mass 2 donne deux atmosphères. Pressure explicite est prioritaire. Retirez-le pour vérifier le calcul à partir de la masse.

Vous pouvez définir une image de nuages indépendamment du calcul physique :

["Earth", "Atmosphere.Clouds", "clouds_up"]

clouds_up est une famille d’images. Le jeu choisit une variante précise pour le monde créé et la conserve. Les nuages ne produisent pas de revenu et ne signifient pas, à eux seuls, que l’air est respirable.

Une atmosphère toxique irrespirable nécessite deux qualités. Cet ensemble ne contient par exemple pas Breathable :

["Earth", "Atmosphere", "Suffocating"],
["Earth", "Atmosphere", "Toxic"]

Examinons uniquement la contribution atmosphérique à l’habitabilité, sans eau ni climat. Sur un monde d’essai distinct, activons Habitability avec zéro, comme dans son article, puis définissons seulement un air respirable à pression 1 :

["MyAirWorld", "Habitability", 0],
["MyAirWorld", "Atmosphere", "Breathable"],
["MyAirWorld", "Atmosphere.Pressure", 1]

Sans Hydrography ni Temperature, les autres termes valent zéro. Habitability.Human reçoit 4 pour cette atmosphère. Dans une variante distincte, remplaçons Breathable par deux qualités sans le garder à côté :

["MyAirWorld", "Habitability", 0],
["MyAirWorld", "Atmosphere", "Suffocating"],
["MyAirWorld", "Atmosphere", "Toxic"]

Pour cet ensemble isolé, Human vaut −1 : l’atmosphère toxique irrespirable donne une pénalité. MildToxic, HighlyToxic et LethalToxic sont aussi reconnus à la place de Toxic. Ajoutons une qualité à cette variante :

["MyAirWorld", "Atmosphere", "Corrosive"]

L’ensemble Suffocating + Toxic + Corrosive donne maintenant Human −2 au lieu de −1. Corrosive a renforcé la pénalité de cette combinaison précise. Si une variante ne contient que Corrosive, sans Breathable, Suffocating ni Toxic, la contribution atmosphérique vaut 0, pas −2. Atmosphere.Toxic numérique est une évaluation d’auteur distincte, pas un remplacement de la qualité textuelle. Ces variantes se remplacent : ne rassemblez pas toutes les atmosphères présentées dans un seul fichier.

Pour une atmosphère respirable, les qualités dégradantes reconnues sont ChlorineFluorine, SulfurCompounds, NitrogenCompounds, OrganicToxins, LowOxygen, Pollutants, HighCarbonDioxide, HighOxygen et InertGases. Un nom inventé ne reçoit pas automatiquement une pénalité. Habitability explique ces évaluations du milieu. Elles ne créditent ni ne dépensent de ressources.

Hydrography - substances en surface et sous la surface

Indiquons que l’eau est la principale substance de surface de la Terre. Elle utilise le symbole H2O :

["Earth", "Hydrography", "H2O"]

Cela choisit une substance. La quantité d’eau de surface n’est pas encore définie et la ressource exploitable Water n’est pas apparue.

Définissons maintenant la couverture : l’eau occupe 71 % de la surface.

["Earth", "Hydrography.Surface", 71]

Surface est le pourcentage global couvert par la substance choisie. Pour répartir cette eau entre phases liquide et solide, il faut une température. Ajoutons 288 K dans le fragment complet d’Earth :

["Earth", "Hydrography", "H2O"],
["Earth", "Hydrography.Surface", 71],
["Earth", "Temperature", 288]

Ce fragment complète Earth du scénario « Système solaire ». L’eau couvre 71 % de sa surface et la température est de 288 K. Le jeu en calcule les fractions liquide et solide dans Hydrography.SurfaceLiquid et Hydrography.SurfaceSolid. Avec un Hydrography.Surface global, inutile de fixer séparément ces phases calculées. Les fractions souterraines sont indépendantes. L’eau de cette description ne devient pas la ressource exploitable Water.

Une deuxième substance possède son propre ensemble de champs. Ajoutons par exemple du méthane couvrant 5 % à la base :

["Earth", "Hydrography.Type2", "CH4"],
["Earth", "Hydrography.Type2.Surface", 5]

L’eau et le méthane sont maintenant décrits indépendamment. Pour la deuxième substance, les résultats s’appellent Hydrography.Type2.SurfaceLiquid et Hydrography.Type2.SurfaceSolid. La troisième utilise Type3 dans ces chemins. Les fractions souterraines se définissent séparément avec SubsurfaceLiquid et SubsurfaceSolid, sous le même début de chemin. Leur représentation dépend de l’interface.

Le modèle de phases reconnaît l’eau H2O, le soufre S, le dioxyde de soufre SO2, l’ammoniac NH3, le méthane CH4, l’azote N2, le dioxyde de carbone CO2 et l’acide sulfurique H2SO4. Il ne devine pas les températures de fusion et d’ébullition d’un symbole arbitraire.

Life - signes de vie et probabilité

Life décrit la vie et les caractéristiques du milieu où elle est possible. Dire « chimie complexe possible » ou « probabilité de 100 % » ne crée ni êtres vivants, ni population, ni Travailleurs. La présence de vie et l’évaluation de sa probabilité sont des faits distincts.

Nommez d’abord le type de vie. Life prend une clé de dictionnaire :

["Earth", "Life", "MyLifeType"]

La clé MyLifeType doit afficher « Vie carbonée ». Le dictionnaire nécessaire figure en fin d’article. C’est un nom, pas un nombre d’êtres.

La probabilité descriptive utilise un autre champ :

["Earth", "Life.Probability", 100]

C’est une évaluation informative de 100 %, pas un tirage aléatoire ni une création de population. Life.Chance sert au choix aléatoire de true ou false. Ne l’utilisez pas à la place de Probability pour une simple évaluation descriptive.

Une caractéristique distincte du milieu, par exemple la chimie complexe, se définit avec true ou false. Rassemblons le nom, l’évaluation et cette caractéristique :

["Earth", "Life", "MyLifeType"],
["Earth", "Life.Probability", 100],
["Earth", "Life.ComplexChemistry", true]

ComplexChemistry true signifie la présence d’une chimie complexe. Life.SubsurfaceOcean, Life.HydrothermalVents, Life.MethaneCycle et Life.Organics se décrivent de la même façon. Chaque caractéristique est indépendante et n’est pas déduite de Probability. Ni le nom de vie ni sa probabilité ne créent de Travailleurs ou de revenus.

MyLifeType est une clé de nom inventée. Ajoutez l’entrée suivante à Text/frFR.json pour afficher « Vie carbonée ». Si le fichier n’existe pas, enregistrez le dictionnaire complet. Cet exemple concerne la Terre existante du scénario « Système solaire ».

{
  "MyLifeType": "Vie carbonée"
}

Geology - activité géologique

La géologie décrit les processus internes et de surface : volcans, mouvement de la croûte, geysers et chauffage. Une observation peut être exprimée par « présent/absent ». Un score numérique est une autre forme, dont l’auteur choisit l’échelle. Ce n’est pas un pourcentage de volcanisme.

Indiquons d’abord uniquement la présence de tectonique et de volcanisme sur Terre. true suffit à cet énoncé :

["Earth", "Geology.Tectonics", true],
["Earth", "Geology.Volcanism", true]

La Terre reçoit les deux caractéristiques. Geology.Cryovolcanism et Geology.Geysers acceptent aussi true ou false. Pour une description textuelle globale de la géologie, Geology prend une clé de traduction.

Dans votre propre modèle, vous pouvez évaluer la tectonique avec un nombre plutôt qu’une présence. Par exemple :

["Earth", "Geology.Tectonics", 40]

40 est ici un score sur votre échelle, pas 40 %. Le true de l’exemple précédent ne vaut pas un score de 1. Pour convertir les scores en catégories « faible » ou « forte », il faut des traits conditionnels distincts.

Le chauffage interne peut être calculé plutôt qu’attribué comme score d’auteur. Il nécessite la gravité du monde et l’âge de l’étoile. Ce fragment fournit les données suffisantes. Pour placer votre monde, utilisez Orbit ou l’exemple physique complet :

["MyHeatStar", "Age", 5e9],
["MyHeatWorld", "Gravity", 1],
["MyHeatWorld", "Distance.CentralBody", "MyHeatStar"]

Le monde a une gravité de 1 sur l’échelle terrestre et son étoile un âge de 5 milliards d’années. Sans Geology.InternalHeat propre, le modèle calcule un score de 8 : 1 / 5 × 40. Le résultat est arrondi à l’entier et plafonné à 100. C’est un état Geology.InternalHeat, pas une température en degrés. Ce score ne reçoit pas automatiquement une ligne descriptive « chauffage intense » : cette étiquette nécessite un trait avec Requires.

Vérifions une donnée nécessaire. Dans une variante, gardons le lien vers l’étoile sans fournir de gravité positive :

["MyHeatStar", "Age", 5e9],
["MyHeatWorld", "Gravity", 0],
["MyHeatWorld", "Distance.CentralBody", "MyHeatStar"]

Dans cette variante isolée, InternalHeat n’est pas calculé. L’absence de résultat ne signifie pas un chauffage nul. Si d’autres données physiques donnent une Gravity positive, les entrées redeviennent suffisantes. Un Geology.InternalHeat déjà défini n’est pas remplacé par le calcul automatique.

Pour une lune, l’âge est recherché à travers sa planète. Pour MyHeatMoon, le chemin mène ici à MyHeatWorld puis à MyHeatStar du premier exemple :

["MyHeatMoon", "Gravity", 1],
["MyHeatMoon", "Distance.CentralBody", "MyHeatWorld"]

Si la planète intermédiaire n’a pas son propre Age, le calcul trouve l’âge stellaire 5e9 et donne également 8 avec Gravity 1. Cet exemple n’exige pas d’âge distinct pour la lune.

Le chauffage de marée Geology.TidalHeating est un autre calcul. Il utilise la masse du corps central attracteur et les paramètres physiques du corps lui-même. Examinons une orbite non allongée :

["MyTidalCenter", "Weight", 5.972e24],
["MyTidalMoon", "Distance.CentralBody", "MyTidalCenter"],
["MyTidalMoon", "Size.Measure", "Kilometers"],
["MyTidalMoon", "Size", 1000],
["MyTidalMoon", "Weight", 1e22],
["MyTidalMoon", "Distance", 100000],
["MyTidalMoon", "Distance.OrbitalPeriod", 24],
["MyTidalMoon", "Distance.Eccentricity", 0]

La première ligne donne la masse du corps central. Tous les autres nombres concernent la lune : diamètre de 1000 km, masse de 1e22 kg, distance de 100000 km et période orbitale de 24 heures. L’excentricité 0 désigne une orbite circulaire. Avec ces données positives, TidalHeating vaut 0 : dans le modèle, le chauffage dépend de l’allongement de l’orbite. C’est un zéro calculé, contrairement à l’absence de résultat quand des données manquent. Retirer la masse positive du centre empêche par exemple le calcul.

Une excentricité positive s’exprime en pourcentage. Elle peut produire un chauffage non nul, mais le résultat dépend de toutes les grandeurs mentionnées. Le score est plafonné à 500 et un résultat inférieur à 1 est enregistré comme zéro. Ces points ne sont ni des degrés ni une probabilité de volcanisme. L’étiquette automatique de l’activité géologique exige toujours des traits distincts.

MagneticField - champ magnétique

Le champ magnétique est ici une caractéristique descriptive du monde. Un nombre peut exprimer une intensité sur l’échelle choisie par l’auteur et une catégorie textuelle « champ intense ». PreWarpAge ne possède pas d’échelle commune intégrée pour ces scores. Ce seul fait ne crée pas automatiquement d’extraction ou de protection de la population.

Définissons d’abord uniquement la catégorie textuelle « Champ magnétique intense ». Il faut une clé de traduction dans MagneticField.Type :

["Earth", "MagneticField.Type", "MagneticFieldStrong"]

Earth existante reçoit l’étiquette de la clé MagneticFieldStrong. Le dictionnaire doit l’associer à « Champ magnétique intense ». Cela ne définit aucune intensité numérique.

Si votre modèle nécessite une évaluation numérique, elle s’écrit sans Type. Par exemple :

["Earth", "MagneticField", 40]

40 est le score final sur l’échelle choisie par l’auteur. Il ne reçoit pas automatiquement l’étiquette « Champ intense » : relier scores et catégories exige des règles distinctes. La clé MagneticFieldStrong ne peut pas remplacer le nombre dans MagneticField. Aucune de ces entrées ne crée elle-même de protection de population ni d’extraction.

Rotation - rotation

Rotation décrit le mouvement autour de l’axe propre du corps, pas sa révolution sur l’orbite du jeu. La période indique le nombre d’heures d’un tour. Avec un verrouillage gravitationnel, le corps présente toujours la même face à son centre et sa rotation correspond à sa période orbitale.

Définissons d’abord la durée d’une rotation de la Terre autour de son axe :

["Earth", "Rotation", 23.93]

Rotation s’exprime en heures. Le tour dure ici 23,93 heures. L’inclinaison de l’axe est une propriété indépendante en degrés. Ajoutons-la à la période :

["Earth", "Rotation", 23.93],
["Earth", "Rotation.AxialTilt", 23.44]

La description physique terrestre indique une période de 23,93 heures et une inclinaison de 23,44°. Aucune ne change automatiquement la vitesse de révolution décorative autour de l’étoile.

Une caractéristique distincte définit la rotation rétrograde. À la place du sens habituel, indiquez par exemple :

["Earth", "Rotation.Retrograde", true]

false signifie l’absence de rotation rétrograde. Le verrouillage gravitationnel est un autre paramètre. Donnons au corps une période orbitale de 24 heures, une rotation initiale de 12 heures et activons le verrouillage :

["MyLockedWorld", "Rotation", 12],
["MyLockedWorld", "Distance.OrbitalPeriod", 24],
["MyLockedWorld", "Rotation.TidallyLocked", true]

À la création du corps, Rotation devient 24, comme sa période orbitale. C’est le sens du verrouillage : une face reste tournée vers le centre. La valeur 12 ne subsiste pas comme période de rotation indépendante. Sans Distance.OrbitalPeriod positif, la caractéristique ne fournit pas le nombre auquel égaler Rotation.

Le jour solaire est le temps qui sépare deux passages de l’astre à la même position dans le ciel. Il ne correspond pas toujours à une rotation dans l’espace fixe. Reprenons ces deux périodes sans verrouillage :

["MyDayWorld", "Rotation", 12],
["MyDayWorld", "Distance.OrbitalPeriod", 24]

Le modèle écrit Rotation.SolarDay 24 heures : |12 × 24 / (24 − 12)| = 24. La rotation propre reste de 12 heures. Si les deux périodes valent 24, ce calcul n’écrit pas de jour solaire fini, car le dénominateur serait nul. Le verrouillage de l’exemple précédent égalise précisément ces périodes.

L’effet cumulé des marées est une autre grandeur, Rotation.TidalEffect. Il nécessite des dimensions et des masses physiques. Ce fragment montre à qui appartiennent les données :

["MySpinStar", "Age", 5e9],
["MySpinStar", "Weight", 1.989e30],
["MySpinWorld", "Rotation", 12],
["MySpinWorld", "Size.Measure", "Kilometers"],
["MySpinWorld", "Size", 12742],
["MySpinWorld", "Weight", 5.972e24],
["MySpinWorld", "Distance", 149597870.7],
["MySpinWorld", "Distance.CentralBody", "MySpinStar"]

L’âge et la première masse concernent l’étoile. La deuxième masse et le diamètre concernent le monde. Avec ces données, Rotation.TidalEffect vaut environ 0,000262. C’est inférieur au seuil de verrouillage de 50 : Rotation.TidallyLocked n’apparaît pas et Rotation reste de 12 heures. Le score n’est ni une durée en heures ni un pourcentage de ralentissement. L’infobulle de rotation n’a pas à l’afficher sur une ligne distincte.

Si vous retirez la masse du centre sans la calculer par d’autres données physiques, l’effet n’est pas calculé. C’est une absence de résultat, pas un zéro calculé. Pour une lune, le lien mène d’abord à la planète puis, par son Distance.CentralBody, à l’étoile où l’âge est recherché, comme dans Geology. À partir d’un score de 50, le modèle attribue le verrouillage gravitationnel. Pour l’effet d’une étoile, cette règle s’applique aux corps d’au moins 2000 km de diamètre. La rotation de l’image et le déplacement sur les anneaux du jeu se règlent séparément.

Rings - anneaux d’un corps

Rings ajoute des anneaux visibles autour d’un corps, par exemple les anneaux glacés d’une géante. C’est une image et une description : les anneaux ne deviennent pas une ceinture exploitable distincte et n’augmentent pas le territoire planétaire.

Choisissons l’image existante d’anneaux brillants pour une géante gazeuse moyenne :

["GasGiantMedium", "Rings", "RingsBright"]

RingsBright utilise les images ringsbright_down.png et ringsbright_up.png : la couche arrière et la couche avant. RingsFaint, RingsModerate et RingsProminent sont les autres variantes existantes.

La taille de l’image se règle séparément. Ajoutons une échelle de 1.05 aux anneaux choisis :

["GasGiantMedium", "Rings", "RingsBright"],
["GasGiantMedium", "Rings.Scale", 1.05]

L’image est agrandie d’un facteur 1,05. Sans Rings.Scale, l’échelle vaut 1. Elle doit être positive. Size et la capacité du corps ne changent pas. Un MyRings personnalisé exige une traduction du nom et deux fichiers myrings_down.png/myrings_up.png. L’article « Fichiers exacts des nouvelles images, des fonds et des sons » explique leur préparation.

Habitability et Affinity - aptitude d’un monde

Habitability évalue l’aptitude du milieu physique à accueillir l’être humain : air respirable, eau liquide et température adaptée. C’est un score informatif, pas un nombre de colons ni le choix du monde de départ. Affinity est une évaluation distincte de l’attrait, déterminée par les règles de l’auteur.

Préparez d’abord l’atmosphère, l’eau et la température du monde. Chaque champ possède son propre article. Si Earth les définit déjà, une entrée distincte active le calcul d’habitabilité humaine :

["Earth", "Habitability", 0]

Zéro est ici une valeur initiale qui autorise le calcul, pas une évaluation « inhabitable ». Le résultat est écrit séparément dans Habitability.Human. Rassemblons les données nécessaires avec cette entrée :

["Earth", "Atmosphere", "Breathable"],
["Earth", "Atmosphere.Pressure", 1],
["Earth", "Hydrography", "H2O"],
["Earth", "Hydrography.Surface", 71],
["Earth", "Temperature", 288],
["Earth", "Habitability", 0]

Ce fragment complète Earth du scénario « Système solaire ». Une atmosphère respirable à pression 1, de l’eau sur 71 % de la surface et une température de 288 K donnent Habitability.Human 8. Si des données manquent, le jeu ne suppose pas les contributions absentes. Le score ne crée ni Workers ni Income et ne remplace pas Earthlike pour choisir un monde natal. Pour Affinity aussi, un zéro initial ne suffit pas : des règles de calcul et de catégories sont nécessaires.

Economy et Civilized - description d’un monde habité

Economy décrit l’économie d’un monde habité avec des nombres affichés : revenu et volume total. Ces informations ne créditent pas de Credits et ne lancent pas la production de PreWarpAge. Un apport réel de ressource utilise Income.<ressource>.

Écrivons d’abord un revenu comme caractéristique informative terrestre :

["Earth", "Economy.Income", 100]

100 est un nombre dans les unités de votre modèle. Ce n’est pas 100 Credits par tour : ni devise ni période ne sont attribuées automatiquement. Une rentrée réelle de Crédits nécessite une capacité ludique avec Income.Credits.

Le deuxième nombre informatif est le volume total de l’économie. Ajoutons Economy.Volume au revenu :

["Earth", "Economy.Income", 100],
["Earth", "Economy.Volume", 1000]

Sur une Terre habitée avec Workers positif, la description affiche un revenu de 100 et un volume de 1000. Sur la même Terre sans Travailleurs, les nombres restent des données mais ce texte ne s’affiche pas. L’affectation des Travailleurs suit les règles ordinaires : le fragment Economy ne les crée pas. Vérifiez donc l’affichage après peuplement et affectation. Economy.Wealth regroupe les traits qualitatifs de richesse définis par l’auteur. Civilized est un caractère descriptif qui ne crée pas lui-même de population.

Health et Damage - points de vie et dégâts

Health est la réserve de points de vie d’une chose : les dégâts la réduisent et son épuisement détruit l’objet en cours de partie. Damage est la quantité de dégâts infligés. Un champ numérique seul ne crée pas une attaque : un mécanisme existant doit appliquer les dégâts, par exemple le choix de bombardement d’un astéroïde.

Examinons d’abord les points de vie d’une chose déjà créée. Donnons-lui par exemple six unités :

["MyMarker", "Health", 6]

Si un mécanisme existant inflige deux unités de dégâts, il en reste quatre. À Health inférieur ou égal à zéro, la chose est détruite avec ses objets dépendants. Health.Max conserve le maximum initial pour l’affichage. Cette entrée ne crée pas MyMarker : placez-le d’abord, par exemple avec PlacedAt.

Modifions maintenant un mécanisme existant de dégâts : le bombardement d’astéroïde Bombard. Définissons deux unités de dégâts et sa cible habituelle Parent :

["Bombard", "Damage", 2],
["Bombard", "Damage.Target", "Parent"]

Bombard est le bombardement existant sur la carte d’événement d’un astéroïde. Parent désigne cette carte. Modifier Damage renforce le bombardement à deux unités, tout en conservant son coût et son bouton. Cela ne crée pas une nouvelle arme. Health est vérifié d’abord sur la cible. S’il manque, Size est utilisé, comme pour l’astéroïde de PreWarpAge. Health.Max accompagne les points de vie initiaux, sans remplacer automatiquement la taille de l’astéroïde.

La collision d’un astéroïde est un autre contexte. Définissons sur l’événement existant AsteroidEvent des dégâts par unité de taille :

["AsteroidEvent", "Damage", 2],
["AsteroidEvent", "Per", "Size"]

Quand le mécanisme de collision applique un astéroïde de taille 3, les dégâts valent 2 × 3 = 6. Le lieu d’impact détermine le destinataire. N’ajoutez pas Damage.Target Parent ici : ce chemin sert à la réponse Bombard, qui endommage l’événement parent de l’astéroïde. L’entrée ne programme pas l’impact et ne crée pas de nouvel astéroïde. Les règles de l’événement existant restent en place.

Vous pouvez donner un Health numérique, par exemple 6, à une entité de votre choix, mais son mécanisme doit d’abord la créer. Les dégâts d’un EventChoice exigent un Damage.Target explicite comme Parent ou Parent.<champ>. Un fait Health/Damage seul ne crée ni combat universel de vaisseaux ni bouton « Attaquer » dans PreWarpAge.

Transforms - transformation d’un corps

Transforms remplace un corps par un autre : une planète devient par exemple des débris ou un monde contaminé après une catastrophe. Ce n’est ni un changement de nom ni d’icône. La position reste la même, les anciens bâtiments sont détruits et la nouvelle classe définit les propriétés suivantes.

Examinons l’expérience existante TestNanobots. Son issue défavorable NanobotsEscaped doit créer un monde de classe Modified. Transforms nomme la classe du résultat :

["NanobotsEscaped", "Transforms", "Modified"]

Cela répond à « en quoi transformer », sans préciser quel corps remplacer. Une autre entrée définit la cible :

["NanobotsEscaped", "Transforms.Target", "Parent.Target"]

Parent mène du résultat à l’événement de l’expérience, puis son Target au monde choisi. C’est lui qui est remplacé. Relions le résultat à l’expérience et conservons la taille de l’ancien monde :

["TestNanobots", "Has", "NanobotsEscaped"],
["NanobotsEscaped", "Transforms", "Modified"],
["NanobotsEscaped", "Transforms.Target", "Parent.Target"],
["Modified", "Size.From", "Parent"]

Le fragment répète une partie de la définition du jeu de base. TestNanobots possède déjà le rôle Event, la cible Rocky et l’issue NanobotsEscaped. Si celle-ci se produit, le monde choisi devient Modified. Dans Transforms.Target, Parent.Target est lu sur l’issue : Parent désigne l’événement et son Target le monde sélectionné. Dans Size.From Parent, sur la nouvelle classe Modified, Parent désigne cette fois l’ancien corps remplacé. Le nouveau monde conserve ainsi sa taille. Sans cette ligne, la taille vient de la nouvelle classe. Une transformation personnalisée nécessite l’événement, sa cible, l’issue reliée et la définition du nouveau corps.

La position et les relations orbitales sont conservées. Les bâtiments portés par l’ancien corps sont détruits. Les champs <nom>.From Parent sur la nouvelle classe préservent explicitement les caractéristiques correspondantes de l’ancien corps. Transforms.Effect, par exemple swarm, choisit un effet visuel de transformation existant. Il n’exécute pas de nouveau script.

Spread et Spreads - propagation d’une transformation

Créons une capacité permettant à un monde contaminé de transformer ses voisins en mondes identiques. Déclarons une capacité distincte MySpread. Elle nécessite deux rôles : Trait pour être reliée au monde et Spread pour la propagation elle-même.

["MySpread", "Is", "Trait"],
["MySpread", "Is", "Spread"]

C’est la définition de la capacité. Le monde ne l’a pas encore reçue et ne contamine rien. Donner seulement Spread au monde lui-même, sans trait distinct, ne crée pas cette capacité.

Fixons la probabilité de déclenchement à 10 % par tour :

["MySpread", "Chance", 10]

Chaque monde possédant la capacité effectue un test par tour. Cela ne garantit pas une contamination après dix tours. La probabilité doit être supérieure à zéro et au plus égale à 100. Chance.Random.Min/Max peut remplacer le nombre fixe pour donner une chance propre à chaque nouveau monde.

Choisissons les cibles admissibles. La contamination doit affecter les mondes de catégorie World :

["MySpread", "Target", "World"]

En cas de réussite, le monde approprié le plus proche est choisi. À égalité, l’un est pris au hasard. La source et les mondes déjà contaminés de même classe sont exclus. Sans cible, rien ne se produit. Des conditions Target supplémentaires peuvent restreindre l’ensemble.

Relions la capacité prête à la classe du monde contaminé :

["MySpreadWorld", "Has", "MySpread"]

Chaque MySpreadWorld créé reçoit maintenant MySpread. Un voisin contaminé devient MySpreadWorld, perd ses anciens bâtiments et reçoit aussi la capacité. Il commence à la propager au tour suivant, tandis que la source reste en place. Une réaction en chaîne apparaît ainsi. Elle s’arrête à la fin de la partie. Le jeu remplit lui-même Spreads et Spreads.Turn pour la probabilité et le tour traité.

L’exemple complet ajoute au Système solaire un monde « Essaim de machines » sur le quatrième anneau. Il a 10 % de chances par tour de transformer le World le plus proche. La Terre correspond aussi à ce Target : vérifiez l’exemple dans une nouvelle partie séparée. Enregistrez le premier bloc dans Logic/Spread.json de votre mod.

[
  ["MySpreadWorld", "Is", "World"],
  ["MySpreadWorld", "Name", "MySpreadWorldName"],
  ["MySpreadWorld", "Icon", "nanobot"],
  ["MySpreadWorld", "Size", 3],
  ["MySpreadWorld", "Orbit.Center", "Sun"],
  ["MySpreadWorld", "Orbit", 4],
  ["MySpreadWorld", "Has", "MySpread"],
  ["MySpread", "Is", "Trait"],
  ["MySpread", "Is", "Spread"],
  ["MySpread", "Name", "MySpreadName"],
  ["MySpread", "Icon", "nanobot"],
  ["MySpread", "Chance", 10],
  ["MySpread", "Target", "World"]
]
{
  "MySpreadWorldName": "Essaim de machines",
  "MySpreadName": "Contamination des voisins"
}

Enregistrez le deuxième bloc dans Text/frFR.json. MySpreadWorld et MySpread sont les noms inventés de la classe de monde et de sa capacité. Ils ne dépendent pas de Modified ou NanobotSpread existants. World définit la catégorie, nanobot choisit une image existante et Size 3 la taille. Orbit.Center Sun et Orbit 4 placent le premier monde dans une cellule libre du quatrième anneau solaire. Has MySpread relie la capacité. Lors d’une transformation, le corps voisin devient aussi MySpreadWorld, reçoit cette capacité et continue la contamination.

Un monde ne peut avoir qu’une capacité Spread active. Si vous héritez d’une classe qui en possède déjà une, éliminez d’abord le doublon. Retirer ou désactiver l’unique trait Spread arrête la propagation et supprime le champ interne Spreads. Pour une transformation unique sans chaîne, utilisez une issue d’événement avec Transforms.

Visibility - éclat apparent et taille angulaire

Visibility décrit l’apparence d’un corps céleste depuis un point d’observation : sa luminosité apparente et sa taille angulaire. Un petit corps proche peut par exemple occuper plus de ciel qu’un grand corps lointain. Sur la carte ordinaire de PreWarpAge, ces informations ne changent ni la taille de l’image ni la production.

Définissons d’abord l’éclat descriptif. Visibility.Brightness est la magnitude apparente :

["Earth", "Visibility.Brightness", 1]

Plus le nombre est petit, plus l’objet est brillant. Il ne change ni la couronne ni la taille de l’image. Visibility.Brightness.Min et Visibility.Brightness.Max donnent une plage plutôt qu’une valeur unique.

Le diamètre angulaire est une autre grandeur : la portion du ciel occupée par le corps. Ajoutons 3,13 minutes d’arc à la magnitude déjà définie :

["Earth", "Visibility.Brightness", 1],
["Earth", "Visibility.Angle", 3.13]

Ce fragment attribue à Earth une magnitude apparente de 1 et un diamètre angulaire de 3.13 minutes d’arc. Visibility.Angle.Min et Visibility.Angle.Max définissent une plage angulaire comme pour l’éclat. Ce sont des informations de l’auteur, pas des calculs liés à la caméra. IconSize modifie la taille de l’image et Luminosity la puissance lumineuse physique de l’étoile.

StellarCorona - intensité de la couronne

La couronne est la lueur visible autour d’une étoile. StellarCorona règle l’intensité de cet effet dans le client existant, pas la luminosité stellaire utilisée dans les calculs physiques ni la production d’Énergie.

StellarCorona est un nombre fini non négatif. Sans lui ou à zéro, il n’y a pas de lueur. La valeur 1 donne l’intensité normale, une fraction positive une lueur plus faible et un nombre supérieur à 1 une lueur plus forte.

["ClassG", "StellarCorona", 1]

Les étoiles jaunes reçoivent une couronne lumineuse. Le client choisit la couleur et la technique de dessin selon les règles existantes.

Noms, descriptions et ressources de présentation

Les champs suivants définissent les noms, explications, images et sons. Ils présentent les objets que le jeu sait déjà afficher, sans créer eux-mêmes de fenêtre ou de bouton. Les textes sont dans Text, les images dans Art et les sons dans Sounds. Écrivez les textes du jeu sans HTML ni balises de couleur. Si le jeu affiche lui-même la valeur d’un effet, ne la répétez pas dans la description : elle deviendrait obsolète après un changement du nombre.

Name - nom et ensemble de noms

Name définit le nom d’un objet. Sa valeur est généralement une clé du dictionnaire Text, qui fournit le texte dans la langue choisie. Pour les nouveaux mondes, vous pouvez aussi définir un ensemble de noms aléatoires. Ils ne se répètent pas tant qu’il reste des noms libres.

Définissons d’abord un nom fixe par une clé du dictionnaire. Le marqueur MyMarker de l’article PlacedAt reçoit par exemple son nom :

["MyMarker", "Name", "MyMarkerName"]

Si la clé MyMarkerName vaut « Ma station » dans Text/frFR.json, le marqueur porte ce nom. Name ne crée pas le marqueur et ne change pas son type.

Autre cas : plusieurs nouveaux mondes ont besoin de noms différents. Énumérons d’abord deux noms dans l’ensemble MyWorldNames :

["MyWorldNames", "Name.Option", "MyNameOne"],
["MyWorldNames", "Name.Option", "MyNameTwo"]

C’est encore seulement un ensemble de clés, attribué à aucun monde. Relions-le à TinyRock avec Name.Random. Voici le lien et les deux options :

["TinyRock", "Name.Random", "MyWorldNames"],
["MyWorldNames", "Name.Option", "MyNameOne"],
["MyWorldNames", "Name.Option", "MyNameTwo"]

Ce fragment change les noms des nouveaux TinyRock. MyWorldNames est le nom inventé de l’ensemble et MyNameOne/MyNameTwo les clés des deux noms. Enregistrez le dictionnaire complet suivant dans Text/frFR.json. Si le fichier existe, ajoutez seulement ces deux entrées.

{
  "MyNameOne": "Premier rocher",
  "MyNameTwo": "Deuxième rocher"
}

Dans une nouvelle partie, TinyRock reçoit « Premier rocher » ou « Deuxième rocher ». Les noms ne se répètent pas tant qu’il en reste des libres. Après épuisement, les répétitions sont admises. L’ordre de Name.Option influence la reproduction d’une partie par graine. Ne le changez pas sans nécessité. Un Name fixe sur la définition est prioritaire sur le groupe aléatoire.

L’étiquette d’une propriété utilise la précision Name sur cette propriété sans changer son sens numérique. Un nom saisi par le joueur est enregistré comme texte final. Même s’il coïncide avec une clé du dictionnaire, il n’est pas retraduit après un changement de langue.

InputName - suggestion de nom pour la saisie

InputName suggère un nom de départ dans un champ de saisie existant, tel que le nom d'une corporation avant de commencer. Le joueur peut modifier la suggestion. Ce n'est pas le nom d'une classe ou d'une commande pour créer un nouvel éditeur.

InputName est la clé pour une première suggestion dans un éditeur de noms existant. <champ>.InputName spécifie une suggestion pour le nom d'une propriété. Il n'ajoute pas d'éditeur. Un nom explicitement saisi est prioritaire ; une suggestion plus proche remplace une suggestion héritée. Lorsqu’une partie est confirmée, la suggestion est traduite dans la langue du joueur et enregistrée sous le nom résultant.

CorpMiner est la corporation « Mineurs » existante et CorpMinerName son nom localisé existant. L'exemple modifie la suggestion dans l'éditeur de corporation existant.

["CorpMiner", "InputName", "CorpMinerName"]

La sélection de « Mineurs » propose la traduction CorpMinerName existante dans le champ du nom de la corporation. Changer de langue ultérieurement ne renomme pas un joueur déjà enregistré. Name.Input et Corporation.DefaultName ne sont pas des synonymes valides pour InputName.

Description - explication d’une entité ou d’une propriété

Description définit l’explication d’un objet ou d’une propriété. Le triplet conserve une clé et le dictionnaire de la langue choisie fournit le texte. Vous pouvez ainsi expliquer le rôle d’un avant-poste sans changer son coût ni son fonctionnement.

Donnons d’abord une explication à l’avant-poste. OutpostDesc est ici une clé de description existante :

["Outpost", "Description", "OutpostDesc"]

L’infobulle de l’avant-poste affiche la traduction d’OutpostDesc. Le coût, la durée et le revenu ne changent pas. Pour expliquer une propriété précise, utilisez Description sur cette propriété, et pour une ligne de propriété, ajoutez aussi le nom de la partie. Le texte ne remplace pas la valeur elle-même.

Pour l’exploration, nous voulons montrer les choix de ressource disponibles plutôt qu’un texte ordinaire. Description.Choices renvoie à l’événement existant WorkFocus. Voici l’usage ordinaire et cet usage particulier ensemble :

["Outpost", "Description", "OutpostDesc"],
["Explore", "Description.Choices", "WorkFocus"]

L’avant-poste reçoit l’explication de la clé existante et la description d’exploration présente les options de WorkFocus. Leurs conditions et leurs valeurs viennent des définitions elles-mêmes.

Text - étiquette de texte

Text spécifie une courte légende pour une vue qui possède déjà son propre mécanisme d'affichage : par exemple, une légende de trait valide. Ceci est différent de Name, le nom de l'entité elle-même, et de Description, l'explication détaillée.

Le trait SizeScale, déjà activé dans le jeu, adapte la capacité en fonction de la taille du monde. La ligne suivante change son étiquette lisible sans attribuer de nouveau trait à tous les mondes ni changer les nombres.

["SizeScale", "Text", "MySizeScaleText"]

Enregistrez le dictionnaire suivant dans Text/frFR.json ou ajoutez l’entrée au fichier existant. Le trait SizeScale reçoit l’étiquette « Capacité selon la taille ». L’exemple modifie un trait actif du jeu de base. Pour créer le vôtre, déclarez d’abord Is Trait puis reliez-le aux objets concernés par Has, ou définissez ses conditions d’attribution avec Grants.

{
  "MySizeScaleText": "Capacité selon la taille"
}

Hint - indice supplémentaire

Hint - un bref indice sur l'action disponible. Dans PreWarpAge, on peut le voir dans l'info-bulle de la propriété à travers laquelle le joueur clique sur l'option d'événement. Elle est affichée lorsqu'une telle action est disponible et ne crée pas d'info-bulle arbitraire sur aucun objet.

RobotHeldTrait - trait existant « Sous contrôle des robots ». L'option RetakeStart est déjà connectée via celle-ci, démarrant l’opération de reprise du monde. Hint définit le libellé d’invitation de ce trait pendant que l'opération est disponible. <champ>.Hint fait référence à l'info-bulle de la propriété correspondante. Ni Hint ni la chaîne de traduction ne déclarent de raccourci clavier.

["RobotHeldTrait", "Hint", "RobotControlHint"]

Ceci illustre une définition existante : RobotControlHint est déjà traduit par « Appuie pour lancer l’opération de reprise du contrôle. ». L'étiquette apparaît dans l'info-bulle de la propriété lorsque l'action est disponible. Pour le changer dans un mod, remplace RobotControlHint dans Text/frFR.json. Un Hint nu sur un Outpost arbitraire ne promet pas de fenêtre séparée.

Tag - étiquette de catégorie

Tag donne une étiquette claire de la catégorie générale. Par exemple, le monde peut être à la fois rocheux et froid ; le joueur voit les deux étiquettes de catégorie plutôt qu'un seul nouveau nom de planète long.

Tag sur la catégorie contient sa clé d'étiquette. L'entité affiche les étiquettes de ses catégories Is sans doublons. Tag n'est pas copié sur chaque enfant et ne remplace pas la description d'un monde individuel. Grâce à cela, le monde rocheux et froid peut afficher les deux catégories en même temps.

["Rocky", "Tag", "CatRocky"]

Toutes les entités Is Rocky reçoivent l'étiquette de catégorie « Rocheux » via cette relation, plutôt qu'un Tag attribué manuellement sur chaque monde. Une catégorie avec Tag n'est pas considérée comme un Type précis indépendant lorsque Type est déduit.

Default - option par défaut

Default sélectionne l'option initiale dans une liste du menu principal : par exemple, corporation ou scénario. Il s'agit de la suggestion initiale jusqu'à ce que le joueur en choisisse une autre. Chacune de ces listes ne peut avoir qu'une seule option par défaut.

Default true sélectionne une définition par défaut sur son axe de sélection si une valeur spécifique n'est pas déjà sélectionnée. Une de ces options est autorisée dans une catégorie. La valeur est true ou false. Default appartient à la définition et n'est ni copiée ni héritée : un descendant d'une corporation ne devient pas automatiquement une nouvelle valeur par défaut. Le choix explicite du joueur prime.

Voici le fichier patch complet Logic/Default.json. Il retire CorpMiner - les Mineurs - du choix initial et propose CorpTechnocrat - les Technocrates. L’opération set remplace les valeurs des champs existants. La section consacrée aux fichiers explique les patches en détail.

{
  "set": [
    ["CorpMiner", "Default", false],
    ["CorpTechnocrat", "Default", true]
  ]
}

Le nouveau menu propose par défaut de « Technocrates » au lieu de « Mineurs ». Les deux lignes restantes Default true auraient donné une erreur d'ambiguïté.

Order, Tier et Level - ordre, niveau de l’arbre et niveau acquis

Order définit l’ordre des cartes, Tier leur niveau dans l’arbre technologique et Level le niveau atteint par une recherche répétable. Pour déplacer une technologie, utilisez Order et Tier. Ne modifiez pas Level pour cela : il concerne les recherches achevées et la force de leur effet.

Choisissons d’abord le niveau de l’arbre pour l’extraction profonde. Elle est déclarée au premier niveau ainsi :

["DeepExtraction", "Tier", 1]

Remplacer 1 par 2 déplace sa carte au deuxième niveau. Cela n’ajoute pas de prédécesseur requis, qui se définit avec Requires. Tier accepte un nombre fini, généralement entier dans l’arbre.

Choisissons maintenant la position dans ce niveau. Order 2.5 place la carte entre les valeurs voisines Order 2 et 3 :

["DeepExtraction", "Order", 2.5]

Order peut être fractionnaire, mais doit être fini et non négatif. Ni l’ordre ni le niveau de l’arbre ne signifie que la technologie est déjà recherchée.

DeepExtraction est la technologie existante d’extraction profonde. L’exemple déplace seulement sa carte : Tier 1 signifie le premier niveau et Order 2.5 une position entre 2 et 3. Aucun Level n’est attribué.

["DeepExtraction", "Tier", 1],
["DeepExtraction", "Order", 2.5]

La carte reste au premier niveau, entre Order 2 et 3. Son coût et son paiement ne changent pas. Level répond à une autre question : combien de niveaux d’une technologie répétable sont achevés dans la partie ? Level 2 signifie deux recherches achevées et participe à la force du bonus. Ce n’est pas un paramètre de placement. Un champ Level seul ne crée pas un système de niveaux sur un objet arbitraire.

Enabled - disponibilité de l'affichage des éléments

Enabled affiche l'état d'un élément commutable déjà existant. Par exemple, si le microphone est allumé, cela signifie que la reconnaissance vocale fonctionne. Le drapeau ne crée pas de nouveau bouton et ne remplace pas les exigences technologiques ou de construction.

Microphone est le commutateur existant du microphone. Quand vous cliquez dessus, son gestionnaire change Enabled et le client démarre ou arrête la reconnaissance vocale. Les données ci-dessous définissent l’état initial désactivé de cet élément.

["Microphone", "Enabled", false]

Cela ne crée pas de bouton et n'interdit pas la construction. Les éléments du menu général peuvent afficher Enabled true avec un indicateur vert, mais les actions elles-mêmes vérifient la disponibilité et les conditions. Pour les technologies ou les bâtiments indisponibles, utilise le Requires/Blocks de leur propriétaire. Utilise le rôle Toggle pour activer et désactiver la production économique, plutôt que le Enabled arbitraire sur une ressource.

Difficulty - une étiquette de difficulté

Difficulty - étiquette du niveau de difficulté sur la carte scénario. Il permet de comparer les options du menu, mais ne recalcule pas l’équilibrage : changer le mot « Moyenne » en « Difficile » ne modifie pas en soi les prix, les stocks et les durées.

Difficulty - clé de chaîne du niveau de difficulté de la carte. Ensemble de base : DifficultyVeryEasy, DifficultyEasy, DifficultyNormal, DifficultyChallenging, DifficultyHard, DifficultyVeryHard, DifficultyMasochist. Il s'agit d'une étiquette et d'une couleur d'affichage acceptée, et non d'un multiplicateur de prix automatique ou de la force de l'ennemi. Les règles exactes du mode sélectionné sont spécifiées séparément.

["ScenarioG", "Difficulty", "DifficultyNormal"]

La carte scénario montre une difficulté moyenne. La modification de cette entrée ne modifie pas les ressources, les durées ou la structure de la carte.

Preview - contenu de la description du menu principal

Preview choisit les capacités à présenter brièvement sur une carte du menu principal. Il concerne la description avant le début de la partie. Une capacité absente de ce résumé continue à fonctionner en jeu.

Affichons les capacités de toute la corporation de « Mineurs » sur sa carte. Donnons à CorpMiner un Preview de valeur MainMenu :

["CorpMiner", "Preview", "MainMenu"]

La carte CorpMiner reçoit un résumé de ses capacités. Supprimer Preview réduit la description, sans désactiver la capacité ni retirer son effet pendant la partie.

Dans l’article « ColdWorld et Icy », nous ajouterons aux « Mineurs » une partie ColdMining donnant un bonus sur les mondes froids. Pour montrer uniquement cette partie sur la carte, définissez Preview sur elle plutôt que sur toute la corporation :

["CorpMiner.ColdMining", "Preview", "MainMenu"]

La description inclut ColdMining et ses parties imbriquées. Il faut d’abord ajouter le bonus de cet exemple : Preview ne le crée pas. Preview appartient à la définition elle-même. Il n’est ni hérité ni transféré aux objets de la partie.

Icon - image d’une entité ou d’une propriété

Icon définit l’image d’une chose ou l’icône d’une propriété. Il faut d’abord un fichier PNG existant, puis un fait portant son nom. Changer l’icône modifie l’image, pas la classe, l’action ni l’effet numérique.

Choisissons d’abord l’image de l’avant-poste lui-même. Écrivez son nom sans .png :

["Outpost", "Icon", "outpost"]

Le jeu retrouve outpost.png dans Art. Changer Icon modifie l’image sans créer de nouvelle classe ni d’action.

L’icône des Travailleurs d’une corporation est un choix distinct. Elle se définit avec Icon.Workers, pas avec l’Icon de CorpMiner lui-même :

["CorpMiner", "Icon.Workers", "cosmo_helmet_orange"]

Les Travailleurs de « Mineurs » utilisent cosmo_helmet_orange.png. L’icône de la corporation ne change pas. Rassemblons ces deux modifications indépendantes :

["Outpost", "Icon", "outpost"],
["CorpMiner", "Icon.Workers", "cosmo_helmet_orange"]

Dans ce fragment, Outpost utilise l’image outpost. L’icône des Travailleurs de CorpMiner devient cosmo_helmet_orange. Les deux fichiers existent déjà dans le jeu. IconMap définit une image distincte pour la carte. Icon.Map n’est pas autorisé.

Pour votre propre image, créez Art/Icons/my_icon.png puis indiquez Icon my_icon. Les noms sont recherchés sans chemin : deux my_icon.png dans des sous-dossiers différents entrent en conflit. Un carré transparent de 256 × 256 est pratique pour commencer, sans être obligatoire.

Si une famille my_icon00.png/my_icon01.png existe sans fichier exact my_icon.png, Icon my_icon choisit une variante pour l’objet créé et la conserve. Ajouter un my_icon.png exact lui donne la priorité. Un composant de propriété ordinaire utilise Icon après le nom du champ. Ne confondez pas cet ordre avec la forme spéciale Icon.Workers.

IconMap - image distincte sur la carte

Un bâtiment peut avoir une icône de bouton et une autre image sur la carte. IconMap change seulement l’image de carte et conserve Icon ailleurs. Si elles doivent être identiques, Icon seul suffit.

Choisissons d’abord une image uniquement pour la carte :

["Outpost", "IconMap", "outpost"]

Ici, l’image correspond à l’icône ordinaire. Un autre nom IconMap ne changerait que l’image de carte. Sans IconMap, la carte utilise à nouveau Icon. IconMap accepte un PNG existant ou une image composée d’un fichier arrière et d’un fichier avant.

Agrandissons seulement l’image sur la carte. Ajoutons un IconMap.Scale positif à l’IconMap choisi. Voici le fragment complet pour Outpost existant :

["Outpost", "Icon", "outpost"],
["Outpost", "IconMap", "outpost"],
["Outpost", "IconMap.Scale", 1.1]

L’avant-poste achevé sur la carte passe à l’échelle 1.1, tandis que son icône de bouton reste ordinaire. Pour une image personnalisée à deux couches, créez les PNG <nom>_down et <nom>_up : l’arrière est dessiné derrière le corps, l’avant devant lui. Ces fichiers doivent eux aussi avoir des noms de base uniques.

IconGain et IconReady - icônes de gain et de disponibilité

Certaines situations utilisent des images distinctes : découverte d’une source accrue et action prête à être exécutée. IconGain et IconReady choisissent ces icônes, pas le montant de la découverte ni le droit d’exécuter l’action.

Définissons d’abord l’icône d’augmentation d’une source de Minéraux :

["Minerals", "IconGain", "ore_iron_plus"]

La découverte utilise l’image existante ore_iron_plus. Cette ligne ne définit pas le montant de la récompense.

Une action prête possède une autre icône, IconReady. Choisissons la loupe magnifier pour Explore. Voici les deux exemples réunis :

["Minerals", "IconGain", "ore_iron_plus"],
["Explore", "IconReady", "magnifier"]

La découverte de Minéraux et l’exploration prête utilisent leurs propres images. IconReady concerne une action Is Action et n’annule pas ses conditions. Les deux champs exigent un nom de fichier exact, pas la base d’une famille aléatoire. L’affichage dépend du résultat réel ou de la disponibilité de l’action.

IconSize - échelle d'image

IconSize modifie la taille de l'image du corps à l'écran. Il n'ajoute pas de territoire ou d’emplois. Sans valeur positive distincte, le client choisit lui-même la taille de l'image selon Size.

IconSize est un nombre fini d’échelle du corps. Une valeur positive de l’auteur prime. Sans valeur positive, l'interface déduit l’échelle de Size. Pour Simulation, il s'agit de l'échelle générale des mondes. <champ>.IconSize fait référence à une représentation de propriété prise en charge. L’échelle ne change pas l’aire de jeu, le prix ou la capacité.

["Debris", "IconSize", 1.5]

La dispersion des débris acquiert sa propre ampleur. Pour une planète ordinaire, il vaut mieux changer Size si la taille du jeu a changé. N’ajoute pas plusieurs échelles de compensation pour le plaisir d'un seul résultat visuel.

IconText - courte étiquette d’icône

IconText est une courte étiquette sur une icône existante. Elle peut être un point d’interrogation ou un nombre. Elle ne devient pas une réserve de ressource, un coût ou une durée parce qu’elle ressemble à un nombre.

IconText et <champ>.IconText acceptent du texte final ou un nombre fini, mais pas true ou false. Le nombre utilise le format du jeu. L’étiquette « 3 » ne signifie pas trois unités de ressource : leur quantité réelle se définit avec Count.

MyMarker est l’objet placé avec l’image outpost dans PlacedAt. Ajoutez la ligne ci-dessous après Is Building, Icon outpost et PlacedAt Earth. IconText ne crée pas le marqueur à lui seul.

["MyMarker", "IconText", "?"]

Le marqueur affiche un point d’interrogation. C’est une étiquette finale, pas une clé du dictionnaire. Pour afficher un nombre à sa place, remplacez seulement la valeur :

["MyMarker", "IconText", 3]

L’étiquette affiche maintenant 3, sans porter la réserve d’une ressource à trois. Une quantité réelle exige Count. IconText accepte du texte ou un nombre fini, pas true/false. L’étiquette ne crée ni action ni fenêtre.

Color - identité des couleurs

Color précise la couleur d'apparence acceptée : par exemple, l'identité orange d'une corporation ou le ton rouge d'un événement dangereux. La couleur aide à lire l'interface ; elle n’annonce pas un nouveau type de danger et ne modifie pas les règles.

Color et <champ>.Color utilisent des noms de palette sémantique. Les identités des joueurs utilisent red, orange, yellow, green, teal, blue, purple et pink. Les événements utilisent des nuances de catégorie acceptées, telles que green, yellow et red. N’écris pas RGB, CSS ou HTML dans les données de jeu. L'interface dérive les couleurs de pénurie et de disponibilité de l'état, plutôt que de stocker un autre fait.

["CorpMiner", "Color", "orange"]

Les « Mineurs » ont une identité orange. Recolorer une corporation ne crée pas de nouvelle ressource ou d'effet.

Palettes de joueurs et de corporations : red, orange, yellow, green, teal, blue, purple, pink. Couleurs d'événement : green, superGreen, lightGreen, darkGreen, red, superRed, darkRed, gray, lightGray, darkGray, veryDarkGray, lightBlue, blue, darkBlue, darkDarkBlue, grayYellow, yellow, pink, cyan, darkCyan, orange, darkOrange, lightViolet, purple, chartreuse, navyBlue. La casse est importante. Il existe également des noms sémantiques positive, danger, info et des couleurs difficultyVeryEasy, difficultyEasy, difficultyNormal, difficultyChallenging, difficultyHard, difficultyVeryHard, difficultyMasochist. Le code couleur personnalisé ne crée pas de nouvelle palette.

Hide - masquer une présentation

Hide masque une présentation existante. Une caractéristique cachée peut continuer à être calculée et à influencer le jeu. Cacher un nombre et annuler son effet sont donc deux opérations distinctes.

Masquons uniquement l’affichage de la taille stellaire. true concerne Size.Hide, pas Size lui-même :

["Star", "Size.Hide", true]

La taille de jeu de l’étoile n’est plus affichée comme bouton distinct, mais sa valeur reste présente. Hide ne change pas les unités physiques et ne constitue pas une condition de génération. Pour annuler un masquage hérité, donnez false à votre définition :

["ClassG", "Size.Hide", false]

ClassG peut maintenant afficher sa taille bien que Star, son parent, la masque. true et false contrôlent l’affichage, pas la valeur de taille.

Une notification peut être masquée entièrement. Ce fragment masque par exemple le message de SuppliesWater, l’événement qui donne de l’Eau au joueur :

["SuppliesWater", "Hide", true]

L’événement continue d’ajouter de l’Eau mais son message n’apparaît pas. Pour un effet numérique, Hide masque de même la ligne descriptive en conservant le calcul. Le masquage ne convient donc pas pour annuler une capacité.

Pour désactiver une capacité, modifiez sa règle ou retirez-la elle-même. Hide ne convient pas : un bonus masqué reste actif et masquer une notification n’annule pas l’événement.

Background - fond de scène

Background choisit le fond de la carte. La parallaxe est un léger décalage des couches donnant une impression de profondeur quand la caméra bouge. Elle peut être désactivée indépendamment de la couche d’étoiles.

Choisissons le fond existant nebula pour la carte de PreWarpAge :

["Simulation", "Background", "nebula"]

Background nomme un ensemble d’images de fond. La couche d’étoiles supplémentaire s’active séparément :

["Simulation", "Background.Stars", true]

false retirerait cette couche en gardant nebula. Le décalage des couches pendant le mouvement de caméra est encore un paramètre distinct. Désactivons-le et rassemblons ces trois choix :

["Simulation", "Background", "nebula"],
["Simulation", "Background.Stars", true],
["Simulation", "Background.Parallax", false]

La carte utilise le fond nebula et la couche d’étoiles existants. Le fond ne se décale pas quand la caméra bouge, car la parallaxe est désactivée.

Dans PreWarpAge, ces paramètres de carte se définissent sur Simulation. Pour votre propre fond, créez Art/Backgrounds/my_space00.jpg et indiquez Background my_space. Si vous avez plusieurs variantes, continuez la numérotation : my_space01.jpg, my_space02.jpg. Même un fichier unique doit finir par 00.jpg. Ne sautez pas de numéro : la recherche s’arrête au premier fichier manquant. Un PNG ne convient pas à la place du JPG.

Sound et Music - voix, ambiance et musique

Commençons par le court son d’exploration. L’action Explore le définit avec Sound :

["Explore", "Sound", "scan"]

scan est le nom d’un fichier OGG existant, sans chemin ni extension. Le son joue à l’exécution de l’exploration, sans devenir un fond permanent.

La musique concerne toute la scène et se définit donc sur Simulation avec Music. Ajoutons le morceau existant interstellar_waltz à l’exemple du son d’exploration :

["Explore", "Sound", "scan"],
["Simulation", "Music", "interstellar_waltz"]

Sound scan reste le son de l’action et Music interstellar_waltz la musique de scène. Music dans un tableau ordinaire remplace l’ancienne liste de Simulation. Pour ajouter une piste à la liste existante, il faut l’opération add de la section sur les patchs. Plusieurs entrées Music dans un fichier forment une nouvelle liste dans l’ordre écrit. Sound.Music n’existe pas.

Les sons courts peuvent autoriser une légère variation de hauteur et de timbre. Ce n’est pas le choix d’une autre piste musicale :

["Explore", "Sound.Variants", true]

false désactive ces variations. Choisir parmi plusieurs fichiers est un autre paramètre : le nom Sound peut désigner une famille. Créez deux fichiers sans my_scan.ogg distinct :

Sounds/FX/my_scan00.ogg
Sounds/FX/my_scan01.ogg

Indiquez maintenant la partie commune du nom, sans terminaison numérique :

["Explore", "Sound", "my_scan"]

À la place d’un fichier exact, l’exploration peut choisir my_scan00 ou my_scan01. Les chiffres peuvent suivre directement le nom ou un trait de soulignement. Sound.Variants reste l’autorisation distincte de varier la hauteur et le timbre du son choisi.

Sound.Ambience est enregistré comme champ d’environnement sonore de la carte, mais aucune recette distincte prise en charge de lecture dans l’interface actuelle de PreWarpAge n’est présentée ici. Ne l’utilisez pas comme moyen garanti d’activer un fond permanent. Les contextes fonctionnels montrés sont Sound pour une action et Music pour une scène. L’interface contrôle le volume et l’ordre de lecture. Des suffixes Sound arbitraires ne créent pas de paramètres.

Pour vos propres sons, créez Sounds/FX/my_scan.ogg et Sounds/Music/my_theme.ogg, puis utilisez my_scan et my_theme. Choisissez OGG Vorbis : un effet court peut être mono et la musique stéréo. Les noms doivent être uniques, même dans des sous-dossiers différents. Le son d’action joue lors de son exécution, pas en permanence. La fréquence d’échantillonnage est définie dans le fichier audio lui-même.

FunFact, Myth et Machinery - récits supplémentaires

Vous pouvez ajouter un fait intéressant, un récit mythologique ou une explication du mouvement d’un monde. Le joueur les lit dans la description. Ces textes ne déclenchent pas les événements et processus physiques racontés.

Ajoutons un fait intéressant à la Terre. FunFact renvoie à une clé de traduction :

["Earth", "FunFact", "MyEarthFact"]

Dans Text/frFR.json, associez MyEarthFact à « De l’eau liquide existe à la surface de la Terre ». Ce texte apparaît dans la description. Il ne crée pas d’eau, c’est une explication pour le joueur.

Ajoutons une explication distincte du mouvement. Machinery.Description ne nécessite pas de champ Machinery sans précision :

["Earth", "Machinery.Description", "MyMotionText"]

La traduction de MyMotionText raconte le mouvement sans changer l’orbite. Voici les deux textes étudiés réunis :

["Earth", "FunFact", "MyEarthFact"],
["Earth", "Machinery.Description", "MyMotionText"]

Après l’ajout des traductions MyEarthFact et MyMotionText, la Terre prédéfinie reçoit ces explications. Elles ne déclenchent aucune nouvelle physique.

Voici le dictionnaire Text/frFR.json du fragment :

{
  "MyEarthFact": "De l’eau liquide existe à la surface de la Terre.",
  "MyMotionText": "La Terre tourne autour du Soleil."
}

L’exemple concerne Earth du scénario « Système solaire ». Un récit mythologique utilise une autre paire de textes :

["Earth", "Myth", "MyEarthMyth"],
["Earth", "Myth.Name", "MyEarthMythName"]

Traduisez par exemple MyEarthMyth par « La Terre était considérée comme la mère des êtres vivants » et MyEarthMythName par « Terre-Mère ». Myth contient le récit et Myth.Name le nom de son personnage. Le profil Deity est décrit séparément : un texte de mythe seul ne le crée pas.

Deity, Nature, Metal et Weekday - profil d’une divinité

Deity relie un corps céleste à un personnage mythologique. Celui-ci peut avoir un nom, une explication, un métal symbolique et un jour de la semaine. C’est un récit supplémentaire sur le monde, sans effet sur les règles économiques.

Créons le profil MyDeity et relions-le à la Terre existante. Deity après Is est ici le rôle du profil, et Deity sur Earth le lien vers celui-ci :

["MyDeity", "Is", "Deity"],
["Earth", "Deity", "MyDeity"]

La Terre possède maintenant un profil lié. Il peut recevoir Name, Description et Icon ordinaires comme toute définition. Sans déclaration Is Deity, une référence à MyDeity serait une erreur.

Ajoutons une caractéristique du personnage. Nature contient la clé d’une phrase, pas une nouvelle règle de comportement :

["MyDeity", "Nature", "MyDeityNature"]

La traduction de MyDeityNature, par exemple « Calme et fertile », apparaît dans la description du profil. Elle n’augmente pas la fertilité du monde.

Le métal symbolique se définit séparément. Iron est ici la clé de l’étiquette « Fer », pas une ressource du joueur :

["MyDeity", "Metal", "Iron"]

Le profil reçoit l’étiquette du métal. La réserve de Minéraux et l’extraction ne changent pas. Le jour associé se définit aussi séparément :

["MyDeity", "Weekday", "Tuesday"]

La traduction de Tuesday, « Mardi », devient l’étiquette du jour. Ce n’est ni un calendrier ni une programmation d’événements. Rassemblons le profil avec un nom, une description et l’image existante ares :

["MyDeity", "Is", "Deity"],
["MyDeity", "Name", "MyDeityName"],
["MyDeity", "Description", "MyDeityDesc"],
["MyDeity", "Icon", "ares"],
["MyDeity", "Nature", "MyDeityNature"],
["MyDeity", "Metal", "Iron"],
["MyDeity", "Weekday", "Tuesday"],
["Earth", "Deity", "MyDeity"]

Le premier bloc relie la Terre au profil achevé. Le deuxième est son dictionnaire Text/frFR.json. Un même profil peut être lié à plusieurs corps et hérité avec Is ordinaire. Deity.Nature lit le Nature du profil lié. Le corps peut ainsi accéder à la caractéristique déjà définie.

{
  "MyDeityName": "Protecteur de la Terre",
  "MyDeityDesc": "Personnage mythologique associé à ce monde.",
  "MyDeityNature": "Calme et fertile",
  "Iron": "Fer",
  "Tuesday": "Mardi"
}

Url - adresse externe

Url stocke l'adresse Internet externe d’une entité de lien distincte. L'adresse elle-même ne se transforme pas en bouton. Dans PreWarpAge, l'ouverture d'un magasin via StorePage fait référence au mécanisme de démonstration existant ; Il est impossible de créer un bouton de site arbitraire dans un jeu complet en utilisant uniquement les faits Url.

L'adresse est stockée sur une entité dans la catégorie descriptive Store ou Site. Il doit s'agir d'une adresse http:// ou https:// complète avec un nom d'hôte ; les paramètres de requête sont conservés. Le bouton StorePage existant le lit via Simulation Demo.Store uniquement dans la démo. Les mods personnalisés y sont désactivés, ce bloc décrit donc une relation de données plutôt qu'un exemple d'installation exécutable pour un mod normal.

["MyStore", "Is", "Store"]
["MyStore", "Url", "https://example.com/game?utm_source=demo"]
["Simulation", "Demo.Store", "MyStore"]

MyStore est l'adresse du magasin annoncée ici. Dans la version complète, ces lignes ne créent pas de bouton de navigation et n’activent pas les restrictions de la démo. Un Url ne s'ouvre pas à partir d'un événement personnalisé, d'une description ou d'un texte de localisation. Ne mets pas de liens HTML dans les chaînes du jeu ; l'adresse n'est pas un code ni un chemin de fichier mod.

Compatibilité des événements

Conflicts - exclusion mutuelle d'événements

Deux événements peuvent décrire des états incompatibles : par exemple, la pénurie d'Eau et son excès. Conflicts leur interdit de fonctionner simultanément pour un seul joueur. « Actif » désigne ici un événement vivant de la partie qui n'est pas encore terminé ou qui n'a pas été supprimé.

WaterShortage est un événement de pénurie d'Eau existant, WaterAbundance est un événement de surplus d'Eau existant. Les deux ont déjà été déclarés avec le rôle Event et ont leurs propres conditions de lancement. La ligne suivante montre leur limite actuelle :

["WaterShortage", "Conflicts", "WaterAbundance"]

Tant que le joueur a WaterShortage en vie, WaterAbundance ne démarrera pas, et vice versa. Inutile d’écrire l’envers : la relation est symétrique. La ligne elle-même ne déclenche aucun des événements, ne crée pas de pénurie et n'inclut pas d'événements dans le calendrier.

Pour vos événements, déclarez d’abord des Event indépendants et lancez-les par Events/Deck ou une autre chaîne prise en charge. Vous pouvez ensuite les relier avec Conflicts. Les deux doivent être des événements. Ce n’est pas une incompatibilité entre technologies, corporations ou paquets de mods. Les conflits de paquets se définissent dans modinfo.json.

Exemples complets de cartes et de répartitions de ressources

ColdWorld et Icy - froid et composition d’un monde

« Froid » et « glacé » désignent des propriétés distinctes. ColdWorld décrit le climat : un corps généré reçoit cette catégorie dans Snow ou Outer. Dans UltraHot et Hot, il reçoit HotWorld, et dans Habitable aucune des deux. Un satellite utilise la zone de sa planète. Ces catégories dépendent du placement, pas d’un seuil général de température en kelvins. Dans un système fixe prédéfini, donnez explicitement la catégorie climatique voulue avec Is.

Icy est une catégorie de composition. Les mondes existants Is Icy sont TinyIce, SmallIce, StandardIce, LargeIce, TinyCryogenic, SmallCryogenic, StandardCryogenic, StandardAmmonia et LargeAmmonia. Les mondes ammoniacaux et cryogéniques sont aussi Icy. Une géante IceGiantSmall ou IceGiantMedium ne devient pas World.Icy parce que son nom contient Ice : elle appartient à Giant. Le nom d’une classe ne détermine pas ses catégories. Son étiquette actuelle dans l’interface est Froid.

["CorpMiner.ColdMining", "Target", "World.ColdWorld"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]

Ce fragment ajoute une nouvelle partie de capacité ColdMining à CorpMiner. Le point dans CorpMiner.ColdMining désigne une partie de la définition de corporation. Aucun Has distinct n’est donc nécessaire. Sur les mondes froids du joueur mineur, chaque Travailleur extrait 0.3 Minéral supplémentaire par tour. Le bonus agit là où une source de Minéraux existe déjà.

Changeons uniquement le bénéficiaire : le bonus doit agir sur les mondes glacés, quelle que soit leur orbite. Gardons l’autre ligne identique :

["CorpMiner.ColdMining", "Target", "World.Icy"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]

La composition glacée compte désormais, pas la zone. Un monde rocheux froid perd le bonus et un monde glacé hors zone froide le reçoit. L’extraction exige toujours une source minérale existante.

Une autre variante retire la restriction World pour couvrir les corps froids d’autres catégories :

["CorpMiner.ColdMining", "Target", "ColdWorld"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]

La condition de zone froide reste présente, mais le rôle World n’est plus vérifié. Ce sont trois variantes alternatives d’un même Target. Ne les ajoutez pas ensemble pour vérifier un seul ensemble de bénéficiaires.

Ton étoile avec un monde natal garanti

Le joueur PreWarpAge standard trouve un monde natal via Spawn.Random Earthlike. Au moins une instance Is Earthlike doit réellement apparaître dans le système. StandardOcean est un World océanique rocheux, mais n'est pas Earthlike. Un monde océanique ne remplace pas automatiquement un monde natal. Augmenter le poids d'une carte de type Terre ne peut garantir un début alors qu'un seul emplacement peut encore avoir un autre résultat.

L’exemple suivant utilise ClassK avec deux emplacements dans la zone habitable. Le paquet contient exactement deux cartes : StandardEarthlike et StandardOcean. Les deux tirages produisent donc les deux mondes et garantissent un monde d’origine. Enregistrez le premier bloc dans Logic/ColdSystem.json et le second dans Text/frFR.json. Pour reproduire cet exemple, ne changez ni le nombre d’anneaux ni les poids des zones, car ils déterminent le nombre d’emplacements. Pour votre propre répartition, vérifiez à nouveau que les emplacements disponibles suffisent à accueillir la carte de monde de type terrestre obligatoire.

[
  ["MyColdStar", "Is", "ClassK"],
  ["MyColdStar", "Name", "MyColdStarName"],
  ["MyColdStar", "Orbits.Habitable.Deck.StandardEarthlike", 1],
  ["MyColdStar", "Orbits.Habitable.Deck.StandardOcean", 1],
  ["MyColdStar", "Orbits.Snow.Deck.TinyIce", 1],
  ["MyColdSystem", "Is", "ScenarioK"],
  ["MyColdSystem", "Name", "MyColdSystemName"],
  ["MyColdSystem", "Description", "MyColdSystemDesc"],
  ["MyColdSystem", "Orbit.Center", "MyColdStar"],
  ["MyColdSystem", "Order", 12]
]
{
  "MyColdStarName": "Berceau glacé",
  "MyColdSystemName": "Voisins glacés",
  "MyColdSystemDesc": "Un foyer de type Terre, un voisin océanique et les mondes glacés de la zone neigeuse."
}

Il s'agit du fichier Logic complet et du dictionnaire Text/frFR.json pour le nouveau scénario. Sélectionne « Voisins glacés » lors de la création d’une partie. L'étoile hérite de l'apparence et de la génération de ClassK. Les paquets locaux les plus proches Habitable et Snow remplacent entièrement ceux hérités : la zone habitable produit les deux cartes, la zone de neige crée uniquement TinyIce. Les zones restantes et les stocks de départ de ScenarioK sont préservés. Les niveaux des ressources des corps glacés sont toujours tirés séparément : la composition de la glace ne garantit pas qu'une ressource spécifique soit exploitée.

Système fixe et limite de Plane

Plaçons maintenant les corps à la main, sans paquets aléatoires de zones. Réalisez cet exemple dans un mod distinct : tant qu’il est activé, Player Spawn change le choix du monde natal de tous les scénarios. Utilisez-le uniquement avec « Mon système ». Le scénario possède son étoile, son monde natal terrestre et une source d’Eau glacée. Enregistrez le premier bloc dans Logic/FixedSystem.json et le deuxième dans Text/frFR.json. Orbit.Center du scénario le relie à l’étoile prédéfinie. Player Spawn choisit un monde natal précis plutôt qu’aléatoire.

[
  ["MyFixedSystem", "Is", "ScenarioG"],
  ["MyFixedSystem", "Name", "MyFixedSystemName"],
  ["MyFixedSystem", "Description", "MyFixedSystemDesc"],
  ["MyFixedSystem", "Orbit.Center", "MyFixedSun"],
  ["MyFixedSystem", "Order", 13],
  ["MyFixedSun", "Is", "Star"],
  ["MyFixedSun", "Type", "MyFixedSun"],
  ["MyFixedSun", "Name", "MyFixedSunName"],
  ["MyFixedSun", "Icon", "star_yellow00"],
  ["MyFixedSun", "Orbits", 3],
  ["MyFixedSun", "Production.Energy", 1],
  ["MyFixedHome", "Is", "StandardEarthlike"],
  ["MyFixedHome", "Name", "MyFixedHomeName"],
  ["MyFixedHome", "Orbit.Center", "MyFixedSun"],
  ["MyFixedHome", "Orbit", 1],
  ["MyFixedHome", "Explored", true],
  ["MyFixedIce", "Is", "TinyIce"],
  ["MyFixedIce", "Is", "ColdWorld"],
  ["MyFixedIce", "Name", "MyFixedIceName"],
  ["MyFixedIce", "Orbit.Center", "MyFixedSun"],
  ["MyFixedIce", "Orbit", 2],
  ["MyFixedIce", "Production.Water", 2],
  ["Player", "Spawn", "MyFixedHome"]
]
{
  "MyFixedSystemName": "Mon système",
  "MyFixedSystemDesc": "Monde natal prédéfini et source d’Eau glacée.",
  "MyFixedSunName": "Mon étoile",
  "MyFixedSun": "Étoile prédéfinie",
  "MyFixedHomeName": "Notre foyer",
  "MyFixedIceName": "Voisin glacé"
}

Activez le mod et choisissez « Mon système » pour une nouvelle partie. « Notre foyer » sera au premier anneau et « Voisin glacé » au deuxième. Leur Orbit.Center est explicite, car cette relation ne s’hérite pas. Les réserves initiales viennent de ScenarioG. Production.Water 2 signifie deux unités d’Eau extraites par Travailleur et par tour, pas deux unités dans le stock du joueur. Cette carte illustre le placement et n’est pas prévue pour terminer une partie : il faudrait les autres sources et une vérification d’équilibrage.

Choisir un autre scénario sans création de MyFixedHome ne fournit pas ce monde natal à la partie. Désactivez ce mod avant de revenir aux scénarios ordinaires.

Remplacer l’Orbit.Center de ce scénario par Plane.Cols et Plane.Rows ne crée pas une version rectangulaire de la même partie. L’étoile et le monde natal peuvent se retrouver dans des grilles distinctes, hors de la carte courante. PreWarpAge ne dispose pas encore de recette complète pour cette combinaison. Le système montré avec un centre explicite fonctionne comme scénario prédéfini autonome. Plane reste ici une référence à une autre géométrie.

Nouvelle ressource exploitable et exploration différée

Ajoutons du cryominerai et deux types de mondes glacés où l’extraire. CryoOre et tous les noms commençant par My sont inventés pour cet exemple. Examinons d’abord trois paramètres de distribution, puis rassemblons un scénario complet. La déclaration de la ressource et la réserve du joueur utilisent Is Resource, Is Stat et Player Has déjà étudiés.

La première tâche est d’autoriser le choix d’une ressource dans la distribution commune. Créons le paquet MyOreDeck avec une carte Resource :

["MyOreDeck", "Deck.Resource", 1]

Resource signifie ici « choisir une ressource admissible pour le corps ». La carte n’attribue pas encore le cryominerai et ne définit pas l’extraction. L’unité est le nombre de telles cartes dans le paquet.

La deuxième tâche est d’inclure MyOreIceA dans cette distribution et de lui autoriser le cryominerai :

["MyOreIceA", "Deck.CryoOre", "MyOreDeck"]

MyOreIceA est relié au paquet commun par le cryominerai. C’est seulement un type de ressource admissible : nous n’avons pas encore défini l’extraction par Travailleur. CryoOre n’exige pas Is Predicate, car son nom sert à l’intérieur de Deck, pas comme nouveau champ indépendant.

La troisième tâche est de donner à cette ressource un rendement possible de 2,1 unités par tour et par Travailleur :

["MyOreIceA", "Deck.CryoOre.2.1", 1]

Dans Deck.CryoOre.2.1, 2.1 est un rendement décimal unique, pas un chemin « 2 puis 1 ». La dernière unité est le nombre de cartes avec ce rendement. Le rendement doit être positif et le nombre de cartes entier non négatif. Cette carte n’ajoute pas 2,1 unités à la réserve : elle définit une production possible après exploration et affectation d’un Travailleur.

Ajoutons un deuxième rendement possible pour la même extraction :

["MyOreIceA", "Deck.CryoOre.2.1", 1],
["MyOreIceA", "Deck.CryoOre.3.1", 1]

Le cryominerai possède maintenant deux cartes de poids égal : un Travailleur extraira soit 2,1 soit 3,1 unités. Les valeurs ne s’additionnent pas. Une autre ressource nécessite son propre lien et son paquet numérique :

["MyOreIceB", "Deck.Minerals", "MyOreDeck"],
["MyOreIceB", "Deck.Minerals.0.9", 1],
["MyOreIceB", "Deck.Minerals.1.5", 1]

MyOreIceB accepte des Minéraux au rendement de 0,9 ou 1,5. Dans l’exemple complet, il accepte aussi le cryominerai : les deux possibilités seront présentées à l’exploration. Pour permettre au joueur de choisir la nouvelle ressource, ajoutons une réponse à la fenêtre « Priorité de travail » existante. Déclarons le choix et sa ressource :

["FocusCryoOre", "Is", "EventChoice"],
["FocusCryoOre", "Resource", "CryoOre"]

Resource sur la réponse signifie « choisir le cryominerai pour l’extraction ». Ce n’est pas une attribution unique de cryominerai à la réserve. Tant que le monde n’est pas désigné, le résultat ne peut être écrit nulle part.

Définissons le destinataire de la réponse. Parent est la fenêtre contenant le choix et son Target le monde exploré :

["FocusCryoOre", "Resource.Target", "Parent.Target"]

Le chemin se lit : réponse FocusCryoOre → fenêtre parente WorkFocus → monde exploré dans le Target de la fenêtre. L’extraction CryoOre s’établit sur ce monde avec le rendement préalablement tiré. Ni la réponse ni la fenêtre ne deviennent un gisement. Parent sans .Target mènerait à la fenêtre. Ne l’utilisez pas ici.

Il reste à inclure la réponse dans le contenu de la fenêtre :

["WorkFocus", "Has", "FocusCryoOre"]

Lors de l’exploration d’un monde acceptant le cryominerai, WorkFocus peut maintenant proposer cette réponse. Sur MyOreIceB, choisir « Cryominerai » fixe Production.CryoOre et choisir les Minéraux fixe Production.Minerals. Une seule ressource est choisie, pas leur somme. Remplacer Resource CryoOre par Minerals ferait de cette réponse un choix de Minéraux avec le même chemin vers le monde. Ne transposez pas mécaniquement Parent.Target à votre fenêtre : elle doit réellement conserver le monde exploré dans Target.

Toutes les parties sont étudiées. Enregistrez le bloc complet suivant dans Logic/CryoOre.json et son dictionnaire dans Text/frFR.json. Il réunit la ressource, sa réserve, les mondes glacés avec leurs paquets, la réponse de la fenêtre et le nouveau scénario.

[
  ["CryoOre", "Is", "Resource"],
  ["CryoOre", "Is", "Stat"],
  ["CryoOre", "Name", "CryoOreName"],
  ["CryoOre", "Icon", "ore_iron"],
  ["CryoOre", "Count", 0],
  ["CryoOre", "Price", 2],
  ["Player", "Has", "CryoOre"],
  ["MyOreDeck", "Deck.Resource", 1],
  ["MyOreIceA", "Is", "World"],
  ["MyOreIceA", "Is", "Icy"],
  ["MyOreIceA", "Name", "MyOreIceAName"],
  ["MyOreIceA", "Size", 3],
  ["MyOreIceA", "Icon", "ice"],
  ["MyOreIceA", "Deck.CryoOre", "MyOreDeck"],
  ["MyOreIceA", "Deck.CryoOre.2.1", 1],
  ["MyOreIceA", "Deck.CryoOre.3.1", 1],
  ["MyOreIceB", "Is", "World"],
  ["MyOreIceB", "Is", "Icy"],
  ["MyOreIceB", "Name", "MyOreIceBName"],
  ["MyOreIceB", "Size", 4],
  ["MyOreIceB", "Icon", "ice"],
  ["MyOreIceB", "Deck.CryoOre", "MyOreDeck"],
  ["MyOreIceB", "Deck.CryoOre.1.2", 1],
  ["MyOreIceB", "Deck.CryoOre.2.4", 1],
  ["MyOreIceB", "Deck.Minerals", "MyOreDeck"],
  ["MyOreIceB", "Deck.Minerals.0.9", 1],
  ["MyOreIceB", "Deck.Minerals.1.5", 1],
  ["FocusCryoOre", "Is", "EventChoice"],
  ["FocusCryoOre", "Name", "CryoOreName"],
  ["FocusCryoOre", "Icon", "ore_iron"],
  ["FocusCryoOre", "Resource", "CryoOre"],
  ["FocusCryoOre", "Resource.Target", "Parent.Target"],
  ["WorkFocus", "Has", "FocusCryoOre"],
  ["MyOreStar", "Is", "ClassK"],
  ["MyOreStar", "Orbits.Snow.Deck.MyOreIceA", 1],
  ["MyOreStar", "Orbits.Snow.Deck.MyOreIceB", 1],
  ["MyOreSystem", "Is", "ScenarioK"],
  ["MyOreSystem", "Name", "MyOreSystemName"],
  ["MyOreSystem", "Description", "MyOreSystemDesc"],
  ["MyOreSystem", "Orbit.Center", "MyOreStar"],
  ["MyOreSystem", "Order", 14]
]
{
  "CryoOreName": "Cryominerai",
  "MyOreIceAName": "Monde de cryominerai",
  "MyOreIceBName": "Monde au choix d’extraction",
  "MyOreSystemName": "Système du cryominerai",
  "MyOreSystemDesc": "Deux types de mondes glacés avec des gisements de cryominerai."
}

Activez le mod et lancez « Système du cryominerai ». « Monde de cryominerai » (MyOreIceA) et « Monde au choix d’extraction » (MyOreIceB) apparaissent dans la zone neigeuse. Le premier n’accepte que le cryominerai, le deuxième le cryominerai ou les Minéraux. Leurs définitions héritent directement de World et Icy pour éviter les paquets de ressources de TinyIce. Les liens Deck.CryoOre et Deck.Minerals vers MyOreDeck incluent les corps dans la distribution commune. L’étoile hérite de ClassK, ce qui conserve un monde natal adapté.

Le jeu prépare d’abord un plan de distribution entre les corps encore inconnus. Dans cet exemple, le plan attribue la carte Resource, la possibilité de choisir une ressource admissible. Il n’écrit pas encore Production.CryoOre ni Production.Minerals définitif. Le jeu remplit Explored.Plan et Explored.Remainder pour le plan et le reliquat.

Explorez « Monde au choix d’extraction ». WorkFocus s’ouvre avec les Minéraux et le nouveau choix « Cryominerai ». À l’affichage, chaque ressource admissible a déjà son rendement numérique tiré et conservé. Sans réponse, le corps n’a pas encore de ressource d’extraction définitive. Le choix écrit un seul Production : celui de la ressource choisie avec le rendement affiché. Rouvrir le corps ne change pas ce résultat. « Monde de cryominerai » n’a qu’une option, donc le résultat s’écrit directement sans fenêtre.

Lors d’une révélation automatique initiale, le jeu choisit lui-même le plus grand rendement tiré sans attendre de réponse. Après exploration, affectez les Travailleurs avec le curseur. Is Resource, Is Stat et Player Has créent la réserve de cryominerai du joueur et son indicateur. Price autorise son commerce.

L’exploration conserve le coût habituel d’Explore et l’éloignement de la zone neigeuse. Les Minéraux initiaux peuvent ne suffire que pour un de ces corps. Explorez le deuxième après avoir accumulé la somme nécessaire. L’exemple ne rend pas l’exploration lointaine gratuite et ne fournit pas de réserve d’essai cachée. Pour vérifier la production après révélation, affectez des Travailleurs : avec des rendements de 2.1 et 2.4, un Travailleur sur chaque corps donne au total 4.5 unités de cryominerai par tour. Les deux nombres précis dépendent de la distribution.

Limites précises de l'héritage, de la physique et des ressources

Ce qui s’hérite et ce qui exige une déclaration explicite

L’héritage crée une variante d’une chose existante sans copier toute sa définition. Mais les règles ne trouvent pas toutes leurs propriétés de la même façon : certaines lisent un ancêtre, d’autres exigent une entrée propre. Prenons une étoile et un scénario.

Conservons les paramètres ordinaires de ClassK dans notre étoile. Un seul Is suffit :

["MyColdStar", "Is", "ClassK"]

MyColdStar reçoit les paramètres de ClassK. Inutile de répéter le nombre d’anneaux et les paquets de mondes : le générateur les trouve chez l’ancêtre. Cette ligne ne choisit encore la nouvelle étoile pour aucun scénario.

Créons une variante de ScenarioK et choisissons précisément MyColdStar à la place de l’étoile d’origine :

["MyColdSystem", "Is", "ScenarioK"],
["MyColdSystem", "Orbit.Center", "MyColdStar"]

L’Orbit.Center propre choisit notre étoile pour la génération. Ne retirez pas cette ligne en comptant sur Is ScenarioK : la description du scénario peut retrouver l’étoile du parent, sans que le centre soit créé dans la partie. Hériter d’une étiquette et créer un corps sont deux étapes différentes. Voici les deux parties ensemble :

["MyColdStar", "Is", "ClassK"],
["MyColdSystem", "Is", "ScenarioK"],
["MyColdSystem", "Orbit.Center", "MyColdStar"]

Ce fragment vient du scénario complet « Voisins glacés ». La nouvelle étoile utilise les paramètres de ClassK et le scénario la choisit avec son propre Orbit.Center. Voici un rappel des articles précédents. N’étendez pas la règle du scénario à tous les champs : pour placer un corps, utilisez Orbit, et un bâtiment, PlacedAt.

  • Orbits, la fraction de ceinture OrbitFill et le choix du monde natal Spawn/Spawn.Random peuvent rester sur l’ancêtre Is : leurs règles savent les y lire. Une ceinture fondée sur RockyAsteroid n’a par exemple pas besoin de répéter OrbitFill, mais son nouvel emplacement doit être défini séparément.
  • Définissez explicitement sur la nouvelle définition les Orbit et Orbit.Center d’un nouveau corps, le PlacedAt d’un nouvel objet et le Center ou Plane d’une nouvelle carte. TrojansOf appartient aussi à la définition de l’essaim : hériter d’une classe d’astéroïdes ne lui attribue pas de planète. Voir les articles correspondants.
  • Pour Deck, ne répétez pas les cartes du parent si vous voulez garder le contenu entier. Une déclaration propre remplace le paquet correspondant en totalité. Pour Random et <champ>.Chance, conservez la déclaration du parent tant que son choix convient. Un champ fixe sur le descendant annule son intervalle Random hérité. Deck, Random et Chance décrivent ces formes de choix.
  • Changes relie une variante à la classe d’objet indiquée. Pour une nouvelle classe, attribuez les variantes comme dans Changes sans compter uniquement sur l’héritage du parent. Conservez ou modifiez les conditions Grants et les capacités numériques Modify/Adds/Multiplies selon « Trait et Grants » et les articles sur les effets numériques. Ce sont des règles d’application distinctes, pas des paramètres de placement.
  • Définissez explicitement Default, Preview et Text sur une nouvelle définition si nécessaire. Gardez Tag sur la catégorie : tous ses descendants Is lisent son étiquette. Order règle l’ordre de la définition. Si l’ordre hérité convient, inutile de le changer. Progress et Tutorial décrivent des processus avec leur état propre. Utilisez leurs articles plutôt qu’une copie du statut d’une sauvegarde.
  • Players, Imports et Seed définissent les paramètres généraux de la partie. Inutile de les reporter sur chaque nouvel objet. Le jeu remplit Parent, Started et les marques internes de génération. Les Name, Description, Icon, coûts et capacités numériques ordinaires s’héritent selon leurs règles propres. Le droit d’utiliser un mot comme prédicat ne s’hérite pas : chaque mot exige son propre Is Predicate.

Changer Is sur une chose déjà créée ne déclenche pas un nouvel héritage complet. Définissez plutôt la nouvelle classe avant la partie, puis ajoutez-la par un contenu, une génération, une action ou un scénario. Déclarer une classe seul ne crée pas d’objet dans la partie.

Owner et PlacedAt sans attributions cachées

Owner et PlacedAt répondent à des questions différentes : à qui appartient l'article et où il se trouve. Un exemple complet de marqueur pré-placé et toutes les relations requises se trouvent désormais directement dans les articles Owner et PlacedAt. Parent est expliqué séparément comme la relation de l'objet créé avec l'entité qui l'a engendré, plutôt que comme un emplacement ou un propriétaire.

Pour la technologie normale de chaque joueur, utilise Player Has <technologie> ; pour un élément standard construit par le joueur - Building et action Build. Un objet partagé avec Owner Player ne remplace pas les instances individuelles, et le PlacedAt de départ ne paie pas le coût de construction.

Champs physiques sans bibliothèque externe

Rassemblons dans un monde les champs physiques vus dans Weight, Temperature, Atmosphere, Hydrography et Habitability. Si un champ reste peu clair, commencez par son exemple court. Nous combinons ici les paramètres étudiés. Les calculs sont disponibles dans PreWarpAge sans Imports. Ils décrivent le milieu sans créer eux-mêmes de population ni d’économie. Enregistrez le bloc complet dans Logic/PhysicalWorld.json et son dictionnaire dans Text/frFR.json, puis lancez une nouvelle partie distincte « Système solaire ». Consultez le rappel ci-dessous avant l’assemblage. La colonisation ordinaire utilise les tailles ludiques des classes existantes. La limite liée au diamètre physique est expliquée après l’exemple.

  • Densité et gravité : Size physique en kilomètres et Weight positif en kilogrammes. Ou Size et Density pour calculer la masse manquante, ou Weight et Density pour le diamètre Size manquant. Le calcul n’utilise pas de champ Diameter distinct. Avec Weight et Size explicites, la densité en est recalculée. N’imposez pas trois nombres contradictoires. Un corps trop dense, dont le rayon ne dépasse pas le rayon de Schwarzschild, s’effondre automatiquement en trou noir et perd son atmosphère, sa vie et les propriétés non conservées par le noyau physique.
  • Température stellaire : Luminosity positive sur l’étoile, Distance positive du corps et lien réel Distance.CentralBody. Une lune retrouve l’étoile par sa planète. Temperature.Modifier doit être positif. Sans cet ensemble, une Temperature explicite reste initiale et n’est pas déduite du numéro d’orbite.
  • Pression : Atmosphere.Pressure explicite est prioritaire. Sans lui, il faut Atmosphere.Mass relative à l’atmosphère terrestre, Gravity et le diamètre physique. Avec diamètre terrestre, Gravity 1 et Atmosphere.Mass 1, on obtient une atmosphère. Sans les données nécessaires, la pression n’est pas calculée.
  • Phases : substance Hydrography, pourcentage total Hydrography.Surface et Temperature positive. H2O, S, SO2, NH3, CH4, N2, CO2 et H2SO4 sont reconnus. Hydrography.SurfaceLiquid et Hydrography.SurfaceSolid sont déduits de la température. Un symbole inconnu ne reçoit pas automatiquement de nouvelles températures de fusion.
  • Habitabilité : indiquez Habitability 0 avec l’atmosphère, la couverture d’eau et la température. Zéro active le calcul. L’évaluation humaine finale est écrite dans Habitability.Human et calculée séparément de l’économie des Travailleurs. Affinity et Economy n’activent pas eux-mêmes production, revenu de ressources, population ou gouvernement.
[
  ["MyPhysicalWorld", "Is", "World"],
  ["MyPhysicalWorld", "Name", "MyPhysicalWorldName"],
  ["MyPhysicalWorld", "Icon", "earth_africa"],
  ["MyPhysicalWorld", "Orbit.Center", "Sun"],
  ["MyPhysicalWorld", "Orbit", 3],
  ["MyPhysicalWorld", "Size.Measure", "Kilometers"],
  ["MyPhysicalWorld", "Size", 12742],
  ["MyPhysicalWorld", "Weight", 5.972e24],
  ["MyPhysicalWorld", "Temperature", 288],
  ["MyPhysicalWorld", "Atmosphere", "Breathable"],
  ["MyPhysicalWorld", "Atmosphere.Pressure", 1],
  ["MyPhysicalWorld", "Hydrography", "H2O"],
  ["MyPhysicalWorld", "Hydrography.Surface", 71],
  ["MyPhysicalWorld", "Habitability", 0]
]
{
  "MyPhysicalWorldName": "Monde physique"
}

Dans une nouvelle partie, « Monde physique » apparaît dans une cellule libre du troisième anneau. La Terre reste en place. Ouvrez la description : masse et diamètre permettent le calcul de densité et de gravité, tandis que l’atmosphère et l’eau participent à l’habitabilité. La température est ici fixe. Distance et Distance.CentralBody ne sont pas indiqués pour calculer le chauffage.

Cet exemple présente une limite importante. Dans PreWarpAge, le même Size participe aussi aux capacités ludiques d’accueil. Un diamètre de 12742 km peut donc donner une capacité immense plutôt qu’un territoire planétaire ordinaire. Aucun commutateur unique ne convertit automatiquement kilomètres et territoire de jeu. L’exemple illustre les calculs physiques, sans définir une colonisation équilibrée ni une distribution de ressources. Pour une carte ordinaire, gardez l’échelle de taille World.

Les qualités atmosphériques reconnues et les règles de composition ouverte sont répertoriées dans Atmosphere. Sans règles de classification propres, les nombres MagneticField et Geology.Tectonics restent des scores d’auteur, pas des pourcentages ni des catégories automatiques. Habitability et Economy ne remplacent pas non plus Workers, Production et Income.

Fichiers précis de nouvelles images, arrière-plans et sons

Vous pouvez créer ces fichiers directement dans votre mod. Les sous-dossiers organisent le contenu. Une clé PNG ou OGG dans un fait est son nom de base sans chemin ni extension. La recherche est récursive et les noms sont plats : Art/Icons/my_icon.png et Art/Worlds/my_icon.png entrent en conflit sous my_icon. Ne comptez pas sur le doublon qui l’emporte. Pour remplacer une ressource existante, reprenez son nom et son emplacement. Pour une nouvelle, choisissez un nom de base unique.

Art/Icons/my_corporation.png
Art/Worlds/my_ice00.png
Art/Worlds/my_ice01.png
Art/Stars/my_star00.png
Art/Worlds/Sprites/myrings_down.png
Art/Worlds/Sprites/myrings_up.png
Art/Backgrounds/my_space00.jpg
Sounds/FX/my_scan.ogg
Sounds/Music/my_theme.ogg

Utilisez des PNG transparents pour les icônes et les corps. Vous pouvez commencer avec 256 × 256 pixels pour une icône ou une planète et 1024 × 1024 pour une étoile. Ce sont des recommandations, pas des dimensions obligatoires : le jeu redimensionne les images. Gardez l’objet à l’intérieur d’un canevas carré pour éviter qu’il soit coupé. Pour un fond, utilisez un JPG, par exemple de 1920 × 1080 pixels, en tenant compte du recadrage possible selon les proportions de la fenêtre. Le code suivant est un fragment à placer dans le tableau de votre fichier Logic/Assets.json.

["CorpMiner", "Icon", "my_corporation"]
["TinyIce", "Icon", "my_ice"]
["ClassK", "Icon", "my_star00"]
["TinyIce", "Rings", "MyRings"]
["Simulation", "Background", "my_space"]
["Explore", "Sound", "my_scan"]
["Simulation", "Music", "my_theme"]

Il s'agit de modifications apportées aux définitions existantes : CorpMiner - Mineurs, TinyIce - minuscule monde glacé, ClassK - étoile orange. Les fichiers du premier bloc sont créés par l'auteur du mod ; les faits suivants les relient aux objets existants. TinyIce choisit l'option my_ice00 ou my_ice01 car il n'existe pas de my_ice.png exact. Pour une famille, les chiffres directement après la base ou après un trait de soulignement sont autorisés, par exemple my_ice_00.. Si un fichier de base exact existe, il est prioritaire. ClassK utilise toujours my_star00. Rings MyRings trouve les minuscules myrings_down et myrings_up : la moitié arrière est dessinée derrière le corps, la moitié avant devant lui. Le champ Rings lui-même nécessite une traduction de MyRings pour l'étiquette de texte.

Background my_space recherche les séries continues my_space00.jpg, my_space01.jpg et au-delà. Même un arrière-plan nécessite un fichier se terminant par 00.jpg. Ne saute pas un numéro au milieu d'un ensemble : la recherche s'arrête au premier manquant. Sound et Music lisent OGG, pour une compatibilité prévisible, utilise Vorbis. Un effet court peut être rendu mono, musique - stéréo. Le taux d'échantillonnage spécifique n'est pas spécifié par les faits du jeu. La répétition de Music remplace la liste de lecture, donc pour ajouter une piste au reste, utilise le patch add décrit dans la section fichiers.

Pour nommer les nouveaux anneaux, ajoutez MyRings avec « Mes anneaux » dans Text/frFR.json. Après avoir choisi une corporation ou un scénario utilisant ces classes, les joueurs voient vos images et entendent vos sons. Un fait Icon ou Sound seul ne crée pas un fichier manquant.

Palettes de joueurs et événements

Color sélectionne la palette prédéfinie ou la couleur d'événement d’un joueur. Une liste complète des noms valides et un exemple d'affectation distinct peuvent être trouvés directement dans l'article Color. Palette de corporation et couleur d'état dangereux - différentes affectations ; un code couleur arbitraire ne déclare pas une nouvelle palette.

Propagation, dégâts et actions internes : limites complètes

Nouveau monde qui propage sa transformation

Les fichiers Logic et Text complets et l’explication pas à pas de la transformation en chaîne se trouve dans l'article « Spread et Spreads - propagation de la transformation » dans l'ouvrage de référence. Cela explique également pourquoi la capacité exige à la fois les rôles Trait et Spread, comment Has la connecte au monde et pourquoi de nouveaux mondes infectés continuent de se propager. C'est la seule source pour cet exemple ; une version distincte de la recette n'est pas annoncée ici.

Où Damage inflige réellement des dégâts

Les points de vie, le bombardement existant Bombard, le chemin explicite Damage.Target et la limite du système de combat universel manquant sont désormais expliqués directement dans l'article "Health et Damage - points de vie et dégâts". Il existe également un exemple de modification du bombardement existant. Pour un impact d'astéroïde, la cible est déterminée par l'impact, donc un Damage.Target distinct n'est pas annoncé.

Enabled et Url : consommateurs actuels

L'état du commutateur existant est expliqué dans Enabled à l'aide de l'exemple du microphone. Url explique les adresses Web et les restrictions StorePage : dans le jeu complet, une nouvelle adresse n'ajoute pas de bouton de site Web personnalisé et les mods personnalisés sont désactivés dans la démo. Vérifie ces limites avant d'écrire un exemple, plutôt qu'après avoir essayé de le lancer.

État du joueur et limites du contenu disponible

Le jeu contient déjà le joueur, sa connexion et la sélection courante. Inutile de les créer à la main dans le mod. Voici les rôles et champs internes rencontrés à la lecture d’une partie. Ils ne constituent pas une recette de nouveau mode en ligne.

Player signifie joueur, Human signifie humain, AI signifie rôle de joueur artificiel. Simulation Players N déclare le nombre de joueurs à créer sous la forme d'un nombre entier non négatif. La palette actuelle prend en charge un maximum de huit options générées. Mais PreWarpAge est conçu pour une seule personne : l'ajout du rôle AI ne crée pas d'adversaire avec sa propre stratégie ou un jeu en réseau. Pour un mod normal, conserve la configuration solo actuelle.

Seat.<identifiant> associe une connexion à un joueur. Selected.<identifiant> stocke la sélection d'un client particulier, tandis que Started enregistre que le jeu a commencé. Par exemple, Started indique une partie en cours, mais un auteur ne doit pas le paramétrer pour tenter de créer un monde. Ne copie pas ces champs à partir d’un dump et ne les utilise pas pour afficher un bouton ou contourner l’autorisation d’action.

World - monde, Rocky - composition rocheuse, Icy - glacé, Giant - géant, Star - étoile, Satellite - satellite. SurfaceBuilding signifie construction en surface, Orbital - orbitale. Unique est un indicateur d’unicité propre à la chose, Store et Site sont des catégories descriptives de liens. Tous les mots après Is ne correspondent pas à un prédicat distinct du même nom. La nouvelle catégorie permet de catégoriser les données ; un rôle arbitraire ne reçoit pas le comportement existant uniquement de son nom.

11. Remarques et suggestions

Vous avez trouvé une erreur, une explication peu claire ou souhaitez proposer une amélioration ? Écrivez au support : support@clarusvictoria.com. Indiquez la version du jeu et la section du guide concernée. Si un exemple se comporte autrement, joignez le fichier du mod et décrivez le résultat obtenu.