Commander, HTTP ve makine tarafından okunabilir kılavuzlar

Arayüz seçimi

Arayüz	Kullanım	Önemli sınır
Terminal	Günlük oyun, komutlar, canlı filo ve kuyruk	Öğe anahtarları İngilizce kalır
Tarayıcı	Kayıt, hesap güvenliği, ittifak merkezi, mesaj, rapor, gezegen adı/terk etme, sıralama	Tam yapım ve filo gönderim istemcisi değildir
Commander MCP	Asistanın giriş yapılmış oyuna erişimi	Araçlar açık yetki gruplarına bağlıdır
Oyuncu HTTP API'si	Aynı servisleri kullanan özel istemci	Kimlik ve sahiplik kontrolleri geçerlidir
Discord	Kimlik bağlantısı, topluluk rolleri ve bildirimler	Ayrı bottur, oyun giriş yöntemi değildir

Commander kurulumu, kesin araç sözleşmesi ve JSON dosyasını kullanın. Araç listesi testte gerçek MCP bağlantısından gelir. Çalışan eski süreç yeniden başlatılana kadar farklı liste sunabilir.

Commander akışı

1. Dünyalar, kuyruklar, filolar ve bildirimler için empire_overview okuyun.
2. Anahtar, maliyet ve tamamlanmış ön koşullar için codex ve research_tree okuyun.
3. Girdi kabul ediyorsa hedef gezegeni açıkça seçin.
4. Yetki verilen tek satın alımı veya görevi gönderin.
5. Yeni sipariş veya tekrar denemeden önce etkilenen durumu okuyun.

Read grubu araçları sınırlar ama sunucuda hiçbir kayıt değişmeyeceği anlamına gelmez. Gezegen okuması geçmiş üretimi hesaplar. Görev okuması ödül verebilir. galaxy aracı gezinti on döteryum harcayabildiği için spend grubundadır. Aynı kurallar bütün istemcilere uygulanır.

Tek imparatorlukta bağımsız yazıcıları koordinasyonsuz çalıştırmayın. Yanıt tek anı gösterir. Başka terminal veya asistan sonraki isteğinizden önce kaynakları harcayabilir. Son bakiye ve kilitleri sunucu denetler.

Terk etme önce preview_abandon_planet, sonra yeni onay bilgileri ve açık onayla abandon_planet kullanır. Ön izleme terk etme yetkisi değildir. Asistanın gönderdiği diğer yıkıcı işlemler de normal oyun sonuçlarını doğurur.

HTTP oturumu ve aktarım

Temel adres https://terminal.army olur. Oyuncu yolları /api/v1 altındadır. Oturumu Authorization: Bearer <session-token> ile gönderin. JSON gövdesi için Content-Type: application/json kullanın. Anahtarı URL'ye veya genel belgeye yazmayın.

Cihaz girişi POST /auth/start ile başlar ve tarayıcı onay bilgisini döndürür. POST /auth/poll, onay veya süre sonuna kadar cihaz code değerini alır. /auth/me ve /api/v1/me giriş kimliğini okur. Etkileşimli istemcide cihaz akışını tercih edin. Ham parola kayıt/giriş uçları vardır ama hesap ve iki aşamalı doğrulama kuralları geçerlidir.

Yol envanteri gerçek yönlendiriciden üretilir. İstek ve veri türleri gerçek JSON alan adlarını korur. Bunlar biçimi açıklar, bütün izin ve doğrulamaları açıklamaz. omitempty girdinin isteğe bağlı olduğu anlamına gelmez. Sınırlar ilgili oyun bölümündedir.

GET /api/v1/events, WebSocket değil sunucudan gönderilen olay akışıdır (SSE). Tek bağlantı tutun, kesilince bağlanın ve durumu tekrar okuyun. Olay, durumu yenileme nedenidir. Durumun tam yerine geçmez.

Sık yazma işlemleri

Aşağıdaki P, Q, F, A, T, gerçek gezegen, kuyruk, filo, ACS ve takas kimliğidir.

İşlem	Yöntem ve yol	JSON gövdesi
Yükselt	POST /api/v1/planets/P/buildings	{"building":"metal_mine"}
Gemi yap	POST /api/v1/planets/P/shipyard	{"ship":"small_cargo","count":1}
Savunma yap	POST /api/v1/planets/P/defense	{"defense":"rocket_launcher","count":1}
Araştır	POST /api/v1/research/	{"planet_id":P,"tech":"energy"}
Kuyruk iptal	DELETE /api/v1/queues/Q	Yok
Geri çağır	POST /api/v1/fleet/F/recall	Yok
ACS kur	POST /api/v1/fleet/acs	{"fleet_id":F}
ACS davet	POST /api/v1/fleet/acs/A/invite	{"username":"friend"}
Takas kabul	POST /api/v1/trades/T/accept	{"planet_id":P}
Açık takas iptal	DELETE /api/v1/trades/T	Yok
Üretim desteği	POST /api/v1/darkmatter/boost	{"planet_id":P}
Hızlandır	POST /api/v1/darkmatter/rush	{"queue_id":Q}
Ad değiştir	POST /api/v1/darkmatter/rename	{"planet_id":P,"name":"New Dawn"}

Simgesel kimlikler nedeniyle tablo doğrudan çalıştırılabilir JSON değil şema örneğidir. Gerçek kimlikleri /planets/, /queues ve /fleet/ okumalarından alın.

Filo gönderimi POST /api/v1/fleet/ ve veri başvurusundaki svc.FleetDispatchRequest kullanır. origin_planet_id, hedef galaksi/sistem/konum, görev, gemiler, yük, hız, hedef dünya ve isteğe bağlı ACS/bekleme alanları vardır. Terminaldeki /deploy komutu aynı deploy görevini kullanır.

Takas araması GET /api/v1/trades/?planet_id=P kullanır. Filtreler offered, wanted, scope, max_hours, mine=true, sort=distance olur. Liste 200 kayıtla sınırlıdır. Oluşturma TradeCreateRequest yapısını kullanır. Başka alıcı önce kabul ederse kabul başarısız olabilir.

Falanks POST /api/v1/moon/phalanx ile moon_id, galaxy, system, position alır. Atlama /api/v1/moon/jump ile from_moon_id, to_moon_id, ships alır. Yük almazlar. Füze /api/v1/fleet/missiles ve MissileLaunch kullanır.

Terk etme ön izlemesini GET /api/v1/planets/P/abandon ile okuyun. POST, confirmation_code, confirmation_token, confirm=true kullanır. Anahtar beş dakika geçerlidir ve incelenen duruma bağlanır. Engel değişirse veya süre dolarsa yeniden inceleyin.

Hatalar ve tekrar deneme

Hatalar genellikle error, oyun işlem hataları ayrıca sabit code içerir. Bazı eski doğrulama yanıtlarında yalnızca error vardır. İngilizce cümleyi ayrıştırmak yerine durum ve içeriğe bakın.

Durum	Anlam	Sonraki işlem
400	Geçersiz gövde veya işlem	Girdiyi düzeltin. Aynı isteği tekrarlamayın
401	Eksik, süresi dolmuş veya iptal oturum	Yeniden giriş yapın
403	Sahiplik, rol, koruma veya kural reddi	Nedeni ve güncel durumu okuyun
404	Olmayan nesne veya yol	Kimlik ve sürümleri kontrol edin
409	Kaynak, kuyruk veya sonuçlanan iş çakışması	Etkilenen durumu yenileyin
429	Hız sınırı	Retry-After veya retry_after izleyin
500/503	Sunucu veya servis sorunu	Durumu kontrol edin, yazmayı tekrar etmeden önce okuyun

Önemli kodlar insufficient_resources, prerequisite_not_met, queue_busy, queue_item_done olur. POST genel olarak yinelendiğinde aynı sonucu garanti etmez. Genel idempotency-key sözleşmesi yoktur. Yanıt kaybolursa kuyruğu, filoyu, takası veya mesaj geçmişini okuyun. Ağ zaman aşımını geri alma kanıtı saymayın.

Mobil yardımcı

Sunucu etkinleştirdiğinde mobil yardımcı /api/mobile/v1 yolunu kullanır. Durum, filolar, raporlar, sohbet ve bildirimleri gösterir. Oyun emri veremez veya ittifak rollerini yönetemez.

Giriş, tarayıcı onayı ve ayrı yardımcı kimlik bilgileri kullanır. Oyun kimlik bilgileri yardımcı API'sinde geçmez. Yardımcı kimlik bilgileri oyun API'sinde geçmez. Yardımcı okumaları oyun varlığını değiştirmez veya kara madde kazandırmaz.

LLM keşfi ve dışa aktarma

llms.txt Türkçe Markdown bölümlerini listeler. llms-full.txt bütün kılavuzu birleştirir. İngilizce sürümler kök adrestedir. Her bölümün index.md karşılığı vardır. Örneğin /tr/economy/index.md.

HTML sayfaları Markdown alternatifini ve llms dizinini bağlantı verileriyle duyurur. Oyunun /llms.txt yolu belge dizinine yönlendirir. Dosyalar insan kılavuzuyla aynı genel Markdown kaynaklarından üretilir. İç operatör notları ve kimlik bilgileri dahil değildir.

Dizin llms.txt önerisini izler. Bağlam verir. Asistana harcama, mesaj veya saldırı yetkisi vermez. Güncel sunucu yanıtları önbellekteki kılavuzdan ve dış OGame kaynaklarından önce gelir.