Piloter les workers
Un script peut allumer et éteindre les automatismes du robot, et demander lequel tourne. C'est la seule famille qui agit sur le robot lui-même et non sur le jeu.
Ce que ces fonctions font vraiment
Elles reproduisent le clic de l'interface, pas un démarrage en mémoire. Le réglage est enregistré, il survit à un redémarrage du bot, et la règle d'exclusivité des outils s'applique comme si vous aviez coché la case vous-même.
C'est une différence qui compte. Un basculement qui ne vivrait qu'en mémoire serait défait au prochain lancement, sans que rien ne le signale : votre script aurait allumé le pillage, et vous retrouveriez le compte inerte le lendemain sans comprendre pourquoi.
Les Start… et les Stop… rendent une erreur, nil quand le geste a eu lieu. Les IsRunning… rendent un booléen.
L'erreur est un ajout de Kepler : l'outil de référence ne rend rien. Un script recopié appelle ces fonctions comme des instructions et ne lit aucun retour, donc rien ne casse ; un script écrit pour Kepler, lui, peut vérifier.
Pour les lectures, false veut dire « je n'ai pas pu lire » autant que « le worker ne tourne pas ». La panne part au journal, jamais en silence.
Allumer et éteindre
| Fonction | Rend | |
|---|---|---|
StartBrain() / StopBrain() | 1 : une erreur | Le Brain. Files de construction et recherches. |
StartScanner() / StopScanner() | 1 : une erreur | Le scanner. Balayage des systèmes. |
StartHunter() / StopHunter() | 1 : une erreur | Le chasseur. Traque des cibles. |
StartSleepMode() / StopSleepMode() | 1 : une erreur | La veille. Voir l'avertissement plus bas. |
StartFarmingBot() / StopFarmingBot() | 1 : une erreur | Le pillage. StartFarmingBot() donne une campagne au Pillage s'il n'en a pas. |
StartFarmSession(campagne) | 1 : une erreur | Lance une campagne désignée, comme le ▶ de sa ligne. |
StartExpeditionsBot() / StopExpeditionsBot() | 1 : une erreur | Les expéditions. |
StartColonizerBot() / StopColonizerBot() | 1 : une erreur | Le colonisateur. |
StartDiscoveryBot() / StopDiscoveryBot() | 1 : une erreur | Le découvreur. |
StartDefenderBot() / StopDefenderBot() | 1 : une erreur | La défense. |
err = StopFarmingBot()
if err != nil { LogError("pillage :", err) }
StartExpeditionsBot()
StartBrain()
StopBrain()
StartScanner()
StopScanner()
StartHunter()
StopHunter()
StartColonizerBot()
StopColonizerBot()
StartDiscoveryBot()
StopDiscoveryBot()
StartDefenderBot()
StopDefenderBot()
StopExpeditionsBot()
Un worker peut refuser de s'allumer, et il dit pourquoi
Testez l'erreur. Elle ne dit pas seulement « ça n'a pas marché » : elle dit ce qui manque, et c'est le plus souvent un réglage.
err = StartWorker("timer")
if err != nil {
LogWarn("le minuteur ne démarre pas :", err)
// mettez un webhook Discord ou cochez Telegram, ici ou dans les
// réglages du robot : sans canal, la surveillance ne préviendrait
// personne
}
Relevé en jouant ce script sur un vrai compte : le minuteur exige un canal d'alerte, le Colonisateur un point de départ, et ainsi de suite. Un script qui ignorerait ce retour croirait avoir allumé un worker qui n'a jamais démarré.
Un nom de worker inconnu est refusé aussi, en le nommant : unknown worker "cephalopode".
Lancer une passe tout de suite
| Fonction | Rend | |
|---|---|---|
RunWorkerNow(nom) | 1 : une erreur | Lance une passe du worker sans attendre son réveil : « Vérifier maintenant » de la Construction, « Vérifier les attaques » de la défense, « Balayer l'univers maintenant » du scanner. |
C'est le bouton de la page, avec ses refus. Une Construction éteinte refuse, parce qu'une passe du Brain construit ; un balayage déjà en cours, ici ou chez un autre robot du même univers, refuse aussi. Un autre worker éteint se lance une fois, avec les réglages de sa page. Pendant que vous jouez dans le navigateur intégré, la passe attend la fin de votre partie. Les noms sont ceux de StartWorker.
err = RunWorkerNow("brain")
if err != nil {
LogWarn("pas de passe de construction :", err)
}
RunWorkerNow("defender")
Demander lequel tourne
| Fonction | Rend | |
|---|---|---|
IsRunningBrainBot() | 1 : un booléen | Vrai si le Brain tourne. |
IsRunningFarmingBot() | 1 : un booléen | Vrai si le pillage tourne. |
IsRunningExpeditionsBot() | 1 : un booléen | |
IsRunningColonizerBot() | 1 : un booléen | |
IsRunningDiscoveryBot() | 1 : un booléen | |
IsRunningDefenderBot() | 1 : un booléen |
if IsRunningFarmingBot() {
Print("le pillage tourne")
}
Print(IsRunningBrainBot(), IsRunningExpeditionsBot(), IsRunningColonizerBot())
Print(IsRunningDiscoveryBot(), IsRunningDefenderBot())
Il n'existe pas de IsRunning pour le scanner, le chasseur ni la veille : l'outil de référence n'en donne pas, et on n'invente pas de nom qu'aucun script recopié n'appellera. La forme générale ci-dessous les couvre.
Quand un worker tourne
Les IsRunning… et IsWorkerRunning disent si le worker tourne en ce moment, comme la page des workers : sa boucle est en marche, qu'il soit en pleine passe ou qu'il attende la suivante. Ils rendent faux quand :
- son interrupteur est éteint et qu'il a fini sa passe ;
- le compte est arrêté, ou n'a pas encore démarré depuis le lancement du robot ;
- la veille, le mode vacances ou
PauseBot()l'ont suspendu. Le mode manuel du navigateur intégré aussi, sauf la défense, qui continue de veiller pendant que vous jouez. L'interrupteur reste allumé, et le worker repart seul.
Sous PauseBot(), la page des workers dit encore « en marche » : la pause ferme la session sans arrêter les boucles, qui n'ont plus rien à faire. Ces fonctions répondent ce que le compte fait vraiment, et RunWorkerNow refuse sa passe.
Ils rendent vrai pour un worker dont la dernière passe a échoué : il tourne, et réessaie ; son erreur se lit sur sa page. Vrai aussi pour un worker qu'on vient d'éteindre et qui finit sa passe, et pour la veille qui reste debout, interrupteur éteint, le temps de ramener une flotte.
Une passe unique sur un worker éteint, lancée par RunWorkerNow ou par le bouton de sa page, ne le met pas en marche : IsWorkerRunning reste faux pendant la passe, et la page dit arrêté.
Pour lire l'interrupteur lui-même, la case de l'écran, c'est IsWorkerEnabled(nom) : vrai pendant toute la nuit ou tout le mode manuel, tant que la case est cochée. C'est elle qu'il faut pour rendre un worker tel qu'on l'a trouvé :
avant = IsWorkerEnabled("expeditions")
StopWorker("expeditions")
// ... le travail du script ...
if avant { StartWorker("expeditions") }
La forme générale
Kepler a des workers que l'outil de référence n'a pas : le rapatriement, l'espionnage, la phalange, la surveillance des champs de ruines, le minuteur. Ces fonctions prennent le nom du worker et les couvrent tous.
| Fonction | Rend | |
|---|---|---|
StartWorker(nom) | 1 : une erreur | Allume le worker nommé. |
StopWorker(nom) | 1 : une erreur | L'éteint. |
IsWorkerRunning(nom) | 1 : un booléen | Dit s'il tourne en ce moment. Voir plus haut. |
IsWorkerEnabled(nom) | 1 : un booléen | Dit si son interrupteur est allumé. |
ListWorkers() | 1 : une liste | Les noms que vous pouvez allumer ici, en anglais. |
L'arrêt d'urgence
Un seul appel fait taire le robot : la session se ferme, les workers sont suspendus, les autres scripts du compte sont mis en pause, et tout appel de jeu échoue tant que la pause dure.
C'est le filet du script oublié. Une boucle restée active qui interroge le serveur ne fait plus une seule requête : ses appels échouent sur « compte en veille », donc des erreurs dans votre console au lieu d'un bannissement.
| Fonction | Rend | Ce qu'elle fait |
|---|---|---|
PauseBot() | 1 : une erreur | Coupe toute communication avec le jeu. |
ResumeBot() | 1 : une erreur | La rend. |
IsBotPaused() | 1 : un booléen | Dit où l'on en est. |
LogOut() | 1 : une erreur | Alias de PauseBot, pour les scripts venus de Ninja. |
Logout() | 1 : une erreur | La même chose, sous l'orthographe de la doc de Ninja. |
Login() | 1 : une erreur | Alias de ResumeBot. |
Le script qui appelle PauseBot n'est jamais mis en pause lui-même, sinon il ne pourrait plus jamais appeler ResumeBot et le compte resterait muet.
Un compte en pause n'est plus défendu. Le Defender ne surveille plus, comme pendant une veille. C'est une mise à l'abri de votre compte contre vos propres scripts, pas contre un attaquant.
Si le script se termine sans lever la pause, le bouton « Lever la pause du robot » du bandeau « Robot en pause », en haut de chaque page du robot, la lève aussi. Vous n'êtes jamais bloqué.
if MesRaisons() {
PauseBot()
SleepMin(30)
ResumeBot()
}
for nom in ListWorkers() {
Print(nom, "tourne :", IsWorkerRunning(nom), "allumé :", IsWorkerEnabled(nom))
}
err = StartWorker("repatriate")
if err != nil { LogError("rapatriement :", err) }
StopWorker("spyer")
Les noms sont en minuscules et sans accent : brain, defender, expeditions, sleep, scanner, farmer, colonizer, repatriate, supply, hunter, discovery, spyer, phalanx, militarydebris, colonywatch, timer, scheduledflights, rewards, orion. Un nom inconnu rend une erreur qui le nomme, plutôt que de ne rien faire. orion ne s'allume que sur un univers d'Orion : ailleurs, StartWorker rend l'erreur de la page d'Orion. ListWorkers ne le nomme que sur un univers dont le robot sait qu'il a Orion, pour qu'une boucle qui s'arrête à la première erreur ne bute pas sur lui ; IsWorkerEnabled et IsWorkerRunning répondent partout.
rewards est la page Récompenses et booster. Comme les autres, il est suspendu pendant la veille : l'allumer la nuit prépare le réveil, aucune requête ne part avant. Il reste hors de la règle des outils : un outil ne l'éteint pas, et l'allumer ne coupe pas l'outil en cours. Pour qu'il se taise pendant un long travail d'un script, l'éteindre avant et le rallumer après : StopWorker("rewards"), puis StartWorker("rewards").
supply est l'alimentation des planètes du Brain depuis des banques. Elle se règle dans l'onglet Ravitaillement de la page Construction, et s'arrête sans arrêter les constructions : le Brain continue, il attend simplement sa production.
L'inverse ne vaut pas : la Construction éteinte met supply en pause. Rien n'est livré tant qu'elle reste éteinte, et les livraisons reprennent seules au rallumage, sur des besoins recalculés. IsWorkerRunning("supply") répond vrai pendant cette pause : le worker tourne, il attend la Construction. Et une plage du Planning qui allume supply Construction éteinte ne fait rien partir.
Le rapatriement épargne une planète qui attend une livraison. Il ne le fait plus quand la Construction est éteinte ou supply arrêté, ni quand le dernier contrôle de supply n'a trouvé aucune banque pour couvrir la livraison. Dans ces cas, rien ne s'apprête à partir pour elle, et la planète ne doit pas rester à découvert.
colonywatch n'est pas le colonisateur. colonizer fonde des planètes ; colonywatch surveille l'apparition de colonies autour des joueurs suivis.
Composer une campagne de pillage
| Fonction | Rend | |
|---|---|---|
NewFarmSession() | 1 : un constructeur | À enchaîner, puis BuildFarmSession(). |
Le constructeur se règle méthode par méthode, puis BuildFarmSession() enregistre la campagne et la rend active, comme le bouton « Lancer » de l'interface. Il rend deux valeurs : la campagne créée et une erreur.
Il n'allume pas le Pillage pour autant : c'est StartFarmingBot() qui le fait. Séparer les deux laisse préparer une campagne sans la faire partir tout de suite.
Ce que StartFarmingBot() choisit de mener
Il n'allume pas seulement l'interrupteur : il donne une campagne au Pillage quand celui-ci n'en a aucune, dans cet ordre.
1. Une campagne active : il se contente de l'allumer. C'est le cas du script qui vient de la créer. 2. Une campagne en pause : il la reprend où elle s'est arrêtée. N'importe quelle autre repartirait du premier système. 3. Ce qui attend en file, dans l'ordre où les campagnes y sont entrées. 4. Sinon, la première campagne enregistrée, dans son ordre de création. 5. Aucune campagne du tout : il rend une erreur et ne fait rien. Un Pillage allumé sans rien à mener est exactement ce qu'on veut éviter.
StartFarmSession(campagne) sert quand ce choix ne suffit pas : il lance celle qu'on lui nomme, comme le ▶ de sa ligne dans l'onglet Pillage. L'identifiant vient de BuildFarmSession(), ou de GetFarmSessions() pour une campagne réglée à l'écran.
campagne, err = f.BuildFarmSession()
StartFarmSession(campagne.ID)
origine = GetCachedCelestials()[0]
f = NewFarmSession()
f.SetName("tour de garde")
f.SetOrigin(origine)
f.SetRangeAroundOrigin(30)
f.SetMinimumResourcesToAttack(300000)
f.SetAdditionalCargo(10)
f.SetAttackDelay(2, 5)
f.SetPriorityRatio(1, 1.5, 2)
f.SetUsePathfinders(false)
f.SetIgnoreActivity(true)
f.SetFastAttacking(true)
campagne, err = f.BuildFarmSession()
if err != nil { LogError("campagne :", err) }
Print("campagne", campagne.ID, "portée", campagne.Range)
StartFarmingBot()
Les réglages qui portent
SetOrigin, SetOriginCoord, SetRange, SetGalaxyRange, SetRangeAroundOrigin, SetName, SetMinimumResourcesToAttack, SetAdditionalCargo, SetMinimumPlayerRank, SetUsePathfinders, SetIgnoreActivity, SetFastAttacking, SetSmallCargosFirst, SetPriorityRatio, SetAttackDelay, SetFarmStrategy, SetMajority, SetRaidsAsReportsArrive, SetBackupCargos, SetDeleteReports.
Chaque champ de la fenêtre de campagne a sa méthode, et un essai du bot le vérifie : un réglage ajouté à l'écran sans la sienne le fait échouer.
Une valeur hors des bornes de l'écran est refusée, jamais ramenée en silence : BuildFarmSession() rend l'erreur, qui nomme la méthode et la valeur reçue, et n'enregistre rien. Les bornes :
SetAdditionalCargode 0 à 50, en pour cent ;SetRangeAroundOriginde 0 à 250 systèmes ;SetAttackDelay(min, max)2 secondes au moins, et un maximum qui n'est pas sous le minimum ;SetProbesde 0 à 100 sondes ;SetMinimumStorageToIgnore0 ou plus pour chacun des trois niveaux ;SetMajorityetSetFarmSpeed, plus bas.
Plusieurs méritent un mot.
SetRange(galaxie, systèmeDe, systèmeÀ) garde vos bornes, comprises, et la galaxie que vous demandez. Elle a longtemps approximé - la demi-largeur de l'intervalle devenait une portée autour de l'origine - puis elle a gardé les systèmes mais refusé toute galaxie autre que celle de l'origine, faute de savoir balayer ailleurs. La campagne sait désormais traverser les galaxies, et ce refus a disparu.
Une galaxie nulle veut dire « toutes ». Sur un univers circulaire, une plage qui commence après sa fin passe par le bord : SetRange(1, 480, 20) traite 480 à 499 puis 1 à 20.
SetGalaxyRange(de, à) est un extra de Kepler, sans équivalent chez l'outil de référence, qui ne borne qu'une galaxie à la fois. SetGalaxyRange(1, 4) avec SetRange(0, 200, 350) balaie les systèmes 200 à 350 des galaxies 1 à 4. Zéro veut dire « toutes » des deux côtés - et sans bornes de systèmes, ce sont des galaxies ENTIÈRES : quatre d'entre elles font près de deux mille systèmes, et une campagne y passe des jours.
SetRangeAroundOrigin(portée) reste là pour qui préfère un rayon. Elle ramène la campagne en mode automatique et efface les quatre bornes : le dernier appel gagne, dans les deux sens.
SetOriginCoord(galaxie, système, position, type) ne demande pas la session. SetOrigin doit résoudre un céleste, donc attendre la connexion ; celle-ci nomme la coordonnée directement. Le type est "planet" ou "moon", tout autre mot est refusé plutôt que deviné.
SetMinimumPlayerRank ne veut pas dire ce qu'on croit. Le rang 1 est le meilleur joueur : « jusqu'à 5000 » garde donc les cinq mille premiers et écarte les autres. Zéro les prend tous.
SetFarmStrategy(nom) choisit la stratégie de vague, comme le menu « Stratégie » de la fenêtre de campagne, avec les mêmes mots que SetExpeditionsStrategy :
"all"attend le retour de tous les pillages avant la vague suivante. C'est le défaut ;"majority"relance quand une part des pillages est rentrée, sans attendre les plus lointains : voirSetMajority;"never"relance au moindre slot libre, « Ne jamais attendre (dangereux) ».
La casse et les espaces ne comptent pas. Un autre mot est refusé : BuildFarmSession() rend l'erreur, avec les trois mots attendus, et n'enregistre rien. "majorite", la clé que montre la configuration du bot, n'en fait pas partie.
SetMajority(seuil, attente) règle les deux champs d'« Attendre la majorité des pillages », dans les unités de l'écran. Le seuil est la part des pillages de la vague, en pour cent, dont le retour fait partir la suivante : de 0 à 100, et 0 vaut la moitié, comme le champ laissé vide. L'attente est le temps au plus, en minutes, que la vague accorde aux pillages qui rentrent juste après le seuil, pour partir avec eux : de 0 à 240, et 0 part dès le seuil atteint. Une valeur hors de ces bornes est refusée plutôt que ramenée en silence.
Elle ne choisit pas la stratégie. Sans SetFarmStrategy("majority"), les deux valeurs sont gardées dans la campagne mais ne servent pas, comme à l'écran quand on passe à une autre stratégie.
SetRaidsAsReportsArrive(vrai) coche « Raids dès les premiers rapports » : chaque cible est pillée dès que son rapport arrive, pendant que l'espionnage continue. Décochée, le défaut, la campagne sonde toute sa zone, classe les cibles, puis pille de la plus riche à la moins riche. Plus rapide, mais les premières cibles venues partent avant les meilleures. Le bot garde toujours des slots libres pour ses sondes, et le pillage aux sondes, lui, attend la fin de l'espionnage.
SetFastAttacking ne veut pas dire la même chose que chez Ninja. Là-bas, la case « Fast attacking » fait partir les raids dès que les rapports d'espionnage arrivent, pendant que l'espionnage continue. Chez Kepler, SetFastAttacking(true) choisit la stratégie « Ne jamais attendre (dangereux) », et false « Attendre le retour de tous les pillages » : c'est SetFarmStrategy("never") ou SetFarmStrategy("all"), la majorité en moins. Elle reste là pour les scripts recopiés, et SetFarmStrategy est la voie complète. Le comportement de Ninja se pose par SetRaidsAsReportsArrive(true) : un script venu de Ninja l'écrit à la place de SetFastAttacking(true), ou en plus s'il veut aussi la stratégie.
f = NewFarmSession()
f.SetName("majorité au fil des rapports")
f.SetOriginCoord(1, 120, 8, "planet")
f.SetRangeAroundOrigin(30)
f.SetFarmStrategy("majority")
f.SetMajority(60, 10) // 60 pour cent rentrés, puis 10 minutes au plus
f.SetRaidsAsReportsArrive(true)
campagne, err = f.BuildFarmSession()
if err != nil { LogError("campagne :", err) }
SetBackupCargos(deuxième, troisième) règle le « Deuxième type » et le « Troisième type » de la fenêtre. Quand le premier vaisseau manque sur un départ, le deuxième porte ce qui reste à piller, puis le troisième ; un raid ne mélange jamais deux types. Le premier se règle comme avant, par SetUsePathfinders et SetSmallCargosFirst, sinon le grand transporteur.
On donne les constantes LARGECARGO, SMALLCARGO ou PATHFINDER, ou 0 pour « Aucun » : ce type-là ne part jamais. Tout autre vaisseau est refusé à BuildFarmSession(). Sans appel, le repli d'avant ce réglage : grand puis petit transporteur, ou l'inverse, derrière l'éclaireur. Un troisième sans deuxième prend la deuxième place, et un type déjà pris plus haut est sauté. Sans autre réglage, SetBackupCargos(PATHFINDER, 0) part donc au grand transporteur, puis à l'éclaireur, et jamais au petit.
Les sondes, elles, pillent seules : avec SetEspionageProbeRaids(true), ces deux types ne servent que sur un univers qui refuse le pillage aux sondes.
SetDeleteReports(espionnage, combats) pose séparément les deux cases de l'écran, « Effacer les rapports d'espionnage » et « Effacer les rapports de combat ». SetDeleteReports(true, false) efface les rapports de vos sondes et garde les rapports de combat, pour OGLight par exemple. SetDeleteCombatReports coche ou décoche les deux ensemble ; des deux, la dernière appelée gagne.
Les réglages venus de Ninja
SetProbes, SetFarmSpeed, SetMinimumDefensesToIgnore, SetAttackPlayersWithDefenses, SetMinimumStorageToIgnore, SetEspionageProbeRaids, SetDeleteCombatReports.
Ils ont tous leur contrôle dans l'écran de campagne depuis le 18/09/2026. Ces fonctions restent le chemin des scripts vers les mêmes champs : un script et un clic posent la même chose, et la fenêtre reporte ce qu'elle n'affiche pas plutôt que de l'effacer.
Chacun vaut par défaut ce que le bot faisait avant qu'il existe : une campagne réglée à la main ne change pas.
SetProbes(n) fixe les sondes par espionnage, à l'aller comme au réespionnage, de 0 à 100. Sans elle, ou à zéro, le nombre réglé dans le compte OGame.
SetFarmSpeed(allure) règle la vitesse des raids, avec les constantes de pourcentage : SetFarmSpeed(FIFTY_PERCENT). Sans elle, la vitesse pleine. Une valeur hors des bornes est refusée plutôt que ramenée en silence.
SetMinimumDefensesToIgnore(n) accepte une cible dont la défense vue est strictement inférieure à n. Le nom vient de Ninja et se lit dans l'autre sens : c'est la défense à partir de laquelle on ignore la cible. Avec 1, on retrouve donc la règle par défaut de Kepler, qui n'accepte aucune défense.
SetAttackPlayersWithDefenses(false) referme ce seuil, quel que soit l'ordre des appels. À vrai, elle ne fait rien : c'est le seuil qui décide.
SetDeleteCombatReports(true) met à la corbeille le rapport de combat de chaque raid, une fois son butin compté, et à la fin les rapports que ses sondes ont rapportés : les deux cases de l'écran à la fois. Pour n'effacer qu'une des deux sortes, SetDeleteReports.
La messagerie du jeu se bloque entièrement quand trop de messages s'accumulent, boîte et corbeille cumulées, et plus rien n'y est possible. Une campagne en fabrique un par raid : sans ce réglage, un pillage qui tourne des nuits finit par bloquer la messagerie de son propre joueur.
Quatre conditions avant d'effacer, et aucune n'est décorative : le rapport doit porter l'identifiant de la flotte que nous avons envoyée, cet identifiant ne doit pas être nul, le rapport doit avoir un numéro, et sa cible doit être celle que nous visions. Un rapport d'attaque subie est donc hors d'atteinte.
Le geste du jeu déplace vers la corbeille et ne détruit pas ; Kepler fait donc les deux, l'effacement puis la purge de la corbeille de l'onglet. Effacer sans purger ne ferait que remplir l'autre moitié du compteur qui bloque la messagerie.
SetMinimumStorageToIgnore(métal, cristal, deut) écarte les cibles dont les hangars sont trop petits : en dessous de ces niveaux, la position n'est pas attaquée. Le nom vient de Ninja et se lit dans ce sens - le minimum en dessous duquel on ignore. SetMinimumStorageToIgnore(4, 0, 0) demande un hangar de métal de niveau 4 au moins et ne dit rien des deux autres. Zéro ne demande rien, et un niveau négatif est refusé : il passait pour un zéro, et la campagne attaquait tout.
Une planète aux petits hangars ne peut rien accumuler : on la vide une fois, et y revenir ne rapporte plus.
Ce réglage coûte des requêtes. Les niveaux de hangar ne sont pas dans la liste des messages, seulement dans le détail de chaque rapport : les demander, c'est une requête par cible retenue là où la campagne n'en fait qu'une pour toutes. Rien n'est lu tant que les trois valeurs sont nulles, et seules les cibles qui ont passé tous les autres filtres sont ouvertes.
Une cible qu'on n'a pas vue est écartée. Un rapport pris avec trop peu de sondes ne montre pas les bâtiments : il ne dit pas que les hangars sont petits, il dit qu'on n'a pas assez regardé. Même règle que pour la défense.
SetEspionageProbeRaids(true) fait porter le butin par les sondes d'espionnage plutôt que par les transporteurs.
Elles sont le vaisseau le plus rapide du jeu et ne coûtent que du cristal, mais ne portent que cinq unités chacune : le pillage aux sondes se joue sur le nombre. Sur un butin qu'un voisin convoite aussi, c'est la vitesse qui décide, et en perdre ne coûte rien à côté d'un transporteur.
L'univers a le dernier mot. Là où le pillage aux sondes est refusé, la soute d'une sonde vaut zéro : Kepler le demande au jeu et reprend les transporteurs, plutôt que de laisser une campagne réglée dessus ne jamais partir.
Ce qu'il faut pour espionner reste au port. La campagne garde de côté ce que son espionnage fait voler à la fois - autant de sondes par cible, fois le plus petit du nombre de cibles et de ses créneaux - et ne pille qu'avec le surplus. Sans cette réserve, la ronde suivante n'aurait plus rien pour regarder et attaquerait sur des rapports périmés.
Les sondes, et rien qu'elles. Une sonde porte si peu qu'un gros butin en prend des centaines de milliers : quelques raids suffisent à toutes les mettre en vol. Le départ n'a alors plus de fret, et la campagne attend leur retour - elle ne reprend jamais les transporteurs. Seul un univers qui refuse le pillage aux sondes la fait partir aux transporteurs.
Deux refus ne se desserrent jamais. Une flotte posée sur la cible refuse toujours - elle tire en retour, et elle vaut plus cher que de la défense. Et un rapport qui n'a pas pu établir le chiffre, faute de sondes, refuse toujours aussi : il ne dit pas que la planète est vide, il dit qu'on n'a pas assez regardé.
Partir du céleste le plus proche
SetAttackFromNearestPlanet(vrai) et SetAttackFromNearestMoon(vrai) font la même chose chez nous, et il vaut mieux le dire que laisser croire à deux réglages : l'outil de référence sépare la planète et la lune, Kepler prend le mieux placé des deux et met la lune devant sa planète à distance égale. Elle porte la même flotte sans rien annoncer au voisinage, et ce qui en part ne laisse pas la planète nue. SetStartFromNearest(vrai) est le nom Kepler de la même chose.
L'une des deux suffit à l'allumer, et false ne l'éteint que si rien ne l'a demandé par ailleurs : un script qui écrit SetAttackFromNearestPlanet(true) puis SetAttackFromNearestMoon(false) veut manifestement le mode.
SONDES ET PILLAGES PARTENT DU MÊME ENDROIT, jamais l'un sans l'autre. Un « au plus proche » qui ne déplacerait que les sondes serait exactement le défaut qu'on reproche ailleurs.
Une galaxie où le compte n'a rien est sautée. Le calcul refuse de traverser une galaxie : un vol qui le fait se remarque, et le jeu le facture des heures. La campagne l'écrit au journal plutôt que de balayer dans le vide. C'est ce qui rend SetGalaxyRange utilisable : sans lui, une plage de quatre galaxies depuis une origine fixe ferait voler les sondes une demi-heure par sortie.
SetOrigin devient facultative. En plage automatique, la portée s'applique alors autour de chacun des célestes du compte, et les zones qui se recouvrent ne sont balayées qu'une fois.
Les réglages sans équivalent
Un seul réglage de Ninja n'existe pas dans la campagne de Kepler. Il est accepté sans rien faire, pour qu'un script recopié ne s'arrête pas, et BuildFarmSession() le nomme dans le journal du bot ainsi que dans le champ Ignored de ce qu'elle rend.
SetIgnoreSleepMode. Il ne partira pas de cette liste : percer une exception dans la veille rouvrirait la partie qui a coûté le plus de défauts.
Print("ignorés :", len(campagne.Ignored))
Une seule campagne à la fois, les autres en file
Le Pillage n'en mène qu'une : deux se disputeraient les slots et les sondes. Mais BuildFarmSession() ne refuse plus quand une campagne tourne - elle met la nouvelle en file, et rend son identifiant comme d'habitude.
Et elle le dit, par deux champs de la campagne rendue : Queued vaut vrai quand elle attend, QueueRank donne sa place à partir de 1. Sans eux, les deux cas se ressemblaient trait pour trait, et un script ne pouvait pas savoir que sa campagne attendait au lieu de partir.
campagne, err = f.BuildFarmSession()
if campagne.Queued {
LogInfo("elle attend son tour, place", campagne.QueueRank)
}
Un script peut donc en monter treize d'affilée : la première devient active, les douze autres attendent leur tour dans l'ordre où vous les avez créées. Quand une campagne se termine, le Pillage prend la suivante tout seul. L'onglet Pillage les affiche « en file - 3 sur 12 ».
Trois choses à savoir :
StopFarmingBot()garde la file : il rend la campagne active au repos, et ce qui attendait attend toujours. Le prochainStartFarmingBot()le reprend dans l'ordre. Abandonner la vide, et le journal dit combien de campagnes y attendaient :AbortAllFarmingSessions(), qui retire en plus toutes les campagnes, alors que le bouton « Tout arrêter » de l'écran les garde : lui, c'estStopAllFarmSessions(). Le ■ d'une ligne, lui, n'arrête que cette campagne : si c'est celle qui tourne, la suivante de la file prend le relais. C'estStopFarmSession, voir Arrêter, mettre en file, retoucher ou supprimer une campagne ;- la pause la garde : une campagne suspendue reprend où elle en était, et ce qui la suivait la suit toujours ;
- si le Planning pilote aussi le Pillage, son programme passe devant : la file d'une plage s'épuise avant celle des scripts.
Le bouton ▶ d'une ligne refuse toujours une seconde campagne : il lance celle que vous désignez, et la mettre en file serait une surprise. C'est à ça que sert le bouton + posé à côté : + pour attendre son tour, ▶ pour partir tout de suite.
La file de l'écran et celle des scripts sont la même. Les douze campagnes qu'un script met en file s'affichent dans le panneau « File d'attente », en bas de l'onglet Pillage : on y voit l'ordre de passage, on peut en retirer une - la campagne n'est pas supprimée - et lancer la première d'un clic. Une campagne supprimée alors qu'elle attendait est écartée sans bruit : le tour passe à la suivante.
Régler et mener l'Espionnage
L'Espionnage ratisse une zone de la galaxie et sonde ce qui répond à ses critères, sans rien attaquer. Tout ce que sa page permet a sa fonction : les réglages du bouton « Enregistrer », les campagnes et les boutons de leurs lignes.
Les réglages
| Fonction | Rend | |
|---|---|---|
GetSpySettings() | 1 : les réglages | Tous les réglages ci-dessous, d'un coup. |
SetSpyTargets(cibles) | 1 : une erreur | "all", "planets" ou "moons" : le menu « Cibles ». |
SetSpyPlayers(joueurs) | 1 : une erreur | "all", "active", "inactive", "hunter" ou "list" : le menu « Joueurs ». |
SetSpyPlayerList(noms) | 1 : une erreur | La zone de texte du choix « Liste » : une liste de pseudos, écrits comme au classement. |
SetSpyRoute(parcours) | 1 : une erreur | "systems" ou "players" : le menu « Parcours », système par système ou joueur par joueur. |
SetSpyStrongPlayers(oui) | 1 : une erreur | « Espionner aussi les joueurs plus forts ». |
SetSpySkipHomeworlds(oui) | 1 : une erreur | « Ignorer les planètes mères » ; leur lune reste sondée. |
SetSpyActivityStar(oui) | 1 : une erreur | La case « Joueurs actifs seulement » : l'étoile rouge, moins de 16 min. |
SetSpyActivityTimer(oui) | 1 : une erreur | La case « Joueurs timer seulement » : de 16 à 59 min. |
SetSpyActivityNone(oui) | 1 : une erreur | La case « Joueurs sans activité » : rien d'affiché, plus d'une heure. |
SetSpyProbeDelay(min, max) | 1 : une erreur | Délai entre deux sondages, en millisecondes. |
SetSpySystemDelay(min, max) | 1 : une erreur | Délai entre deux systèmes, en millisecondes. |
SetSpyPlayerDelay(min, max) | 1 : une erreur | Délai entre deux joueurs, quand la campagne va joueur par joueur, en millisecondes. |
SetSpyMaxSlots(n) | 1 : une erreur | Plafond de slots de l'Espionnage, de 0 (pas de plafond) à 100. |
SetSpyCheckInterval(min, max) | 1 : une erreur | Attente entre deux passes du worker, en secondes. |
Chaque Set… est enregistré comme le bouton « Enregistrer » de la page : le réglage vaut tout de suite et survit au redémarrage du bot. Le plafond de slots est celui de la ligne « Espionnage » des Paramètres ; l'intervalle n'a pas de champ à l'écran.
Une valeur hors bornes est refusée, jamais ramenée en silence : un nom inconnu, un délai sous 200 ms, un minimum plus grand que son maximum, un intervalle sous 120 secondes, plus de 100 slots. L'erreur dit ce qui est attendu, et rien n'est changé.
Les trois cases d'activité s'additionnent. Chacune ajoute sa catégorie de cibles, d'après ce que la galaxie montre sur la planète ou la lune visée : timer et sans activité sondent tout le monde sauf les actifs. Aucune case, ou les trois : toutes les cibles.
"active" et "inactive" de SetSpyPlayers parlent d'autre chose : du statut que le jeu donne au joueur, le i et le I de la galaxie. L'activité affichée sur la planète, ce sont les trois cases.
Le parcours joueur par joueur lit moins la galaxie. Avec "systems", le défaut, la campagne lit la galaxie de chaque système de sa zone. Avec "players", elle garde d'abord les joueurs de sa zone qui passent ses filtres d'après la carte du bot (statut, vacances, force, classement, joueurs épargnés), puis ne lit que les systèmes où le Scanner les a vus, un joueur après l'autre, avec le délai entre deux joueurs. Sur un univers entier de 4 491 systèmes, trente-six joueurs gardés en demandent quelques centaines. La vue de chaque système visité décide encore de ce qui part : l'activité, la lune et les vacances du moment. Un joueur que le Scanner n'a jamais vu n'est pas sondé. "hunter" va toujours joueur par joueur, quel que soit le parcours.
La Liste, ce sont vos joueurs à vous. SetSpyPlayers("list") choisit « Liste » dans le menu et SetSpyPlayerList(noms) en écrit la zone de texte, comme à l'écran : deux gestes, deux fonctions. La campagne les espionne comme la liste du Hunter, joueur par joueur, là où le Scanner les a vus, dans sa zone ; un pseudo que la carte ne connaît pas est dit au journal et n'est pas sondé. La casse et les espaces autour ne comptent pas, un doublon est écarté. Cette liste n'alimente pas celle du Hunter. Une liste vide la vide ; la campagne lancée sur une liste vide s'arrête aussitôt, et le journal le dit.
SetSpyPlayers("list")
err = SetSpyPlayerList(["Alpha", "Beta"])
if err != nil { LogError("liste :", err) }
Print(GetSpySettings().PlayerList)
La page s'ouvre aussi sur une liste par son adresse : #/bot/1/spyer?players=Alpha,Beta choisit « Liste » et remplit la zone, sans rien enregistrer ni envoyer. « Enregistrer » la garde ; les sondes ne partent qu'au lancement d'une campagne.
GetSpySettings() rend Targets, Players, PlayerList, Route, StrongPlayers, SkipHomeworlds, ActivityStar, ActivityTimer, ActivityNone, ProbeDelayMin, ProbeDelayMax, SystemDelayMin, SystemDelayMax, PlayerDelayMin, PlayerDelayMax, MaxSlots, CheckIntervalMin et CheckIntervalMax.
// les timers et les joueurs sans activité, pas les actifs
SetSpyActivityStar(false)
SetSpyActivityTimer(true)
err = SetSpyActivityNone(true)
if err != nil { LogError("espionnage :", err) }
r = GetSpySettings()
Print(r.ActivityStar, r.ActivityTimer, r.ActivityNone)
SetSpyTargets("planets")
SetSpyPlayers("inactive")
SetSpyRoute("players")
SetSpyStrongPlayers(false)
SetSpySkipHomeworlds(true)
SetSpyProbeDelay(300, 450)
SetSpySystemDelay(300, 500)
SetSpyPlayerDelay(2000, 5000)
SetSpyMaxSlots(4)
err = SetSpyCheckInterval(900, 1800)
if err != nil { LogError("espionnage :", err) }
Les campagnes
| Fonction | Rend | |
|---|---|---|
NewSpySession() | 1 : un constructeur | Une campagne neuve, à enchaîner puis BuildSpySession(). |
EditSpySession(campagne) | 1 : un constructeur | Le bouton « Modifier » : la campagne enregistrée, à retoucher. |
GetSpySessions() | 1 : une liste | Le tableau des campagnes. |
StartSpySession(campagne) | 1 : une erreur | « Lancer », ou la reprise de la campagne en pause. |
PauseSpySession() | 1 : une erreur | « Pause » : l'avancement est gardé. |
ResumeSpySession() | 1 : une erreur | « Reprendre » : la campagne en pause repart du système atteint. |
StopSpySession() | 1 : une erreur | « Arrêter » : l'avancement est jeté. |
RemoveSpySession(campagne) | 1 : une erreur | « Supprimer » ; la campagne choisie s'arrête avec. |
campagne est l'identifiant, le champ ID de ce que rendent BuildSpySession() et GetSpySessions().
BuildSpySession() enregistre, il ne lance pas : c'est le bouton « Valider » de l'éditeur. Il rend deux valeurs, la campagne et une erreur, et la campagne n'est jamais nil, même en échec. StartSpySession(campagne.ID) la lance ensuite, comme le bouton « Lancer » de sa ligne.
s = NewSpySession()
s.SetName("voisinage")
s.SetRadiusAroundPlanets(30)
campagne, err = s.BuildSpySession()
if err != nil { LogError("campagne :", err) }
err = StartSpySession(campagne.ID)
if err != nil { LogError("lancement :", err) }
Deux façons de définir une zone, comme les deux onglets de l'éditeur, et elles s'excluent.
- La campagne manuelle.
SetOrigin(céleste)ouSetOriginCoord(galaxie, système, position, type)pour un départ fixe, qui sonde toutes les galaxies de sa zone aussi loin que porte le réservoir de ses sondes : un système dont le trajet brûle plus de deutérium que ce réservoir est laissé, et le journal le dit ;SetStartFromNearest(true)pour partir du céleste le mieux placé, recalculé à chaque système - c'est le défaut d'une campagne neuve.SetGalaxyRange(min, max)etSetSystemRange(min, max)pour la zone. - La campagne automatique.
SetRadiusAroundPlanets(rayon), de 1 à 499 systèmes autour de chaque planète ;AddPlanet(planète)coche une planète du compte,ClearPlanets()les décoche toutes. SansAddPlanet, toutes les planètes, colonies à venir comprises. Les sondes partent toujours du plus proche.
SetName(nom) et SetRankRange(min, max), le classement général, valent pour les deux. Zéro et zéro veulent dire « pas de limite », et zéro d'un côté laisse ce côté ouvert.
Les filtres posés à côté du classement général valent aussi pour les deux :
SetAlliances(tags)ne sonde que ces alliances, une liste de tags ; la casse ne compte pas, et une liste vide les reprend toutes. Un joueur sans alliance n'est d'aucune.SetMilitaryRange(min, max, unité),SetOffensiveRange(min, max, unité)etSetDefensiveRange(min, max, unité)bornent le classement militaire, sa flotte et sa défense. L'unité est"rank"(1 est le premier) ou"points". La flotte et la défense se séparent commeOffensivePoints()etDefensivePoints(), d'après le classement public que le bot relit toutes les heures, et leurs rangs se comptent sur ces points. Dès qu'une bande est posée, un joueur absent du classement est écarté : sonder quelqu'un qu'on ne sait pas placer, c'est risquer la sonde que la bande devait empêcher. Tant que le classement n'a pas pu être lu, la campagne attend et le journal le dit.SetIncludeOwnAllianceAndFriends(oui)est la case « Espionner aussi mon alliance et mes amis ». Décochée, le défaut, les membres de votre alliance et vos amis sont écartés ; cochée, ils sont sondés s'ils passent les autres filtres.
// les petits joueurs militaires de deux alliances, sans les siens
s = NewSpySession()
s.SetName("cibles faciles")
s.SetAlliances(["FLZ", "ABC"])
s.SetMilitaryRange(0, 50000, "points")
s.SetDefensiveRange(200, 0, "rank")
s.SetIncludeOwnAllianceAndFriends(false)
campagne, err = s.BuildSpySession()
Print(campagne.Alliances, campagne.MilitaryMax, campagne.MilitaryBy, err)
Un script qui appelle des deux familles est refusé : laisser l'une effacer l'autre en silence ferait sonder une autre zone que celle qu'il a écrite. Sont refusés aussi, et BuildSpySession() le dit : un nombre négatif, un minimum plus grand que son maximum, un rayon hors de 1 à 499, une coordonnée hors du ciel, une planète qui n'est pas au compte, une campagne manuelle sans départ.
// une campagne manuelle depuis une lune, galaxies 1 à 3
origine = GetCachedMoons()[0]
s = NewSpySession()
s.SetName("galaxies 1 à 3")
s.SetOrigin(origine)
s.SetGalaxyRange(1, 3)
s.SetRankRange(1, 500)
campagne, err = s.BuildSpySession()
Print(campagne.ID, campagne.Reused, err)
Une campagne identique n'est pas doublée. Si le tableau en porte déjà une avec les mêmes réglages, BuildSpySession() rend celle-là, avec Reused à vrai : un script lancé au démarrage du bot ne remplit pas le tableau de jumelles à chaque redémarrage.
Une seule campagne choisie à la fois. StartSpySession refuse quand une autre est choisie, en marche ou en pause : le bouton « Lancer » de la page la remplacerait et jetterait son avancement, un script l'arrête d'abord par StopSpySession(). Pour la même raison, la campagne choisie ne se modifie pas.
for c in GetSpySessions() {
if c.Paused {
ResumeSpySession()
}
}
e = EditSpySession(campagne.ID)
e.SetRadiusAroundPlanets(40)
campagne, err = e.BuildSpySession()
PauseSpySession()
StopSpySession()
RemoveSpySession(campagne.ID)
GetSpySessions() rend, pour chaque campagne : ID, Name, Auto, Radius, Planets, StartFromNearest, Origin, RankMin, RankMax, GalaxyMin, GalaxyMax, SystemMin, SystemMax, les filtres Alliances, MilitaryMin, MilitaryMax, MilitaryBy, OffensiveMin, OffensiveMax, OffensiveBy, DefensiveMin, DefensiveMax, DefensiveBy ("rank" ou "points") et IncludeOwnAllianceAndFriends, et Running ou Paused pour la campagne choisie.
StopWorker("spyer") vaut une pause et StartWorker("spyer") la reprise : l'interrupteur garde la campagne choisie. Sans campagne choisie, l'Espionnage allumé s'éteint aussitôt, faute de zone. Une campagne qui va au bout de sa zone l'éteint d'elle-même.
La stratégie des expéditions
| Fonction | Rend | |
|---|---|---|
GetExpeditionsStrategy() | 1 : un texte | "majority", "all" ou "never". |
SetExpeditionsStrategy(nom) | 1 : une erreur | La change, réglage enregistré. |
C'est le menu « Stratégie » des expéditions dans l'interface : "majority" attend que la plupart des slots d'expédition soient revenus avant la salve suivante, "all" les attend tous, "never" n'attend pas. Le réglage est enregistré comme le menu et vaut dès la salve suivante.
Tout autre nom est refusé, et l'erreur donne les trois. Un nom mal écrit, ramené en silence à "majority", laisserait croire au script qu'il a obtenu ce qu'il demandait.
Le reste de la page Expéditions, compositions comprises, se lit et s'écrit par GetExpeditionsConfigs et SetExpeditionsConfigs : voir Réglages des workers.
if GetExpeditionsStrategy() != "all" {
err = SetExpeditionsStrategy("all")
if err != nil { LogError("stratégie :", err) }
}
La réserve d'emplacements de flotte
| Fonction | Rend | |
|---|---|---|
GetFleetSlotsReserved() | 1 : un entier | Le nombre d'emplacements laissés libres. |
SetFleetSlotsReserved(n) | 1 : une erreur | Change ce nombre, réglage enregistré. |
Ce chiffre garde au Defender de quoi esquiver. Une esquive est un envoi de flotte : sans emplacement libre, elle n'a pas lieu, et l'attaque tombe sur une planète pleine. Tout ce qui vole chez Kepler respecte cette réserve — la sortie de nuit, les vols programmés, le sondage de riposte, l'Expédition de forme de vie. Votre script est le seul à pouvoir la manger sans s'en apercevoir.
libres = GetSlots()
garde = GetFleetSlotsReserved()
if libres.Total - libres.InUse <= garde {
LogInfo("on laisse la place au Defender")
return
}
SetFleetSlotsReserved enregistre, comme le champ de l'interface : le réglage survit au redémarrage. Zéro est accepté — c'est « je gère mes esquives moi-même » — un nombre négatif est refusé.
Le plafond de chaque worker, l'autre colonne de Paramètres > Slots de flotte, est le champ MaxSlots de ses réglages, et SetMaxSlotsFor plafonne les envois de vos propres scripts : voir Réglages des workers.
Épargner des joueurs, des positions, des alliances
Le Pillage n'attaque que des inactifs, ce qui règle déjà le voisin avec qui l'on s'entend : un joueur qui joue n'est jamais attaqué. Reste ce que le robot ne peut pas deviner — l'inactif de votre propre alliance, l'ami qui a arrêté, la position sur laquelle vous vous êtes brûlé une fois.
Cette liste vit en base et appartient au compte, pas à une campagne : elle vaut donc pour tous vos robots sur ce compte, et elle survit à l'arrêt comme au redémarrage.
Elle se règle dans les Paramètres du compte, onglet « Joueurs épargnés », ou par script. Les fonctions ci-dessous lisent et écrivent la même liste que l'écran.
| Fonction | Rend | |
|---|---|---|
IgnorePlayer(joueur) | 1 : une erreur | Épargne un joueur. Son nom ou son identifiant. |
IgnorePlanet(coord) | 1 : une erreur | Épargne une position, la lune comprise. |
IgnoreAlliance(tag) | 1 : une erreur | Épargne tous les membres connus d'une alliance. |
UnignorePlayer(joueur) | 1 : une erreur | Le retire de la liste. |
UnignorePlanet(coord) | 1 : une erreur | |
UnignoreAlliance(tag) | 1 : une erreur | |
IsPlayerIgnored(joueur) | 1 : un booléen | Dit s'il est dans la liste. |
IsPlanetIgnored(coord) | 1 : un booléen | |
IsAllianceIgnored(tag) | 1 : un booléen | |
GetIgnored() | 2 : la liste et une erreur | Toute la liste, les trois genres mêlés. |
IgnorePlayer("Xylo") // par son nom, comme à l'écran
IgnorePlayer(4242) // ou par son identifiant
IgnorePlanet("1:42:8") // la planète ET sa lune
IgnoreAlliance("SLD") // tous ses membres que le Scanner a vus
if IsPlayerIgnored("Xylo") {
Print("il est tranquille")
}
liste, err = GetIgnored()
for e in liste {
// e.Kind vaut « player », « planet » ou « alliance ».
// e.Key porte l'identifiant, la coordonnée ou le tag ; e.Label s'affiche.
Printf("%s : %s", e.Kind, e.Label)
}
Ce que le Pillage en fait, et à quel moment
Deux filtres, pas un. Le premier écarte la position en lisant la galaxie, avant la moindre sonde. Le second écarte le rapport au moment de choisir les attaques — et c'est le plus important des deux : une campagne reprise en phase d'attaque ne relit pas la galaxie, et les rapports qu'elle exploite sont ceux de la boîte de réception entière, y compris ceux qu'un autre outil a laissés.
Le journal dit cible épargnée quand cela se produit. Les autres motifs d'écartement, eux, sont muets.
Qui respecte la liste, et qui ne la respecte pas
Ce qui la respecte : le Pillage, en galaxie *et* au moment de choisir ses attaques ; le spyer, parce que sonder laisse une trace exactement comme attaquer ; et FindInactivePlanetWithMinimumTravelTime, seule des quatre recherches à désigner un joueur.
Ce qui ne la respecte pas, et c'est voulu : l'écran Galaxie, où vous devez continuer à voir ce que vous épargnez, et la sortie de flotte de nuit — où poser sa flotte n'a rien à voir avec qui l'on pille.
Le bouton d'espionnage du chasseur avertit au journal, et envoie quand même.
Le bouton du chasseur est un geste délibéré sur des joueurs que vous avez nommés à la main : vous refuser l'envoi en silence vous retirerait un choix que vous venez de faire. La contradiction est signalée, pas arbitrée.
Cette liste n'est pas non plus la liste blanche du Defender, qui dit l'inverse : « ceux contre qui je ne me défends pas ». Épargner une alliance de deux cents membres ne doit surtout pas empêcher d'esquiver leurs attaques.
Deux signatures diffèrent de la documentation de référence
Elle prend un int64 partout. Nous ne pouvons pas la suivre sur deux points, et ces deux fonctions refusent un nombre plutôt que de l'accepter en silence :
IgnorePlanetattend une coordonnée, pas un identifiant de planète. Le jeu donne bien cet identifiant en galaxie, mais le relevé n'en garde que la coordonnée : un identifiant serait rangé et n'attraperait jamais rien.IgnoreAllianceattend le tag, pas un identifiant d'alliance. La v13 n'en donne aucun dans les données de galaxie.
Un tag se compare sans casse ni espaces. Il peut changer du jour au lendemain, là où un identifiant de joueur ne bouge jamais : c'est la limite de la notion.
Un joueur absent des relevés est refusé
Comme pour la surveillance : IgnorePlayer résout le nom depuis les relevés du Scanner, et refuse ce qu'il n'y trouve pas. Enregistrer une entrée qui n'attraperait jamais personne ferait croire au script qu'il épargne quelqu'un.
Une alliance, elle, s'ajoute même si le Scanner n'est pas encore passé : ses membres seront reconnus au fur et à mesure des relevés.
La liste noire du Pillage
Ce que le Pillage ne sonde plus et n'attaque plus. Elle n'a pas le même rôle que la liste des épargnés : celle-ci protège des amis, et vaut aussi pour l'espionnage ; la liste noire écarte des cibles qui ne produisent plus, et ne vaut que pour le Pillage.
Une position y entre d'elle-même quand trois rapports de suite montrent exactement les mêmes ressources, sous le butin minimal de la campagne : la planète ne produit plus, ses hangars sont pleins mais petits. Un rapport qui bouge ou qui vaut le détour remet son compte à zéro, et l'en fait sortir si elle y était entrée d'elle-même. Cette entrée ne vaut que pour le joueur qui possédait la planète : reprise par un autre, elle est de nouveau sondée, et n'est écartée qu'après trois rapports pareils chez lui. Elle n'écarte que la planète, pas sa lune. Une position ajoutée à la main, elle, écarte les deux et ne sort jamais d'elle-même.
Elle se voit et se règle dans l'onglet « Liste noire » de la page Pillage, ou par script. Les ajouts et les retraits valent dès la passe suivante du Pillage.
| Fonction | Rend | |
|---|---|---|
GetFarmBlacklist() | 2 : la liste et une erreur | Toute la liste, joueurs et positions mêlés. |
AddToFarmBlacklist(cible) | 1 : une erreur | Un joueur, par son nom ou son identifiant, ou une position. |
RemoveFromFarmBlacklist(cible) | 1 : une erreur | Retirer ce qui n'y est pas n'est pas une erreur ; un nom que rien ne connaît en est une. |
ClearFarmBlacklist() | 1 : une erreur | Tout vider, entrées d'office comprises. |
AddToFarmBlacklist("1:42:8") // à la main : la planète ET sa lune
AddToFarmBlacklist("Xylo") // un joueur, par son nom
AddToFarmBlacklist(4242) // ou par son identifiant
liste, err = GetFarmBlacklist()
for e in liste {
// e.Kind vaut « player » ou « planet », comme pour GetIgnored ;
// e.Source vaut « auto » ou « manual ».
// e.Key porte l'identifiant ou la coordonnée ; e.Label s'affiche.
if e.Source == "auto" {
RemoveFromFarmBlacklist(e.Key) // ne rendre que les entrées d'office
}
}
ClearFarmBlacklist()
Une position se désigne sans son type : "M:1:42:8" et "1:42:8" sont la même entrée. Un joueur absent des relevés du Scanner est refusé à l'ajout, mais se retire toujours : par son identifiant, par le nom affiché dans la liste, ou par e.Key tel que GetFarmBlacklist le rend.
Retirer une position, ou vider la liste, remet aussi son compte de rapports identiques à zéro : elle n'y revient qu'après trois nouveaux rapports pareils, pas au premier.
Composer une liste de surveillance
StartHunter() allume la surveillance. Elle ne dit pas qui surveiller : cette liste vit en base et se modifie au fil du jeu. Allumer le chasseur sur une liste vide ne relève rien.
| Fonction | Rend | |
|---|---|---|
GetHunterTargets() | 2 : la liste et une erreur | Les joueurs sous surveillance. |
AddHunterTarget(joueur) | 1 : une erreur | Met un joueur sous surveillance. |
RemoveHunterTarget(joueur) | 1 : une erreur | Le retire, avec son historique. |
PauseHunterTarget(joueur, suspendu) | 1 : une erreur | Le suspend sans perdre son historique. |
GetHunterHistory(joueur, n) | 2 : la série et une erreur | Les relevés d'activité du joueur, du plus récent au plus ancien. |
AddHunterTarget("Xylo") // par son nom, comme à l'écran
AddHunterTarget(4242) // ou par son identifiant
StartHunter()
cibles, err = GetHunterTargets()
for c in cibles {
Printf("%s : %d positions, activité %d", c.PlayerName, c.Positions, c.Activity)
}
Le nom marche autant que l'identifiant. La doc de référence ne prend que l'identifiant ; le nom est ce que vous lisez à l'écran, et c'est donc ce qu'un script écrit le plus souvent. Les deux écritures mènent à la même cible : le robot résout le nom depuis ses relevés de galaxie, une fois, à l'ajout — parce qu'un joueur peut se renommer, son identifiant non.
Ajouter deux fois le même joueur ne le double pas. La liste est tenue par identifiant.
Un joueur absent des relevés est refusé
err = AddHunterTarget(999999)
// joueur n° 999999 introuvable dans les relevés :
// le Scanner est-il passé chez lui ?
C'est notre second écart avec la doc de référence, qui accepte n'importe quel identifiant. La surveillance travaille sur les positions connues : elle relève, à chaque passe, les célestes que le Scanner a vus. Une cible dont on ne connaît aucune position ne rendrait donc jamais rien, et votre script croirait surveiller quelqu'un.
Le refus vous dit quoi faire : laissez le Scanner couvrir la zone du joueur, puis rappelez AddHunterTarget.
Ce que porte une cible
| Champ | |
|---|---|
PlayerID, PlayerName, Alliance, Rank | Qui il est. |
Positions | Combien de célestes lui sont connus. |
Activity | Le dernier relevé de toutes ses positions : 15 quand l'une est active à l'instant, sinon le plus court minuteur trouvé, 0 quand il n'y a rien nulle part. |
Paused | La surveillance est suspendue. |
NotifyTimer | Une alerte est armée sur son retour. |
LastCheck, AddedAt | Des dates Unix, 0 si jamais relevé. |
Relire l'historique d'une cible
GetHunterTargets ne rend que le dernier relevé, résumé. La série complète, position par position, se lit avec GetHunterHistory : une ligne par position et par passage, du plus récent au plus ancien. n borne le nombre de lignes : 500 quand il vaut 0, jamais plus de 5000.
serie, err = GetHunterHistory("Xylo", 200)
if err != nil {
Print("historique illisible : ", err)
} else {
for s in serie {
if s.Activity == 15 {
Printf("en ligne le %d sur %d:%d:%d", s.Seen, s.Galaxy, s.System, s.Position)
}
}
}
| Champ | |
|---|---|
Galaxy, System, Position, IsMoon | La position relevée. |
Activity | 0 rien, 15 en ligne à l'instant, de 16 à 59 les minutes depuis la dernière activité. |
Seen | La date Unix du relevé. |
La base garde trente jours de relevés par cible. Seuls ceux du robot qui fait tourner le script sont lus, même quand un autre de vos robots suit le même joueur.
Suspendre plutôt que retirer
RemoveHunterTarget efface aussi l'historique d'activité du joueur, qui est le seul intérêt d'une surveillance ancienne. PauseHunterTarget(joueur, true) arrête les relevés et garde la série : c'est ce qu'on veut pendant les vacances d'une cible.
Deux pièges
La veille n'est pas un worker comme les autres. StartSleepMode() n'endort pas le compte sur-le-champ : elle allume le worker, qui suivra ensuite le planning réglé dans le panneau. Si le mode n'est pas automatique et qu'aucune veille manuelle n'est posée, il ne se passera rien du tout.
En revanche, quand la fenêtre de veille s'ouvre pour de bon, la session se ferme. Votre script continue de tourner, mais ses appels au jeu échouent sur « compte en veille » jusqu'au réveil, et le Defender ne surveille plus rien. Un script qui allume la veille se retrouve donc plus tard sans jeu, à une heure qu'il n'a pas choisie.
Allumer un outil éteint le reste. La phalange, la surveillance des champs de ruines et les autres outils sont exclusifs : le robot n'en fait tourner qu'un, et allumer l'un éteint les workers ordinaires. C'est la règle de l'interface, et elle s'applique ici aussi. Un StartWorker("phalanx") peut donc arrêter votre pillage sans que vous l'ayez demandé.
Un script qui en pilote d'autres
| Fonction | Rend | |
|---|---|---|
GetScripts() | 1 : une liste de noms | Tous les scripts du compte. |
GetRunningScripts() | 1 : une liste de noms | Ceux qui tournent en ce moment. |
IsScriptRunning(nom) | 1 : un booléen | Celui-là tourne-t-il. |
IsPausedScript(nom) | 1 : un booléen | Celui-là est-il en pause. |
StartScript(nom, [paramètres]) | 1 : une erreur | Le lance et rend la main aussitôt. La table de paramètres est facultative. |
ScriptParams() | 1 : une table | Les paramètres du lancement en cours, vide quand il n'y en a pas. |
StopScript(nom) | 1 : une erreur | L'arrête. |
PauseScript(nom) | 1 : une erreur | Le suspend. |
ResumeScript(nom) | 1 : une erreur | Le reprend là où il en était. |
IsScriptRunAtStart(nom) | 1 : un booléen | Sa case « exécuter au démarrage » est-elle cochée. |
SetScriptRunAtStart(nom, oui) | 1 : une erreur | La coche (true) ou la décoche (false). |
IsScriptRemoteStart(nom) | 1 : un booléen | Sa case « lancement à distance » est-elle cochée. |
SetScriptRemoteStart(nom, oui) | 1 : une erreur | La coche ou la décoche. |
IsRemoteStartEnabled() | 1 : un booléen | Le lancement à distance est-il allumé dans Mon compte. |
À quoi ça sert. Un script tourne d'un bout à l'autre dans un seul fil : ce qu'il fait, il le fait à la suite. Un compte qui veut une garde de nuit, un pillage et un rapport quotidien a donc trois scripts — et quelque chose doit décider lequel tourne quand. C'est le rôle d'un script chef d'orchestre : il n'agit pas sur le jeu, il allume et éteint les autres.
// Le chef d'orchestre : la garde la nuit, le rapport le matin.
CronExec("@22h00", func() {
StartScript("garde-de-nuit")
})
CronExec("@08h00", func() {
StopScript("garde-de-nuit")
StartScript("rapport")
})
Le suffixe .ank est facultatif. StartScript("garde") et StartScript("garde.ank") désignent le même script : le stockage ajoute le suffixe tout seul, et exiger de le taper ferait échouer la moitié des appels sur un script bien présent.
StartScript rend la main aussitôt, elle n'attend pas la fin du lancé. Et le script lancé ne meurt pas avec celui qui l'a lancé : les deux sont indépendants une fois partis.
Trois refus qu'il vaut mieux connaître.
- Un script ne se relance pas lui-même : cela ne veut rien dire.
- Un script ne se met pas en pause lui-même. Ce serait un blocage définitif : plus personne ne tourne pour le reprendre, et le compte garde un script figé qui a l'air vivant.
- Un script peut s'arrêter lui-même, et c'est une sortie propre. Le geste ne bloque pas : il annule, et le script s'arrête à l'instruction suivante.
Exit()fait la même chose sous un autre nom.
« En pause » n'est pas « arrêté ». Un script en pause ne figure pas dans GetRunningScripts, mais le relancer le ferait repartir de sa première ligne. IsPausedScript est là pour cette distinction : lisez-la avant de décider entre StartScript et ResumeScript.
Passer des paramètres à un script
Ce qu'un script doit savoir n'est plus forcément écrit dans son texte ou dans !global.ank. Le lanceur le lui confie au départ, dans une table :
// Le lanceur : le rapport de la semaine, en version courte.
err = StartScript("rapport", {"jours": 7, "mode": "court"})
if err != nil {
Print("rapport non lancé : ", err)
}
// Dans rapport.ank : ce que son lancement lui a confié.
p = ScriptParams()
jours = 1
if p["jours"] != nil {
jours = p["jours"]
}
Print("rapport sur ", jours, " jours, mode ", p["mode"])
La table n'appartient qu'à ce lancement. ScriptParams() en rend une copie neuve à chaque appel : la retoucher ne change rien pour l'appel suivant, ni pour personne d'autre. Deux lancements partis l'un derrière l'autre lisent chacun la leur. PutShared suivi de StartScript ne le garantissait pas : un second lancement parti avant que le premier ait lu sa clé l'écrasait.
Vide quand rien n'a été passé. Un script lancé du panneau, au démarrage du robot ou par StartScript(nom) seul lit une table vide, jamais celle de son lanceur. Une fonction de !global.ank qui appelle ScriptParams() lit celle du script qui l'appelle.
Les types restent ceux que vous avez écrits. Nombres, textes, booléens, listes et tables imbriquées arrivent comme JsonDecode les rendrait : 7 reste un entier, et p["id"] == 33628068 est vrai. Un objet du moteur, un céleste ou une coordonnée, arrive en table de ses champs : passez plutôt son identifiant, ou ses coordonnées en texte. Une table qui se contient elle-même est refusée, comme tout ce qui n'est pas une table.
Lancer un script de l'extérieur
Hors du robot et du jeu, rien n'atteignait un script. Pour obéir à une commande venue d'ailleurs, il devait interroger en boucle. Une adresse le lance désormais, avec ses paramètres, depuis une commande Discord, une page ou tout outil qui sait faire une requête HTTP :
curl -X POST \
-H "Authorization: Bearer VOTRE_CLÉ" \
-H "Content-Type: application/json" \
-d '{"jours": 7, "mode": "court"}' \
https://votre-bot/api/instances/2/scripts/rapport/start
Le script lit le corps par ScriptParams(), exactement comme une table passée à StartScript. Un corps vide le lance sans paramètres, et …/rapport/stop l'arrête.
Rien n'est ouvert tant que vous ne l'ouvrez pas, et il faut trois gestes :
1. La clé, dans Mon compte : « Générer une clé et allumer », sur la carte « Lancer des scripts depuis l'extérieur » (onglet Accès à distance sur un PC Windows, onglet Compte ailleurs). C'est une clé à elle, pas celle du statut. « Nouvelle clé » rend l'ancienne inutilisable, « Éteindre » ferme tout. 2. La case « lancement à distance » du script, à côté de « exécuter au démarrage », puis Enregistrer. Seuls les scripts cochés répondent ; elle est décochée sur tout script neuf ou importé. 3. L'adresse : celle où votre panneau répond, sur le PC, sur le Cloud ou par le lien d'accès à distance. Le nombre après /instances/ est le numéro du robot, celui des adresses du panneau (#/bot/2/…), jamais son identifiant.
Ce que l'adresse répond, en JSON court :
200: le script est parti,{"ok":true,"script":"rapport.ank","status":"running"}. Après/stop,"status":"stopped".404: éteint, clé absente ou fausse, robot inconnu, script absent, réservé (!global.anket ses voisins) ou non coché. Toujours la même réponse : la clé ne permet pas de dresser la liste de vos scripts.409: le script tourne déjà, ou il est en pause, et"status"dit lequel. Arrêtez-le ou reprenez-le d'abord.400: le corps n'est pas un objet JSON ;413: il dépasse seize kilo-octets.429: plus de trente demandes par minute, dix d'un coup. L'en-têteRetry-Afterdit combien de secondes attendre.
Chaque lancement et chaque arrêt s'écrivent au journal du robot, avec l'adresse d'où ils viennent, jamais la clé ni les paramètres. Cocher ou décocher la case s'y écrit aussi, avec qui l'a fait.
Gardez la clé hors de vos scripts. Aucune fonction ne la lit : IsRemoteStartEnabled() dit seulement qu'elle existe. Un script recopié d'ailleurs ne peut donc pas la faire sortir, tant que vous ne l'écrivez pas dedans vous-même.
Une commande Discord
Discord ne joint pas votre robot de lui-même : il faut un petit bot Discord à vous, qui reçoit la commande et appelle l'adresse. En Python, avec discord.py et aiohttp :
import os
import aiohttp
import discord
from discord import app_commands
ADRESSE = "https://votre-bot/api/instances/2/scripts/rapport/start"
CLE = os.environ["KEPLER_CLE"]
client = discord.Client(intents=discord.Intents.default())
commandes = app_commands.CommandTree(client)
@commandes.command(name="rapport", description="Lance le rapport du robot")
async def rapport(interaction: discord.Interaction, jours: int = 7, mode: str = "court"):
async with aiohttp.ClientSession() as http:
async with http.post(ADRESSE, json={"jours": jours, "mode": mode},
headers={"Authorization": "Bearer " + CLE}) as reponse:
await interaction.response.send_message(f"{reponse.status} {await reponse.text()}")
@client.event
async def on_ready():
await commandes.sync()
client.run(os.environ["DISCORD_JETON"])
/rapport jours:30 lance alors rapport.ank avec {"jours": 30, "mode": "court"}. Réglez dans Discord qui a le droit de taper la commande : qui peut la taper lance le script.
Piloter les autres robots de l'installation
Un script voit les autres robots de son Kepler, et peut les piloter : les démarrer, les arrêter, lancer leurs scripts. Ceux de la même installation, et eux seuls : votre Kepler chez vous, ou votre instance sur le Cloud. Rien ici n'atteint un autre Kepler, même le vôtre sur une autre machine.
| Valeur | Contient | |
|---|---|---|
BotID | un entier | Le numéro du robot du script, celui des adresses du panneau (#/bot/2/…). |
| Fonction | Rend | |
|---|---|---|
BotsCount() | 1 : un entier | Le nombre de robots de l'installation, ceux au-delà de la licence compris. |
OwnBots() | 1 : une liste de robots | Tous, celui du script compris, dans l'ordre de l'accueil. |
AllBots() | 1 : une liste de robots | La même liste : Kepler ne partage pas de robot entre installations. |
GetBotByID(numéro) | 1 : un robot, ou nil | Le robot de ce numéro, nil quand il n'existe pas. |
StartRemoteScript(adresse, numéro, clé, script) | 1 : une erreur | Lance un script de ce robot. L'adresse et la clé restent vides. |
StopRemoteScript(adresse, numéro, clé, script) | 1 : une erreur | L'arrête. |
Un robot rendu par ces fonctions s'emploie ainsi :
| Écriture | Rend | |
|---|---|---|
b.GetID() | 1 : un entier | Son numéro. |
b.GetName() | 1 : une chaîne | Son nom affiché, réglé dans ses Paramètres. |
b.GetUniverse(), b.GetLang() | 1 : une chaîne | Son univers et la langue de son serveur, connus même robot arrêté. |
b.GetServerNumber() | 1 : un entier | Le numéro de son serveur, s152-en donnant 152. Zéro tant qu'il n'est pas connecté. |
b.GetPlayerName(), b.GetPlayerID() | 1 : une chaîne, un entier | Son joueur ; le dernier lu quand il est arrêté, comme sa carte. |
b.GetState() | 1 : une chaîne | stopped, connecting, running, sleeping, maintenance, error, ou paused après PauseBot. |
b.IsActive() | 1 : un booléen | Repartira-t-il au prochain lancement de Kepler. |
b.Start() | 1 : une erreur | Le bouton Démarrer, avec ses gardes. Un robot arrêté depuis le panneau (case « actif » décochée) n'est pas redémarré par un script : il faut le démarrer depuis le panneau. Un robot qu'un script a arrêté par Stop() se relance par un script, jusqu'à ce que le joueur le démarre ou l'arrête au panneau. |
b.Stop() | rien | Le bouton Arrêter. |
b.StartScript(nom, [paramètres]) | 1 : une erreur | Lance un de ses scripts, avec une table facultative. |
b.StopScript(nom), b.PauseScript(nom), b.ResumeScript(nom) | 1 : une erreur | L'arrête, le suspend, le reprend. |
b.IsScriptRunning(nom), b.IsPausedScript(nom) | 1 : un booléen | Tourne-t-il, est-il en pause. |
b.SetScriptRunAtStart(nom, oui) | 1 : une erreur | Sa case « exécuter au démarrage ». |
// Le chef d'orchestre : chaque robot arrêté repart et lance sa garde.
for b in OwnBots() {
if b.GetID() == BotID {
continue
}
if b.GetState() == "stopped" {
err = b.Start()
if err != nil {
Print(b, " ne démarre pas : ", err)
continue
}
}
b.StartScript("garde-de-nuit", {"depuis": BotID})
}
Un robot se désigne par son numéro, jamais par son identifiant. L'identifiant d'un robot porte l'adresse e-mail de son compte, et un script recopié d'ailleurs pourrait la faire sortir. Un script voit d'un autre robot son numéro, son nom, son univers, sa langue, son état, sa case « actif », son serveur et son joueur : rien de ses réglages, de ses mots de passe ou de son proxy. Print(b) écrit Bot 2 (Zenith). Le numéro ne change jamais, et celui d'un robot supprimé n'est pas redonné : un objet gardé trop longtemps répond « aucun robot n°2 dans cette installation », jamais au nom d'un autre.
Start a les gardes du bouton. Un robot au-delà de votre licence, un Kepler dont la mise à jour est échue, ou sur le Cloud une adresse de sortie qui n'est plus à votre lot, ne démarrent pas, et l'erreur dit pourquoi, mot pour mot comme l'écran. Un robot déjà démarré répond « instance déjà démarrée ». Comme les boutons, Start coche sa case « actif » et Stop la décoche : le prochain lancement de Kepler suit ce que le script a décidé.
Arrêter le robot du script arrête aussi le script, comme le bouton : ses scripts s'arrêtent avec lui. Le robot du script est un robot comme les autres pour le reste, avec les refus de StartScript : un script ne se relance ni ne se suspend lui-même par GetBotByID(BotID).
StartRemoteScript et StopRemoteScript portent les noms de Ninja, où ils appellent un autre serveur avec une clé. Ici, l'adresse et la clé restent vides, et le geste est celui de GetBotByID(numéro).StartScript(script) : une adresse ou une clé est refusée, plutôt que de laisser croire qu'un autre Kepler a été atteint, et pour que votre clé du lancement à distance ne s'écrive jamais dans un script. Le script lancé n'a pas besoin de sa case « lancement à distance » : elle ne vaut que pour l'extérieur.
Trois méthodes de Ninja manquent à l'objet : GetServerID, l'identifiant de sa base, que Kepler n'a pas ; DeleteScript, qu'aucun script ne fait non plus sur son propre robot ; Publish, faute de messagerie entre robots : PutShared et GetShared partagent déjà des valeurs entre tous les robots de l'installation.
Chaque geste s'écrit au journal du robot du script, avec le numéro du robot visé : « robot démarré par un script », « script d'un autre robot piloté par un script ».
Appliquer à tous mes robots
Les boutons « Appliquer à tous mes robots » des écrans, et la copie de la liste du Hunter. Chacun part du robot du script.
| Fonction | Rend | |
|---|---|---|
ApplyAddonsToAllBots() | 1 : une erreur | « Appliquer ce choix à tous les robots » des compléments du navigateur : le choix de ce robot devient celui de tous. |
CopyNotificationsToAllBots() | 1 : une erreur | Les canaux des Notifications de ce robot, webhooks et jeton compris, posés sur tous les autres. |
SetFarmProbesEverywhere(sondes) | 1 : une erreur | Le nombre de sondes par espionnage de toutes les campagnes de pillage de tous les robots. |
CopyHunterTargets(numéro) | 1 : une erreur | La liste du Hunter de ce robot, recopiée vers celui du numéro. |
SetFarmProbesEverywhere(6)
err = CopyHunterTargets(2)
if err != nil {
Print("liste non copiée : ", err)
}
- Les secrets ne passent pas par le script.
CopyNotificationsToAllBotsrecopie les webhooks et le jeton Telegram dans la configuration, et aucune fonction ne les lit. - Un robot qui refuse les sondes n'arrête pas les autres, comme à l'écran : l'erreur nomme ceux qui ont refusé, par leur nom et leur numéro, quand un autre de leurs réglages ne passe plus la validation. Un nombre négatif est refusé, au-delà de cent il est ramené à cent.
- La liste du Hunter ne va que vers un robot du même univers : ailleurs, un identifiant de joueur désigne quelqu'un d'autre. Les joueurs déjà suivis là-bas gardent leurs réglages ; la suspension et l'alerte de retour suivent, l'historique non.
Les réglages communs à l'installation
Les quatre réglages de Paramètres > Généralités qui valent pour tous les robots. Chacun s'enregistre par le chemin de l'écran, avec ses bornes.
| Fonction | Rend | |
|---|---|---|
GetBotLanguage() | 1 : une chaîne | La langue de l'interface et des notifications, fr ou en par exemple. GetLang dit celle du serveur de jeu. |
SetBotLanguage(code) | 1 : une erreur | La change pour toute l'installation. |
GetStartBotsOnLaunch() | 1 : un booléen | Kepler démarre-t-il les robots actifs à son ouverture. |
SetStartBotsOnLaunch(oui) | 1 : une erreur | Coche ou décoche, sans rien démarrer tout de suite. |
GetSameEmailBotsDelay() | 2 : le bas et le haut | L'écart, en secondes, entre les actions de deux robots d'une même adresse e-mail. |
SetSameEmailBotsDelay(bas, haut) | 1 : une erreur | De 0 à 30 secondes, le haut jamais sous le bas. |
GetManualModeTimeout() | 1 : un entier | Les minutes après lesquelles le robot reprend la main sur le navigateur intégré. |
SetManualModeTimeout(minutes) | 1 : une erreur | De 1 à 120 minutes. Une partie en cours garde le délai de son allumage. |
bas, haut = GetSameEmailBotsDelay() // DEUX cibles
Printf("écart actuel : %d à %d s", bas, haut)
err = SetSameEmailBotsDelay(3, 8)
if err != nil {
Print(err)
}
Ce qui reste fermé aux scripts. Ce qui manie un secret ou l'installation entière n'a pas de fonction : l'import et l'export des robots, la clé de licence, la mise à jour, le mot de passe OGame et la double authentification, les proxys avec identifiants, la création et la suppression d'un robot, le remplacement de l'adresse de sortie.
Savoir ce que fait le Pillage
| Fonction | Rend | |
|---|---|---|
IsFarmSessionOngoing() | 1 : un booléen | Une campagne travaille-t-elle en ce moment. |
IsPausedFarmingBot() | 1 : un booléen | Une campagne est-elle en pause. |
FarmingBotSessionsCount() | 1 : un entier | Combien de campagnes tournent. |
GetFarmSessions() | 1 : une liste | Les campagnes enregistrées, celles de l'écran comprises, avec leur état et leurs réglages. |
PauseFarmingBot() | 1 : une erreur | Suspend la campagne en cours. |
ResumeFarmingBot() | 1 : une erreur | La reprend où elle s'est arrêtée. |
AbortAllFarmingSessions() | 1 : une erreur | Arrête tout et retire toutes les campagnes, celle qui tourne et celles de l'onglet Pillage comprises. |
Une campagne en pause rend false à IsFarmSessionOngoing : elle ne travaille pas. La distinction compte — un script qui attend la fin d'une campagne pour lancer autre chose attendrait sinon indéfiniment devant une campagne que personne ne reprendra.
Écart avec Ninja, et il vaut mieux le lire ici qu'en jeu. L'outil de référence mène plusieurs campagnes de front ; Kepler n'en mène qu'une à la fois, parce que deux se disputeraient les emplacements et les sondes et que l'on ne saurait plus laquelle a vidé quoi. FarmingBotSessionsCount vaut donc zéro ou un, jamais davantage : un script recopié qui le compare à trois ne trouvera jamais son compte.
Lister les campagnes
GetFarmSessions() rend toutes les campagnes enregistrées, celles de l'onglet Pillage comme celles de vos scripts, dans leur ordre de création. C'est ce qui donne à StartFarmSession l'identifiant d'une campagne réglée à l'écran, qu'aucun BuildFarmSession() n'a rendu.
for s in GetFarmSessions() {
if s.Name == "nuit" && s.State == "idle" {
StartFarmSession(s.ID)
}
}
Chaque campagne porte :
ID,Name,CreatedAt;State:"active"pour celle que le Pillage mène, ou mènera dèsStartFarmingBot()s'il est éteint,"paused","queued"pour celle qui attend son tour, à la place que ditQueueRank(comptée comme à l'écran), et"idle"pour celle qui est au repos.IsFarmSessionOngoing()dit si le Pillage travaille vraiment ;- la zone, sous les noms que
BuildFarmSession()rend déjà :Origin,StartFromNearest,Range,ManualRange,SystemFrom,SystemTo,GalaxyFrom,GalaxyTo; - la vague :
Strategy("all","majority"ou"never", les mots deSetFarmStrategy),MajorityThreshold,MajorityWaitMinutes,RaidsAsReportsArrive,AttackDelayMin,AttackDelayMax; - les cibles :
MinimumResourcesToAttack,MinimumDefensesToIgnore,MinimumMetalStorage,MinimumCrystalStorage,MinimumDeuteriumTank,MinimumPlayerRank,IgnoreActivity,MetalRatio,CrystalRatio,DeuteriumRatio; - les vaisseaux :
NbProbes,PctCargo,FarmSpeed(de 0,5 à 10, comme les constantes deSetFarmSpeed),UsePathfinders,SmallCargosFirst,EspionageProbeRaids,SecondCargoetThirdCargo(0pour « Aucun ») ; - la messagerie :
DeleteEspionageReports,DeleteCombatReports.
Les noms de Ninja sont repris là où ils veulent dire la même chose, AttackFromNearestPlanet et AttackFromNearestMoon compris. Deux sont écartés exprès : FastAttacking, qui ne dit pas la même chose chez eux et chez nous (voir SetFastAttacking), et la plage RangeGalaxy, RangeFrom, RangeTo, qu'une seule galaxie ne suffit pas à dire. L'identifiant est un texte, celui que StartFarmSession attend.
Une campagne dont les types d'appoint n'ont jamais été réglés montre le repli qu'elle emploie, comme la fenêtre de campagne qui s'ouvre préremplie avec lui.
Elle ne demande rien au jeu et passe pendant le mode manuel. Une campagne en pause ne se lit "paused" que robot lancé : la pause vit dans sa mémoire, comme pour IsPausedFarmingBot().
Arrêter, mettre en file, retoucher ou supprimer une campagne
Les boutons d'une ligne de l'onglet Pillage, son « ⏹ Tout arrêter », et le plafond de slots du Pillage. Sa cadence se règle par un couple de réglages, GetFarmingBotConfigs et SetFarmingBotConfigs : voir Pillage (cadence).
| Fonction | Rend | |
|---|---|---|
StopFarmSession(campagne) | 1 : une erreur | Le ■ : arrête cette campagne, "" pour celle qui tourne ; la suivante de la file prend le relais. |
QueueFarmSession(campagne) | 1 : une erreur | Le + : la range derrière celles qui attendent leur tour. |
EditFarmSession(campagne) | 1 : un constructeur | Le ✎ : la campagne enregistrée, à retoucher puis BuildFarmSession(). |
DeleteFarmSession(campagne) | 1 : une erreur | Le ✕ : la retire de la liste. |
GetFarmMaxSlots() | 1 : un entier | Le plafond de slots du Pillage, 0 pour MAX. |
SetFarmMaxSlots(n) | 1 : une erreur | Le change, de 0 (MAX, pas de plafond) à 100. |
StopAllFarmSessions() | 1 : une erreur | Le « ⏹ Tout arrêter » : arrête toutes les campagnes et vide la file ; elles restent dans la liste. |
campagne est l'identifiant, le champ ID de ce que rendent BuildFarmSession() et GetFarmSessions() ; les espaces autour ne comptent pas. Ces fonctions font exactement ce que font les boutons, par le même chemin, et refusent ce qu'ils refusent. Un seul refus de plus : un identifiant que le compte n'a pas rend campagne inconnue. L'écran ne peut pas viser une campagne qu'il n'affiche pas ; un script le peut, et le silence se lirait comme « c'est fait ». Aucune ne demande rien au jeu : elles passent pendant le mode manuel.
Arrêter une campagne n'est pas éteindre le Pillage. Cinq gestes voisins :
StopFarmSession(""), ou l'identifiant de celle qui tourne, est le « ■ Arrêter la campagne en cours » : sa passe est coupée, son avancement effacé - relancée, elle repartira du premier système -, et la suivante de la file part tout de suite. Sans suivante, le Pillage s'éteint. Ses raids déjà en vol ne sont pas rappelés : ils rentrent ;StopFarmSession(campagne)d'une campagne qui ne tourne pas, en pause ou en file, efface son avancement et la sort de la file ; celle qui tourne continue. C'est aussi la façon de retirer une campagne de la file ;StopFarmingBot()éteint le Pillage : la campagne active revient au repos, rien ne prend le relais, et la file est gardée pour le prochainStartFarmingBot();PauseFarmingBot()suspend en gardant l'avancement ;StopAllFarmSessions()est le « ⏹ Tout arrêter » : le Pillage s'éteint, la file se vide et l'avancement de chaque campagne est effacé, mais toutes restent dans la liste, prêtes à repartir du premier système. Le journal dit combien ont été abandonnées.AbortAllFarmingSessions(), lui, les retire en plus.
Sans campagne en cours, StopFarmSession("") éteint un Pillage resté allumé pour compter la dernière vague de la précédente, comme le bouton ; si rien n'est allumé non plus, il rend aucune campagne à arrêter.
QueueFarmSession(campagne) range une campagne enregistrée derrière celles qui attendent, comme le + de sa ligne : elle partira quand la précédente aura fini, ou au prochain StartFarmingBot() si le Pillage est éteint. Une campagne déjà en file garde sa place, sans doublon ; une campagne en pause peut y entrer. Celle qui tourne est refusée, cette campagne tourne déjà : elle n'attend pas derrière elle-même. Sa place se lit ensuite dans GetFarmSessions(), State à "queued" et QueueRank, et dans le panneau « File d'attente » de l'onglet.
EditFarmSession(campagne) rend un constructeur rempli de la campagne enregistrée : les méthodes de NewFarmSession() la retouchent, et BuildFarmSession() l'enregistre à sa place au lieu d'en créer une, sans la lancer ni l'arrêter - elle garde son état, en cours, en pause, en file ou au repos. Il rend la campagne telle qu'enregistrée, avec le même ID, et une erreur.
- Seul ce que le script appelle change, comme la fenêtre « Modifier la campagne », qui n'écrit que ce qu'on y a changé : un réglage posé à l'écran entre
EditFarmSessionetBuildFarmSessionreste. - Les mêmes refus qu'à la création : une valeur hors bornes, une stratégie inconnue, une campagne sans origine qui ne part pas du plus proche. Rien n'est alors changé.
- Celle qui tourne se retouche aussi, comme à l'écran : un seuil ou un butin minimal valent dès le système ou l'attaque suivante. La zone - origine, portée, plage, départ au plus proche - garde la valeur du départ jusqu'à la prochaine relance.
SetOriginne quitte pas le départ au plus proche d'une campagne qui l'a :SetStartFromNearest(false)le fait.- Un identifiant vide ou inconnu rend quand même un constructeur, jamais
nil;BuildFarmSession()dit alors le refus.
DeleteFarmSession(campagne) est le ✕ : la campagne quitte la liste, et rien d'autre ne bouge. Celle qui tourne n'est pas arrêtée pour autant : comme à l'écran, sa passe finit avec ce qu'elle tient, et le Pillage n'a plus de campagne au réveil suivant. Pour que la suivante de la file parte tout de suite, StopFarmSession d'abord. Une campagne supprimée alors qu'elle attendait est écartée de la file sans bruit, et ses raids restent dans l'historique du butin.
GetFarmMaxSlots() et SetFarmMaxSlots(n) lisent et changent le plafond de la ligne « Pillage » de Paramètres > Slots de flotte : 0, MAX, ne plafonne pas - le Pillage va jusqu'à ce que la réserve générale laisse -, sinon de 1 à 100. Le réglage est enregistré comme le menu, vaut tout de suite et survit au redémarrage. Hors de 0 à 100, refusé plutôt que ramené en silence.
// la nuit : plus de slots au Pillage, et la campagne « nuit » prend le relais
SetFarmMaxSlots(8)
for s in GetFarmSessions() {
if s.Name == "nuit" && s.State == "idle" {
e = EditFarmSession(s.ID)
e.SetMinimumResourcesToAttack(500000)
nuit, err = e.BuildFarmSession()
if err != nil { LogError("retouche :", err) }
err = QueueFarmSession(nuit.ID)
if err != nil { LogError("file :", err) }
}
}
err = StopFarmSession("") // celle qui tourne s'arrête, « nuit » part
if err != nil { LogError("arrêt :", err) }
Rapatrier tout de suite
| Fonction | Rend | |
|---|---|---|
RepatriateNow() | 1 : une erreur | Lance une passe de rapatriement sans attendre. |
Le worker dort entre deux passes. Un script qui vient de vider une planète veut que les ressources partent maintenant, pas au prochain réveil.
Elle ne règle rien : les destinations, les seuils et les vaisseaux restent ceux de la page. Elle ne fait qu'avancer l'heure. Le worker doit être allumé — déclencher un worker éteint ne ferait rien, et l'erreur le dit.
Rassembler tout au même endroit
| Fonction | Rend | |
|---|---|---|
RepatriateSetAllDestinations(céleste) | 1 : une erreur | Ce céleste reçoit, tous les autres l'alimentent. |
Lisez le nom jusqu'au bout : « All ». Le céleste donné devient la destination, et tous les autres deviennent des origines. Le réglage précédent des origines est REMPLACÉ, pas complété : une colonie que vous aviez mise de côté — le temps d'y construire — y revient.
Les autres destinations sont effacées. La page en accepte plusieurs, et chaque céleste rapatrie vers la plus proche ; cet appel n'en laisse qu'une, la vôtre. C'est ce que le nom promet, mais un compte à trois banques n'en a plus qu'une après l'appel.
Elle ne lance rien : c'est RepatriateNow qui déclenche une passe.
RepatriateSetAllDestinations("1:64:8")
RepatriateNow()
La file de la Construction
| Fonction | Rend | |
|---|---|---|
ClearAllConstructionQueues() | 1 : une erreur | Vide la file de chaque céleste en mode File. |
AddItemToQueue(céleste, quoi, nombre) | 1 : une erreur | Pose une ligne au bout de la file d'un céleste. |
Les deux écrivent la file que la Construction lit, exactement comme la page Construction : elles ne lancent rien dans le jeu. C'est la Construction qui bâtit ensuite, à sa passe, si elle est allumée (StartBrain()).
Une ligne de Kepler est un niveau à atteindre, pas une action. Chez l'outil de référence, AddItemToQueue(c, SOLARPLANT, 0) veut dire « un niveau de plus ». Ici, la ligne posée vise le niveau suivant de ce qui est déjà bâti, en chantier ou déjà demandé dans la file : deux appels d'affilée demandent donc bien deux niveaux, et la centrale dont le 11 monte reçoit la ligne « centrale 12 ». Le niveau actuel et le chantier se lisent dans le jeu à l'appel, deux ou trois requêtes.
- Bâtiment, recherche, forme de vie : le nombre est ignoré, sauf
-1. - Vaisseau, défense : le nombre est une quantité, au moins une.
AddItemToQueue(c, BOMBER, 0)rend une erreur. -1, démolir, n'est pas pris en charge et rend une erreur qui le dit : la file ne sait pas descendre un niveau.TearDowndémolit tout de suite.- Une forme de vie qui n'est pas de l'espèce du céleste est refusée : sa page ne la montre pas, et son niveau ne se lit pas.
- Ce que la page Construction ne propose pas est refusé : la foreuse, une mine ou une recherche sur une lune, une forme de vie sur une lune. La ligne serait morte.
- Un vaisseau réservé à une autre classe est refusé : le Faucheur hors Général, l'Éclaireur hors Explorateur. Le jeu ne le construirait pas.
Un céleste éteint à la file vide passe en mode File : une ligne posée dans une file que personne ne lit ne ferait rien. Un céleste éteint qui garde une file est refusé, sans rien toucher : le rallumer bâtirait aussi ses anciennes lignes. Un céleste en mode IA est refusé de même : le passer en File jetterait son plan. Dans les deux cas, c'est à vous de le décider sur la page.
ClearAllConstructionQueues ne vide que les célestes en mode File. La file gardée par un céleste en mode IA ou éteint reste telle quelle, comme avec le bouton « Vider toutes les files » de la page.
Pendant le mode manuel du navigateur, ClearAllConstructionQueues passe tout de suite : elle ne touche qu'à la file du robot, sans rien demander au jeu. AddItemToQueue, elle, attend la fin du mode, puisqu'elle peut avoir à lire le niveau du céleste dans le jeu.
ClearAllConstructionQueues()
c = GetCachedCelestial("1:2:3")
err = AddItemToQueue(c.GetID(), METALMINE, 0)
if err != nil { LogError("file :", err) }
AddItemToQueue(c.GetID(), METALMINE, 0) // un niveau de plus encore
AddItemToQueue(c.GetID(), BOMBER, 5)
Finir les livraisons avant l'arrêt du Planning
| Fonction | Rend | |
|---|---|---|
GetSupplyFinishDeliveries() | 1 : un booléen | La case « Finir les livraisons en cours avant l'arrêt du Planning » est-elle cochée. |
SetSupplyFinishDeliveries(oui) | 1 : une erreur | La coche ou la décoche, comme sur la page Construction, panneau Ravitaillement. |
Une livraison qui se poserait Construction éteinte ne part pas, case cochée ou non. Quand le Planning va éteindre la Construction, le ravitaillement compare l'atterrissage de la livraison, plus deux minutes et vingt secondes pour que la Construction la voie et lance son chantier, à l'heure réelle de l'extinction, décalage aléatoire compris. Trop tard, elle attend que la Construction soit rallumée, et le journal le dit une fois par planète : « ravitaillement retenu : la Construction sera éteinte par le planning avant l'arrivée ». Sans Planning coché, rien ne change.
La case sert ce qui vole déjà quand le bord tombe. Cochée, la Construction éteinte par le Planning reste en marche pour les seules planètes qu'une livraison en vol, ou posée et pas encore servie, va payer : elle attend l'atterrissage, lance ce que la cargaison paie, puis s'éteint. Deux heures au plus après le bord, et une demi-heure au plus après le dernier atterrissage. Pendant ce temps la page montre la Construction éteinte, et le ravitaillement n'envoie rien de neuf. La veille, le mode manuel, la pause et l'arrêt du robot la coupent ; une extinction à la main n'est jamais gardée.
SetSupplyFinishDeliveries ne touche à rien d'autre : les banques, les planètes nourries et les types de fret restent ceux de la page.
if !GetSupplyFinishDeliveries() {
err = SetSupplyFinishDeliveries(true)
if err != nil {
LogWarn("case du ravitaillement refusée : " + err.Error())
}
}
Ce que le robot fait de ce compte
| Fonction | Rend | |
|---|---|---|
IsStarted() | 1 : un booléen | Le robot tourne-t-il pour ce compte. |
IsActive() | 1 : un booléen | Le redémarrera-t-il au prochain lancement. |
Les deux questions se ressemblent et n'ont pas la même réponse. IsActive lit la CASE du compte : un compte actif mais arrêté repartira, un compte inactif ne repartira pas. IsStarted lit l'état vivant.
Vue de l'intérieur d'un script, IsStarted est toujours vraie — un script ne tourne pas sur un robot arrêté. Elle sert après une longue attente : entre-temps, la session a pu se fermer.
La veille, et la cadence du Defender
| Fonction | Rend | |
|---|---|---|
GetNextSleepTime() | 1 : une heure, ou nil | Le prochain coucher. |
GetNextWakeTime() | 1 : une heure, ou nil | Le prochain réveil. |
SetDefenderCheckInterval(min, max) | 1 : une erreur | La cadence de la ronde, en secondes. |
SetDefenderCheckOrigin(n) | 1 : une erreur | D'où la ronde regarde : 1 un céleste au hasard, 2 la planète mère, 3 le dernier céleste visité, 4 une lune au hasard. |
TriggerFleetSave() | 1 : une erreur | Sort la flotte maintenant, avec les réglages du mode veille. |
Les deux heures sont celles qui auront vraiment lieu, tirage au sort compris. Le robot décale ses couchers de quelques minutes pour ne pas s'éteindre chaque soir à la seconde ronde ; un script qui se fierait à l'heure saisie dans la page se ferait couper au milieu d'un geste.
fin = GetNextSleepTime()
if fin != nil && fin.Sub(Now()).Minutes() < 10 {
LogInfo("le compte s'endort bientôt, on ne lance pas la campagne")
return
}
nil veut dire quelque chose : la veille n'est pas automatique, ou la session n'est pas ouverte. C'est pour cela que ces deux-là rendent un pointeur et non une date — une date nulle se lirait comme l'an 1, et un script qui compare des heures y verrait un coucher déjà passé.
SetDefenderCheckInterval prend DEUX bornes, en secondes, et le robot tire au hasard entre elles à chaque tour : une cadence fixe se reconnaît d'en face, c'est tout l'intérêt d'en avoir deux. Le réglage est enregistré, comme les champs de l'interface. Une borne nulle ou à l'envers est refusée plutôt que corrigée en silence.
TriggerFleetSave sort la flotte maintenant, avec les célestes cochés dans le mode veille, leurs destinations et leur découpage. Elle ne règle rien : un script qui veut envoyer autre chose compose son vol avec SendFleet.
Elle marche même quand la veille est éteinte, et c'est voulu. La sortie de flotte se règle sous la veille, mais celui qui ne se sert pas de la veille est justement celui à qui le geste sert le plus.
Elle attend la fin. Plusieurs célestes qui découpent leur flotte se comptent en dizaines de minutes ; le script reprend la main quand tout est parti, ce qui est le seul moyen d'écrire « je sors la flotte PUIS j'éteins tout ». Arrêter le script arrête la sortie.
L'erreur ne se lève que si RIEN n'est parti - session fermée, aucun céleste coché, version sans sortie de flotte. Un départ partiel ne la lève pas : il va au journal et en avertissement plein écran, comme quand on clique le bouton, parce que c'est le joueur qui peut y faire quelque chose, pas le script. La documentation de référence, elle, ne rend rien du tout ; un TriggerFleetSave() recopié tel quel marche donc aussi ici.
err = TriggerFleetSave()
if err != nil {
LogWarn("rien n'est sorti : " + err.Error())
}
L'heure de rentrée du Fleet Save
| Fonction | Rend | |
|---|---|---|
GetFleetSaveReturn() | 1 : une structure | L'heure de rentrée de la sortie de nuit : AtWake, WakeFrom, WakeTo, From, To, From2, To2. |
SetFleetSaveReturnAtWake(oui, de, à) | 1 : une erreur | Coche ou décoche « Rentrer au réveil » et règle ses minutes après le réveil. |
SetFleetSaveReturnWindow(plage, de, à) | 1 : une erreur | La fourchette en heures d'une plage de veille, 1 ou 2 : "08:00", "08:30". |
Rentrer au réveil, c'est rentrer entre deux délais après le réveil de la nuit, décalage compris : SetFleetSaveReturnAtWake(true, 2, 10) fait rentrer la flotte entre deux et dix minutes après que le robot s'est réveillé. Ce sont les deux champs de la page Mode veille, sous la case. Les minutes vont de 0 à 1440, la seconde plus grande que la première ; décochée, la case garde ses minutes pour la prochaine fois.
La fourchette en heures sert quand la case est décochée, et pour une sortie sans veille en cours, TriggerFleetSave compris, même cochée : il n'y a alors pas de réveil à viser. La plage 2 est celle de la seconde plage de veille du planning ; SetFleetSaveReturnWindow(2, "", "") l'efface, et elle reprend la première. Une fin avant le début passe minuit : "23:30" et "00:15" font quarante-cinq minutes.
Une plage de plus de trois heures est enregistrée, et dite. Le robot prend le vol le moins cher qui tombe dedans, souvent le plus lent, et la flotte peut rentrer jusqu'à sa fin : "15:45" et "13:55" font vingt-deux heures dix. La fonction rend nil, et un avis s'écrit à la console du script et au journal du robot, comme sur la page. Une heure illisible, des minutes à l'envers ou une plage autre que 1 et 2 sont refusées, et rien ne change.
r = GetFleetSaveReturn()
if !r.AtWake {
err = SetFleetSaveReturnAtWake(true, 2, 10)
if err != nil {
LogWarn("rentrée au réveil refusée : " + err.Error())
}
}
Print("sortie sans veille : rentrée entre", r.From, "et", r.To)
Les réglages de la Colonisation
| Fonction | Rend | |
|---|---|---|
GetColonizerSettings() | 1 : une structure | Tous les réglages de la page Colonisation : Origin, OriginIsHome, Galaxy, SystemFrom, SystemTo, Positions, MinFieldsOn, MinFields, MinTempOn, MinTemp, MaxTempOn, MaxTemp, SystemDelayMin, SystemDelayMax, ArrivalGapMin, ArrivalGapMax, MaxSlots. |
SetColonizerOrigin(céleste) | 1 : une erreur | La planète d'où partent les vaisseaux de colonisation, ou "home" pour suivre la planète mère. |
SetColonizerRange(galaxie, de, à) | 1 : une erreur | La galaxie et la plage de systèmes où chercher. |
SetColonizerPositions(positions) | 1 : une erreur | Les positions à coloniser dans chaque système : [4, 5, 6]. |
SetColonizerMinFields(oui, cases) | 1 : une erreur | La case « Cases minimales » et son nombre. |
SetColonizerMinTemperature(oui, t) | 1 : une erreur | La case « Température minimale » et sa valeur. |
SetColonizerMaxTemperature(oui, t) | 1 : une erreur | La case « Température maximale » et sa valeur. |
SetColonizerSystemDelay(min, max) | 1 : une erreur | Délai entre deux systèmes, en millisecondes. |
SetColonizerArrivalGap(min, max) | 1 : une erreur | Délai entre deux arrivées, en secondes. |
SetColonizerMaxSlots(n) | 1 : une erreur | Plafond de slots de la Colonisation, de 0 (pas de plafond) à 100. |
Chaque fonction pose un réglage de la page Colonisation, comme si vous l'aviez changé puis enregistré : il s'applique tout de suite et survit au redémarrage. L'interrupteur reste StartColonizerBot et StopColonizerBot, et le plafond de slots est celui de la Colonisation sous Paramètres > Slots de flotte.
Une case garde son nombre. SetColonizerMinFields(false, 200) décoche « Cases minimales » et range 200 pour la fois où vous la recocherez, comme à l'écran. Une colonie qui ne remplit pas une condition cochée est rendue tout de suite, pour que le vaisseau suivant puisse coloniser à son tour : deux températures cochées qui se contredisent sont donc refusées, aucune planète ne les remplirait.
Les bornes sont celles de l'écran, et un dépassement est refusé, pas ramené : positions de 1 à 15, systèmes à partir de 1 et le premier avant le second, délai entre deux systèmes de 200 ms au moins, entre deux arrivées de 30 à 180 s. Une liste de positions vide est refusée tant que la Colonisation est active. L'origine est une planète du compte : une lune, qui ne construit pas de vaisseau de colonisation, est refusée, comme une position qui n'est pas à vous. Avec "home", l'origine suit la planète mère réglée sous Paramètres > Général, et OriginIsHome vaut true.
s = GetColonizerSettings()
if s.ArrivalGapMax < 90 {
err = SetColonizerArrivalGap(60, 90)
if err != nil {
LogWarn("délai entre deux arrivées refusé : " + err.Error())
}
}
SetColonizerOrigin("home")
SetColonizerPositions([4, 5, 6, 10, 11, 12])
StartColonizerBot()
Les réglages par tables : Get…Configs et Set…Configs
| Fonction | Rend | |
|---|---|---|
GetDefenderConfigs(céleste) | 1 : une table | Les réglages de la page Défense. Avec un céleste, sa ligne « Évacuation par planète ». |
SetDefenderConfigs(céleste, table) | 1 : une erreur | Pose les champs donnés. Sans céleste, ceux de la page : SetDefenderConfigs(table). |
GetColonizerConfigs() | 1 : une table | La page Colonisation. |
SetColonizerConfigs(table) | 1 : une erreur | Pose les champs donnés. |
GetDiscoveryConfigs() | 1 : une table | La page Expédition fdv. |
SetDiscoveryConfigs(table) | 1 : une erreur | Pose les champs donnés. |
GetBrainConfigs(céleste) | 1 : une table | Les réglages généraux de la page Construction. Avec un céleste, sa carte : mode, file, objectifs, cases. |
SetBrainConfigs(céleste, table) | 1 : une erreur | Pose les champs donnés. Sans céleste, ceux du haut de la page : SetBrainConfigs(table). |
GetSupplyConfigs() | 1 : une table | Le panneau Ravitaillement de la page Construction. |
SetSupplyConfigs(table) | 1 : une erreur | Pose les champs donnés. |
GetSupplyBanks() | 1 : une liste | Les banques du Ravitaillement, comme GetSupplyConfigs().Banks. |
SetSupplyBanks(célestes) | 1 : une erreur | Les remplace, comme SetSupplyConfigs({"Banks": célestes}). |
GetScannerConfigs() | 1 : une table | La page Scanner de galaxie. |
SetScannerConfigs(table) | 1 : une erreur | Pose les champs donnés. |
GetTimerConfigs() | 1 : une table | La page Surveillance timer. |
SetTimerConfigs(table) | 1 : une erreur | Pose les champs donnés. |
GetColonyWatchConfigs() | 1 : une table | La page Détection nouvelle colonie. |
SetColonyWatchConfigs(table) | 1 : une erreur | Pose les champs donnés. |
GetMilitaryDebrisConfigs() | 1 : une table | La page Détection de champ de débris. |
SetMilitaryDebrisConfigs(table) | 1 : une erreur | Pose les champs donnés. |
GetHunterConfigs() | 1 : une table | Les réglages de la Surveillance joueurs : cadence et « Espionnage à la demande ». |
SetHunterConfigs(table) | 1 : une erreur | Pose les champs donnés. |
GetFarmingBotConfigs() | 1 : une table | Le panneau « Cadence du pillage » de l'onglet Pillage, et son plafond de slots. |
SetFarmingBotConfigs(table) | 1 : une erreur | Pose les champs donnés. |
Le Get rend tout l'écran d'un worker sous forme de table, un champ par réglage, aux noms des tableaux ci-dessous. C'est le modèle de GetExpeditionsConfigs chez Ninja : on relit, on change un champ, on rend la table.
Le Set ne change que les champs qu'on lui donne, et seulement s'ils diffèrent de ce qui est enregistré. cfg = GetTimerConfigs(), puis cfg.MapHours = 2, puis SetTimerConfigs(cfg) ne touche qu'au relevé de la galaxie, même si le joueur a changé autre chose à l'écran entre les deux appels. Une table écrite à la main marche aussi : SetTimerConfigs({"MapHours": 2}).
C'est l'enregistrement de l'écran. Les champs changés partent d'un seul tenant, s'appliquent tout de suite et survivent au redémarrage. Les refus de l'écran valent aussi : un outil allumé sans aucun canal pour prévenir est refusé, avec la phrase de la page. L'interrupteur n'est pas dans la table : il reste StartWorker et StopWorker.
Rien n'est corrigé en silence. Un champ inconnu, un type faux ou une valeur hors bornes font refuser le Set en entier : rien n'est écrit, et l'erreur nomme le champ, par exemple SetTimerConfigs : MapHours vaut 30, hors de ses bornes : l'écran l'enregistrerait comme 24. Les bornes sont celles que le robot tient pour l'écran ; un tableau les donne pour chaque champ. Un minimum au-dessus de son maximum est refusé aussi, comme une valeur qui en déplacerait une autre : poser IntervalMin au-dessus de l'IntervalMax enregistré demande de donner les deux.
Les valeurs. Un nombre est un entier, une case vaut true ou false, un choix est un mot anglais. Un céleste s'écrit comme ailleurs dans l'API : une planète ou une lune de GetCachedPlanets(), une coordonnée, "1:2:3" ou "M:1:2:3". Il doit être du compte, comme dans les menus de l'écran ; le Get le rend en coordonnée, et nil pour aucun. Une liste se manie comme une liste (cfg.Banks += p), une table de ressources se retouche en place (cfg.BankReserveMoon.Deuterium = 0), et ses clés absentes gardent leur valeur.
Les noms sont un contrat : ils ne changeront plus. Ceux de Ninja sont repris quand ils existent (CheckIntervalMin, Origin, SystemFrom). Le plafond de slots d'un worker, sous Paramètres > Slots de flotte, est le champ MaxSlots de sa table.
cfg = GetHunterConfigs()
Print(cfg)
cfg.CheckIntervalMin = 300
cfg.CheckIntervalMax = 600
err = SetHunterConfigs(cfg)
if err != nil {
LogWarn("réglage refusé : " + err.Error())
}
Défense
GetDefenderConfigs(), la page Défense :
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
CheckIntervalMin, CheckIntervalMax | entier, secondes | 10 au moins, le premier avant le second | Check toutes les … à … |
CheckOrigin | "random", "moon", "home", "last" ou un céleste | 1 à 4 lus comme SetDefenderCheckOrigin | D'où le bot regarde s'il est attaqué |
EvacuationSpeed | entier, % | 10 à 100, de dix en dix | Vitesse d'évacuation |
DeuteriumToLeave | entier | 0 ou plus | Deutérium laissé sur place |
DodgeLeadMin, DodgeLeadMax | entier, secondes | 0 ou plus, le premier avant le second | Esquiver combien de temps avant l'impact |
RecallEnabled | booléen | Rappeler la flotte après l'attaque | |
RecallMin, RecallMax | entier, secondes | 0 ou plus, le premier avant le second | ses deux nombres |
DumpIntoDefence | booléen | Dépenser dans la défense ce qui n'a pas pu être sauvé | |
NotifyDesktop | booléen | Notification sur le bureau | |
PlaySound | booléen | Jouer un son | |
NotifySmallFleets | booléen | Signaler aussi les petites flottes | |
SmallFleetPercent | entier, % | 1 à 100 | Une flotte est petite en dessous de … % |
SpyAttackers | booléen | Sonder l'origine du raid | |
BuildABM | booléen | Construire des missiles d'interception | |
MessagesEnabled | booléen | Envoyer un message | |
Messages | liste de textes | les messages, un par ligne | |
Whitelist | liste d'entiers | identifiants de joueurs, 1 ou plus | Liste blanche |
GetDefenderConfigs(céleste), sa ligne du tableau « Évacuation par planète » :
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
Mode | "dangerous", "always", "never" | Dangereuse, Toujours, Jamais | |
Destination | un céleste, ou nil | du compte | Destination ; nil laisse le robot choisir |
Debris | booléen | sur une lune seulement | Champ de débris |
Un céleste absent du tableau se lit comme le Defender le traite : "dangerous", sans destination. La table d'une planète n'a pas de champ Debris.
Colonisation
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
Origin | une planète, "home" ou nil | du compte, jamais une lune ; pas nil Colonisation allumée | Origine ; "home" suit la planète mère |
Galaxy | entier | 1 ou plus | Galaxie |
SystemFrom, SystemTo | entier | 1 ou plus, le premier avant le second | Systèmes … à … |
Positions | liste d'entiers | 1 à 15, rangées sans doublon ; pas vide Colonisation allumée | Positions |
MinFieldsOn, MinFields | booléen, entier | 0 ou plus | Cases minimales |
MinTempOn, MinTemp | booléen, entier | Température minimale | |
MaxTempOn, MaxTemp | booléen, entier | cochées toutes deux, le minimum pas au-dessus du maximum | Température maximale |
SystemDelayMin, SystemDelayMax | entier, ms | 200 au moins, le premier avant le second | Délai entre deux systèmes |
ArrivalGapMin, ArrivalGapMax | entier, secondes | 30 à 180, le premier avant le second | Délai entre deux arrivées |
MaxSlots | entier | 0 (pas de plafond) à 100 | Paramètres > Slots de flotte, Colonisation |
Ce sont les champs de GetColonizerSettings, à une différence près : l'origine qui suit la planète mère s'y lit "home", et non OriginIsHome.
Expédition fdv
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
StopAtArtifactCap | booléen | Arrêter quand le plafond d'artefacts est atteint | |
SystemDelayMin, SystemDelayMax | entier, ms | 200 au moins, le premier avant le second | Délai entre deux systèmes |
SendDelayMin, SendDelayMax | entier, ms | 200 au moins, le premier avant le second | Délai avant le bouton du système |
Origins | liste de célestes | du compte, planètes et lunes ; pas vide Expédition fdv allumée | Points de départ |
Radius | entier, systèmes | 0 à 100 | Rayon |
Strategy | "all", "majority", "never" | Stratégie : attendre tous, la majorité, ne jamais attendre | |
ReturnDelayMin, ReturnDelayMax | entier, secondes | 0 ou plus, le premier avant le second | Délai avant de relancer après un retour |
MaxSlots | entier | 0 (pas de plafond) à 100 | Paramètres > Slots de flotte, Expédition fdv |
Construction
GetBrainConfigs(), le haut de la page :
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
ResourceCheckMin, ResourceCheckMax | entier, minutes | 20 à 240, le premier avant le second | Check d'une caisse insuffisante |
PauseAfterBuild | entier, % | 0 à 5 | Pause après un chantier |
GetBrainConfigs(céleste), sa carte. Un céleste sans carte se lit comme une carte neuve de l'écran : éteint, file vide, lignes terminées retirées.
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
Mode | "off", "queue", "ai" | Arrêt, File, IA ; "ai" sur une lune est son IA de lune | |
Queue | liste de lignes | voir plus bas | la file du mode File |
StrictOrder | booléen | pas avec AnyOrder | Mono-file : une seule file à la fois |
AnyOrder | booléen | pas avec StrictOrder | Lancer tout ce qui peut partir |
RemoveDone | booléen | Retirer de la file les lignes terminées | |
Targets | liste d'objectifs | planète seulement | les objectifs du mode IA |
Robotics, Nanites | booléen | planète seulement | Autoriser l'usine de robots, l'usine de nanites |
Fusion, Satellites | booléen | planète seulement | Réacteurs à fusion, satellites solaires |
MoonBase, MoonRobotics | entier | 1 à 20, lune seulement | Base lunaire, usine de robots visées |
MoonPhalanx | entier | 0 à 20, lune seulement | Phalange de capteur visée |
Une ligne de Queue est une table : ID, l'objet ; Level, le niveau visé, ou le nombre pour un vaisseau ou une défense ; Mode, "build" (le défaut), "reach" (en avoir Level, vaisseaux et défenses) ou "energy" (satellites solaires d'une planète, Level étant le plafond, 0 pour aucun) ; Plus, un niveau de plus que l'actuel, de 0 à 50, bâtiments et recherches ; Done, ce qui est déjà commandé ; Auto, la ligne posée par le robot comme prérequis. Un objectif de Targets porte ID, Level et Done. La liste donnée REMPLACE la file ou les objectifs. Un objet que la file de ce céleste ne sait pas mener est refusé, comme le catalogue de l'écran ne le propose pas.
p = GetCachedPlanets()[0]
err = SetBrainConfigs(p, {"Mode": "queue", "Queue": [
{"ID": METALMINE, "Level": 20},
{"ID": ROCKETLAUNCHER, "Level": 200, "Mode": "reach"},
]})
if err != nil {
LogWarn("file refusée : " + err.Error())
}
for l in GetBrainConfigs(p).Queue {
Print(l.ID, l.Level, l.Mode, l.Done)
}
Ravitaillement
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
Banks | liste de célestes | du compte | Banques |
Targets | liste de célestes | du compte | Planètes et lunes à alimenter |
AdvanceHours | entier, heures | 1 à 168 | Avance à livrer |
LeadMinutes | entier, minutes | 5 à 1440 | Livrer combien de temps avant la fin |
MinDelivery | entier | 0 ou plus | Livraison minimale |
BanksPerDelivery | entier | 2 à 10 | Banques par livraison, au plus |
Cargo | "LargeCargo", "SmallCargo", "Pathfinder" | Vaisseau de fret | |
Cargo2, Cargo3 | les mêmes, ou "" | différents du premier et entre eux | Deuxième et troisième type |
RoundUp | booléen | Arrondir les livraisons vers le haut | |
FinishDeliveries | booléen | Finir les livraisons en cours avant l'arrêt du Planning | |
BankReservePlanet, BankReserveMoon | table de ressources | 0 ou plus | Garder sur une banque planète, lune |
TargetReservePlanet, TargetReserveMoon | table de ressources | 0 ou plus | Garder sur une destination planète, lune |
MaxSlots | entier | 0 (pas de plafond) à 100 | Paramètres > Slots de flotte, Ravitaillement |
Une table de ressources porte Metal, Crystal et Deuterium ; NewResources(m, c, d) est accepté aussi.
Scanner de galaxie
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
FrequencyHours | entier, heures | 1 ou plus | Balayer l'univers toutes les |
DelayMin, DelayMax | entier, ms | 200 à 60000, le premier avant le second | Attente entre deux systèmes |
From | un céleste, ou nil | du compte | Consulter depuis ; nil : la planète active |
Surveillance timer
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
Players | liste de textes | Joueurs surveillés, un par ligne | |
IntervalMin, IntervalMax | entier, secondes | 30 au moins, le second au-dessus du premier | Entre deux tours de surveillance |
PositionDelayMin, PositionDelayMax | entier, ms | 200 au moins, le premier avant le second | Entre deux positions surveillées |
ReminderMinutes | entier, minutes | 0 ou plus ; 0 : la première alerte seule | Rappel d'inactivité |
MapHours | entier, heures | 1 à 24 | Refresh la galaxie toutes les |
SystemDelayMin, SystemDelayMax | entier, ms | 200 au moins, le premier avant le second | Entre deux systèmes relevés |
GalaxyPauseMin, GalaxyPauseMax | entier, ms | 0 ou plus, le second au-dessus du premier | Pause au passage d'une galaxie |
Webhooks, Mentions | liste de textes | Où prévenir : webhooks Discord, mentions | |
Telegram | booléen | Où prévenir : Telegram |
Détection nouvelle colonie
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
Coordinates | liste de textes | "1:69" ou "[1:69:8]", lisibles par l'outil | Coordonnées surveillées |
Radius | entier, systèmes | 0 à 100 ; 0 : le système seul | Rayon autour de chaque position |
NotifyDestroyed | booléen | Prévenir dès qu'une planète est détruite | |
MaxMilitaryRank | entier | 1 à 1000 | Classement militaire minimum pour notifier |
SystemDelayMin, SystemDelayMax | entier, ms | 200 au moins, le premier avant le second | Entre deux systèmes |
CyclePauseMin, CyclePauseMax | entier, minutes | 1 au moins, le second au-dessus du premier | Pause entre deux passages complets |
Webhooks, Mentions, Telegram | Où prévenir |
Détection de champ de débris
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
MinPointsLost | entier | 1 ou plus | Perte de points militaires minimale |
MinDebris | entier | 1 ou plus | Champ de débris minimal pour notifier |
MaxRank | entier | 100 à 1000 | Classement surveillé |
IntervalMin, IntervalMax | entier, secondes | 15 au moins, le premier avant le second | Entre deux relevés du classement |
PageDelayMin, PageDelayMax | entier, ms | 200 au moins, le second au-dessus du premier | Entre deux pages de classement |
PositionDelayMin, PositionDelayMax | entier, ms | 200 au moins, le second au-dessus du premier | Entre deux systèmes vérifiés |
MapHours | entier, heures | 1 à 24 | Refresh la galaxie toutes les |
SystemDelayMin, SystemDelayMax | entier, ms | 200 au moins, le premier avant le second | Entre deux systèmes relevés |
Webhooks, Mentions, Telegram | Où prévenir |
Surveillance joueurs (Hunter)
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
CheckIntervalMin, CheckIntervalMax | entier, secondes | 60 au moins, le premier avant le second | Check toutes les (en minutes à l'écran) |
Origin | un céleste, ou nil | du compte | Planète de départ ; nil : la planète active |
SpyDelayMin, SpyDelayMax | entier, ms | 200 au moins, le premier avant le second | Attente entre deux gestes |
MaxSlots | entier | 0 (pas de plafond) à 100 | Paramètres > Slots de flotte, Surveillance joueurs |
La liste des joueurs suivis reste à AddHunterTarget et à ses voisines.
Pillage (cadence)
| Champ | Type | Bornes | À l'écran |
|---|---|---|---|
SystemDelayMin, SystemDelayMax | entier, ms | 300 au moins, le premier avant le second | Passage d'un système au suivant |
SpyDelayMin, SpyDelayMax | entier, ms | 300 au moins, le premier avant le second | Entre deux espionnages |
MaxSlots | entier | 0 (pas de plafond) à 100 | Paramètres > Slots de flotte, Pillage ; le même que SetFarmMaxSlots |
Ces deux cadences valent pour toutes les campagnes. Sous 300 ms, l'écran relève la valeur sans rien dire ; un script, lui, est refusé. Les campagnes restent à NewFarmSession, EditFarmSession et à leurs voisines.
La Surveillance timer, joueur par joueur
| Fonction | Rend | |
|---|---|---|
GetTimerTargets() | 1 : une liste | Les joueurs surveillés, comme GetTimerConfigs().Players. |
AddTimerTarget(joueur) | 1 : une erreur | Ajoute un joueur, par son nom ou son identifiant. |
RemoveTimerTarget(joueur) | 1 : une erreur | Le retire de la liste. |
| Valeur | Porte | |
|---|---|---|
OnTimerTargetIdleCh | un canal de bascules | Les joueurs surveillés qui viennent de passer « full timer ». |
C'est la liste « Joueurs surveillés » de la page Surveillance timer, posée comme « Enregistrer » la pose. Un nom que les relevés connaissent prend leur écriture exacte ; un nom inconnu est accepté comme à l'écran, et le Timer le cherchera à chaque tour. Un joueur déjà dans la liste, à la casse près, n'y entre pas deux fois ; en retirer un qui n'y est pas rend une erreur, pour qu'une faute de frappe se voie.
OnTimerTargetIdleCh part avec l'alerte « Joueur Timer » : quand toutes les positions connues d'un joueur sont lues et qu'aucune n'est active. Jamais sur un relevé incomplet, jamais pour un rappel. L'événement porte PlayerID, PlayerName, Timer (le plus court compteur affiché, de 16 à 59, ou 0 quand aucune position n'en montre), Checked (les planètes et lunes lues) et Positions (ses planètes et ses lunes connues). Le canal n'a rien à porter tant que la Surveillance timer est éteinte : elle a besoin d'un canal de notification, le sien ou ceux des Paramètres. Le Hunter, lui, a OnHunterTargetIdleCh, sur peu de cibles.
AddTimerTarget("Kcwin")
for {
e = <-OnTimerTargetIdleCh
if e.PlayerID == 0 { break }
LogInfo(e.PlayerName, "est timer, compteur le plus court :", e.Timer)
}
Les messages de la mission « Envoyez un message en jeu »
| Fonction | Rend | |
|---|---|---|
GetRewardsMessages() | 1 : une liste | Les textes que le robot tire au hasard pour la mission « Envoyez un message en jeu » des Récompenses. |
SetRewardsMessages(messages) | 1 : une erreur | Remplace la liste, un message par élément : ["sry for event", "event"]. Une liste vide remet celle par défaut. |
C'est la liste de la page Récompenses et booster, onglet Missions, un message par ligne : la fonction la pose comme si vous l'aviez changée puis enregistrée, elle s'applique tout de suite et survit au redémarrage. À chaque envoi, le robot en tire un au hasard. Sans liste réglée, il tire parmi ".", "event", "rewards", "hi" et "Hi", et c'est cette liste-là que GetRewardsMessages rend.
Les bornes sont celles de l'écran, et un dépassement est refusé, pas coupé : vingt messages au plus, de cent caractères au plus chacun, un message par élément sans retour à la ligne. Les éléments vides sont ignorés, les espaces du bord retirés. Un refus ne change rien.
Le destinataire ne se règle pas. C'est d'abord un joueur inactif, i ou I, que la carte du robot a vu ces sept derniers jours, tiré au hasard ; sans inactif connu, un joueur classé entre la 201e et la 300e place, ou dans le bas du classement d'un petit univers, un inactif de la page passant devant les autres. Jamais vous-même ni un membre de votre alliance, jamais un joueur en vacances, banni ou administrateur quand la carte ou le classement le dit.
err = SetRewardsMessages(["sry for event", "event", "rewards"])
if err != nil {
LogWarn("messages refusés : " + err.Error())
}
Print(GetRewardsMessages())
Pause et arrêt ne sont pas la même chose, et c'est ce qui justifie deux fonctions plutôt qu'une. PauseFarmingBot garde l'avancement : la reprise repart du système atteint. StopFarmingBot l'efface : la campagne repartira du premier. Sur une campagne de trois cents systèmes, c'est une nuit de travail.
if IsFarmSessionOngoing() {
PauseFarmingBot() // on rend les slots au Defender
SleepMin(30)
ResumeFarmingBot() // et on repart là où on s'était arrêté
}
ResumeFarmingBot trouve seule laquelle reprendre : une seule campagne à la fois peut être en pause. Sans campagne en pause, elle rend une erreur plutôt que de relancer celle qu'elle trouve — la relancer la ferait repartir du premier système, ce qui est exactement ce qu'on cherchait à éviter.
AbortAllFarmingSessions est le geste de « on repart de zéro », et il fait exactement comme chez Ninja : il retire toutes les campagnes, quel que soit leur état - en cours, en pause, en file ou terminée -, celles de vos scripts comme celles de l'onglet Pillage. Un script qui abandonne le soir et recompose le matin depuis le céleste où sa flotte a dormi ne retrouve donc plus les campagnes de la veille sous les neuves.
AbortAllFarmingSessions() // le soir : plus rien ne tourne, plus rien d'hier
Pendant le mode manuel du navigateur, AbortAllFarmingSessions passe tout de suite : elle ne fait que retirer des campagnes, sans rien demander au jeu.
Celles de l'onglet Pillage partent aussi, même celle qui tourne. Un Planning qui nommait une campagne retirée le dit à son bord suivant, comme pour une campagne supprimée à la main : il garde celle qui tourne s'il y en a une, et sinon laisse le Pillage éteint plutôt que de l'allumer sur rien. Le bouton « Tout arrêter » de l'écran, lui, ne retire rien : c'est StopAllFarmSessions().
Les raids déjà en vol ne sont pas rappelés : ils rentrent normalement, et rien ne relance une campagne retirée - ni leur retour, ni la file, ni un redémarrage du robot, ni un onglet de Kepler resté ouvert depuis la veille, quelle que soit sa page.
L'historique du butin par journée est tenu par compte, pas par campagne : retirer une campagne n'en efface rien. Le butin d'une vague qui vole encore au moment de l'abandon y entre comme celui des vagues rentrées mais pas encore comptées : au prochain passage du Pillage, une fois ses rapports de combat arrivés, si le robot n'a pas redémarré entre-temps. Il n'est plus porté à aucune campagne, puisqu'elles sont retirées. C'est aussi vrai de « Tout arrêter », qui remet toutes les campagnes à zéro.
Éteint à la main, le Pillage garde de même sa vague en vol pour son prochain passage. Éteint par le Planning, il la compte la nuit même : il reste en marche sans campagne - rien ne part, aucune campagne ne reprend - jusqu'à ce que ses rapports de combat soient lus, ou dits introuvables, puis s'éteint de lui-même. IsRunningFarmingBot() répond vrai pendant ce temps, et le bord d'allumage suivant du Planning reprend comme d'habitude.
Appelez StartFarmingBot() après avoir composé les campagnes du jour : juste après l'abandon, il n'y a plus rien à lancer et il rend une erreur ; et si une campagne a été composée entre-temps, à l'écran par exemple, il lance celle-là et les neuves se rangent en file derrière elle.