Les réglages des workers
Chaque écran de worker se lit et s'écrit d'un coup, par un couple de fonctions : GetExpeditionsConfigs() rend tous les réglages de la page Expéditions dans une table, le script change ce qu'il veut, et SetExpeditionsConfigs(cfg) l'enregistre. C'est le modèle de Ninja, et pour les Expéditions ses noms de champs : un script recopié qui écrit configs.Sheets[0].Origin tourne. Six écrans ont leur couple sur cette page : Expéditions, Mode veille, sortie de flotte pour la nuit, Rapatriement, Distribution, Récompenses et booster.
c = GetExpeditionsConfigs()
c.MaxSlots = 6
c.Sheets[0].Duration = 4
err = SetExpeditionsConfigs(c)
if err != nil {
LogWarn("réglages des expéditions refusés : " + err.Error())
}
Ce que fait un Set
Il ne change que les champs donnés. SetExpeditionsConfigs({"MaxSlots": 6}) change le plafond et rien d'autre. Une table imbriquée se fusionne de même : une composition, un jour du planning, l'onglet Booster. Un script qui relit, attend, puis rend l'objet entier n'efface donc rien de ce que vous avez changé à l'écran entre-temps : un champ rendu tel qu'il a été lu ne s'écrit pas.
Il passe par le même chemin que le bouton Enregistrer de l'écran. Le réglage s'applique tout de suite, survit au redémarrage, et suit les mêmes règles : exclusivité des outils, normalisation, refus. Rien n'est écrit quand rien ne change.
Un champ inconnu est refusé, avec la liste des champs connus ; une valeur hors bornes aussi, jamais ramenée en silence. L'erreur nomme la fonction et le champ : SetExpeditionsConfigs : Sheets[0].Duration : 20 refusé : le robot le ramènerait à 15. Un seul champ refusé, et rien n'est écrit. Les bornes sont celles de l'écran ; celles que le robot applique de lui-même se disent par « le robot le ramènerait à ».
L'interrupteur n'est pas un champ. Un worker s'allume et s'éteint par StartWorker, StopWorker et leurs noms de Ninja (voir Workers) : écrire Enabled est refusé.
Un céleste s'écrit de quatre façons : l'objet (GetCachedPlanets()[0]), son identifiant (planet.GetID(), comme chez Ninja), sa coordonnée ("1:105:8", "M:1:105:8" pour la lune) ou "home" là où le champ peut suivre la planète mère réglée sous Paramètres > Général. Quand le robot est connecté, il doit être un céleste du compte. Une lecture rend la coordonnée, ou "home".
Le plafond de slots d'un worker est son champ MaxSlots, la ligne du worker sous Paramètres > Slots de flotte, de 0 (pas de plafond) à 100. Pour les envois de vos propres scripts, c'est SetMaxSlotsFor, plus bas.
Les Expéditions
| Fonction | Rend | |
|---|---|---|
GetExpeditionsConfigs() | 1 : une table | Tous les réglages de la page Expéditions, compositions comprises (Sheets). |
SetExpeditionsConfigs(cfg) | 1 : une erreur | Enregistre les champs donnés. |
NewSheet() | 1 : une table | Une composition neuve, à ajouter à Sheets : configs.Sheets += *sheet. |
SetActiveExpeditionsSheet(nom) | 1 : une erreur | Choisit la composition utilisée, par son nom ou son UUID, et décoche les autres. "" n'en laisse aucune. |
| Champ | Type et bornes | À l'écran |
|---|---|---|
Strategy | "majority", "all" ou "never" | Stratégie |
MajorityThreshold | entier, 0 et plus ; 0 : la moitié des slots | Seuil de départ |
MajorityMaxWait | minutes, de 0 à 1440 | Attente max |
DelayMin, DelayMax | secondes, 1 et plus, le premier pas plus grand | Délai entre deux flottes d'une vague |
WaveDelayMin, WaveDelayMax | secondes, 1 et plus, le premier pas plus grand | Délai avant de relancer après un retour |
LargeCargoHome, SmallCargoHome, PathfindersHome | entier, 0 et plus | Vaisseaux à garder |
RecycleDebris | true ou false | Recycler les débris en position 16 |
MinimumPathfinders | entier, 1 et plus | Éclaireurs minimum par champ |
RecyclePathfindersHome | entier, 0 et plus | Éclaireurs gardés à quai |
MaxSlots | entier, de 0 à 100 | Paramètres > Slots de flotte > Expéditions |
Sheets | liste de compositions | Les onglets des compositions |
Une composition :
| Champ | Type et bornes | À l'écran |
|---|---|---|
UUID | texte, rendu par la lecture | Désigne la composition ; absent ou "" : une composition neuve |
Name | texte | Nom |
Active | true ou false, une seule à la fois | Composition utilisée |
Multi | true ou false | Mono ou multi planètes |
Origin | céleste ou "home" | Origine (mono) |
SystemFrom, SystemTo | systèmes de l'univers, le premier pas plus grand | Plage de systèmes (mono) |
Origins | liste de célestes, dans l'ordre d'envoi | Positions de départ (multi) |
Range | entier, de 0 à 499 | Portée (multi) |
ExpeditionsPerOrigin | entier, de 1 à 25 | Expéditions par position (multi) |
OwnCountPerOrigin | true ou false | Nombre propre (multi) |
CountPerOrigin | table {céleste: entier de 1 à 25} ; 0 ou nil retire | Le nombre de chaque position (multi) |
ExpeditionSpeed | entier, de 1 à 10 | Vitesse d'expédition |
Duration | heures, de 1 à 15 | Durée |
AutoFleet | true ou false | Flotte automatique |
AutoCargo | LARGECARGO, SMALLCARGO ou PATHFINDER | Vaisseau qui porte |
Growth | true ou false | Croissance |
AutoCargo2, AutoCargo3 | les mêmes, ou 0 pour aucun | Deuxième et troisième vaisseau qui porte |
AutoCombatMax | 0 (le meilleur disponible) ou un vaisseau de combat | Vaisseau de combat au maximum |
LightFighter, HeavyFighter, Cruiser, Battleship, Battlecruiser, Bomber, Destroyer, SmallCargo, LargeCargo, EspionageProbe, Reaper, Pathfinder | entier, 0 et plus | Par expédition |
LightFighterAuto … PathfinderAuto | true ou false | Répartir |
Delete | true, en écriture seulement | Supprimer la composition |
Une seule composition est utilisée à la fois, comme à l'écran : en cocher une décoche les autres, et deux cochées dans le même appel sont refusées. SetActiveExpeditionsSheet("Nuit") est le raccourci, pour changer de composition selon l'heure.
Une composition absente de la liste n'est pas supprimée : on supprime en écrivant {"UUID": "…", "Delete": true}. Une composition neuve, sans UUID, s'ajoute au bout et prend le nom « Config N » quand elle n'en donne pas, comme le « + » de l'écran ; elle n'est pas utilisée tant que Active ne le dit pas. Choisir une origine sans plage pose les cinq systèmes de part et d'autre, comme le menu de l'écran.
Les écarts avec Ninja. Strategy est un mot et non un nombre ; DelayMin et DelayMax sont l'écart entre deux flottes d'une vague, WaveDelayMin et WaveDelayMax l'attente après un retour avant de relancer ; Origin se lit en coordonnée et non en identifiant ; les champs …Auto sont la case « Répartir ». Ce que Kepler n'a pas s'accepte à zéro et se refuse sinon : EarlyPathfinders, EarlyPFSecsMin, EarlyPFSecsMax, MinSpeedEarlyPathfinders, et dans une composition IgnoreMinimumDeuterium, SlotsAllowed, ColonyShip, Recycler, Deathstar et leurs …Auto.
configs = GetExpeditionsConfigs()
celestial = GetCachedPlanets()[0]
sheet = NewSheet()
sheet.Name = "Nuit"
sheet.Origin = celestial.GetID()
sheet.Duration = 8
sheet.LargeCargo = 300
sheet.Pathfinder = 1
configs.Sheets += *sheet
err = SetExpeditionsConfigs(configs)
if err != nil {
LogWarn("composition refusée : " + err.Error())
}
CronExec("0 23 * * *", func() { SetActiveExpeditionsSheet("Nuit") })
Le Mode veille
| Fonction | Rend | |
|---|---|---|
GetSleepModeConfigs() | 1 : une table | Les réglages de la page Mode veille : horaires, et ce que font les flottes pendant la veille. |
SetSleepModeConfigs(cfg) | 1 : une erreur | Enregistre les champs donnés. |
SetSleepSchedule(jour, de, à, de2, à2) | 1 : une erreur | Les deux plages d'un jour, comme une ligne du tableau des horaires ; de2 et à2 sont facultatifs. |
| Champ | Type et bornes | À l'écran |
|---|---|---|
Mode | "manual" ou "auto" | Mode |
WakeHour, WakeMinute | de 0 à 23, de 0 à 59 | Se réveiller à (mode manuel) |
Days | table d'un jour par nom, "monday" à "sunday" | Horaires |
SleepJitter, WakeJitter | minutes : 0, 5, 10, 15, 20, 30, 45, 60, 90 ou 120 | Décalage aléatoire du coucher, du réveil |
BeforeSleep | "skip", "ignore" ou "returnwindow" | Flottes qui rentreraient pendant la veille : ne pas envoyer, envoyer quand même, faire rentrer dans la plage de retour |
AnticipateDelays | true ou false | Anticiper les retards d'expédition |
HandleNightReturns | true ou false | Gérer les retours de flotte pendant la veille |
StayAwakeIfMainFleetHome | true ou false | Ne pas passer en veille si la main flotte est restée à quai (onglet Sortie de flotte) |
Timezone | "machine", "game" ou un fuseau comme "Europe/Paris" | Fuseau horaire du robot |
Un jour :
| Champ | Type et bornes | À l'écran |
|---|---|---|
From, To | heure, "23:30" | Première plage |
From2, To2 | heure, ou "" pour aucune ; les deux ensemble | Seconde plage (facultative) |
ReturnFrom, ReturnTo | heure, ou "" ; les deux ensemble | Flotte rentrée entre (plage de veille 1), onglet Sortie de flotte |
ReturnFrom2, ReturnTo2 | heure, ou "" ; les deux ensemble | Flotte rentrée entre (plage de veille 2) |
SetSleepSchedule pose les plages, pas le mode. Le jour s'écrit en anglais ("monday"), par son rang de Now().Weekday() (0 pour dimanche), ou "everyday" pour les sept jours, comme « Chaque jour pareil » : les fourchettes de retour de chaque jour restent ce qu'elles sont. Sans seconde plage, le jour n'en a plus. Le planning ne sert qu'en mode automatique : SetSleepModeConfigs({"Mode": "auto"}).
SetSleepSchedule("everyday", "23:30", "07:00")
SetSleepSchedule("saturday", "01:30", "10:00")
err = SetSleepModeConfigs({"Mode": "auto", "SleepJitter": 15, "BeforeSleep": "returnwindow"})
if err != nil {
LogWarn("veille refusée : " + err.Error())
}
La sortie de flotte pour la nuit
| Fonction | Rend | |
|---|---|---|
GetFleetSaveConfigs() | 1 : une table | Les réglages de la sortie de flotte pour la nuit (Fleet Save) et son tableau des célestes. |
SetFleetSaveConfigs(cfg) | 1 : une erreur | Enregistre les champs donnés. |
| Champ | Type et bornes | À l'écran |
|---|---|---|
OnSleep | true ou false | Sortir la flotte à la mise en veille |
From, To | heure, "08:00" | Plage fixe, ou heure de rentrée |
From2, To2 | heure, ou "" pour aucune ; les deux ensemble | Flotte rentrée entre (plage de veille 2) |
AtWake | true ou false | Rentrer au réveil |
WakeFrom, WakeTo | minutes après le réveil, de 0 à 1440, le premier plus petit | Entre … et … minutes après le réveil |
DeuteriumToLeave | entier, 0 et plus ; nil : jamais réglé, 10 000 | Deutérium à laisser sur place |
ProductionMinutesMin, ProductionMinutesMax | minutes, de 0 à 1440, le premier pas plus grand | Minutes de production laissées sur les planètes |
SplitDelayMin, SplitDelayMax | secondes, de 1 à 600 ; 0 et 0 : cinq à dix | Écart entre deux départs d'un découpage |
MainFleetAlways | true ou false | Ghost la main flotte dans tous les cas |
Celestials | liste de lignes | Onglet Célestes |
Une ligne du tableau des célestes :
| Champ | Type et bornes | À l'écran |
|---|---|---|
Celestial | céleste | Désigne la ligne ; un céleste sans ligne en reçoit une |
Active | true ou false, avec une destination | Sortir |
Destination | "park", "emptytomoon", "spy16", "spy16recall", "expedition", "expeditions", "colonize", "debris" ou "" | Destination : stationner, vider la planète sur sa lune, espionner la position 16, la même rappelée en vol, expédition, expéditions (tous les slots), coloniser, récolter un champ de débris |
Target | céleste, ou nil : le robot choisit ; avec "park" | Céleste visé |
Remainder | "park", "spy16", "spy16recall", "colonize", "debris" ou "" ; après une expédition | Reste de la flotte |
RemainderTarget | céleste, ou nil ; avec Remainder "park" | Céleste visé par le reste |
Expeditions | entier, de 0 à 25 | Nombre d'expéditions |
ExpeditionSheet | UUID d'une composition, ou "" | Composition d'expédition |
KeepShips | table {vaisseau: nombre} ; avec "emptytomoon" | À quai |
Split | true ou false | Découper |
DeuteriumToLeave garde son zéro : 0 laisse zéro au sol, nil remet la case à « jamais réglé », qui se lit 10 000. Une ligne du tableau se désigne par son céleste, et les lignes que la liste ne nomme pas restent telles quelles. GetFleetSaveReturn et ses deux voisines (voir Workers) règlent les mêmes heures de rentrée.
f = GetFleetSaveConfigs()
for line in f.Celestials {
if line.Destination == "spy16" {
line.Destination = "spy16recall"
}
}
f.DeuteriumToLeave = 0
err = SetFleetSaveConfigs(f)
if err != nil {
LogWarn("sortie de nuit refusée : " + err.Error())
}
Le Rapatriement
| Fonction | Rend | |
|---|---|---|
GetRepatriateConfigs() | 1 : une table | Les réglages de l'onglet Rapatriement. |
SetRepatriateConfigs(cfg) | 1 : une erreur | Enregistre les champs donnés. |
SetRepatriateDestinations(célestes) | 1 : une erreur | Les banques, plusieurs à la fois, sans toucher aux célestes à vider. |
| Champ | Type et bornes | À l'écran |
|---|---|---|
Mode | "direct", "moon" ou "collect" | Mode : normal, lune, collecte |
EveryHours | heures, de 1 à 168 | Rapatrier toutes les |
SendDelayMin, SendDelayMax | secondes, 2 et plus, le premier pas plus grand | Délai entre deux transports |
Destinations | liste de célestes | Destinations (les banques) |
Origins | liste de célestes | Planètes et lunes à rapatrier |
Resources, Ships | true ou false | Que rapatrier : les ressources, les vaisseaux |
KeepShipsPlanet, KeepShipsMoon | table {vaisseau: nombre} ; 0 retire | Vaisseaux à garder sur la planète, sur la lune |
LeavePlanet, LeaveMoon | table Metal, Crystal, Deuterium, 0 et plus | Laisser sur la planète, sur la lune |
Cargo | "LargeCargo", "SmallCargo" ou "Pathfinder" | Vaisseau de fret |
Cargo2, Cargo3 | les mêmes, ou "" pour aucun | Deuxième et troisième type |
RoundShips | 0, 10, 100, 1000 ou 10000 | Arrondir les vaisseaux à |
MinResources | entier, 0 et plus | Ressources minimales pour rapatrier |
MaxSlots | entier, de 0 à 100 | Paramètres > Slots de flotte > Rapatriement |
Les refus de l'écran, worker allumé : une banque au moins, un céleste à vider au moins, et les ressources, les vaisseaux ou les deux. Une table de vaisseaux se fusionne vaisseau par vaisseau : {LARGECARGO: 100} ne change que les grands transporteurs, {LARGECARGO: 0} les retire.
SetRepatriateDestinations(["M:1:105:8", "M:4:220:9"])
err = SetRepatriateConfigs({"Mode": "moon", "KeepShipsPlanet": {LARGECARGO: 100}, "LeaveMoon": {"Deuterium": 2000000}})
if err != nil {
LogWarn("rapatriement refusé : " + err.Error())
}
La Distribution
| Fonction | Rend | |
|---|---|---|
GetDistributionConfigs() | 1 : une table | Les réglages de l'onglet Distribution. |
SetDistributionConfigs(cfg) | 1 : une erreur | Enregistre les champs donnés. |
| Champ | Type et bornes | À l'écran |
|---|---|---|
Banks | liste de célestes | Banques qui envoient |
Destinations | liste de célestes | Destinations qui reçoivent |
Metal, Crystal, Deuterium | entier, 0 et plus, par destination | Dotation |
FillUp | true ou false | Compléter chaque destination jusqu'à ces quantités, au lieu de les envoyer |
MinSend | entier, 0 et plus | Envoi minimum |
Cargo | "LargeCargo" ou "SmallCargo" | Vaisseau de fret |
ShipsToStation | entier, 0 et plus | Vaisseaux à stationner par destination |
Auto | true ou false | Compléter automatiquement |
BelowMetal, BelowCrystal, BelowDeuterium | entier, 0 et plus, sous sa quantité quand Auto est coché | En dessous de |
CheckEveryMin, CheckEveryMax | minutes, de 10 à 240, le premier pas plus grand | Vérifier toutes les |
MaxSlots | entier, de 0 à 100 | Le plafond du Rapatriement, partagé |
Le plafond de slots est celui du Rapatriement, le même onglet : l'écrire ici le change là.
err = SetDistributionConfigs({"Deuterium": 20000000, "FillUp": true, "Auto": true, "BelowDeuterium": 5000000})
if err != nil {
LogWarn("distribution refusée : " + err.Error())
}
Les Récompenses et le booster
| Fonction | Rend | |
|---|---|---|
GetRewardsConfigs() | 1 : une table | Les réglages de la page Récompenses et booster, une table par onglet. |
SetRewardsConfigs(cfg) | 1 : une erreur | Enregistre les champs donnés. |
| Champ | Type et bornes | À l'écran |
|---|---|---|
DailyMissions | true ou false | Faire les missions du jour |
AllowDarkMatter | true ou false | Antimatière autorisée pour les missions |
MissionsCelestial | céleste, "home", ou nil pour tous | Lieu des missions |
Messages | liste de textes d'une ligne, 20 au plus, 100 caractères chacun ; vide : la liste par défaut | Messages de la mission « Envoyez un message en jeu » |
Booster | table, ci-dessous | Onglet Booster |
Auction | table, ci-dessous | Onglet Commissaire-priseur |
OfferOfTheDay | table : Active, Origin, Resource | Onglet Import/export |
Asteroid | table, ci-dessous | Onglet Farm event P17 |
Booster :
| Champ | Type et bornes | À l'écran |
|---|---|---|
Active | true ou false | Garder les boosters allumés |
Buy | true ou false | Acheter avec l'antimatière le booster qui manque |
Account | table {genre: palier} : "booster:expedition", "computer:expedition" | Booster du compte |
Stacks | table {genre: liste de paliers} : "slots:expedition" (1, 2, 3), "slots:fleet" (2, 4, 6) | Slots d'expédition et de flotte, paliers cumulés |
AllPlanets | table {genre: palier} : "booster:metal", "booster:crystal", "booster:deuterium", "booster:energy", "booster:resources" | Ligne « Toutes les planètes » |
Planets | liste de {"Planet": planète, "Choices": {genre: palier}} ; nil rend un genre à « Comme toutes » | Une ligne par planète qui fait exception |
Days | table {genre: 7, 30 ou 90}, ce que la boutique vend | Durée d'achat |
Un palier est celui de la boutique (40 pour +40 %), 0 pour aucun, -1 pour « Meilleur disponible » hors des slots.
Auction :
| Champ | Type et bornes | À l'écran |
|---|---|---|
Active | true ou false, avec une origine | Enchérir au commissaire-priseur |
Origin | céleste ou "home" | Enchérir depuis |
Resource | "metal", "crystal" ou "deuterium" | Payer en |
MaxBids | table {objet: mise} ; négative : objet décoché, mise gardée ; 0 ou nil retire | Mise maximale par objet |
DelayMin, DelayMax | secondes, 1 et plus, le premier pas plus grand | Délai avant de répondre à une surenchère |
OnlyAtEnd | true ou false | Enchérir seulement sur la fin |
MinutesBeforeEnd | minutes, de 1 à 30 | Entrer dans la vente |
LastSecond | true ou false | Offre à la dernière seconde |
SpareIgnored | true ou false | Ne jamais surenchérir sur un joueur épargné |
Les objets de MaxBids sont ceux de l'écran : "booster:metal:40", "booster:energy:80", "kraken:1d", "newtron:6h", "detroid:30m"…
Asteroid :
| Champ | Type et bornes | À l'écran |
|---|---|---|
Active | true ou false, avec une origine | Attaquer l'astéroïde de l'événement |
Origin | céleste ou "home" | Partir depuis |
Ship | un vaisseau qui vole, sauf colonisation et étoile de la mort | Vaisseau envoyé |
Slots | entier, de 1 à 20 | Slots de flotte attribués |
Les deux cases qui dépensent de l'antimatière s'écrivent comme les autres : le robot n'en dépense jamais de lui-même, un script le peut.
err = SetRewardsConfigs({
"Booster": {"Active": true, "Stacks": {"slots:fleet": [2, 4]}, "AllPlanets": {"booster:metal": -1}},
"Auction": {"MaxBids": {"kraken:1d": 9000}},
})
if err != nil {
LogWarn("booster refusé : " + err.Error())
}
Les slots des envois de script
| Fonction | Rend | |
|---|---|---|
SetMaxSlotsFor(initiateur, n) | 1 : une erreur | Plafonne les vols en l'air d'un initiateur, un nom que le script choisit : de 0 (pas de plafond à lui) à 100. |
GetSlot(initiateur) | 1 : un canal | Attend un slot de flotte libre pour l'initiateur, réserve du compte comptée ; le canal livre une fonction à appeler avec la flotte partie. |
CreateFleet(flotte, initiateur) | 1 : une erreur | Inscrit une flotte déjà partie sous un initiateur : elle compte pour son plafond jusqu'à son retour. |
Comme chez Ninja, pour qu'un script qui envoie lui-même ne prenne pas tous les slots du compte. GetSlot attend tant que l'initiateur tient autant de vols que son plafond, ou que le compte n'a plus de slot libre au-delà de la réserve (Paramètres > Slots de flotte) ; l'attente se lit sur cette page, sous le nom du script. La fonction livrée se donne la flotte partie, ou son identifiant ; une flotte vide, celle d'un envoi refusé, rend le slot. Un slot accordé dont la flotte n'est jamais rendue se libère au bout de cinq minutes.
Un initiateur n'est pas un worker : un nom de worker est refusé, son plafond est le champ MaxSlots de ses réglages. Les plafonds vivent en mémoire, partagés par les scripts du compte, et se reposent au démarrage du script.
SetMaxSlotsFor("raids", 3)
for target in ["2:40:6", "2:41:7", "2:43:4"] {
slot = <-GetSlot("raids")
f = NewFleet()
f.SetOrigin("M:1:105:8")
f.SetDestination(target)
f.SetMission(ATTACK)
f.AddShips(LARGECARGO, 200)
fleet, err = f.SendNow()
slot(fleet)
}