Kepler. Documentation · Scripts 508 fonctions disponibles actuellement English

Les réglages des workers

Chaque écran de worker se lit et s'écrit d'un coup, par un couple de fonctions : GetExpeditionsConfigs() rend tous les réglages de la page Expéditions dans une table, le script change ce qu'il veut, et SetExpeditionsConfigs(cfg) l'enregistre. C'est le modèle de Ninja, et pour les Expéditions ses noms de champs : un script recopié qui écrit configs.Sheets[0].Origin tourne. Six écrans ont leur couple sur cette page : Expéditions, Mode veille, sortie de flotte pour la nuit, Rapatriement, Distribution, Récompenses et booster.

c = GetExpeditionsConfigs()
c.MaxSlots = 6
c.Sheets[0].Duration = 4
err = SetExpeditionsConfigs(c)
if err != nil {
	LogWarn("réglages des expéditions refusés : " + err.Error())
}

Ce que fait un Set

Il ne change que les champs donnés. SetExpeditionsConfigs({"MaxSlots": 6}) change le plafond et rien d'autre. Une table imbriquée se fusionne de même : une composition, un jour du planning, l'onglet Booster. Un script qui relit, attend, puis rend l'objet entier n'efface donc rien de ce que vous avez changé à l'écran entre-temps : un champ rendu tel qu'il a été lu ne s'écrit pas.

Il passe par le même chemin que le bouton Enregistrer de l'écran. Le réglage s'applique tout de suite, survit au redémarrage, et suit les mêmes règles : exclusivité des outils, normalisation, refus. Rien n'est écrit quand rien ne change.

Un champ inconnu est refusé, avec la liste des champs connus ; une valeur hors bornes aussi, jamais ramenée en silence. L'erreur nomme la fonction et le champ : SetExpeditionsConfigs : Sheets[0].Duration : 20 refusé : le robot le ramènerait à 15. Un seul champ refusé, et rien n'est écrit. Les bornes sont celles de l'écran ; celles que le robot applique de lui-même se disent par « le robot le ramènerait à ».

L'interrupteur n'est pas un champ. Un worker s'allume et s'éteint par StartWorker, StopWorker et leurs noms de Ninja (voir Workers) : écrire Enabled est refusé.

Un céleste s'écrit de quatre façons : l'objet (GetCachedPlanets()[0]), son identifiant (planet.GetID(), comme chez Ninja), sa coordonnée ("1:105:8", "M:1:105:8" pour la lune) ou "home" là où le champ peut suivre la planète mère réglée sous Paramètres > Général. Quand le robot est connecté, il doit être un céleste du compte. Une lecture rend la coordonnée, ou "home".

Le plafond de slots d'un worker est son champ MaxSlots, la ligne du worker sous Paramètres > Slots de flotte, de 0 (pas de plafond) à 100. Pour les envois de vos propres scripts, c'est SetMaxSlotsFor, plus bas.

Les Expéditions

FonctionRend
GetExpeditionsConfigs()1 : une tableTous les réglages de la page Expéditions, compositions comprises (Sheets).
SetExpeditionsConfigs(cfg)1 : une erreurEnregistre les champs donnés.
NewSheet()1 : une tableUne composition neuve, à ajouter à Sheets : configs.Sheets += *sheet.
SetActiveExpeditionsSheet(nom)1 : une erreurChoisit la composition utilisée, par son nom ou son UUID, et décoche les autres. "" n'en laisse aucune.
ChampType et bornesÀ l'écran
Strategy"majority", "all" ou "never"Stratégie
MajorityThresholdentier, 0 et plus ; 0 : la moitié des slotsSeuil de départ
MajorityMaxWaitminutes, de 0 à 1440Attente max
DelayMin, DelayMaxsecondes, 1 et plus, le premier pas plus grandDélai entre deux flottes d'une vague
WaveDelayMin, WaveDelayMaxsecondes, 1 et plus, le premier pas plus grandDélai avant de relancer après un retour
LargeCargoHome, SmallCargoHome, PathfindersHomeentier, 0 et plusVaisseaux à garder
RecycleDebristrue ou falseRecycler les débris en position 16
MinimumPathfindersentier, 1 et plusÉclaireurs minimum par champ
RecyclePathfindersHomeentier, 0 et plusÉclaireurs gardés à quai
MaxSlotsentier, de 0 à 100Paramètres > Slots de flotte > Expéditions
Sheetsliste de compositionsLes onglets des compositions

Une composition :

ChampType et bornesÀ l'écran
UUIDtexte, rendu par la lectureDésigne la composition ; absent ou "" : une composition neuve
NametexteNom
Activetrue ou false, une seule à la foisComposition utilisée
Multitrue ou falseMono ou multi planètes
Origincéleste ou "home"Origine (mono)
SystemFrom, SystemTosystèmes de l'univers, le premier pas plus grandPlage de systèmes (mono)
Originsliste de célestes, dans l'ordre d'envoiPositions de départ (multi)
Rangeentier, de 0 à 499Portée (multi)
ExpeditionsPerOriginentier, de 1 à 25Expéditions par position (multi)
OwnCountPerOrigintrue ou falseNombre propre (multi)
CountPerOrigintable {céleste: entier de 1 à 25} ; 0 ou nil retireLe nombre de chaque position (multi)
ExpeditionSpeedentier, de 1 à 10Vitesse d'expédition
Durationheures, de 1 à 15Durée
AutoFleettrue ou falseFlotte automatique
AutoCargoLARGECARGO, SMALLCARGO ou PATHFINDERVaisseau qui porte
Growthtrue ou falseCroissance
AutoCargo2, AutoCargo3les mêmes, ou 0 pour aucunDeuxième et troisième vaisseau qui porte
AutoCombatMax0 (le meilleur disponible) ou un vaisseau de combatVaisseau de combat au maximum
LightFighter, HeavyFighter, Cruiser, Battleship, Battlecruiser, Bomber, Destroyer, SmallCargo, LargeCargo, EspionageProbe, Reaper, Pathfinderentier, 0 et plusPar expédition
LightFighterAuto … PathfinderAutotrue ou falseRépartir
Deletetrue, en écriture seulementSupprimer la composition

Une seule composition est utilisée à la fois, comme à l'écran : en cocher une décoche les autres, et deux cochées dans le même appel sont refusées. SetActiveExpeditionsSheet("Nuit") est le raccourci, pour changer de composition selon l'heure.

Une composition absente de la liste n'est pas supprimée : on supprime en écrivant {"UUID": "…", "Delete": true}. Une composition neuve, sans UUID, s'ajoute au bout et prend le nom « Config N » quand elle n'en donne pas, comme le « + » de l'écran ; elle n'est pas utilisée tant que Active ne le dit pas. Choisir une origine sans plage pose les cinq systèmes de part et d'autre, comme le menu de l'écran.

Les écarts avec Ninja. Strategy est un mot et non un nombre ; DelayMin et DelayMax sont l'écart entre deux flottes d'une vague, WaveDelayMin et WaveDelayMax l'attente après un retour avant de relancer ; Origin se lit en coordonnée et non en identifiant ; les champs …Auto sont la case « Répartir ». Ce que Kepler n'a pas s'accepte à zéro et se refuse sinon : EarlyPathfinders, EarlyPFSecsMin, EarlyPFSecsMax, MinSpeedEarlyPathfinders, et dans une composition IgnoreMinimumDeuterium, SlotsAllowed, ColonyShip, Recycler, Deathstar et leurs …Auto.

configs = GetExpeditionsConfigs()
celestial = GetCachedPlanets()[0]
sheet = NewSheet()
sheet.Name = "Nuit"
sheet.Origin = celestial.GetID()
sheet.Duration = 8
sheet.LargeCargo = 300
sheet.Pathfinder = 1
configs.Sheets += *sheet
err = SetExpeditionsConfigs(configs)
if err != nil {
	LogWarn("composition refusée : " + err.Error())
}
CronExec("0 23 * * *", func() { SetActiveExpeditionsSheet("Nuit") })

Le Mode veille

FonctionRend
GetSleepModeConfigs()1 : une tableLes réglages de la page Mode veille : horaires, et ce que font les flottes pendant la veille.
SetSleepModeConfigs(cfg)1 : une erreurEnregistre les champs donnés.
SetSleepSchedule(jour, de, à, de2, à2)1 : une erreurLes deux plages d'un jour, comme une ligne du tableau des horaires ; de2 et à2 sont facultatifs.
ChampType et bornesÀ l'écran
Mode"manual" ou "auto"Mode
WakeHour, WakeMinutede 0 à 23, de 0 à 59Se réveiller à (mode manuel)
Daystable d'un jour par nom, "monday" à "sunday"Horaires
SleepJitter, WakeJitterminutes : 0, 5, 10, 15, 20, 30, 45, 60, 90 ou 120Décalage aléatoire du coucher, du réveil
BeforeSleep"skip", "ignore" ou "returnwindow"Flottes qui rentreraient pendant la veille : ne pas envoyer, envoyer quand même, faire rentrer dans la plage de retour
AnticipateDelaystrue ou falseAnticiper les retards d'expédition
HandleNightReturnstrue ou falseGérer les retours de flotte pendant la veille
StayAwakeIfMainFleetHometrue ou falseNe pas passer en veille si la main flotte est restée à quai (onglet Sortie de flotte)
Timezone"machine", "game" ou un fuseau comme "Europe/Paris"Fuseau horaire du robot

Un jour :

ChampType et bornesÀ l'écran
From, Toheure, "23:30"Première plage
From2, To2heure, ou "" pour aucune ; les deux ensembleSeconde plage (facultative)
ReturnFrom, ReturnToheure, ou "" ; les deux ensembleFlotte rentrée entre (plage de veille 1), onglet Sortie de flotte
ReturnFrom2, ReturnTo2heure, ou "" ; les deux ensembleFlotte rentrée entre (plage de veille 2)

SetSleepSchedule pose les plages, pas le mode. Le jour s'écrit en anglais ("monday"), par son rang de Now().Weekday() (0 pour dimanche), ou "everyday" pour les sept jours, comme « Chaque jour pareil » : les fourchettes de retour de chaque jour restent ce qu'elles sont. Sans seconde plage, le jour n'en a plus. Le planning ne sert qu'en mode automatique : SetSleepModeConfigs({"Mode": "auto"}).

SetSleepSchedule("everyday", "23:30", "07:00")
SetSleepSchedule("saturday", "01:30", "10:00")
err = SetSleepModeConfigs({"Mode": "auto", "SleepJitter": 15, "BeforeSleep": "returnwindow"})
if err != nil {
	LogWarn("veille refusée : " + err.Error())
}

La sortie de flotte pour la nuit

FonctionRend
GetFleetSaveConfigs()1 : une tableLes réglages de la sortie de flotte pour la nuit (Fleet Save) et son tableau des célestes.
SetFleetSaveConfigs(cfg)1 : une erreurEnregistre les champs donnés.
ChampType et bornesÀ l'écran
OnSleeptrue ou falseSortir la flotte à la mise en veille
From, Toheure, "08:00"Plage fixe, ou heure de rentrée
From2, To2heure, ou "" pour aucune ; les deux ensembleFlotte rentrée entre (plage de veille 2)
AtWaketrue ou falseRentrer au réveil
WakeFrom, WakeTominutes après le réveil, de 0 à 1440, le premier plus petitEntre … et … minutes après le réveil
DeuteriumToLeaveentier, 0 et plus ; nil : jamais réglé, 10 000Deutérium à laisser sur place
ProductionMinutesMin, ProductionMinutesMaxminutes, de 0 à 1440, le premier pas plus grandMinutes de production laissées sur les planètes
SplitDelayMin, SplitDelayMaxsecondes, de 1 à 600 ; 0 et 0 : cinq à dixÉcart entre deux départs d'un découpage
MainFleetAlwaystrue ou falseGhost la main flotte dans tous les cas
Celestialsliste de lignesOnglet Célestes

Une ligne du tableau des célestes :

ChampType et bornesÀ l'écran
CelestialcélesteDésigne la ligne ; un céleste sans ligne en reçoit une
Activetrue ou false, avec une destinationSortir
Destination"park", "emptytomoon", "spy16", "spy16recall", "expedition", "expeditions", "colonize", "debris" ou ""Destination : stationner, vider la planète sur sa lune, espionner la position 16, la même rappelée en vol, expédition, expéditions (tous les slots), coloniser, récolter un champ de débris
Targetcéleste, ou nil : le robot choisit ; avec "park"Céleste visé
Remainder"park", "spy16", "spy16recall", "colonize", "debris" ou "" ; après une expéditionReste de la flotte
RemainderTargetcéleste, ou nil ; avec Remainder "park"Céleste visé par le reste
Expeditionsentier, de 0 à 25Nombre d'expéditions
ExpeditionSheetUUID d'une composition, ou ""Composition d'expédition
KeepShipstable {vaisseau: nombre} ; avec "emptytomoon"À quai
Splittrue ou falseDécouper

DeuteriumToLeave garde son zéro : 0 laisse zéro au sol, nil remet la case à « jamais réglé », qui se lit 10 000. Une ligne du tableau se désigne par son céleste, et les lignes que la liste ne nomme pas restent telles quelles. GetFleetSaveReturn et ses deux voisines (voir Workers) règlent les mêmes heures de rentrée.

f = GetFleetSaveConfigs()
for line in f.Celestials {
	if line.Destination == "spy16" {
		line.Destination = "spy16recall"
	}
}
f.DeuteriumToLeave = 0
err = SetFleetSaveConfigs(f)
if err != nil {
	LogWarn("sortie de nuit refusée : " + err.Error())
}

Le Rapatriement

FonctionRend
GetRepatriateConfigs()1 : une tableLes réglages de l'onglet Rapatriement.
SetRepatriateConfigs(cfg)1 : une erreurEnregistre les champs donnés.
SetRepatriateDestinations(célestes)1 : une erreurLes banques, plusieurs à la fois, sans toucher aux célestes à vider.
ChampType et bornesÀ l'écran
Mode"direct", "moon" ou "collect"Mode : normal, lune, collecte
EveryHoursheures, de 1 à 168Rapatrier toutes les
SendDelayMin, SendDelayMaxsecondes, 2 et plus, le premier pas plus grandDélai entre deux transports
Destinationsliste de célestesDestinations (les banques)
Originsliste de célestesPlanètes et lunes à rapatrier
Resources, Shipstrue ou falseQue rapatrier : les ressources, les vaisseaux
KeepShipsPlanet, KeepShipsMoontable {vaisseau: nombre} ; 0 retireVaisseaux à garder sur la planète, sur la lune
LeavePlanet, LeaveMoontable Metal, Crystal, Deuterium, 0 et plusLaisser sur la planète, sur la lune
Cargo"LargeCargo", "SmallCargo" ou "Pathfinder"Vaisseau de fret
Cargo2, Cargo3les mêmes, ou "" pour aucunDeuxième et troisième type
RoundShips0, 10, 100, 1000 ou 10000Arrondir les vaisseaux à
MinResourcesentier, 0 et plusRessources minimales pour rapatrier
MaxSlotsentier, de 0 à 100Paramètres > Slots de flotte > Rapatriement

Les refus de l'écran, worker allumé : une banque au moins, un céleste à vider au moins, et les ressources, les vaisseaux ou les deux. Une table de vaisseaux se fusionne vaisseau par vaisseau : {LARGECARGO: 100} ne change que les grands transporteurs, {LARGECARGO: 0} les retire.

SetRepatriateDestinations(["M:1:105:8", "M:4:220:9"])
err = SetRepatriateConfigs({"Mode": "moon", "KeepShipsPlanet": {LARGECARGO: 100}, "LeaveMoon": {"Deuterium": 2000000}})
if err != nil {
	LogWarn("rapatriement refusé : " + err.Error())
}

La Distribution

FonctionRend
GetDistributionConfigs()1 : une tableLes réglages de l'onglet Distribution.
SetDistributionConfigs(cfg)1 : une erreurEnregistre les champs donnés.
ChampType et bornesÀ l'écran
Banksliste de célestesBanques qui envoient
Destinationsliste de célestesDestinations qui reçoivent
Metal, Crystal, Deuteriumentier, 0 et plus, par destinationDotation
FillUptrue ou falseCompléter chaque destination jusqu'à ces quantités, au lieu de les envoyer
MinSendentier, 0 et plusEnvoi minimum
Cargo"LargeCargo" ou "SmallCargo"Vaisseau de fret
ShipsToStationentier, 0 et plusVaisseaux à stationner par destination
Autotrue ou falseCompléter automatiquement
BelowMetal, BelowCrystal, BelowDeuteriumentier, 0 et plus, sous sa quantité quand Auto est cochéEn dessous de
CheckEveryMin, CheckEveryMaxminutes, de 10 à 240, le premier pas plus grandVérifier toutes les
MaxSlotsentier, de 0 à 100Le plafond du Rapatriement, partagé

Le plafond de slots est celui du Rapatriement, le même onglet : l'écrire ici le change là.

err = SetDistributionConfigs({"Deuterium": 20000000, "FillUp": true, "Auto": true, "BelowDeuterium": 5000000})
if err != nil {
	LogWarn("distribution refusée : " + err.Error())
}

Les Récompenses et le booster

FonctionRend
GetRewardsConfigs()1 : une tableLes réglages de la page Récompenses et booster, une table par onglet.
SetRewardsConfigs(cfg)1 : une erreurEnregistre les champs donnés.
ChampType et bornesÀ l'écran
DailyMissionstrue ou falseFaire les missions du jour
AllowDarkMattertrue ou falseAntimatière autorisée pour les missions
MissionsCelestialcéleste, "home", ou nil pour tousLieu des missions
Messagesliste de textes d'une ligne, 20 au plus, 100 caractères chacun ; vide : la liste par défautMessages de la mission « Envoyez un message en jeu »
Boostertable, ci-dessousOnglet Booster
Auctiontable, ci-dessousOnglet Commissaire-priseur
OfferOfTheDaytable : Active, Origin, ResourceOnglet Import/export
Asteroidtable, ci-dessousOnglet Farm event P17

Booster :

ChampType et bornesÀ l'écran
Activetrue ou falseGarder les boosters allumés
Buytrue ou falseAcheter avec l'antimatière le booster qui manque
Accounttable {genre: palier} : "booster:expedition", "computer:expedition"Booster du compte
Stackstable {genre: liste de paliers} : "slots:expedition" (1, 2, 3), "slots:fleet" (2, 4, 6)Slots d'expédition et de flotte, paliers cumulés
AllPlanetstable {genre: palier} : "booster:metal", "booster:crystal", "booster:deuterium", "booster:energy", "booster:resources"Ligne « Toutes les planètes »
Planetsliste de {"Planet": planète, "Choices": {genre: palier}} ; nil rend un genre à « Comme toutes »Une ligne par planète qui fait exception
Daystable {genre: 7, 30 ou 90}, ce que la boutique vendDurée d'achat

Un palier est celui de la boutique (40 pour +40 %), 0 pour aucun, -1 pour « Meilleur disponible » hors des slots.

Auction :

ChampType et bornesÀ l'écran
Activetrue ou false, avec une origineEnchérir au commissaire-priseur
Origincéleste ou "home"Enchérir depuis
Resource"metal", "crystal" ou "deuterium"Payer en
MaxBidstable {objet: mise} ; négative : objet décoché, mise gardée ; 0 ou nil retireMise maximale par objet
DelayMin, DelayMaxsecondes, 1 et plus, le premier pas plus grandDélai avant de répondre à une surenchère
OnlyAtEndtrue ou falseEnchérir seulement sur la fin
MinutesBeforeEndminutes, de 1 à 30Entrer dans la vente
LastSecondtrue ou falseOffre à la dernière seconde
SpareIgnoredtrue ou falseNe jamais surenchérir sur un joueur épargné

Les objets de MaxBids sont ceux de l'écran : "booster:metal:40", "booster:energy:80", "kraken:1d", "newtron:6h", "detroid:30m"…

Asteroid :

ChampType et bornesÀ l'écran
Activetrue ou false, avec une origineAttaquer l'astéroïde de l'événement
Origincéleste ou "home"Partir depuis
Shipun vaisseau qui vole, sauf colonisation et étoile de la mortVaisseau envoyé
Slotsentier, de 1 à 20Slots de flotte attribués

Les deux cases qui dépensent de l'antimatière s'écrivent comme les autres : le robot n'en dépense jamais de lui-même, un script le peut.

err = SetRewardsConfigs({
	"Booster": {"Active": true, "Stacks": {"slots:fleet": [2, 4]}, "AllPlanets": {"booster:metal": -1}},
	"Auction": {"MaxBids": {"kraken:1d": 9000}},
})
if err != nil {
	LogWarn("booster refusé : " + err.Error())
}

Les slots des envois de script

FonctionRend
SetMaxSlotsFor(initiateur, n)1 : une erreurPlafonne les vols en l'air d'un initiateur, un nom que le script choisit : de 0 (pas de plafond à lui) à 100.
GetSlot(initiateur)1 : un canalAttend un slot de flotte libre pour l'initiateur, réserve du compte comptée ; le canal livre une fonction à appeler avec la flotte partie.
CreateFleet(flotte, initiateur)1 : une erreurInscrit une flotte déjà partie sous un initiateur : elle compte pour son plafond jusqu'à son retour.

Comme chez Ninja, pour qu'un script qui envoie lui-même ne prenne pas tous les slots du compte. GetSlot attend tant que l'initiateur tient autant de vols que son plafond, ou que le compte n'a plus de slot libre au-delà de la réserve (Paramètres > Slots de flotte) ; l'attente se lit sur cette page, sous le nom du script. La fonction livrée se donne la flotte partie, ou son identifiant ; une flotte vide, celle d'un envoi refusé, rend le slot. Un slot accordé dont la flotte n'est jamais rendue se libère au bout de cinq minutes.

Un initiateur n'est pas un worker : un nom de worker est refusé, son plafond est le champ MaxSlots de ses réglages. Les plafonds vivent en mémoire, partagés par les scripts du compte, et se reposent au démarrage du script.

SetMaxSlotsFor("raids", 3)
for target in ["2:40:6", "2:41:7", "2:43:4"] {
	slot = <-GetSlot("raids")
	f = NewFleet()
	f.SetOrigin("M:1:105:8")
	f.SetDestination(target)
	f.SetMission(ATTACK)
	f.AddShips(LARGECARGO, 200)
	fleet, err = f.SendNow()
	slot(fleet)
}