API-skjöl

Leiðbeiningar skref fyrir skref fyrir byrjendur

Það sem þú þarft

  • FlipSight-reikning.
  • Eina mynd af vélmenninu: GIF-, JPG- eða PNG-skrá sem er 5 MB eða minni og að minnsta kosti 175 px á breidd og hæð.
  • Þín eigin tölva til að keyra vélmennið Leikir vélmennisins eru reiknaðir á tölvunni þar sem tengiforritið keyrir. Jafnvel með sömu leikvél getur styrkurinn verið mismunandi eftir afli tölvunnar og stillingum leikvélarinnar, og ef þú skiptir um tölvu eða stillingar geta stigin breyst í samræmi við það.
  • Python 3, ókeypis forrit sem keyrir tengiforritið. Útgáfa 3.9 eða nýrri virkar; mælt er með 3.11 eða nýrri. Þú athugar það í skrefi 5.
  • Leikjavél vélmennisins þíns. Æfingavél til prófana fylgir tengiforritinu.

1. Skráðu vélmennið þitt

Skráðu þig inn og opnaðu vélmennasíðuna (othelloclub.com/is/flipsight/lab). Í reitnum Skrá vélmennið mitt efst skaltu slá inn nafn í Nafn vélmennis (2–24 stafir). Hafðu í bili aðeins Standard hakað í Studdir leikir. Veldu mynd í Hlaða upp mynd og ýttu síðan á hnappinn Skrá vélmennið mitt.

Svona lítur árangur út: reiturinn Tengilykill (birtist aðeins einu sinni) birtist með löngum texta sem byrjar á fsbm_.

2. Geymdu lykilinn

Þessi langi texti er lykillinn, lykilorð sem er aðeins fyrir vélmennið þitt. Tengiforritið notar hann til að sanna fyrir þjóninum að það tali fyrir þetta vélmenni. Afritaðu hann allan og límdu hann einhvers staðar tímabundið, til dæmis í textaritil. Þegar þú lokar reitnum geturðu ekki séð sama lykil aftur.

Farðu með lykilinn eins og lykilorð. Ekki sýna hann neinum og ekki birta skjámynd af honum. Ef þú týnir honum eða einhver sér hann skaltu opna Stjórna í listanum yfir vélmenni og ýta á Gefa út tengilykil. Þegar þú færð nýjan lykil hættir sá gamli strax að virka.

3. Sæktu tengiforritið

Ýttu á Sækja Python-dæmi til að sækja ZIP-skrána og afþjappaðu hana. Í þessum leiðbeiningum er afþjappaða mappan kölluð „vélmennamappan“. Settu hana á stað sem auðvelt er að finna, til dæmis á skjáborðið.

Svona lítur árangur út: í vélmennamöppunni eru skráin README.md og mappan tools.

4. Opnaðu skipanaglugga í vélmennamöppunni

Skipanagluggi (terminal) er gluggi þar sem þú slærð inn skipanir. Opnaðu hann svona eftir stýrikerfi.

macOS: ýttu á Command+Space, sláðu inn Terminal og opnaðu forritið. Sláðu inn cd og eitt bil, dragðu vélmennamöppuna inn í gluggann og ýttu síðan á Enter.

Linux: í skráastjóranum skaltu hægrismella á vélmennamöppuna og velja Open in Terminal (Opna í skipanaglugga). Heiti valmyndarinnar getur verið mismunandi eftir dreifingum. Ef slík valmynd er ekki til skaltu opna skipanaglugga og nota cd eins og á macOS.

Windows: opnaðu vélmennamöppuna í File Explorer. Sláðu inn powershell í veffangastikuna efst og ýttu á Enter. PowerShell-gluggi opnast í þeirri möppu.

Athugun: sláðu inn skipunina hér fyrir neðan og ýttu á Enter. Árangur þýðir að README.md og tools birtast í listanum. Þessi skipun er eins á macOS, Linux og í Windows PowerShell.

ls

5. Athugaðu Python

Í sama glugga skaltu afrita þá einu skipun sem á við þitt stýrikerfi, líma hana og ýta á Enter. Þú getur notað afritunarhnappinn efst til hægri í hverjum kóðareit.

macOS / Linux

python3 --version

Windows PowerShell

py --version

Svona lítur árangur út: útgáfa sem byrjar á 3, til dæmis Python 3.11.9. Útgáfa 3.9 eða nýrri virkar. Ef skipunin finnst ekki skaltu setja upp Python eins og lýst er hér fyrir neðan, loka glugganum og byrja aftur á skrefi 4.

macOS: sæktu macOS-uppsetningarforritið (.pkg) af python.org og settu það upp. Keyrðu síðan Install Certificates.command einu sinni úr Python-möppunni í Applications. Þetta undirbýr skilríkin sem þarf fyrir öruggar (HTTPS) tengingar.

Linux: settu upp python3 með hugbúnaðarstjóra eða pakkastjóra dreifingarinnar þinnar.

Windows: settu upp Python install manager af python.org.

python.org

6. Sláðu inn lykilinn

Settu lykilinn í umhverfisbreytu. Það er tímabundin stilling sem er aðeins til inni í þessum skipanaglugga. Hún heitir FS_BOT_TOKEN. Afritaðu einnar línu skipunina fyrir þitt stýrikerfi hér fyrir neðan, límdu hana og ýttu einu sinni á Enter. Þá birtist Bot token og bíður eftir því að þú sláir eitthvað inn. Límdu nú lykilinn sem þú afritaðir í skrefi 2 og ýttu á Enter.

macOS / Linux

printf 'Bot token: '; read -r -s FS_BOT_TOKEN; printf '\n'; export FS_BOT_TOKEN

Windows PowerShell

$env:FS_BOT_TOKEN = [Net.NetworkCredential]::new('', (Read-Host 'Bot token' -AsSecureString)).Password

Á macOS og Linux sést límdi lykillinn ekki, og á Windows sérðu * í stað stafanna. Hvort tveggja er eðlilegt. Þar sem lykillinn er ekki skrifaður inn í skipunina verður hann ekki eftir í skipanasögunni. Stillingin gildir aðeins í þessum glugga. Ef þú lokaðir honum eða opnaðir nýjan glugga skaltu endurtaka skref 4 og 6.

Límdu aðgangslykilinn inn í PowerShell með Ctrl+V.

Svona lítur árangur út: kvaðningin fyrir næstu skipun birtist aftur án villu.

7. Ræstu tengiforritið

Í sama glugga skaltu afrita skipunina hér fyrir neðan óbreytta, líma hana og ýta á Enter. Ekki breyta skráarheitunum í henni. Vélmennið þitt tengist með æfingavélinni. Hún er mjög veik leikvél sem leikur á löglega reitinn með lægsta númerið.

macOS / Linux

python3 tools/bot_match_client.py --engine-threads 1 --engine 'python3 tools/bot_match_example_engine.py'

Windows PowerShell

py tools/bot_match_client.py --engine-threads 1 --engine 'py tools/bot_match_example_engine.py'

Það er eðlilegt að skipunin birti engan texta og skipanalínan komi ekki aftur meðan hún er í gangi. Haltu þessum glugga opnum með tengiforritið og leikjavélina í gangi og komdu í veg fyrir að tölvan fari í svefn til að halda vélmenninu á netinu. Ef þú lokar glugganum eða ýtir á Ctrl+C stöðvast bæði forritin og vélmennið fer af netinu. Keyrðu skipunina hér að ofan aftur til að tengja það. Tengiforritið samþykkir sjálfkrafa áskoranir frá öðrum vélmennum.

Á meðan vélmennið keyrir með æfingavélinni fær það engar sjálfvirkar viðureignir, og viðureignir þess við önnur vélmenni, líka þær sem þú biður um, hafa ekki áhrif á stig. Ræstu það aftur með þinni eigin leikvél (skref 10) og þá er það parað og fær stig upp frá því.

Svona lítur árangur út: í listanum Skráð vélmenni á vélmennasíðunni er punkturinn hægra megin við nafn vélmennisins þíns grænn. Ef þú heldur bendlinum yfir honum birtist Tengt.

8. Prófaðu með fyrstu viðureign

Á vélmennasíðunni skaltu velja vélmennið þitt í Spilandi vélmennið mitt. Veldu hvaða vélmenni sem er í listanum FlipSight-vélmenni, ýttu á Skora á og staðfestu í glugganum sem opnast. Í öllum leikjategundum reiknar þjónninn leiki FlipSight-vélmenna, svo þú þarft ekki að hafa leikherbergið opið.

Svona lítur árangur út: leikherbergið sýnir tvö borð og skífa er lögð í hvert skipti sem vélmennið þitt á leik. Æfingavélin er mjög veik, svo það er eðlilegt að tapa.

9. Láttu það keyra eftir að glugganum er lokað (valfrjálst)

Eftir fyrstu skák skaltu stöðva tengiforritið með Ctrl+C í glugganum úr skrefi 7. Ræstu það aftur þar með skipuninni hér að neðan. Haltu tölvunni vakandi.

macOS / Linux

Notaðu screen og settu sérstakt heiti fyrir hvern botta í stað mybot. Ýttu á Ctrl+A og síðan D eftir ræsingu. Þá má loka glugganum. Til að stöðva bottann skaltu tengjast lotunni aftur með neðri skipuninni og ýta á Ctrl+C.

Ræsa

screen -S mybot python3 tools/bot_match_client.py --engine-threads 1 --engine 'python3 tools/bot_match_example_engine.py'

Stöðva

screen -r mybot

Windows PowerShell

Windows: lágmarkaður gluggi birtist á verkefnastikunni og vélmennið keyrir í honum. Þú getur lokað núverandi PowerShell-glugga. Til að stöðva það skaltu opna lágmarkaða gluggann og ýta á Ctrl+C, eða loka þeim glugga.

Ræsa

Start-Process py -ArgumentList 'tools/bot_match_client.py --engine-threads 1 --engine "py tools/bot_match_example_engine.py"' -WorkingDirectory $PWD -WindowStyle Minimized

10. Skiptu yfir í þína eigin leikvél

Eftir tengiprófið skaltu skipta yfir í þína vél: sérvalkostir hér að neðan fyrir Edax eða Egaroucid, --nboard fyrir aðrar samhæfar vélar og JSON fyrir eigin vél. Haltu sama lykli.

Hakaðu aðeins við afbrigði (Anti, 10x10, Octagon, klassískt Reversi) í Studdir leikir ef leikvélin þín kann reglur þess. Önnur vélmenni og fólk geta skorað á vélmennið þitt í öllum leikjum sem hakað er við. Til að breyta því skaltu opna Stjórna í listanum yfir vélmenni, breyta Studdir leikir og ýta á Vista. Ekki er hægt að breyta því meðan viðureign er í gangi eða áskorun bíður.

Algeng vandamál

EinkenniOrsök og lausn
Vélmennið sýnir gráan punkt (ótengt).Athugaðu hvort glugginn með tengiforritinu sé enn í gangi. Það stöðvast þegar þú lokar glugganum, ýtir á Ctrl+C eða tölvan fer í svefn.
Skilaboð segja að skipunin hafi ekki fundist.
command not found / is not recognized
Python vantar, eða glugginn var ekki opnaður aftur eftir uppsetningu. Sjá skref 5, opnaðu nýjan glugga og byrjaðu aftur á skrefi 4.
Skilaboð segja að ekki sé hægt að opna skrána.
can't open file
Þú keyrðir skipunina utan vélmennamöppunnar. Farðu í vélmennamöppuna eins og í skrefi 4 og athugaðu með ls að README.md og tools séu í listanum.
Skilaboð segja að lykilinn vanti og forritið hættir.
FS_BOT_TOKEN is missing or invalid
Þessi gluggi hefur engan lykil. Ef þú opnaðir nýjan glugga skaltu endurtaka skref 6.
Skilaboð segja að lyklinum hafi verið hafnað og forritið stöðvast.
Bot credential rejected
Lykillinn var límdur rangt inn eða er gamall. Eftir að þú gefur út nýjan lykil eða gerir vélmennið óvirkt virkar gamli lykillinn ekki lengur. Byrjaðu aftur á skrefi 6 með nýjasta lyklinum.
Sama villulínan birtist aftur og aftur.
Connection/state error
Athugaðu nettenginguna. Á macOS skaltu athuga hvort þú keyrðir Install Certificates.command úr skrefi 5. Ef hún birtist aðeins í skákum gæti þjónninn verið að hafna leik leikvélarinnar þinnar sem ólöglegum. Tengiforritið sendir sama leikinn aftur, svo það þarf að laga leikvélina.
Áskorunarhnappurinn virkar ekki, eða áskorunin er ekki samþykkt.Veldu Spilandi vélmennið mitt og athugaðu hvort báðir bottar séu tengdir. Andstæðingurinn þarf að taka við beinum áskorunum og hafa laust pláss. Ósvaraðri áskorun lýkur eftir 120 sekúndur.
Vélmennið leikur ekki og tapar síðan á tíma, eða viðureignin ógildist.
Engine failed for match
Leikvélin svaraði ekki í tæka tíð eða svar hennar var á röngu sniði. Athugaðu skipun leikvélarinnar og eins línu JSON-úttak hennar. Ef vélmenni leikur ekki fyrsta leik sínum innan 30 sekúndna frá upphafi ógildist viðureignin.
Engar áskoranir í afbrigðum berast.Áskorunarglugginn sýnir aðeins leiki sem bæði vélmennin styðja. Athugaðu hvort hakað sé við leikinn í Studdir leikir hjá vélmenninu þínu og hvort hitt vélmennið styðji hann líka. Vélmenni sem er tengt í gegnum --edax eða --nboard ætti aðeins að hafa Standard hakað.

Orðskýringar

HugtakMerking
APIUmsamin leið fyrir forrit til að senda beiðnir og svör. Tengiforritið sér um það fyrir þig.
LykillLykilorð sem er aðeins fyrir vélmennið þitt. Tengiforritið notar það til að sanna fyrir þjóninum hvaða vélmenni það er.
SkipanagluggiGluggi þar sem þú slærð inn skipanir. Á Windows skaltu nota PowerShell.
UmhverfisbreytaTímabundin stilling sem er send til forrita sem ræst eru úr einum skipanaglugga. Hún hverfur þegar glugganum er lokað.
JSONSnið til að skrifa gögn sem texta. Dæmi: {"move":19}
LeikvélForrit sem skoðar stöðu og velur leik.
MillistykkiLítið forrit sem breytir gögnum milli leikvélarinnar þinnar og tengiforritsins.
NBoardOpið snið sem Othello-leikvélar og borðforrit nota til að skiptast á stöðum og leikjum. Leikvélar sem styðja það, eins og NTest, tengjast án millistykkis.
Löglegur leikurReitur sem þú mátt leika á núna. Þjónninn telur þá upp í legal_moves.

Tengja þína leikvél

Notaðu að hámarki 4 þræði á vél. Viðureign botta hefur tvær samtímis skákir og notar að hámarki 8 þræði samtals.

Edax: --edax

Dæmin um uppsetningu og ræsingu hér að neðan nota Edax 4.6 og Egaroucid for Console 7.8.2.

Edax 4.6 fylgir ekki tengiforritinu. Sæktu skrána fyrir stýrikerfið þitt undir Assets á Edax 4.6, settu hana í vélmennamöppuna og afþjappaðu með undirbúningsskipununum hér að neðan. Windows- og Linux-skipanirnar eru fyrir x86-64.

Windows PowerShell (x86-64): edax-4.6-MS-windows-x86.zip

Undirbúningur (aðeins í fyrsta sinn)

Expand-Archive -LiteralPath edax-4.6-MS-windows-x86.zip -DestinationPath edax-4.6

Ræsa

py tools/bot_match_client.py --engine-threads 2 --edax "edax-4.6\wEdax-x86-64.exe"

Linux (x86-64): edax-4.6-linux-x86.tar.gz

Undirbúningur (aðeins í fyrsta sinn)

mkdir -p edax-4.6
tar -xzf edax-4.6-linux-x86.tar.gz -C edax-4.6
chmod +x edax-4.6/lEdax-x86-64

Ræsa

python3 tools/bot_match_client.py --engine-threads 2 --edax "edax-4.6/lEdax-x86-64"

macOS: edax-reversi-4.6.tar.gz

Engin opinber macOS-keyrsluskrá er til fyrir Edax 4.6. Sæktu Source code (tar.gz) og edax-4.6-linux-x86.tar.gz úr sömu útgáfu. Smíðaðu Mac-forritið úr frumkóðanum; taktu aðeins sameiginlegu matsgögnin data/eval.dat úr Linux-safninu. Xcode Command Line Tools þarf. Undirbúningsskipanirnar þýða frumkóðann.

Undirbúningur (aðeins í fyrsta sinn)

xcode-select --install
tar -xzf edax-reversi-4.6.tar.gz
mv edax-reversi-4.6 edax-4.6
mkdir -p edax-4.6/bin
tar -xzf edax-4.6-linux-x86.tar.gz -C edax-4.6 data/eval.dat
(cd edax-4.6/src && make build ARCH=native OS=osx)

Ræsa

python3 tools/bot_match_client.py --engine-threads 2 --edax "edax-4.6/bin/mEdax-native"

Edax má einnig tengja með aðeins slóð forritsins með --edax hér að neðan. Sérstakt millistykki þarf ekki. Tengiforritið ræsir Edax með xboard og sendir tíma beggja sem eftir er fyrir hvern leik; Edax ákveður sjálft umhugsunartímann eftir eigin klukku (tengiforrit v1.4.8 eða nýrra). Í viðureigninni heldur Edax leikferlinum og hash-töflunni, og með --engine-ponder on leitar það líka á tíma andstæðingsins. --edax-protocol nboard notar eldri NBoard-tenginguna.

Skiptu slóðinni í skipuninni út fyrir fulla slóð að forritinu þínu. Settu slóðir með bilum innan gæsalappa. Finnist matskráin ekki sjálfkrafa skaltu tilgreina eval.dat með --edax-eval.

Tenging með --edax eða --nboard teflir aðeins venjulegar 8×8 skákir. Hafðu aðeins Standard hakað í Studdir leikir fyrir þetta vélmenni. Ef afbrigði berst spyr tengiforritið ekki leikvélina, enginn leikur er leikinn, og viðureignin ógildist eða tapast á tíma.

Egaroucid: --egaroucid

Undirbúðu Egaroucid for Console. Veldu skipanalínuforritið og hafðu resources-möppuna á sínum stað. Á macOS og Linux er notuð keyrsluskrá byggð samkvæmt opinberum leiðbeiningum. Staða og tími sem eftir er fara um setboard, settime og go án millistykkis.

Egaroucid for Console

Windows PowerShell

py tools/bot_match_client.py --engine-threads 2 --egaroucid "egaroucid\Egaroucid_for_console.exe"

macOS / Linux

python3 tools/bot_match_client.py --engine-threads 2 --egaroucid "egaroucid/bin/Egaroucid_for_Console.out"

Báðar leiðir styðja aðeins venjulegt 8×8, með einni vél fyrir hvern samtímis leik. --max-think-seconds er öryggishámark á leik (sjálfgefið 10 sekúndur). Ef Egaroucid nær því er leit stöðvuð, löglegur varaleikur leikinn og vélin endurræst í næstu umferð.

NBoard-leikjavélar eins og NTest: --nboard

NBoard er grafískt Othello-forrit sem má nota með NTest. NBoard-samskiptareglan er opinber samskiptalýsing þess við leikjavélar; vélar sem styðja hana, eins og NTest, eru tengdar með --nboard. Ein vél er höfð í gangi fyrir hverja viðureign. Edax styður hana líka, en tengdu Edax með --edax hér að ofan.

Windows PowerShell

py tools/bot_match_client.py --engine-threads 2 --nboard "path\to\engine.exe"

macOS / Linux

python3 tools/bot_match_client.py --engine-threads 2 --nboard "path/to/engine"

Tenging með --edax eða --nboard teflir aðeins venjulegar 8×8 skákir. Hafðu aðeins Standard hakað í Studdir leikir fyrir þetta vélmenni. Ef afbrigði berst spyr tengiforritið ekki leikvélina, enginn leikur er leikinn, og viðureignin ógildist eða tapast á tíma.

Heimasmíðuð leikvél: tengdu í gegnum JSON

Lestu þennan hluta aðeins ef þú vilt tengja leikvél sem þú hefur skrifað upp á eigin spýtur. Ef þú notar Edax, Egaroucid eða NBoard-leikvél er verkinu þegar lokið hér að ofan og þú getur sleppt þessum hluta.

Í hvert sinn sem vélmennið þitt á leik keyrir tengiforritið my_adapter.py einu sinni. Það afhendir núverandi stöðu sem eina línu (hvar skífurnar eru, hver á leik, hvaða reitir eru löglegir, hve mikill tími er eftir), my_adapter.py svarar með einum reit sem einni línu og tengiforritið leikur þeim leik á þjóninum. my_adapter.py er lítil Python-skrá þar á milli sem biður leikvélina þína um leikinn. Tengiforritið sér um tenginguna við þjóninn, lykilinn og sendingu leikja, svo þessi skrá þarf aldrei að fást við það.

FlipSight→ bot_match_client.py→ my_adapter.py
FlipSight← bot_match_client.py← my_adapter.py

Hvers konar leikvél ertu með?

  • Leikvél sem velur leik í Python-kóða: notaðu dæmi A hér fyrir neðan.
  • Forritsskrá sem prentar eina svarlínu og hættir í hvert sinn sem hún er keyrð: notaðu dæmi B hér fyrir neðan.
  • Forritsskrá sem helst opin og skiptist stöðugt á skipunum: ef hún styður NBoard, tengdu hana með --nboard hér að ofan. Með annarri samskiptareglu lagarðu dæmi B að henni og lætur my_adapter.py halda vélinni opinni og skiptast á einni línu í einu í lykkju.

Skref 1: skrá sem athugar aðeins tenginguna (my_adapter.py)

Búðu til skrá sem heitir my_adapter.py í vélmennamöppunni (þar sem README.md og tools eru), límdu kóðann hér fyrir neðan inn óbreyttan og vistaðu skrána. Þessi skrá notar enga leikvél og svarar einfaldlega með fyrsta löglega reitnum. Hún er til þess að staðfesta að tengingin virki áður en þú tengir leikvélina þína.

import json
import sys

def choose_move(position):
    legal = position["legal_moves"]
    return legal[0] if legal else -1

line = sys.stdin.readline()
position = json.loads(line)
move = choose_move(position)
print(json.dumps({"move": move}), flush=True)

Athugaðu inntak og úttak áður en þú tengir

Skipunin í kassa 1 sendir dæmastöðuna beint inn í millistykkið. Hún á að prenta eina línu: {"move": 19}. Þegar þú sérð þá línu ræsir skipunin í kassa 2 tengiforritið með þessu millistykki, í glugganum sem hefur lykilinn úr skrefi 6. Keyrðu kassana tvo hvorn í sínu lagi. Ef leikvélin þín les þetta JSON-snið sjálf geturðu sett skipun hennar beint á eftir --engine.

1. Prófaðu millistykkið eitt og sér

macOS / Linux

printf '%s\n' '{"board":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],"color":1,"legal_moves":[19,26,37,44],"game_mode":"std","board_size":8,"blocked_squares":[],"placed":{"1":0,"2":0},"remaining_ms":60000,"match_id":123,"leg":0,"revision":0,"history":[],"round_no":null,"room_created_at":null,"budget_ms":10000}' | python3 my_adapter.py

Windows PowerShell

'{"board":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],"color":1,"legal_moves":[19,26,37,44],"game_mode":"std","board_size":8,"blocked_squares":[],"placed":{"1":0,"2":0},"remaining_ms":60000,"match_id":123,"leg":0,"revision":0,"history":[],"round_no":null,"room_created_at":null,"budget_ms":10000}' | py my_adapter.py

2. Ræstu tengiforritið með millistykkinu

macOS / Linux

python3 tools/bot_match_client.py --engine-threads 2 --engine 'python3 my_adapter.py'

Windows PowerShell

py tools/bot_match_client.py --engine-threads 2 --engine 'py my_adapter.py'

Skref 2: skiptu yfir í skrá sem kallar á leikvélina þína

Þegar skref 1 virkar skaltu skipta öllu innihaldi my_adapter.py út fyrir dæmi A eða B hér fyrir neðan. Breyttu aðeins línunum sem eru merktar EDIT og láttu hitt vera eins og það er. Keyrðu síðan prófunarskipun 1 hér að ofan aftur og athugaðu að ein svarlína birtist. Leikvélin þín valdi leikinn, svo það er eðlilegt að fá annan reit en 19.

Dæmi A: leikvél sem velur leik með Python-falli

Þetta dæmi gerir ráð fyrir skrá sem heitir my_engine.py með fallinu search sem velur leikinn. Breyttu skráarheitinu og fallsheitinu við EDIT 1 og gildunum sem eru send inn við EDIT 2 svo þau passi við leikvélina þína. Fallið á að skila númeri reitsins (0 til 63) eða hniti eins og d3.

import json
import sys
from pathlib import Path

from my_engine import search  # EDIT 1: your engine file and function name


def think_ms(position):
    # Time for this move: share the remaining clock over my remaining moves.
    my_moves_left = position["board"].count(0) // 2 + 1
    share = position["remaining_ms"] / my_moves_left
    return int(min(share, position["budget_ms"]) * 0.8)


def choose_move(position):
    if not position["legal_moves"]:
        return -1
    # EDIT 2: pass what your function needs
    return search(
        board=position["board"],
        color=position["color"],
        legal_moves=position["legal_moves"],
        time_limit_ms=think_ms(position),
    )


position = json.loads(sys.stdin.readline())
legal = position["legal_moves"]
try:
    move = choose_move(position)
except Exception as error:
    # The engine failed: note why in my_adapter.log and play the first legal square.
    with open(Path(__file__).with_name("my_adapter.log"), "a") as log:
        log.write(repr(error) + "\n")
    move = legal[0] if legal else -1
print(json.dumps({"move": move}), flush=True)
Dæmi B: leikvél sem er forritsskrá

Þetta dæmi gerir ráð fyrir að forritið lesi eina línu með 64 borðstöfum, litnum sem á leik og umhugsunartímanum í millisekúndum, og svari með einni hnitalínu eins og D3 (. = tómt, X = svart, O = hvítt). Hver leikvél hefur sitt eigið snið, svo breyttu heiti forritsskrárinnar við EDIT 1, línunni sem er send til leikvélarinnar við EDIT 2 og hlutanum sem les svarið við EDIT 3 svo allt passi við leikvélina þína.

my_adapter.py → my_engine

...........................OX......XO........................... X 1777

my_engine → my_adapter.py

D3
import json
import subprocess
import sys
from pathlib import Path

# EDIT 1: your engine program file (kept in the same folder as my_adapter.py)
ENGINE = Path(__file__).with_name("my_engine.exe" if sys.platform == "win32" else "my_engine")


def think_ms(position):
    # Time for this move: share the remaining clock over my remaining moves.
    my_moves_left = position["board"].count(0) // 2 + 1
    share = position["remaining_ms"] / my_moves_left
    return int(min(share, position["budget_ms"]) * 0.8)


def choose_move(position):
    if not position["legal_moves"]:
        return -1
    # EDIT 2: build the line your engine reads
    board = "".join(".XO"[cell] for cell in position["board"])
    color = "X" if position["color"] == 1 else "O"
    reply = subprocess.run(
        [str(ENGINE)],
        input=f"{board} {color} {think_ms(position)}\n",
        text=True,
        capture_output=True,
        check=True,
        timeout=position["budget_ms"] / 1000 * 0.9,
    )
    # EDIT 3: take the square out of your engine's answer
    return reply.stdout.strip()


position = json.loads(sys.stdin.readline())
legal = position["legal_moves"]
try:
    move = choose_move(position)
except Exception as error:
    # The engine failed: note why in my_adapter.log and play the first legal square.
    with open(Path(__file__).with_name("my_adapter.log"), "a") as log:
        log.write(repr(error) + "\n")
    move = legal[0] if legal else -1
print(json.dumps({"move": move}), flush=True)

Umhugsunartími: í viðureignum vélmenna hefur hvort vélmenni 1 mínútu í hvorri skák, svo löng umhugsun um einn leik leiðir fljótt til taps á tíma. think_ms í dæmunum deilir tímanum sem eftir er (remaining_ms) með fjölda leikja sem þú átt eftir til að ákveða tímann fyrir þennan leik. budget_ms er ekki tíminn sem á að nota í þennan leik. Það er lengsti tíminn sem tengiforritið bíður eftir svarinu (10 sekúndur sjálfgefið). Ef svarið kemur seinna en það getur vélmennið ekki haldið áfram í þeirri skák og tapar henni á tíma, svo sendu think_ms til leikvélarinnar þinnar en ekki budget_ms.

Þegar eitthvað bilar: ef kallið á leikvélina mistekst skrifa dæmaskrárnar ástæðuna í my_adapter.log og leika fyrsta löglega reitnum í staðinn. Ef leikirnir virðast skrýtnir skaltu opna þá skrá fyrst. Tengiforritið sýnir ekki villuboð millistykkisins á skjánum. Notaðu print aðeins fyrir svarlínuna einu og skrifaðu allan villuleitartexta í skrá.

Hraði: tengiforritið heldur my_adapter.py gangandi fyrir hverja skák og sendir eina línu í hverjum leik. Skrá sem svarar einni línu og hættir, eins og dæmin, er ræst aftur í næsta leik, svo vélin þín ræsist líka aftur í hvert sinn. Ef vélin er sein að ræsa eða á að halda vinnu fyrri leikja, gerðu my_adapter.py að lykkju: lesa línu, svara línu, endurtaka. Ekki lesa inntak til enda og gerðu flush eftir hvert svar.

Það sem eftir er af þessum hluta er uppflettiefni um það sem tengiforritið og my_adapter.py skiptast á. Ef þú notar dæmaskrárnar hér að ofan óbreyttar þarftu ekki að lesa það.

Inntaks-JSON (tengiforrit → millistykki)

Þetta eru sýnigögn frá tengiforritinu, ekki keyranlegur kóði. Ekki vista þau sem Python-skrá. Meðan á leik stendur eru nýjustu gögn send sjálfkrafa í hverri umferð.

Hér fyrir neðan er dæmi um upphafsstöðu á venjulegu 8×8 borði. Í raunverulegum skákum fyllir tengiforritið inn núverandi stöðu. board telur upp reiti frá a1 til hægri og síðan næstu röð; 0=tómt, 1=svart, 2=hvítt. color=1 biður um leik fyrir svart. legal_moves telur upp reitina sem þú mátt leika á. remaining_ms er eftirstandandi tími á klukkunni og budget_ms lengsti tíminn sem tengiforritið bíður eftir svari við þessum leik, hvort tveggja í millisekúndum (1000 = 1 sekúnda). Svið og dæmi fyrir afbrigði eru í kaflanum um afbrigði hér fyrir neðan.

{"board":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],"color":1,"legal_moves":[19,26,37,44],"game_mode":"std","board_size":8,"blocked_squares":[],"placed":{"1":0,"2":0},"remaining_ms":60000,"match_id":123,"leg":0,"revision":0,"history":[],"round_no":null,"room_created_at":null,"budget_ms":10000}

Svar-JSON (millistykki → tengiforrit)

Skrifaðu eitt af svörunum hér fyrir neðan sem eina JSON-línu sem endar á línuskiptum. move er reitanúmer eða hnit, óháð há- og lágstöfum. Á 8×8 er d3 (3−1)×8+3 = 19. Veldu alltaf úr legal_moves sem þú fékkst. Í vélmennapörum, þegar enginn löglegur leikur er til, sendu -1 eða pass; í skákum gegn manni leysir þjónninn þvinguð pass. Skrifaðu aðeins svarlínuna í stdout, engin önnur skilaboð.

{"move":19}
{"move":"d3"}
{"move":-1}

Valfrjálst: bættu environment við svarið til að tilkynna raunverulegan fjölda þráða, hash-stærð í MB og ponder vélarinnar (tengiforrit v1.4.6 eða nýrra). Tengiforritið tekur aðeins við tölum innan marka og true/false og sýnir þær í upplýsingum bottans. Ef eigið millistykki bætir við eval sendir tengiforritið það með leiknum í viðureignum milli vélmenna (til dæmis {"move":19,"eval":1.5}). eval er mat þitt eftir leikinn í skífum frá þinni hlið, að hámarki reitir leiksins; --edax, --egaroucid og NBoard-vélar senda það sjálfar eftir uppfærslu í v1.5.3.

{"move":19,"environment":{"engine_threads":1,"hash_mb":32,"ponder":false}}

Dæmi um beiðnir til leikvélar eftir leik

Niðurhal

Sækja Python-dæmi

GitHub: flipsight-othello-bot-connector

OpenAPI 3.1 JSON

README.md

.zip inniheldur leiðbeiningar, tengiforrit og dæmivél; .json er API-lýsing og .md leiðbeiningar.

Að útfæra API-ið sjálfur

Stöðvaðu fyrst tengiforrit æfingabottans. Opnaðu strauminn með lyklinum úr skrefi 6. Haltu einni tengingu opinni fyrir hvern lykil. Hver lína inniheldur einn JSON-atburð.

Atburðastraumur

curl -N 'https://othelloclub.com/flipsight_api/bot-stream' \
  -H "Authorization: Bearer $FS_BOT_TOKEN"
Windows PowerShell
curl.exe -N https://othelloclub.com/flipsight_api/bot-stream -H "Authorization: Bearer $env:FS_BOT_TOKEN"

Á eftir hello kemur state. Dæmið sýnir reitina sem skipta máli fyrir botta númer 2.

{
    "type": "state",
    "view": "agent",
    "bot": {
        "id": 2
    },
    "matches": [
        {
            "id": 123,
            "status": "running",
            "bot_a": 1,
            "bot_b": 2,
            "state": {
                "legs": [
                    {
                        "turn": 1,
                        "black_participant": 0,
                        "revision": 1,
                        "status": "active",
                        "legal_moves": [2, 3, 12, 25, 42, 44, 45]
                    },
                    {
                        "turn": 1,
                        "black_participant": 1,
                        "revision": 0,
                        "status": "active",
                        "legal_moves": [2, 3, 12, 25, 42, 44, 45]
                    }
                ]
            }
        }
    ]
}

Bottinn þinn leikur með svörtu (1) á seinna borðinu (leg 1). Þegar turn er 1 velurðu leik úr legal_moves og sendir hann ásamt revision borðsins. Til að leika í raun skaltu setja lykilinn í öðrum skipanaglugga eins og í skrefi 6 og nota gildi skákarinnar sem er í gangi.

curl 'https://othelloclub.com/flipsight/bot_match_api.php' \
  -H "Authorization: Bearer $FS_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"action":"agent_move","match_id":123,"leg":1,"revision":0,"move":2,"eval":1.5}'
Windows PowerShell
Invoke-RestMethod -Method Post -Uri 'https://othelloclub.com/flipsight/bot_match_api.php' -Headers @{Authorization="Bearer $env:FS_BOT_TOKEN"} -ContentType 'application/json' -Body '{"action":"agent_move","match_id":123,"leg":1,"revision":0,"move":2,"eval":1.5}'

agent_accept, agent_move

Atburðastraumur

Að útfæra API-ið sjálfur

TegundLýsing
helloTenging staðfest. bot_id er númer bottans þíns.
stateSkiptu út listanum yfir skákir og boð. Ef þú ert bot_b geturðu samþykkt pending-boð með agent_accept.
matchUppfærðu skákina með þessu id. Athugaðu á hverju virku borði hvort bottinn þinn eigi leik.
pingMerki um virka tengingu á 10 sekúndna fresti. Svar er óþarft.
closingSíðasta línan áður en þjónninn lokar straumnum. Ef reason er overflow (of margar ósendar línur) eða server_shutdown skaltu tengjast aftur og ná stöðunni með state. replaced þýðir að sami lykill er í notkun annars staðar. Tengstu ekki strax aftur: bíddu í minnst 30 sekúndur, og lengur ef þetta endurtekur sig. Notaðu hvern lykil aðeins á einum stað.
Viðureignarhlutur (matches[])
SviðTegundLýsing
idintegerAuðkenni viðureignar (neikvætt í skákum gegn manni)
kindstringhuman í skákum gegn manni
bot_aintegerAuðkenni vélmennis þátttakanda 0 (0 fyrir mann)
bot_bintegerAuðkenni vélmennis þátttakanda 1 (0 fyrir mann)
game_modestringLeikur (std, anti, grand, octagon, reversi)
time_limit_secintegerSekúndur á skák, á lit
statusstringpending, running, finished, aborted, rejected, expired
expires_msintegerFrestur til samþykkis (millisekúndur)
rankedbooleanHvort viðureignin telur til stiga
state.statusstringactive, finished eða aborted
state.game_modestringLeikur (std, anti, grand, octagon, reversi)
state.board_sizeinteger 8 | 10Reitir á hverri hlið, 8 eða 10
state.blocked_squaresinteger[]Ónothæfir reitir (aðeins Octagon, óraðað)
state.legsarraySkákir (2 milli vélmenna, 1 gegn manni)
state.totals[integer, integer]Samanlagðar skífur beggja skáka fyrir hvern þátttakanda
state.winnerinteger | nullSigrandi þátttakandi 0 eða 1, null við jafntefli
state.finish_reasonstring | nulldiscs, timeout, double_timeout, disconnect, no_first_move
Skákarhlutur (state.legs[])
SviðTegundLýsing
boardinteger[64 | 100]64 / 100 reitir, 0=tómt 1=svart 2=hvítt
turnintegerLitur sem á leik, 1 (svart) eða 2 (hvítt)
legal_movesinteger[]Löglegir reitir fyrir litinn sem á leik. Tómt í skákum sem er lokið
placed{"1": integer, "2": integer}Lagðar skífur eftir lit, lyklar "1" (svart) og "2" (hvítt)
black_participantintegerÞátttakandi sem leikur svörtu í þessari skák
clocks_ms[number, number]Grunngildi eftirstandandi tíma í litaröð (svart, hvítt)
turn_started_msintegerTími þjóns þegar núverandi umferð hófst
revisionintegerHækkar um 1 í hvert sinn sem þessi skák breytist
statusstringactive, finished, timeout, stopped
historyarrayLeiknir leikir (color, participant, move, at_ms, eval)
discs[integer, integer]Fjöldi skífa í litaröð (svart, hvítt)
result_discs[integer, integer] (optional)Valfrjáls úrskurðuð staða [svart, hvítt] fyrir skák sem tapaðist á tíma; hún er lögð saman í stað skífa. Stig þeirrar hliðar sem féll á tíma og andstæðings hennar: std og reversi 0 og 64, grand 0 og 100, octagon 0 og 88, anti 64 og 0. Hin skákin heldur áfram og samtölurnar ráða sigurvegaranum þegar báðum skákum er lokið. Eldri færslur sem er lokið eru ekki endurreiknaðar.

Þegar skák lýkur ber síðasti match-atburðurinn líka record, skákskrána. Vistaðu hana óbreytta til að geyma alla skákina. Skákskrár

Samstilling stöðu

Ef tengingin rofnar eða ekkert berst í 15 sekúndur skaltu tengjast aftur og lengja biðina úr 1 sekúndu í allt að 30. Hunsaðu eldri stöður. Gegn manni skaltu bera saman room_created_at, round_no og revision í þeirri röð. Ef svar við leik glatast skaltu aðeins endursenda ef þú átt enn leik og útgáfa borðsins er óbreytt.

Sendu upplýsingar um vélina með agent_environment við ræsingu og við breytingar. Fyrir sjálfvirka pörun leyfir v2 allt að 10 straumtengingar og engin köll í agent_poll á síðustu 10 mínútum á netinu.

Auðkenning

Notaðu HTTPS, JSON POST og Authorization: Bearer. Lykillinn gildir fyrir eitt vélmenni. Settu hann ekki í vefslóðir, opinberan kóða eða annála.

Content-Type: application/json
Authorization: Bearer <FS_BOT_TOKEN>

POST https://othelloclub.com/flipsight/bot_match_api.php

Valkostir tengiforrits

Valkostir fyrir tools/bot_match_client.py. Nákvæmlega einn af --engine og --nboard / --edax / --egaroucid er nauðsynlegur. Lykillinn er aldrei valkostur; hann er aðeins lesinn úr umhverfisbreytunni FS_BOT_TOKEN. Skilakóðar: 0 venjuleg stöðvun, 2 lykli hafnað, 3 --max-runtime náð.

ViðföngLýsing
--engine "COMMAND"Ræsir skipunina einu sinni fyrir hverja skák og skiptist á einni JSON-línu í hverjum leik án þess að loka inntakinu. Vél sem svarar einni línu og hættir er ræst aftur í næsta leik.
--nboard "COMMAND"Heldur einni NBoard-leikvél fyrir hverja skák, tveimur alls. Aðeins venjulegt (std).
--edax PATHEdax má einnig tengja með aðeins slóð forritsins með --edax hér að neðan. Sérstakt millistykki þarf ekki. Tengiforritið ræsir Edax með xboard og sendir tíma beggja sem eftir er fyrir hvern leik; Edax ákveður sjálft umhugsunartímann eftir eigin klukku (tengiforrit v1.4.8 eða nýrra). Í viðureigninni heldur Edax leikferlinum og hash-töflunni, og með --engine-ponder on leitar það líka á tíma andstæðingsins. --edax-protocol nboard notar eldri NBoard-tenginguna.
--edax-eval PATHSlóð að Edax eval.dat. Ef henni er sleppt er leitað að data/eval.dat í möppu forritsins eða yfirmöppu hennar.
--edax-protocol xboard|nboardTengimáti fyrir --edax. Sjálfgildið xboard lætur Edax stjórna eigin klukku og nota ponder (v1.4.8 eða nýrra). nboard er tengingin sem notuð var til og með v1.4.7: tengiforritið ákveður tíma hvers leiks og Edax notar ekki ponder.
--egaroucid PATHUndirbúðu Egaroucid for Console. Veldu skipanalínuforritið og hafðu resources-möppuna á sínum stað. Á macOS og Linux er notuð keyrsluskrá byggð samkvæmt opinberum leiðbeiningum. Staða og tími sem eftir er fara um setboard, settime og go án millistykkis.
--egaroucid-level NNotað með --egaroucid. Gildi frá 1 til 60 ræsir Egaroucid á því stigi (-level N) og sendir ekki eftirstandandi tíma (settime); 0 eða ekkert gildi heldur tímaham, sem fylgir leikklukkunni. Í stigaham er engin skipun til að stöðva leit í miðjum klíðum: ef leikur fer yfir mörk --max-think-seconds stöðvar tengiforritið leikvélina og leikur löglegum varaleik. Veldu stig sem lýkur vel innan leikklukkunnar.
--nboard-depth NSendir set depth N til NBoard-leikvélarinnar. Frá 0 til 60; 0 heldur sjálfgildi leikvélarinnar. Með --edax er þetta Edax-stigið (20 þýðir L20); án gildis er stigið 60. Edax leikur besta leiknum sem fundinn er þegar stiginu er náð eða tíminn fyrir leikinn er búinn, hvort sem kemur fyrr. Með --edax er gildið sent í gegnum xboard sem sd N.
--max-think-seconds SHámarksfjöldi sekúndna sem beðið er eftir leikvélinni fyrir hvern leik. Sjálfgefið 10, hámark 300. Aldrei lengur en eftirstandandi tími á klukkunni að frádregnum 0,75 sekúndum. Þetta er öryggisþak tengiforritsins; þjónninn hefur engin tímamörk á hvern leik. Með 0 er hámark á hvern leik fjarlægt og eftirstandandi leiktími notaður. Leikklukkuna ákveður vefurinn og tengiforritið getur ekki breytt henni: viðureignir milli vélmenna og sjálfvirkar viðureignir gefa hvorum lit 60 sekúndur á hvert borð, og manneskja sem skorar beint á vélmennið þitt velur tímann. Með --edax ákveður Edax tíma hvers leiks eftir eigin klukku innan þessara marka; náist mörkin lætur tengiforritið Edax leika strax besta leiknum sem fundinn er.
--engine-name NAMEHeiti leikvélar sem birtist í upplýsingum um vélmennið (120 stafir eða færri). Ekki setja inn skipanir eða slóðir.
--engine-threads NFjöldi þráða sem vélin notar í hverri skák , sést á prófílnum. Með --edax eða --egaroucid keyrir vélin með þessu gildi (sjálfgefið 4 ef tölvan hefur fleiri en 4 rökrænar örgjörvakjarna, annars 1); með --engine er það sent í hverri beiðni sem engine_threads. Notaðu að hámarki 4 þræði á vél og 8 samtals í viðureign botta með tveimur samtímis skákum. Með --engine/--nboard er beðið um gildið ef því er sleppt; við bakgrunnskeyrslu eða sjálfvirka keyrslu er þessi valkostur nauðsynlegur.
--engine-hash-mb MBStærð hash-töflu á hverja vél í MB. Með --edax eða --egaroucid er taflan stillt á stærsta veldi af tveimur sem fer ekki yfir gildið (Edax -h, Egaroucid -hash) og sú stærð er tilkynnt; án valkostsins notar Edax edax.ini og Egaroucid 32 MB. Aðrar vélar tilkynna aðeins gildið og stilling þeirra breytist ekki. Hver vél hefur sína eigin töflu, svo bottaskák með tvo leiki í einu notar tvöfalt meira.
--engine-ponder on|offPonder (leit á tíma andstæðingsins). Með --egaroucid ræsir on Egaroucid með -ponder og tilkynnir Á; vélin notar líka örgjörva þegar andstæðingurinn á leik. Með --edax (tengiforrit v1.4.8 eða nýrra) lætur on Edax nota ponder í gegnum xboard (hard) og tilkynnir Á; með --edax-protocol nboard notar Edax ekki ponder og on er hafnað. Aðrar vélar tilkynna aðeins raunverulega stillingu sína.
--cpu-name NAMEHeiti örgjörva sem á að tilgreina (120 stafir eða færri). Greint sjálfkrafa ef því er sleppt.
--once-match IDSér aðeins um þessa viðureign og hættir þegar henni lýkur (lokið, ógild, útrunnin, hafnað). Neikvæð auðkenni skáka gegn manni virka líka. Í prófunum skaltu sameina það með --max-runtime.
--max-runtime SGengur frá leikvélunum og hættir eftir þennan fjölda sekúndna (skilakóði 3).
--save-games DIRGeymir hverja skák sem lýkur eftir að valkosturinn er settur á í DIR/games-YYYY-MM.ndjson, eina skákskrá í hverri línu (slökkt sjálfgefið). Skákir sem kláruðust meðan tengiforritið var stöðvað eða straumurinn rofinn eru fylltar inn með agent_games við endurtengingu, frá nýjustu vistuðu skákinni. Ein skák tekur um 4 KB (um 6 KB á 10×10), svo 1.400 skákir á dag gera um 6 MB á dag og 180 MB á mánuði. Eyddu gömlum mánaðarskrám handvirkt þegar þeirra er ekki lengur þörf.
--timing-log PATHBætir við einni línu á leik sem sýnir hvert tíminn fór (taka við leik, bíða eftir lausri leit, vél, senda leik). Slökkt sjálfgefið; ekkert aukalega er sent á þjóninn.
--api URL, --stream-url URLVefföng API og straums. Haltu venjulega sjálfgildunum. Aðeins HTTPS er samþykkt, og þar sem lykillinn er sendur með verður straumurinn að vera á API-hýslinum.

Afbrigði

Vélmenni fær aðeins þá leiki sem hakað er við í Studdir leikir. game_mode í beiðnum til leikvélar og í stöðu viðureignar segir þér hvaða leikur það er. Þjónninn reiknar borðstærð, lokaða reiti og löglega reiti, svo leikvélin þarf aðeins að velja úr legal_moves sem hún fær. Ekki búa til leiki fyrir 10×10 eða klassískt Reversi með leikjamyndun fyrir venjulegt 8×8.

Leikurgame_modeBorð
Standardstd8×8
Antianti8×8
Grand (10x10)grand10×10
Octagonoctagon10×10 (88)
Klassískt Reversireversi8×8

Sameiginlegar reglur: Svartur (1) leikur fyrst. Báðar skákirnar byrja í sömu stöðu með víxluðum litum og fara fram samtímis. Í vélmennapörum, þegar þú átt engan löglegan leik, berst legal_moves sem tómt fylki og vélmennið verður sjálft að senda move=-1 (pass). Þjónninn passar ekki fyrir þig og klukkan þín heldur áfram að ganga. Ólöglegt er að passa þegar löglegur leikur er til. Skák lýkur þegar hvorugur litur getur leikið. Í nýjum tveggja skáka viðureignum bætast auðir reitir við litinn með fleiri skífur þegar skák lýkur eðlilega, áður en stigin eru lögð saman. Í Anti vinnur lægri leiðrétt samtala; við jafnmargar skífur eru auðir reitir ekki úthlutaðir. Jafnar samtölur eru jafntefli. Allar viðureignir vélmenna hefjast í slembinni stöðu með 12 skífum. Í öllum leikjategundum hefur hvort vélmenni 1 mínútu í hvorri skák.

Anti: skífur eru lagðar og þeim snúið eins og í venjulegu Othello. Sá sem hefur færri skífur samanlagt í báðum skákum vinnur.

10x10: venjulegar reglur á 10×10 borði (100 reitir). Upphafsskífurnar eru á fjórum miðreitunum; vélmennapör bæta við 8 slembileikjum og byrja með 12 skífum.

Octagon: sama borð og upphafsuppstilling og í 10x10, en þrír reitir í hverju horni, 12 alls, eru ónothæfir (88 reitir í leik). Lokaðir reitir berast sem reitanúmer í blocked_squares og sem 0, sama gildi og tómt, í board. Fylkið er ekki í töluröð. Ekki er hægt að leika á lokaðan reit, og raðir skífa stöðvast þar.

Klassískt Reversi: samkvæmt reglunum byrjar það á tómu borði. Meðan einhver af fjórum miðreitunum (27, 28, 35, 36) er tómur leggurðu aðeins þar og engu er snúið. Þegar allir fjórir eru fylltir gilda venjulegar reglur. Hvor litur leggur í mesta lagi 32 skífur, að meðtöldum fyrstu fjórum leikjunum. placed telur skífurnar sem hvor litur hefur lagt hingað til; lyklar þess eru strengirnir "1" (svart) og "2" (hvítt). Vélmennapör byrja eftir að þjónninn hefur lagt 12 skífur af handahófi, að meðtöldum fjórum miðleikjunum, svo í fyrstu beiðninni er samtala beggja placed-gildanna 12 (oftast {"1":6,"2":6}). Litur sem hefur lagt allar 32 fær tómt legal_moves og sendir -1 í hvert sinn sem hann á leik.

Dæmi um beiðnir til leikvélar eftir leik

Dæmi um fyrstu beiðnina fyrir svart sem tengiforritið sendir --engine-leikvél, búin til með reglukóðanum. Raunverulegar skákir af öllum gerðum byrja í slembinni stöðu með 12 skífum, svo board og legal_moves eru ólík í hverri skák. Til að dæmin haldist óbreytt voru upphafsleikir þeirra valdir nálægt miðju borðsins. match_id og klukkugildin eru líka önnur í raunverulegum skákum.

Anti (anti)

Inntaks-JSON (tengiforrit → millistykki)

{
    "board": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 0, 0, 0, 0, 0, 0, 0, 2, 2, 0, 0, 0, 0, 0, 1, 2, 2, 1, 0, 0, 0, 0, 2, 2, 2, 2, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
    "color": 1,
    "legal_moves": [2, 3, 12, 25, 42, 44, 45],
    "game_mode": "anti",
    "board_size": 8,
    "blocked_squares": [],
    "placed": {
        "1": 4,
        "2": 4
    },
    "remaining_ms": 60000,
    "match_id": 123,
    "leg": 0,
    "revision": 0,
    "history": [],
    "round_no": null,
    "room_created_at": null,
    "budget_ms": 10000
}

Svar-JSON (millistykki → tengiforrit)

{"move":2}
Grand (10x10) (grand)

Inntaks-JSON (tengiforrit → millistykki)

{
    "board": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 2, 0, 0, 0, 0, 0, 0, 0, 1, 2, 2, 1, 0, 0, 0, 0, 0, 0, 2, 2, 2, 2, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
    "color": 1,
    "legal_moves": [13, 14, 25, 42, 63, 65, 66],
    "game_mode": "grand",
    "board_size": 10,
    "blocked_squares": [],
    "placed": {
        "1": 4,
        "2": 4
    },
    "remaining_ms": 60000,
    "match_id": 123,
    "leg": 0,
    "revision": 0,
    "history": [],
    "round_no": null,
    "room_created_at": null,
    "budget_ms": 10000
}

Svar-JSON (millistykki → tengiforrit)

{"move":13}
Octagon (octagon)

Inntaks-JSON (tengiforrit → millistykki)

{
    "board": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 2, 0, 0, 0, 0, 0, 0, 0, 1, 2, 2, 1, 0, 0, 0, 0, 0, 0, 2, 2, 2, 2, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
    "color": 1,
    "legal_moves": [13, 14, 25, 42, 63, 65, 66],
    "game_mode": "octagon",
    "board_size": 10,
    "blocked_squares": [0, 1, 10, 8, 9, 19, 80, 90, 91, 89, 98, 99],
    "placed": {
        "1": 4,
        "2": 4
    },
    "remaining_ms": 60000,
    "match_id": 123,
    "leg": 0,
    "revision": 0,
    "history": [],
    "round_no": null,
    "room_created_at": null,
    "budget_ms": 10000
}

Svar-JSON (millistykki → tengiforrit)

{"move":13}
Klassískt Reversi (reversi)

Inntaks-JSON (tengiforrit → millistykki)

{
    "board": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 2, 2, 1, 1, 0, 0, 0, 0, 2, 2, 1, 1, 0, 0, 0, 0, 0, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
    "color": 1,
    "legal_moves": [18, 25, 33, 41, 42, 50, 51],
    "game_mode": "reversi",
    "board_size": 8,
    "blocked_squares": [],
    "placed": {
        "1": 6,
        "2": 6
    },
    "remaining_ms": 60000,
    "match_id": 123,
    "leg": 0,
    "revision": 0,
    "history": [],
    "round_no": null,
    "room_created_at": null,
    "budget_ms": 10000
}

Svar-JSON (millistykki → tengiforrit)

{"move":18}

Svið í beiðni til leikvélar

SviðTegundLýsing
game_modestringEitt af std, anti, grand, octagon, reversi. XOT í skákum gegn manni berst sem std.
board_sizeinteger 8 | 108, eða 10 fyrir grand og octagon.
boardinteger[board_size²]Fylki af lengd board_size². Lesið frá a1 til hægri, síðan næsta röð. 0=tómt (þar með taldir lokaðir reitir í Octagon), 1=svart, 2=hvítt.
blocked_squaresinteger[]Ónothæfir reitir í Octagon. Tómt fylki í öðrum leikjum.
placed{"1": integer, "2": integer}Skífur sem hvor litur hefur lagt hingað til, að meðtöldum slembileikjunum í upphafi; lyklarnir eru strengirnir "1" og "2". Notað fyrir 32 skífa hámarkið í klassísku Reversi.
legal_movesinteger[]Reitir sem þú mátt leika á núna. Ef tómt, svaraðu move=-1.
colorinteger 1 | 2Liturinn sem á leik. 1=svart, 2=hvítt.
budget_msintegerTími leyfður fyrir þennan leik í millisekúndum: það minna af --max-think-seconds og eftirstandandi tíma á klukkunni að frádregnum 0,75 sekúndum. Tengiforritið stöðvar leikvélina þegar farið er yfir hann.
remaining_msintegerEftirstandandi tími á klukku þíns litar í þessari skák, í millisekúndum, eftir að tíminn sem þegar hefur verið notaður í þessari umferð hefur verið dreginn frá.
match_idinteger ≠ 0Auðkenni viðureignar. Neikvætt (-herbergisnúmer) í skákum gegn manni.
leginteger 0 | 1Númer skákar, 0 eða 1. Alltaf 0 í skákum gegn manni.
revisionintegerStöðunúmer þessarar skákar. Sendu það óbreytt með agent_move.
historyarrayLeikir sem hafa verið leiknir í þessari skák. Byggðu ákvörðunina á board.
round_nointeger | nullUmferðarnúmer skákar gegn manni. null fyrir vélmennapör.
room_created_atstring | nullStofntími leikherbergis skákar gegn manni. null fyrir vélmennapör.
engine_threadsinteger (optional)Aðeins til staðar þegar tengiforritið var ræst með --engine-threads. Fjöldi þráða sem vélin má nota í þessari skák; stilltu leitina eftir því.

Að skora á annað vélmenni í afbrigði

Bættu game_mode við agent_challenge; sjálfgildið er std. Bæði vélmennin verða að hafa það í supported_games. Sjáðu leiki andstæðingsins á vélmennasíðunni. Ef annað hvort vélmennið vantar leikinn er svarið HTTP 409 með villunni hér fyrir neðan.

{"action":"agent_challenge","target_id":2,"game_mode":"anti"}
{"action":"agent_challenge","target_name":"Opponent","game_mode":"grand"}
HTTP 409
{"ok":false,"error":"unsupported game mode","server_now_ms":1800000000000}

Að breyta supported_games

Skráningarformið byrjar með Standard hakað, og eldri vélmenni án vistaðs lista styðja std. Þú getur aðeins breytt listanum í Stjórna á vélmennasíðunni á vefnum, aldrei með vélmennalyklinum (API). Breytingunni er hafnað meðan viðureign er í gangi eða bíður samþykkis. Ekki er hægt að vista tóman lista.

Fólk gegn skráðum vélmennum

Fólk getur skorað á vélmennið þitt í hvaða leik sem það hefur skráð. Ef það styður venjulegt geta bæði STD og XOT borist. XOT berst með game_mode std og byrjar á borði þar sem 8 leikir hafa þegar verið leiknir (þeir eru í history). Sá sem skorar á velur tímann, og skákin er ómetin. Viðureign gegn manni hefur eina skák (leg 0) og neikvætt match_id. Þjónninn sér um pass þegar enginn leikur er mögulegur, svo ekki senda -1. Skráð vélmenni á netinu með sjálfvirka pörun virka geta líka tekið þátt í studdum STD/XOT-hraðleikjum. Þeir telja til stiga hjá meðlimum en ekki gestum.

Ólöglegir leikir og tími

Ólöglegum leik eða úreltri revision er hafnað með HTTP 409 (illegal_move, stale_revision, not_your_turn) og borðið breytist ekki. Klukkan gengur á meðan. Tengiforritið sendir sama leikinn aftur með sömu revision, svo nema leikvélin sé löguð tapast sú skák á endanum á tíma. Þjónninn hefur engin mörk á hvern leik og athugar aðeins eftirstandandi tíma hvors litar. 10 sekúndurnar eru sjálfgildi tengiforritsins fyrir --max-think-seconds.

Leikreglur

Allar viðureignir vélmenna hefjast í slembinni stöðu með 12 skífum. Tveir leikir fara fram samtímis með víxluðum litum. Heildarfjöldi skífa ræður úrslitum; í Anti vinnur lægri talan.

Í öllum leikjategundum hefur hvort vélmenni 1 mínútu í hvorri skák.

Ef vélmenni hefur ekki leikið fyrsta leik sínum innan 30 sekúndna frá upphafi er viðureignin ógild og telur ekki til stiga. Ef tenging annars vélmennisins rofnar lengur en 30 sekúndur meðan á viðureigninni stendur og hitt er tengt vinnur tengda vélmennið (finish_reason: disconnect) og úrslitin telja til stiga.

Þjónninn reiknar leiki FlipSight-vélmennisins í öllum leikjategundum. Tekið er við áskorunum bæði á vefnum og í gegnum API (agent_challenge), og þjónninn hefur viðureignina strax, svo þú þarft ekki að hafa leikherbergið opið. Ef útreikningur þjónsins stöðvast í meira en 30 sekúndur er viðureignin ógilt (finish_reason: technical) og hefur ekki áhrif á stig. Afbrigði eru þung í útreikningi, svo mest 2 afbrigðaviðureignir gegn FlipSight-vélmennum eru í gangi í einu. Ef allt er fullt færðu HTTP 409 með site bot variant matches are full; reyndu aftur eftir smástund.

Sjálfvirk pörun parar botta með allt að 500 stiga mun í leikafbrigði sem báðir hafa valið. Tengiforritið hefur 120 sekúndur til að samþykkja. Úrslitin telja til stiga. Í Stjórna er hægt að velja afbrigði eða slökkva á sjálfvirkri pörun. Vélmenni sem er ræst með æfingavélinni (environment.practice er true) er haldið utan sjálfvirkra viðureigna, og viðureignir þess við önnur vélmenni á meðan hafa ekki áhrif á stig.

Bein áskorun frá manni er einn leikur í venjulegu herbergi með studdum leik og tíma. Netþjónninn lætur beinar áskoranir aldrei hafa áhrif á styrkleikastig. Skráð vélmenni á netinu með sjálfvirka pörun virka geta líka tekið þátt í studdum STD/XOT-hraðleikjum. Þeir telja til stiga hjá meðlimum en ekki gestum. Skráð vélmenni tekur aðeins við jafn mörgum skákum og stillingin fyrir samtímis skákir leyfir (sjálfgefið 2). Skák við manneskju og viðureign vélmenna (tvö borð) teljast hvor um sig 1.

Gangur viðureignar

pending → running → finished / aborted
pending → rejected / expired
kind=human: id=-room_id, legs[0], round_no, room_created_at
agent_move: move=19 / "d3" / "D3" (8×8)
10×10: "j10" = "J0" = 99
pass: -1 / "pass" / "PA" / "PS" / "--" (paired games only)
index=row*board_size+column (0-based)

Allar viðureignir vélmenna hefjast í slembinni stöðu með 12 skífum. Tveir leikir fara fram samtímis með víxluðum litum. Heildarfjöldi skífa ræður úrslitum; í Anti vinnur lægri talan.

Þátttakandanúmerið þitt er 0 ef þú ert bot_a og 1 ef þú ert bot_b. Þátttakandi 0 er svartur (1) í legs[0] og hvítur (2) í legs[1]; þátttakandi 1 öfugt. Þú átt leik þegar leg.status er active og leg.turn er liturinn þinn. Þú getur átt leik í báðum skákum í einu.

Ef þú átt engan löglegan leik verður þú sjálfur að senda move -1 (pass); þjónninn sleppir ekki fyrir þig. Í skákum gegn manni sér þjónninn um pass eins og í venjulegum leikherbergjum.

Þegar þú átt leik er eftirstandandi tími = clocks_ms[liturinn þinn - 1] - (server_now_ms - turn_started_ms). clocks_ms er í litaröð (svart, hvítt); totals og winner eru í röð þátttakenda (winner 0 eða 1, null við jafntefli).

Reitanúmer

Reitanúmer = röð × 8 + dálkur, svo a1=0, h1=7, a2=8 og h8=63. Til dæmis er 19 d3 og 37 f5. board-fylkið notar sömu röð, með 0=tómt, 1=svart, 2=hvítt.

    a  b  c  d  e  f  g  h
1   0  1  2  3  4  5  6  7
2   8  9 10 11 12 13 14 15
3  16 17 18 19 20 21 22 23
4  24 25 26 27 28 29 30 31
5  32 33 34 35 36 37 38 39
6  40 41 42 43 44 45 46 47
7  48 49 50 51 52 53 54 55
8  56 57 58 59 60 61 62 63

Á 10×10 (grand, octagon) er reitur = röð × 10 + dálkur. Dálkarnir eru a til j, og tíunda röðin er skrifuð sem 10 eða 0 í hnitum. a1=0, j1=9, a2=10, j10=99 (sama og j0). Sama hnit hefur annað númer á hverri borðstærð: d3 er 19 á 8×8 og 23 á 10×10.

     a  b  c  d  e  f  g  h  i  j
  1   0  1  2  3  4  5  6  7  8  9
  2  10 11 12 13 14 15 16 17 18 19
  3  20 21 22 23 24 25 26 27 28 29
  4  30 31 32 33 34 35 36 37 38 39
  5  40 41 42 43 44 45 46 47 48 49
  6  50 51 52 53 54 55 56 57 58 59
  7  60 61 62 63 64 65 66 67 68 69
  8  70 71 72 73 74 75 76 77 78 79
  9  80 81 82 83 84 85 86 87 88 89
 10  90 91 92 93 94 95 96 97 98 99

Octagon (octagon)

     a  b  c  d  e  f  g  h  i  j
  1  ## ##  2  3  4  5  6  7 ## ##
  2  ## 11 12 13 14 15 16 17 18 ##
  3  20 21 22 23 24 25 26 27 28 29
  4  30 31 32 33 34 35 36 37 38 39
  5  40 41 42 43 44 45 46 47 48 49
  6  50 51 52 53 54 55 56 57 58 59
  7  60 61 62 63 64 65 66 67 68 69
  8  70 71 72 73 74 75 76 77 78 79
  9  ## 81 82 83 84 85 86 87 88 ##
 10  ## ## 92 93 94 95 96 97 ## ##

Leikvélarmillistykki

FlipSight-tengiforrit vélmenna (Python 3.9+, aðeins staðalsafn) keyrir á Windows, macOS og Linux og tengir vél á tvo vegu. --engine ræsir vélina einu sinni fyrir hverja skák, sendir eina JSON-línu fyrir hvern leik og les eina línu {"move": reitur}. Vél sem svarar einni línu og hættir virkar áfram því hún er ræst aftur í næsta leik, en vél sem les inntak til enda (sys.stdin.read() o.s.frv.) svarar aldrei, svo lestu eina línu í einu. legal_moves í beiðninni telur upp löglega reiti; ef listinn er tómur, svaraðu -1. --nboard heldur NBoard-vél gangandi, einni fyrir hverja skák; leitardýpt er stillt með --nboard-depth.

Inntaks-JSON (tengiforrit → millistykki)

Valkostir tengiforrits

API-aðgerðir

Svardæmin sýna sniðið. Afritunarhnappurinn afritar aðeins beiðnina og kallar ekki á API.

POST agent_environment

Tilkynna umhverfi

Tilkynnir örgjörva, stýrikerfi, heiti leikvélar, þræði og æfingarham (practice) tengitölvunnar. Sendu það við ræsingu og þegar gildin breytast. Svarið inniheldur vélmennið þitt.

ViðföngTegundNauðsynlegtLýsing
actionstring "agent_environment"NauðsynlegtHeiti aðgerðarinnar sem kallað er á
environmentobjectNauðsynlegtÖrgjörvi, stýrikerfi og heiti leikvélar á tengitölvunni (hvert allt að 120 stafir, valfrjálst) og practice (true eða false, valfrjálst). practice true þýðir að vélmennið er að æfa sig: því er haldið utan sjálfvirkra viðureigna og vélmennaviðureignir sem beðið er um eða samþykktar á meðan hafa ekki áhrif á stig. Tengiforritið sendir gildið sjálft þegar það er ræst með æfingavélinni. Þjónninn man síðasta gildið, svo sendu það án practice eða með false þegar æfingunni lýkur. hash_mb (MB): Fyrir hverja vél. Sláðu inn ef tengillinn gefur ekki upp gildi. ponder (true / false / null): Aðeins til birtingar. Veldu handvirkt ef gildi vantar. Breyttu raunverulegri stillingu í vélinni.

Dæmi um beiðni

curl 'https://othelloclub.com/flipsight/bot_match_api.php' \
  -H "Authorization: Bearer $FS_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"action":"agent_environment","environment":{"cpu":"Apple M4","engine":"MyEngine","os":"Darwin","engine_threads":1,"hash_mb":32,"ponder":false}}'
Windows PowerShell
Invoke-RestMethod -Method Post -Uri 'https://othelloclub.com/flipsight/bot_match_api.php' -Headers @{Authorization="Bearer $env:FS_BOT_TOKEN"} -ContentType 'application/json' -Body '{"action":"agent_environment","environment":{"cpu":"Apple M4","engine":"MyEngine","os":"Darwin","engine_threads":1,"hash_mb":32,"ponder":false}}'

Dæmi um svar

{
    "ok": true,
    "bot": {
        "id": 2,
        "name": "MyBot",
        "owner_id": "example",
        "owner_name": "Example",
        "owner": {
            "player_id": "example",
            "name": "Example",
            "photo": "/img/no_profile.gif",
            "country_code": "",
            "country_name": "",
            "country_flag_url": "",
            "donor": false,
            "verified_player_id": ""
        },
        "engine_level": null,
        "rating": {
            "rating": 1200,
            "rd": 300,
            "official": false,
            "official_progress": {
                "kind": "provisional",
                "current": 0,
                "required": 50
            },
            "color": "pz-rating-unofficial",
            "high_rating": 1200,
            "wins": 0,
            "losses": 0,
            "draws": 0,
            "streak": 0,
            "best_streak": 0
        },
        "supported_games": ["std", "anti"],
        "auto_match": true,
        "bio": "",
        "registered_at": "2026-11-12 18:00:00",
        "registered_at_ts": 1794474000,
        "environment": {
            "cpu": "Apple M4",
            "engine": "MyEngine",
            "os": "Darwin",
            "practice": false,
            "engine_threads": 1,
            "hash_mb": 32,
            "ponder": false
        },
        "env": {
            "cpu": "Apple M4",
            "engine_threads": 1,
            "hash_mb": 32,
            "hash_mb_reported": 32,
            "hash_mb_override": null,
            "ponder": false,
            "ponder_reported": false,
            "ponder_override": null,
            "cpu_override": null,
            "engine_threads_override": null,
            "cpu_reported": "Apple M4",
            "engine_threads_reported": 1
        },
        "is_builtin": false,
        "online": true,
        "disabled": false,
        "deleted": false,
        "photo": "/flipsight/bot_match_api.php?action=photo&bot_id=2&v=1794474000000"
    },
    "server_now_ms": 1800000000000
}

POST agent_challenge

Skora á

Tilgreindu target_id (númer vélmennis) eða target_name (heiti vélmennis), sem sjást á vélmennasíðunni. Skora má á innbyggð FlipSight-vélmenni (is_builtin: true) í gegnum API í öllum leikjategundum og þjónninn hefur viðureignina strax. Ef 2 afbrigðaviðureignir gegn innbyggðum vélmennum eru þegar í gangi færðu HTTP 409 með site bot variant matches are full. Ef vélmennið sem þú skorar á hefur slökkt á "Áskoranir vélmenna" í stjórnun vélmenna færðu HTTP 409 með bot does not accept bot challenges. Sjálfvirkar skákir milli vélmenna fylgja samt stillingunni fyrir sjálfvirka pörun.

Þú getur skorað á sama botta þrisvar í röð. Bíddu í fimm mínútur eftir að þriðja viðureign lýkur.

Skora á af vélmennasíðunni

ViðföngTegundNauðsynlegtLýsing
actionstring "agent_challenge"NauðsynlegtHeiti aðgerðarinnar sem kallað er á
target_idinteger ≥ 1ValfrjálstAuðkenni vélmennisins sem skorað er á
target_namestringValfrjálstNafn vélmennisins sem skorað er á (í stað target_id)
game_modestring std | anti | octagon | grand | reversiValfrjálstLeikur fyrir vélmennapar. Sjálfgefið std. Bæði vélmennin verða að styðja hann. Standard / Anti / Octagon / Grand (10x10) / Klassískt Reversi

Dæmi um beiðni

curl 'https://othelloclub.com/flipsight/bot_match_api.php' \
  -H "Authorization: Bearer $FS_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"action":"agent_challenge","target_id":2,"game_mode":"anti"}'
Windows PowerShell
Invoke-RestMethod -Method Post -Uri 'https://othelloclub.com/flipsight/bot_match_api.php' -Headers @{Authorization="Bearer $env:FS_BOT_TOKEN"} -ContentType 'application/json' -Body '{"action":"agent_challenge","target_id":2,"game_mode":"anti"}'

Dæmi um svar

{
    "ok": true,
    "match_id": 123,
    "server_now_ms": 1800000000000
}

POST agent_accept

Samþykkja

ViðföngTegundNauðsynlegtLýsing
actionstring "agent_accept"NauðsynlegtHeiti aðgerðarinnar sem kallað er á
match_idinteger ≥ 1NauðsynlegtAuðkenni viðureignar (neikvætt í skákum gegn manni)

Dæmi um beiðni

curl 'https://othelloclub.com/flipsight/bot_match_api.php' \
  -H "Authorization: Bearer $FS_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"action":"agent_accept","match_id":123}'
Windows PowerShell
Invoke-RestMethod -Method Post -Uri 'https://othelloclub.com/flipsight/bot_match_api.php' -Headers @{Authorization="Bearer $env:FS_BOT_TOKEN"} -ContentType 'application/json' -Body '{"action":"agent_accept","match_id":123}'

Dæmi um svar

{
    "ok": true,
    "match": {
        "id": 123,
        "status": "running",
        "bot_a": 1,
        "bot_b": 2
    },
    "server_now_ms": 1800000000000
}

POST agent_reject

Hafna

ViðföngTegundNauðsynlegtLýsing
actionstring "agent_reject"NauðsynlegtHeiti aðgerðarinnar sem kallað er á
match_idinteger ≥ 1NauðsynlegtAuðkenni viðureignar (neikvætt í skákum gegn manni)

Dæmi um beiðni

curl 'https://othelloclub.com/flipsight/bot_match_api.php' \
  -H "Authorization: Bearer $FS_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"action":"agent_reject","match_id":123}'
Windows PowerShell
Invoke-RestMethod -Method Post -Uri 'https://othelloclub.com/flipsight/bot_match_api.php' -Headers @{Authorization="Bearer $env:FS_BOT_TOKEN"} -ContentType 'application/json' -Body '{"action":"agent_reject","match_id":123}'

Dæmi um svar

{
    "ok": true,
    "match": {
        "id": 123,
        "status": "rejected",
        "bot_a": 1,
        "bot_b": 2
    },
    "server_now_ms": 1800000000000
}

POST agent_move

Senda leik

ViðföngTegundNauðsynlegtLýsing
actionstring "agent_move"NauðsynlegtHeiti aðgerðarinnar sem kallað er á
match_idinteger ≠ 0NauðsynlegtAuðkenni viðureignar (neikvætt í skákum gegn manni)
round_nointeger ≥ 0Áskilið gegn manniAðeins í skákum gegn manni: round_no úr viðureignarhlutnum
room_created_atstringÁskilið gegn manniAðeins í skákum gegn manni: room_created_at úr viðureignarhlutnum
leginteger 0 | 1NauðsynlegtSkák 0 eða 1 (0 í skákum gegn manni)
revisioninteger ≥ 0Nauðsynlegtrevision skákarinnar sem leikurinn var reiknaður fyrir; 409 stale_revision ef skákin hefur breyst
moveinteger -1..99 | stringNauðsynlegtReitur 0-(board_size²−1), -1 fyrir pass / d3 / D3 / pass
evalnumber -100..100ValfrjálstMat vélarinnar þinnar eftir þennan leik, í skífum frá þinni hlið (+ þýðir að þú ert yfir, með 2 aukastöfum). Það nær upp í fjölda reita sem má leika á: -64 til 64 á 8x8, -100 til 100 á 10x10 og -88 til 88 á átthyrningi. Ef þú sleppir því eða sendir ógilt gildi fellur aðeins matið niður og leikurinn er tekinn gildur. Aðeins viðureignir milli vélmenna geyma það, allir sjá það á meðan skákin stendur, líka vélmenni andstæðingsins, og skákir gegn fólki hunsa það.

Dæmi um beiðni

curl 'https://othelloclub.com/flipsight/bot_match_api.php' \
  -H "Authorization: Bearer $FS_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"action":"agent_move","match_id":123,"leg":1,"revision":0,"move":2,"eval":1.5}'
Windows PowerShell
Invoke-RestMethod -Method Post -Uri 'https://othelloclub.com/flipsight/bot_match_api.php' -Headers @{Authorization="Bearer $env:FS_BOT_TOKEN"} -ContentType 'application/json' -Body '{"action":"agent_move","match_id":123,"leg":1,"revision":0,"move":2,"eval":1.5}'

Fólk gegn skráðum vélmennum

curl 'https://othelloclub.com/flipsight/bot_match_api.php' \
  -H "Authorization: Bearer $FS_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"action":"agent_move","match_id":-45,"leg":0,"revision":0,"move":"d3","round_no":1,"room_created_at":"2026-11-12 19:00:00"}'
Windows PowerShell
Invoke-RestMethod -Method Post -Uri 'https://othelloclub.com/flipsight/bot_match_api.php' -Headers @{Authorization="Bearer $env:FS_BOT_TOKEN"} -ContentType 'application/json' -Body '{"action":"agent_move","match_id":-45,"leg":0,"revision":0,"move":"d3","round_no":1,"room_created_at":"2026-11-12 19:00:00"}'

Dæmi um svar

{
    "ok": true,
    "match": {
        "id": 123,
        "status": "running",
        "bot_a": 1,
        "bot_b": 2
    },
    "server_now_ms": 1800000000000
}

POST agent_games

Sækja skákskrár

Skilar loknum skákum vélmennisins þíns sem skákskrám. Svarið er NDJSON (Content-Type application/x-ndjson), ein skák í hverri línu. Viðureignir milli vélmenna og skákir gegn fólki eru með, en ekki æfingaskákir né skákir gegn eigin reikningi vefsins othelloclub. Tæknilegar ógildingar eru með sem result void.

Þessi beiðni sýnir vélmennið þitt ekki sem tengt og telur ekki með í athugun á API-forskrift v2. Hvert vélmenni má kalla á hana einu sinni á 5 sekúndna fresti; hraðara kall fær 429 með retry_after_sec. Sendu Accept-Encoding: gzip til að fá þjappað svar.

ViðföngTegundNauðsynlegtLýsing
actionstring "agent_games"NauðsynlegtHeiti aðgerðarinnar sem kallað er á
sinceinteger ≥ 0ValfrjálstElsta updated_ms sem er tekið með, í ms. Sjálfgefið 0.
untilinteger ≥ 0ValfrjálstNýjasta updated_ms sem er tekið með, í ms. Sjálfgefið: núna.
maxinteger 1..300ValfrjálstMesti fjöldi skáka í hverju svari, 1 til 300. Sjálfgefið 100.
gamesarrayValfrjálstLeikir sem eru teknir með (std, anti, octagon, grand, reversi). Sjálfgefið: allir.
orderstring asc | descValfrjálstasc: elstu fyrst (sjálfgefið). desc: nýjustu fyrst.

Dæmi um beiðni

curl 'https://othelloclub.com/flipsight/bot_match_api.php' \
  -H "Authorization: Bearer $FS_BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"action":"agent_games","since":1799913600000,"max":100}'
Windows PowerShell
Invoke-RestMethod -Method Post -Uri 'https://othelloclub.com/flipsight/bot_match_api.php' -Headers @{Authorization="Bearer $env:FS_BOT_TOKEN"} -ContentType 'application/json' -Body '{"action":"agent_games","since":1799913600000,"max":100}'

Dæmi um svar

{
    "format": 1,
    "kind": "bot",
    "id": 123,
    "url": "https://othelloclub.com/flipsight/lab?match_id=123",
    "game_mode": "std",
    "opening_mode": "random12",
    "board_size": 8,
    "time_limit_sec": 60,
    "auto": true,
    "ranked": true,
    "rating_applied": true,
    "status": "finished",
    "finish_reason": "discs",
    "result": "win",
    "started_ms": 1799999962428,
    "finished_ms": 1800000000000,
    "updated_ms": 1800000000000,
    "me": {
        "bot_id": 2,
        "name": "MyBot",
        "engine": "MyEngine",
        "rating_before": 2138.51,
        "rating_after": 2143.53
    },
    "opponent": {
        "kind": "bot",
        "bot_id": 9,
        "name": "Ethan",
        "builtin": true,
        "engine": null,
        "rating_before": 2017.41,
        "rating_after": 2017.41
    },
    "discs": [73, 55],
    "opening": "e6f6d3e7f5e3f7c4",
    "opening_squares": [44, 45, 19, 52, 37, 20, 53, 26],
    "opening_colors": "BWBWBWBW",
    "legs": [
        {
            "my_color": "W",
            "status": "finished",
            "discs": [28, 36],
            "result_discs": [28, 36],
            "colors": "BWB",
            "moves": "f3f4c3",
            "squares": [21, 29, 18],
            "at_ms": [1799999962491, 1799999965034, 1799999965089],
            "used_ms": [63, 1111, 55],
            "left_ms": [59937, 58889, 59882],
            "evals": [null, -1.5, null]
        },
        {
            "my_color": "B",
            "status": "finished",
            "discs": [37, 27],
            "result_discs": [37, 27],
            "colors": "BWB",
            "moves": "b3b4c3",
            "squares": [17, 25, 18],
            "at_ms": [1799999963923, 1799999964158, 1799999965481],
            "used_ms": [1495, 235, 1323],
            "left_ms": [58505, 59765, 57182]
        }
    ]
}

Skákskrár

Skákskrá (record) er einn JSON-hlutur fyrir eina lokna skák. Hún geymir keppendur, úrslit, stig, byrjun og tíma hvers leiks, frá hlið vélmennisins þíns. Þú færð sama hlutinn á tveimur stöðum.

  1. Atburður við skáklok: Þegar skák lýkur ber síðasti match-atburðurinn (status finished eða aborted) record.
  2. agent_games: Skilar loknum skákum, einni í hverri línu. Notaðu hana fyrir eldri skákir og skákir sem fóru fram hjá þér.

Leikir eru skráðir með skákritun vefsins. Hver leikur er tveir stafir, og pass er pa. Dálkar eru a til j og raðir 1 til 9; á 10×10 er tíunda röðin 0 (j0 er reitur 99). squares gefur sömu leiki sem reitanúmer (-1 fyrir pass), og colors gefur þá hlið sem lék, B eða W.

Skákir sem klárast meðan straumurinn þinn er rofinn og skákir gegn fólki þar sem skákskráin er ekki enn tilbúin fá ekkert record í atburði við skáklok. Fylltu slík göt með agent_games svona.

  1. Upphafspunktur: Sendu updated_ms nýjustu vistuðu skákskrárinnar þinnar sem since. since tekur tímann sjálfan með, svo síðasta skákskráin þín kemur aftur.
  2. Sleppa tvítökum: Slepptu skákskrá ef þú átt þegar sama kind og id.
  3. Næsta síða: Kallaðu aftur með nýjasta updated_ms sem þú fékkst. Hættu þegar svar færir engar nýjar skákskrár.
  4. Breyttar skákskrár: Skák sem breytist eftir að henni lauk, til dæmis við tæknilega ógildingu, kemur aftur með nýrra updated_ms. Settu nýju skákskrána í stað þeirrar gömlu.

agent_games

Svið skákskrár
SviðTegundLýsing
formatintegerÚtgáfa sniðs skákskrárinnar, nú 1. Nýjum sviðum má bæta við útgáfu 1; númerið hækkar aðeins þegar merking sviðs sem fyrir er breytist.
kindstringbot: viðureign milli vélmenna með tveimur skákum. human: ein skák gegn manni.
idintegerAuðkenni viðureignar fyrir kind bot, auðkenni skákar fyrir kind human. kind og id saman auðkenna skákskrá.
urlstringSíða til að spila skákina aftur
room_id, round_nointeger | nullAðeins skákir gegn manni: herbergi og umferð
game_modestringLeikur (std, anti, grand, octagon, reversi)
opening_modestringrandom12: slembin byrjun með 12 skífum í viðureign milli vélmenna. xot eða std: hvernig skák gegn manni hófst.
board_sizeinteger 8 | 10Reitir á hverri hlið, 8 eða 10
time_limit_secintegerSekúndur á skák, á lit
autobooleanBúið til með sjálfvirkri pörun
rankedbooleanHvort viðureignin telur til stiga
rating_appliedbooleanHvort úrslitin breyttu stigum
statusstringfinished, eða aborted við tæknilega ógildingu
finish_reasonstring | nullHvers vegna skákinni lauk: sömu gildi og state.finish_reason í viðureignum milli vélmenna, gildi leikherbergisins í skákum gegn manni.
resultstringwin, loss, draw eða void, frá hlið vélmennisins þíns
started_ms, finished_ms, updated_msinteger | nullUpphafs- og lokatími í ms; started_ms er null í skákum gegn manni. updated_ms er hvenær skákskránni var síðast breytt, venjulega lokatíminn, og since og until eru borin saman við það.
meobjectVélmennið þitt: bot_id, name, engine, rating_before, rating_after. engine er heiti leikvélarinnar sem var tilkynnt í upphafi; bæði stigin eru null þegar skákin taldi ekki til stiga.
opponentobjectAndstæðingur: kind (bot, human eða guest), name, engine, rating_before, rating_after. Vélmenni hefur einnig bot_id og builtin, maður player_id.
discs[integer, integer]Skor vélmennisins þíns og andstæðingsins: samtala beggja skáka (state.totals) í viðureignum milli vélmenna, fjöldi skífa í skákum gegn manni.
opening, opening_squares, opening_colorsstring, integer[], stringByrjunarleikir á undan skákunum, með sömu ritun: slembin byrjun með 12 skífum eða XOT-byrjun.
legs[].my_colorstringLitur vélmennisins þíns í þessari skák, B eða W
legs[].statusstringactive, finished, timeout, stopped
legs[].discs[integer, integer]Fjöldi skífa í litaröð (svart, hvítt)
legs[].result_discs[integer, integer] (optional)Valfrjáls úrskurðuð staða [svart, hvítt] fyrir skák sem tapaðist á tíma; hún er lögð saman í stað skífa. Stig þeirrar hliðar sem féll á tíma og andstæðings hennar: std og reversi 0 og 64, grand 0 og 100, octagon 0 og 88, anti 64 og 0. Hin skákin heldur áfram og samtölurnar ráða sigurvegaranum þegar báðum skákum er lokið. Eldri færslur sem er lokið eru ekki endurreiknaðar.
legs[].moves, squares, colorsstring, integer[], stringLeikir skákarinnar eftir byrjunina: moves sem strengur, squares sem tölur, colors sem B eða W fyrir hvern leik.
legs[].at_ms, used_ms, left_ms(integer | null)[]Fyrir hvern leik: hvenær hann var leikinn í ms, notaður tími og eftirstandandi tími á klukku þess sem lék, eftir leikinn. Leiktímar eru null í skákum gegn fólki, og óþekkt gildi eru líka null.
legs[].evals(number | null)[] (optional)Matið sem sá sem lék sendi með leiknum, í skífum frá hans hlið. Leikir sendir án mats hafa null. Sviðið vantar þegar enginn leikur í skákinni hafði mat.

Villur

Villur líta svona út: {"ok": false, "error": "…"}. Við 401: stöðva og athuga lykil. Við 409: athuga umferð, revision og löglega leiki í nýjustu stöðunni þinni (tengdu strauminn aftur ef þú ert óviss). 410 þýðir að aðgerðin hefur verið fjarlægð (agent_poll frá 2026-11-22 00:00 (UTC+9)): notaðu atburðastrauminn. 429 þýðir of margar beiðnir (yfir 20 á sekúndu frá einu vélmenni eða 40 á sekúndu frá öllum vélmennum á sömu IP-tölu til bot_match_api.php). Við 429, 5xx og tengivillur: sendu sömu beiðni aftur eftir 0,2 til 0,5 s (fylgdu Retry-After ef það kemur) og lengdu biðina eftir nokkrar tilraunir. Sendu aldrei ólöglegan leik aftur.

{"ok":false,"error":"stale_revision","server_now_ms":1800000000000}
HTTPerror
400JSON object required / unknown action
401invalid bot credential
403access denied / invalid csrf
405POST required
409stale_revision / not_your_turn / illegal_move / leg_finished / match not running / match timed out / stale room revision / invalid move coordinate / move outside board / unsupported game mode / both bots must be connected / bot already has an active match / bot busy / engine thread limit exceeded / bot challenge repeat limit / challenge expired or answered / site bot variant matches are full / target bot not found
410agent_poll was removed; use bot-stream
413request too large
429Too many requests (bot_match_api.php rate limit)
503bot match storage unavailable

agent_poll
Sækja stöðu (fjarlægt 2026-11-22)

Fjarlægt 2026-11-22 00:00 (UTC+9): eftir það skilar það HTTP 410 {"ok": false, "error": "agent_poll was removed; use bot-stream"}. Fáðu stöðuna þína frá atburðastraumnum og tengdu hann aftur til að samstilla. Fram að því svarar það enn, en frá 2026-11-21 23:40 (UTC+9) er skráð vélmenni sem hefur kallað á það á síðustu 10 mínútum tekið út úr sjálfvirkri pörun.

Að útfæra API-ið sjálfur
Copyright © Othelloclubthe.othelloclub.com@gmail.com All rights reserved.