GBELY

V katastri vymysleného mesta Gbely po sto rokoch objavili pracovníci skrachovaných Hornonitrianskych baní Prievidza ropu. Veľa ropy! Dokonca ju rovno začali ťažiť. Ako správny energokapitalista si rozhodnutý tento vzácny nerast od neschopných baníkov oslobodiť.

V ceste ti však stojí gbelské mestské zastupiteľstvo, ktoré na poslednú chvíľu za dotácie od VÚC nakúpilo armádu čínskych humanoidných robotov a je rozhodnuté ťažbu vo svojom katastri prebrať pod vlastnú réžiu.

Klin sa klinom vybíja a AI roboti sa AIčkou porážajú. Susedné mesto Kúty ti na pomoc nečakane ponúklo milovanú vlakovú stanicu, ktorú využiješ ako základňu pre svoju vlastnú AI armádu.

Naprogramuj armádu AI robotov, vyžeň z gbelského katastra Hornonitrianske bane a zachráň ropu pred skorumpovaným gbelským mestským zastupiteľstvom, ktoré by zisk z nej prehajdákalo na automatoch v šenku.

Každý účastník odovzdá agenta, svoju AI armádu, ktorá hrá vlastnú, nezávislú partiu proti tej istej vstavanej AI, Gbelskému mestskému zastupiteľstvu a jeho čínskym humanoidným robotom, na tom istom území: gbelskom katastri.

Poradie určuje jednoduchá metrika: koľko percent gbelského katastra AI armáda na konci ovláda, teda koľko ropy sa podarilo oslobodiť.

Šablóna my_agent.py nie je prázdna: obsahuje jednoduchého agenta, ktorý odohrá celý zápas, takže prvé číslo dostaneš bez toho, aby si napísal riadok — a vidíš na ňom, ako sa rozhodovanie zapisuje. Hrá zámerne naivne; útočí na najslabšieho suseda každého poľa a nič neplánuje, takže je to základ na prekonanie, nie kostra na doplnenie. Stiahneš si SDK, rozbalíš ho a doma si na ňom agenta vyladíš alebo natrénuješ, ako uznáš za vhodné. Do súťaže potom odovzdáš jeden Python súbor s funkciou decide(stav) — telo rozhodovania, nič viac. Počas behu agent nesmie volať žiadne externé API; rozhoduje výlučne tým, čo je v tom súbore. Jeden leaderboard, jedno finále, všetci za rovnakých podmienok.

Súťaž je o tom, ako dobre tvoj kód hrá proti Zastupiteľstvu — a vo finále proti jeho finálovej podobe, na inej mape a spolu so siedmimi ďalšími armádami (§ 09).

Gbelský kataster je štvorcová mriežka 60 × 60 polí (3 600 políčok), rovnaká pre všetkých (beh je plne reprodukovateľný). Tri typy terénu: lúka (ropné polia, vyššia produkcia jednotiek), vrch (obranný bonus, pomalší presun jednotiek) a rieka (hraničné pole, na prekonanie treba viac síl). Neobsadené polia majú vlastnú posádku ťažobných robotov Hornonitrianskych baní (1 – 8 jednotiek podľa hodnoty polohy), ktorú treba pri obsadení prekonať.

Priechodnosť je podiel presúvanej kolóny, ktorý na pole dorazí ešte v tom istom kole (§ 04, MOVE). Zvyšok sa nestráca — ostáva na pôvodnom poli a pokračuje ďalšie kolo, takže presun armády cez vrch jednoducho trvá dlhšie. Domovská základňa produkuje navyše pevný bonus +5 jednotiek za kolo. Jednotky investované cez FORTIFY (§ 04) sa menia na trvalú obranu v pomere 0,3 — jedna jednotka teda kúpi 0,3 obrany. Keďže tá istá jednotka v posádke dávala obranu v pomere terénneho bonusu z tabuľky vyššie, je to výmena so stratou; prečo, rozoberá § 04.

AI armáda aj Gbelské mestské zastupiteľstvo štartujú zo svojej domovskej základne v protiľahlých rohoch katastra — tvoja AI armáda z vlakovej stanice v Kútoch, mestské zastupiteľstvo z mestského úradu Gbely. Obe strany začínajú s jedným poľom a 10 jednotkami na ňom. Pole základne je vždy lúka a nemá vlastnú posádku, ktorú by bolo treba najprv prekonať. Kataster je symetrický voči otočeniu o 180° — terén aj posádky neobsadených polí vyzerajú od jednej základne presne tak ako od druhej, takže z rohu, ktorý ti pripadol, neplynie žiadna výhoda ani nevýhoda. Bonus základne patrí poľu, nie strane: kto ho práve drží, ten ho aj inkasuje, takže dobytie súperovej základne mu tých +5 za kolo zoberie a pripíše tebe.

Zastupiteľstvo nie je náhodné: má pevnú, deterministickú stratégiu o štyroch častiach — rozumne expanduje k slabším susedným poliam, presúva jednotky zo zázemia na front, občas sústredí robotov niekoľkých polí na jeden výpad a ohrozené hranice zakopáva opevnením. Tá druhá časť je na ňom to podstatné: produkcia vzniká na celom území, ale konať vedia len hraničné polia, takže súper, ktorý svoju armádu nepresúva, bojuje zlomkom svojich síl.

Sú dve mapy a hráš na oboch. Tréningová mapa je verejná: dostaneš ju v SDK, beží na nej leaderboard počas celého testovacieho obdobia, a keďže je pre všetkých rovnaká a plne reprodukovateľná, svoj výsledok si vieš doma zopakovať do posledného políčka.

Boj o gbelskú ropu trvá 150 kôl, prípadne skončí skôr, ak jedna strana stratí všetky polia. Každé kolo:

1. Produkcia — každé ovládané pole vyprodukuje jednotky podľa svojho typu (lúka najviac, vrch menej ale s obranným bonusom), domovská základňa navyše pevný bonus.
2. Príkazy — agent v jednom kroku odošle ľubovoľný počet príkazov naraz.
3. Vyhodnotenie — presuny, obsadzovanie a útoky sa spočítajú podľa pravidiel v § 06.

Produkcia prebehne skôr, než engine požiada strany o príkazy, takže obe rozhodujú nad tou istou doskou, na ktorej sa bude aj konať.

Príkazy sa vyhodnocujú po stranách, nie úplne súčasne. Ak by obe strany v tom istom kole mierili na to isté pole, rozhodne poradie — a to sa strieda podľa čísla kola, aby z neho ani jedna strana nemala trvalú výhodu.

Engine posiela na začiatku kola stav viditeľného územia, agent odpovedá zoznamom príkazov — pevný JSON formát, žiadny voľný text.

Vstup enginu → agent (skrátené)

{
  "kolo": 42,
  "moja_zakladna": "P57_02",
  "moje_pola": [
    { "id": "P12_07", "typ": "luka", "jednotky": 14, "opevnenie": 1,
      "susedia": ["P11_07", "P13_07", "P12_06", "P12_08"] },
    { "id": "P13_07", "typ": "vrch", "jednotky": 6, "opevnenie": 2,
      "susedia": ["P12_07", "P14_07", "P13_06", "P13_08"] }
  ],
  "viditelne_susedne_pola": [
    { "id": "P14_07", "vlastnik": "hbp", "posadka": 5, "opevnenie": 0, "typ": "luka" },
    { "id": "P12_08", "vlastnik": "zastupitelstvo", "posadka": 9, "opevnenie": 3, "typ": "rieka" }
  ]
}

• susedia vymenúva všetky susedné polia daného poľa — vlastné aj cudzie. Cudzie z nich nájdeš vo viditelne_susedne_pola, vlastné vo moje_pola. Bez tejto väzby by agent nevedel, ktoré jeho pole s ktorým cieľom susedí, a vedel by za kolo konať len z jedného poľa.
• posadka je surový počet jednotiek, nie hotová obrana — terénny bonus si agent doplní sám podľa § 06. Počty jednotiek aj opevnenie sú desatinné čísla, nie celé: priechodnosť vrchu (0,6) a účinnosť opevnenia (0,3) z § 02 zlomky vyrábajú. Na vstupe sú zaokrúhlené na jedno desatinné miesto; príklady vyššie sú kvôli čitateľnosti celé.
• opevnenie je viditeľné aj na cudzích poliach, inak by obranu z § 06 nebolo možné dopočítať a útok by bol lotéria.
• moja_zakladna je bežné id poľa, na ktorom základňa stojí — dá sa teda použiť v príkazoch ako ktorékoľvek iné vlastné pole.
• kolo sa počíta od nuly: prvé kolo zápasu je 0, posledné 149. Je to zároveň to isté číslo, podľa ktorého sa v § 03 strieda poradie vyhodnotenia — pri párnom kolo sa tvoje príkazy vyhodnotia skôr než príkazy Zastupiteľstva, pri nepárnom neskôr. Dá sa to teda dopočítať, netreba hádať.
• Vidíš len vlastné polia a to, čo s nimi bezprostredne susedí; zvyšok katastra ostáva zahalený.

Agent → engine, príkazy pre dané kolo

{
  "prikazy": [
    { "typ": "MOVE",    "z": "P12_07", "na": "P13_07", "pocet": 5 },
    { "typ": "ATTACK",  "z": "P13_07", "na": "P12_08", "pocet": 6 },
    { "typ": "FORTIFY", "pole": "P12_07", "investicia": 3 }
  ]
}

Výpočet je deterministický — žiadna kocka, žiadne šťastie, len čísla (dôležité pre reprodukovateľnosť a ladenie):

Nerovnosť je ostrá: pri obrane presne 9 útok so silou 9 neuspeje, treba 10. Najlacnejšia víťazná sila je teda floor(obrana) + 1. Pozor na to pri zaokrúhľovaní — útok, ktorý skončí čo i len o jednotku nižšie, nie je „skoro úspešný", ale úplná strata všetkých vyslaných jednotiek.

Keďže neúspešný útok zníži obranu presne o svoju silu, je jedno, či pole napadneš jedným veľkým útokom alebo viacerými menšími z rôznych polí — súčet potrebnej sily je rovnaký. Sústredený výpad viacerých polí na jeden cieľ teda nič nestojí navyše.

Hlavné poradie určuje percento gbelského katastra (a teda oslobodenej ropy), ktoré agent ovláda na konci 150. kola (alebo pri úplnej eliminácii Mestského zastupiteľstva skôr) na referenčnej mape z § 02.

Pri rovnakom skóre rozhoduje rýchlosť — kto svoj podiel dosiahol skôr, je vyššie. Berie sa kolo, v ktorom agent svoj konečný podiel dosiahol prvýkrát; územie mení majiteľa opakovane, takže záleží na tom, kedy tú hranicu prekročil, nie kedy ju držal naposledy. Leaderboard toto kolo pri každom agentovi zobrazuje, aby bolo poradie vysvetliteľné.

Agent, ktorý bol na referenčnej mape diskvalifikovaný (§ 08), nemá skóre a na leaderboarde nie je. Keďže sa hodnotí jediná mapa, niet čo priemerovať a niet sa o čo oprieť — stav submissionu aj dôvod nájdeš na svojej stránke stavu, na ktorú ťa odovzdanie presmeruje a ktorej odkaz je aj v e-maile s výsledkom.

Čo sa stane, keď agent zlyhá

Kolo, v ktorom agent neodpovie do 2 s, spadne alebo pošle niečo, čo sa nedá prečítať, sa počíta ako porušenie: stratí príkazy toho jedného kola, nie zápas — engine pokračuje, akoby neposlal nič. Agenta judge reštartuje a pýta sa ďalej. Až štvrté porušenie na tej istej mape tú mapu ukončí a agent je na nej diskvalifikovaný. Ako sa diskvalifikovaná mapa premietne do skóre, hovorí § 07.

Jednotlivý chybný príkaz nie je porušenie — príkaz s neznámym typom, neexistujúcim poľom alebo nezmyselným počtom sa jednoducho zahodí a zvyšok kola sa vyhodnotí normálne.

Izolácia a fair play

• Agent beží vo vlastnom procese, ktorý nemá referenčnú implementáciu Zastupiteľstva ani engine k dispozícii — vidí len to, čo mu judge pošle na vstup podľa § 05, a ovplyvniť zápas vie len tým, čo pošle späť. Proces nedostáva žiadne poverenia a v hostenom prostredí beží v sieti bez cesty von, takže „žiadny sieťový prístup“ je vynútený infraštruktúrou, nie dôverou.
• Zámerné využívanie chýb enginu je zakázané — nahláste ich cez bug-bounty kanál (odmena mimo súťažných cien).
• Kód musí byť pôvodná práca tímu. Pred finálovým behom prebehne krátky code review u postupujúcich.
• Jedna prihláška na osobu/tím. Identitu určuje overená e-mailová adresa: každý ďalší submit z tej istej adresy prepíše ten predchádzajúci, takže platí posledná odovzdaná verzia. Aktualizovať sa dá kedykoľvek do uzávierky z § 09; po nej systém nový upload neprijme a to, čo si mal odovzdané v momente uzávierky, ostáva.

Ako finále prebieha

Leaderboard je súboj jedného agenta proti Zastupiteľstvu. Finále nie je. Všetkých osem finalistov stojí naraz na jednej mape, každý vo svojom rohu, a Zastupiteľstvo drží stred. Nehráte proti sebe — hráte spolu proti nemu, no hodnotí sa podiel katastra, ktorý oslobodil práve tvoj agent. Kto ukrojí najviac, vyhráva (§ 10).

To má jeden dôsledok pre § 05, s ktorým treba počítať pri ladení. V poli vlastnik sa okrem hbp, zastupitelstvo a armada (ty) môže objaviť aj armada_2 až armada_8 — pole iného finalistu. Číslo za podčiarkovníkom je poloha voči tebe, nie identita konkrétneho finalistu: každý z ôsmich vidí svojich sedem súperov ako armada_2 až armada_8, takže to isté číslo znamená pre dvoch finalistov dvoch rôznych ľudí. Nedá sa naň teda nič viazať — a netreba, lebo všetci ostatní finalisti sú pre teba rovnako nedotknuteľní. Ak si agenta píšeš tak, že všetko, čo nie je tvoje a nie je hbp, považuje za nepriateľa, vo finále bude plytvať príkazmi na spojencov. Rozhodujúci test je vlastnik == "zastupitelstvo", nie „nie je moje".

Finálová mapa je väčšia než tréningová — musí sa na ňu zmestiť deväť strán namiesto dvoch. Formát identifikátorov polí sa nemení: ostáva presne ten z § 05 (P07_12), takže agent, ktorý ich parsuje, funguje bez úpravy. Zvyšok pravidiel — produkcia, presuny, boj z § 06, limit 2 s na kolo a tolerancia porušení z § 08 — platí nezmenený.

• Celkový víťaz (najvyššie % oslobodeného gbelského katastra vo finálovom behu proti posilám z VÚC) — hlavná cena, vstupy na VýťahConf, balík Panaxeo merchu.
• Druhé a tretie miesto vo finálovom behu — elektro poukaz.
• Bleskové víťazstvo — úplná eliminácia Zastupiteľstva v najnižšom kole počas testovacieho obdobia, na referenčnej mape — špeciálna cena. Pozor, nie je to to isté ako 100 % katastra: obsadením posledného poľa Zastupiteľstva sa zápas končí (§ 03), takže neutrálne polia Hornonitrianskych baní, ktoré v tej chvíli ešte stoja, už nikto nezoberie — a cena viazaná na celý kataster by nebola náročná, ale nedosiahnuteľná. Vyhodnocuje sa oddelene od hlavného poradia; nie je to pozícia na leaderboarde.
• Najlepší nováčik (menej než 2 roky praxe v IT) — ročné predplatné kurzov Skillmea.

Prihlásenie, SDK a presné znenie API budú zverejnené na panaxeo.com/coding-arena-26 pri spustení registrácie. Presné hodnoty vyváženia (produkcia podľa terénu, sila Zastupiteľstva) sa môžu do spustenia registrácie ešte doladiť; § 02 uvádza tie, ktoré platia dnes.