Domination
Ein Team hält ein paar Sekunden lang den Eingang des Props, um es einzunehmen, und punktet in jedem Takt, solange es das Prop hält. Das andere Team kann es jederzeit übernehmen.
Pre-Alpha · Software der Phasen 1 und 2 fertig; echte Boards spielen auf dem Labortisch ganze Spiele mit dem Feld-Controller, mit Tastenfeld; Phase 3 in Software fertig, die iOS-App auf einem iPhone geprüft; der Site-Server aus Phase 4 läuft auf einem Testserver; Phase 5 in Software gebaut · noch nicht feldtauglich
Die offene Plattform für Force-on-Force
Atalaia ist eine offene Plattform für die elektronischen Props von Airsoft, Paintball und Milsim: die Boxen, die Teams einnehmen, die Bomben, die sie scharf machen und entschärfen. Bau eine Domination-Box aus einem Mikrocontroller für 20 € (eine winzige, günstige Computerplatine), mach aus einem alten Android-Handy ein Hacking-Terminal, lass ein Milsim-Wochenende mit 20 Boxen über ein LoRa-Mesh laufen (Funk mit großer Reichweite und wenig Strom, den die Boxen über das Feld weiterreichen), und schreib deine eigenen Spielmodi als kleine Skripte. Jedes Spiel läuft auf dem Feld selbst: keine Cloud, kein Internet nötig, und kein Hersteller kann dich festnageln.
Atalaia (a-ta-LAI-a) ist Portugiesisch für Wachturm: ein Ausguck auf einem Hügel, der nach Gefahr Ausschau hielt und die Warnung weitergab. Warum dieser Name?
So läuft ein Spiel
Zum Spielen brauchst du kein Technikwissen. So wird ein Spiel laufen, sobald die Boxen gebaut sind (Phasen 1 und 2); der Simulator spielt dieselben Modi heute schon auf einem Computer.
Aufbauen
Die Orga verteilt die Boxen auf dem Feld und wählt einen Spielmodus, etwa Domination, am Tastenfeld einer Box oder am Handy, in weniger als einer Minute.
Einnehmen
Um eine Box einzunehmen, hält ein Team ein paar Sekunden lang den Knopf seiner Farbe gedrückt. Die Box leuchtet in dieser Farbe und punktet für das Team, bis die Gegenseite sie zurückholt.
Weiterleiten
Jede Box meldet sich per Funk beim Feld-Controller, einem kleinen Computer in der Basis; weit entfernte Boxen werden von denen dazwischen weitergeleitet. Eine Box, die den Kontakt verliert, spielt weiter und holt später auf.
Punkten
Der Controller zählt alles zusammen. Die Orga verfolgt das Spiel live auf dem Handy, und das Feld kann den Punktestand auf einem großen Bildschirm oder in einem Stream zeigen.
Warum Atalaia
Elektronische Props bringen viel ins Spiel, aber kommerzielle Systeme sperren die Regeln in geschlossene Firmware. Neue Modi warten auf den Hersteller, es gibt keine öffentliche API, und eigene Hardware kannst du nicht einbinden. Atalaia macht es anders.
Local-first
Jedes Spiel läuft auf dem Feld selbst, komplett offline, vom einzelnen Haus bis zum kilometergroßen Wald. Internet ist optional.
Jede Hardware
Günstige ESP32-Boards, scheckkartengroße Raspberry-Pi-Computer, einfache Boards der Arduino-Klasse und neue oder ausgediente Android-Handys haben alle ihren Platz im selben Spiel. Die Software für die ESP32-Boxen, den Feld-Controller und Android-Handys ist geschrieben; die Boards der Arduino-Klasse kommen später.
Modi sind Skripte
Spielmodi sind kurze Lua-Skripte, kleine Textdateien mit Regeln, plus eine Datei mit Einstellungen: leicht zu lesen, zu ändern und zu teilen, und kein Modus braucht eigenen Code in der eingebauten Software der Boxen. Vorerst haben die Boxen ihre Modi eingebaut; einen neuen ohne Neuflashen (Neuinstallieren) dieser Software zu schicken, kommt noch.
Offenes Protokoll und API
Props sprechen Skirmesh-RF, ein dokumentiertes Funkprotokoll, also kann jede und jeder ein Gerät bauen, das mitspielt. Der Feld-Controller bietet MQTT-, REST- und WebSocket-APIs für Anzeigetafeln, Stream-Overlays und andere Tools.
Fürs Spielfeld gebaut
Rollen, Squads, Check-in am Feld mit einem gedruckten Aushang und ein Chrono-Register, das die signierten Messwerte jeder Replik für Stichproben aufbewahrt, sind in Software gebaut; eigene Szenarien kommen in Phase 4.
Copyleft
Felder, die Eintritt nehmen, und Leute, die Boxen verkaufen, sind willkommen. Wer eine geänderte Version weitergibt oder betreibt, teilt die Änderungen.
Wie alles zusammenpasst
Einfach gesagt: Die Props auf dem Feld funken mit dem Feld-Controller, einem kleinen Computer in der Basis, der das Spiel leitet und die Punkte zählt. Handys verbinden sich per WLAN mit ihm, Anzeigetafeln, Stream-Overlays und Karten-Apps wie ATAK über seine API. Ein optionaler Site-Server im Internet verwaltet Konten und Verlauf. Der Controller, seine API und die Konsole der Orga sind gebaut und auf einem Computer getestet, noch nicht auf dem Feld; vom Site-Server gibt es bisher nur das Grundgerüst und die Konten (Anmeldung mit Zwei-Faktor-Codes und Rollen pro Feld; noch keine Spieldaten).
- Site-Server (optional): Konten, Verlauf und die Spieler-App, über das Internet.
- Feld-Controller auf einem Raspberry Pi oder Android: Apps für GM und Spielende verbinden sich per WLAN; Anzeigetafeln und ATAK nutzen MQTT, REST und Webhooks.
- Props im LoRa-Mesh Skirmesh-RF: ESP32-Field Boxes und Satelliten, Android-Props mit einem ESP32-Pod und Thin Nodes der Arduino-Klasse.
Unter der Haube nutzt jedes Gerät, das Spielmodi ausführt, denselben gemeinsamen Kern, geschrieben in C11, und dieselben Lua-Modi; nur eine dünne Schicht pro Hardware-Art ist anders. Ein einmal geschriebener Modus läuft auf einer Box, einem Handy oder einem Raspberry Pi gleich.
So funktioniert der Funk
Die Props funken über LoRa, einen Funk mit großer Reichweite und wenig Strombedarf, im eigenen Protokoll von Atalaia, Skirmesh-RF. Zwei Diagramme zeigen, was LoRa auf einem Feld kann und was nicht, und wie ein Protokoll auf sehr unterschiedlichen Geräten läuft. Nichts davon war schon auf einem echten Feld.
Spielmodi
Modi reagieren auf Absichten („ein Team beansprucht dieses Prop“), nicht auf Hardware, also läuft dasselbe Skript auf einer Field Box, einer Box mit Tastenfeld oder einem Android-Handy. Vierzehn Modi, ein Modifikator und das Medic-Kit sind heute in Software geschrieben und getestet; noch keiner lief auf einem echten Feld.
Bombe / Rush
Die Angreifenden machen die Bombe scharf und verteidigen sie; die Verteidigenden müssen sie entschärfen, bevor die Zündzeit abläuft. Eine Explosion beendet das Spiel, die Angreifenden gewinnen. Scharf machen und entschärfen durch Gedrückthalten eines Knopfs, oder jedes Team bekommt seinen eigenen Code fürs Tastenfeld.
Kill Confirmed
Spielende tragen signierte NFC-Tags. Ein Team scannt die gesammelten Tags an einer Station: Ein gegnerischer Tag bestätigt den Kill, ein Tag aus dem eigenen Team verweigert ihn. Gefälschte Tags werden abgelehnt.
So sieht es aus
Drei Modi, wie die Box sie zeigt: Animationen, die der Code der Field-Box-Firmware selbst zeichnet, nicht nachgebaut. Die Schaltfläche unter jedem Bild pausiert es. Weiter unten die Screenshots der App.
Die echte Box auf dem Labortisch
Die Modi oben sind Animationen, die der Code der Firmware zeichnet. Hier spielt der Aufbau der Field Box auf dem Labortisch (ein Board an losen Kabeln, ohne Gehäuse) wirklich Domination.
Die Android-App
Die eigenen Bildschirme der App gibt es auf Portugiesisch, Englisch, Deutsch und traditionellem Chinesisch, und sie zeichnet die Bildschirme jedes Modus aus denselben YAML-Dateien wie die Field Box. Das sind die Testbilder der App, keine Fotos eines Handys: Die App lief bisher auf Android-Emulatoren, noch nicht auf einem echten Handy.
Das Medic-Kit zeichnet seine Bildschirme aus denselben YAML-Dateien auf einer Field Box und auf einem Android-Prop, auf Portugiesisch, außer die Spielleitung stellt Englisch, Deutsch oder Chinesisch ein. So zeichnet die App sie:
Heute ausprobieren
Hardware brauchst du nicht: Der gemeinsame Kern läuft auf einem Computer. Der Simulator spielt einen Modus in deinem Browser: Halte Team-Knöpfe gedrückt, sieh dir den Bildschirm jedes Props an und verfolge das Event-Log. Die Befehle unten tippst du in ein Terminal.
Mit einem C-Compiler
cmake -S core -B build -DATALAIA_SHARED=ON
cmake --build build
cd simulator
python -m atalaia_sim serve ../modes/bombNur mit Docker
cd simulator
python ../tools/docker_sim.py serve ../modes/bombDann öffne http://localhost:8000. Du brauchst Python 3.10+ mit PyYAML. Die Anleitung zum Simulator (auf Englisch und Portugiesisch) hat alle Optionen.
Auf einem Board
Die Firmware der Field Box, des USB-Funkmodems und des I/O-Pods ist geschrieben, und alle drei laufen in Tests auf einem Computer. Die der Field Box und des Modems laufen auf echten Heltec V4.3 auf dem Labortisch: Eine Box tritt über Funk den Spielen des Feld-Controllers bei, mit einem zweiten Board als Modem, spielt sie bis zum Ende und bekommt Firmware-Updates per Funk, wobei der kleine Bildschirm des Boards das Spiel zeigt; die des Pods lief noch auf keinem Board. Um ein nacktes Board ohne Box zu testen, gibt es eine Labor-Version der Firmware (Tasten über das USB-Kabel). Um eine Box zu bauen und zu flashen, folge dem Bauhandbuch; die Anleitung zur Firmware baut auch Modem und Pod (beide auf Englisch).
Auf einem Android-Handy
Bau die Debug-APK der App mit Docker und installiere sie auf einem Handy mit Android 8.0 oder neuer oder im Android-Emulator, wie die Anleitung zur App (auf Englisch und Portugiesisch) erklärt. Sie lief auf Emulatoren, noch nicht auf einem echten Handy.
Spielen und ausrichten
Handbücher für alle, die Atalaia benutzen, nicht für Entwickelnde: für Spielende, Orga, Marshals, Box-Betreuende und alle, die Boxen bauen, auf Englisch und Portugiesisch, mit einer Kurzanleitung auf einer Seite. Sie beschreiben, was die Software heute zeigt, und markieren, was noch nicht auf einem Feld erprobt wurde. Auf Deutsch gibt es sie noch nicht.
Roadmap
Sechs Phasen, jede mit einem echten Feldtest als Abschluss: ihrem Gate. Die Software ist der Hardware voraus: Die Phasen 1 bis 3 sind in Software fertig (echte Boards spielen auf dem Labortisch ganze Spiele, und die iOS-App hat ihre Checkliste auf einem iPhone bestanden); die Phasen 4 und 5 sind in Software gebaut. Die Gates warten auf gebaute Boxen, Feldtests, einen echten Server und den Registry-Schlüssel des Projekts.
- Fertig
0 · Grundlagen
Gemeinsamer Kern, Lua-Sandbox, Skirmesh-RF-Codec und Browser-Simulator. Gate erreicht.
- Software fertig
1 · Eine Box
Firmware der Field Box und ein Bauhandbuch; auf dem Labortisch spielt ein echtes Board ganze Spiele, inzwischen mit Display, Tastenfeld und Tastern an losen Kabeln (Foto und Clip auf der Bauseite). Es fehlt noch eine zusammengebaute Box.
- Software fertig
2 · Feldnetzwerk
Skirmesh-RF über LoRa, Feld-Controller, API, GM-Konsole und ein Modus-Paket, in Software getestet; auf dem Labortisch spielen echte Boards ganze Spiele mit dem Controller über Funk, und was der Labortisch gezeigt hat, ist in Software behoben. Es warten 5 gebaute Boxen auf einem Feld.
- Software fertig
3 · Android und Spielende
Android-Props, der I/O-Pod, die Spieler-App und die Modi, die Handys brauchen: in Software fertig, iOS eingeschlossen (auf einem iPhone geprüft). Der Feldtest wartet auf echte Handys und Pods.
- Software fertig
4 · Site-Server und erweitertes Spiel
Site-Server, Spielplanung und Anmeldung, eigene Szenarien, erweiterte Modi, ATAK. Alle Software-Schritte sind gebaut; die Anmeldung mit Google und Microsoft wurde auf einem Testserver echt ausprobiert. Es fehlen ein echter Server, die Go-live-Bedingungen des Hosted-Modus und die Tests auf Hardware.
- Software fertig
5 · Community
Visueller Modus-Editor, signierte Modus-Pakete, die Modus-Registry als Vorlage, Deutsch und traditionelles Chinesisch, Bauanleitungen. Alle Software-Schritte sind gebaut.
Die ganze Roadmap, mit dem Inhalt jeder Phase und ihrem Gate →
Community-Hub
Hier werden sich Felder, Teams und Bastelnde treffen. Alles ist freiwillig: Der Hub enthält nur, was Leute veröffentlichen möchten, und Spieldaten bleiben auf den eigenen Servern jedes Felds.
- Offen
Diskussion
Fragen, Ideen, Reviews des Designs und Berichte von Events. Zu den Discussions
- Geplant
Bau-Galerie
Fotos, Stücklisten, Gehäusedateien und Verdrahtungsnotizen für jeden Bau, angefangen mit den ersten Prototypen der Field Box.
- Geplant
Verzeichnis von Feldern und Teams
Eine freiwillige Liste von Feldern und Teams, die Atalaia nutzen, mit Region, Geländeart und einem Kontakt-Link.
- Geplant
Modus- und Szenario-Browser
Die Modus-Registry ist online, noch ohne Modi: Sei die oder der Erste. Ein Browser mit Beschreibungen und Bewertungen der Community kommt später.
- Später
Nutzungsstatistik
Freiwillige, anonyme Summen von Versionen, Plattformen und gespielten Modi. Standardmäßig aus.
- Später
Gehostete Site-Server
Für Clubs ohne IT-Unterstützung, zum Selbstkostenpreis, mit getrennten und exportierbaren Daten jedes Clubs.
Mitmachen
Atalaia wird von Spielenden, Feldbetreibenden und Bastelnden gebaut. Du kannst heute schon helfen:
- die Design-Spezifikation (auf Englisch und Portugiesisch) prüfen und Issues eröffnen;
- Spielmodi mit der Vorlage für Spielmodus-Ideen vorschlagen;
- erzählen, wie auf deinem Feld gespielt wird, damit die Standardwerte zu echten Spielen passen;
- Code schreiben: Fang mit CONTRIBUTING.md (auf Englisch und Portugiesisch) an.
Jeder Commit trägt eine Zeile Signed-off-by, und das Projekt ist strikt Clean-Room, von Grund auf neu geschrieben: kein Code, keine Firmware, keine Handbücher, Töne oder Bilder aus einem kommerziellen Produkt.
Der Name
Eine atalaia ist ein Wachturm: ein Ausguck auf einem Hügel oder an einem Küstenstreifen. Das Wort kam aus dem Arabischen aṭ-ṭalāʾiʿ, „die Späher“, ins Portugiesische, und estar de atalaia heißt noch heute „auf der Hut sein“.
Ein Feld-Controller sieht jedes Prop auf dem Feld und sagt der Spielleitung sofort, wenn sich etwas ändert. Auch Wachtürme waren local-first und betrieben das ursprüngliche Mesh mit wenig Bandbreite: Rauch bei Tag, Feuer bei Nacht, von Turm zu Turm weitergegeben. Skirmesh-RF folgt denselben Regeln mit LoRa.
Sicherheit auf dem Feld
Props von Atalaia sind Spielausrüstung. Lass sie wie Spielprops aussehen: kräftige Farben, klare Aufschriften „GAME PROP“ und nichts, was einem echten Sprengsatz ähnelt. Transportiere sie in beschrifteten Koffern, lass sie außerhalb des Felds nie unbeaufsichtigt und geh sorgsam mit Lithium-Akkus um.