Der Bestellschalter
Deine Nachbarn bestellen Weizen, Karotten und Kürbisse per Mail. Der Bestellschalter schaut in dein Postfach, listet die neuen Bestellungen auf dem Laptop, markiert sie und legt sie in einen Ordner Orders. Ein zweiter Knopf zeigt die nächste offene Bestellung mit ihrem Text und markiert sie als beantwortet, wenn du sie gepackt hast.
Funktionen: IMAP_SERVER, MAILBOX, MAIL, IMAP_SELECT, IMAP_SEARCH, IMAP_FETCH, IMAP_STORE und IMAP_MOVE
Was du brauchst
- die Mod c0de net in deinem Spiel
- ein Mailkonto, dessen Anbieter IMAP erlaubt – schlag seinen IMAP-Server nach, etwa
imap.example.com, und den Port, meist 993 - dein App-Passwort als Geheimnis
mailPasswordin deinem Tresor, wie in Mail von der Farm, und den Tresor offen - einen Ordner Orders in deinem Postfach – leg ihn in deinem Mailprogramm an oder mit dem Programm aus Das Postfach aufräumen
- zwei Auslöserblöcke mit Knöpfen,
ordersunddeliver, einen Laptop und Variablenkartenserver(STRING) undport(INTEGER)
Die Idee
IMAP ist die Art, wie Mailprogramme ein Postfach auf dem Server lesen: Die Nachrichten bleiben dort, in Ordnern wie INBOX, und jedes Programm sieht dasselbe. Der Struct-Typ IMAP_SERVER von c0de hält die Verbindung, wie SMTP_SERVER fürs Senden.
Jede Funktion von c0de_net/mail öffnet ihre eigene Verbindung, erledigt ihre Arbeit und schließt sie wieder – zwischen zwei CALL-Zeilen bleibt nichts offen. Woher wissen die Funktionen dann, in welchem Ordner du arbeitest? IMAP_SELECT prüft, ob ein Ordner existiert, und schreibt seinen Namen in das Element folder deiner IMAP_SERVER-Variablen. Die Funktionen für Nachrichten – IMAP_SEARCH, IMAP_FETCH, IMAP_STORE, IMAP_MOVE und IMAP_EXPUNGE – arbeiten in diesem Ordner. Weil IMAP_SELECT die Variable ändert, gibst du ihm die Variable selbst, keine Berechnung.
Nachrichten haben UIDs, Nummern, die in ihrem Ordner eindeutig sind. IMAP_SEARCH gibt die UIDs der Nachrichten zurück, die zu Kriterien passen, IMAP_FETCH liest die Nachrichten zu UIDs. Und jede Nachricht hat Flags: \Seen, sobald sie gelesen ist, \Answered, \Flagged für die wichtigen, \Deleted und \Draft. IMAP_STORE setzt und entfernt sie.
Das Programm
PROGRAM orderdesk
NOOP
INCLUDE c0de_net/mail
NOOP
FUNCTION orders
PARAMETER server STRING "imap.example.com"
PARAMETER port INTEGER 0
RESULT count INTEGER
BEGIN
SECRET mailPassword STRING
VARIABLE imap STRUCT c0de_net/mail/IMAP_SERVER
VARIABLE box STRUCT c0de_net/mail/MAILBOX
VARIABLE uids ARRAY INTEGER
VARIABLE letters ARRAY STRUCT c0de_net/mail/MAIL
ASSIGN imap.server server ;
ASSIGN imap.port port ;
ASSIGN imap.user "steve@example.com" ;
ASSIGN imap.password mailPassword ;
CALL CLS
CALL c0de_net/mail/IMAP_SELECT
PARAMETER server imap ;
RESULT result box
CALL PRINT
PARAMETER value box.unseen ⊕ " of " ⊕ box.messages ⊕ " messages unseen" ;
CALL c0de_net/mail/IMAP_SEARCH
PARAMETER server imap ;
PARAMETER criteria "UNSEEN SUBJECT Order:" ;
RESULT result uids
CALL c0de_net/mail/IMAP_FETCH
PARAMETER server imap ;
PARAMETER uids uids ;
PARAMETER text FALSE ;
RESULT result letters
EACH letter letters
BEGIN
CALL PRINT
PARAMETER value "New: " ⊕ letter.subject ;
END EACH
CALL c0de_net/mail/IMAP_STORE
PARAMETER server imap ;
PARAMETER uids uids ;
PARAMETER flags "\\Flagged" ;
CALL c0de_net/mail/IMAP_MOVE
PARAMETER server imap ;
PARAMETER uids uids ;
PARAMETER folder "Orders" ;
CALL LEN
PARAMETER value uids ;
RESULT result count
END FUNCTION
NOOP
FUNCTION deliver
PARAMETER server STRING "imap.example.com"
PARAMETER port INTEGER 0
BEGIN
SECRET mailPassword STRING
VARIABLE imap STRUCT c0de_net/mail/IMAP_SERVER
VARIABLE box STRUCT c0de_net/mail/MAILBOX
VARIABLE uids ARRAY INTEGER
VARIABLE letters ARRAY STRUCT c0de_net/mail/MAIL
VARIABLE count INTEGER
ASSIGN imap.server server ;
ASSIGN imap.port port ;
ASSIGN imap.user "steve@example.com" ;
ASSIGN imap.password mailPassword ;
CALL CLS
CALL c0de_net/mail/IMAP_SELECT
PARAMETER server imap ;
PARAMETER folder "Orders" ;
RESULT result box
CALL c0de_net/mail/IMAP_SEARCH
PARAMETER server imap ;
PARAMETER criteria "FLAGGED UNANSWERED" ;
RESULT result uids
CALL LEN
PARAMETER value uids ;
RESULT result count
IF count = 0 ;
BEGIN
CALL PRINT
PARAMETER value "No open orders" ;
EXIT 0 ;
END IF
CALL c0de_net/mail/IMAP_FETCH
PARAMETER server imap ;
PARAMETER uids uids[0] ;
RESULT result letters
CALL PRINT
PARAMETER value letters[0].from ;
CALL PRINT
PARAMETER value letters[0].subject ;
CALL PRINT
PARAMETER value letters[0].text ;
CALL c0de_net/mail/IMAP_STORE
PARAMETER server imap ;
PARAMETER uids uids[0] ;
PARAMETER flags "\\Answered" ;
CALL c0de_net/mail/IMAP_STORE
PARAMETER server imap ;
PARAMETER uids uids[0] ;
PARAMETER flags "\\Flagged" ;
PARAMETER mode "remove" ;
END FUNCTIONAufbauen und ausführen
- Stelle den ersten Auslöserblock auf
orderdesk/ordersund den zweiten auforderdesk/deliver. Leg die Variablenkartenserverundportin beide und eine nicht initialisierte Variablenkarte für das Ergebniscountin den ersten. - Binde den Laptop an
orderdesk/ordersund drück den ersten Knopf. Der Laptop zeigt, wie viele Nachrichten ungelesen sind, und die neuen Bestellungen:
3 of 6 messages unseen
New: Order: 32 wheat
New: Order: 12 carrotsDas Ergebnis count ist 2. In deinem Mailprogramm sind die beiden Bestellungen nach Orders gewandert, mit Markierung, und noch ungelesen.
- Binde den Laptop an
orderdesk/deliverund drück den zweiten Knopf. Er zeigt die älteste markierte Bestellung, die noch nicht beantwortet ist, mit ihrem Text:
Sam <sam@example.com>
Order: 16 eggs
Sixteen eggs for the bakery, by Friday.Drück ihn noch einmal für die nächste Bestellung. Wenn alle erledigt sind, sagt er No open orders.

So funktioniert es
- IMAP_SELECT ohne
folderwählt INBOX und gibt ihre MAILBOX zurück:messages,unseen,recent,uid_nextunduid_validity. Nach dem CALL istimap.foldergleich"INBOX". - Die Kriterien
UNSEEN SUBJECT Order:sind Wörter von IMAP, und alle müssen passen: ungelesen, mitOrder:im Betreff. Andere sindSEEN,FLAGGED,UNANSWERED,FROM alex,SINCE 1-Nov-2026und mehr – die Seite von IMAP_SEARCH listet sie. Ein Text mit Leerzeichen kommt in doppelte Anführungszeichen: TippeSUBJECT "wheat order"in den Dialog des Literals, was die Textschreibweise als"SUBJECT \"wheat order\""schreibt. - IMAP_FETCH gibt eine Liste von MAIL-Structs zurück:
uid,from,to,cc,subject,date,text,flagsundsize. MittextFALSE liest es alles außer dem Text, was schneller ist und die Nachricht ungelesen lässt – dein Mailprogramm zeigt sie weiter als neu. Indeliverliest es den Text, und die Nachricht wird\Seen, wie wenn du sie öffnest. - IMAP_STORE fügt Flags standardmäßig hinzu. Im Dialog des Literals tippst du
\Flagged; die Textschreibweise des Programms schreibt den Backslash doppelt,"\\Flagged".mode "remove"nimmt ein Flag weg,mode "set"ersetzt alle. - IMAP_MOVE legt die Nachrichten in einen anderen Ordner desselben Postfachs. In INBOX sind sie weg; in Orders bekommen sie neue UIDs.
deliverwählt Orders, suchtFLAGGED UNANSWEREDund nimmt die erste UID,uids[0]– die UIDs kommen älteste zuerst. Nach dem Anzeigen fügt es\Answeredhinzu und entfernt\Flagged, damit der nächste Druck die nächste zeigt.
Die Funktionen nehmen eine UID oder eine Liste, uids[0] und uids gehen also beide.
Probier es selbst
- Die Bestellungen sollen beim Eintreffen gleich mit ihrem Text gezeigt werden.
Lösung
Lass in orders die Zeile PARAMETER text FALSE ; weg und gib in der EACH-Schleife letter.text aus. Bedenke, dass dadurch jede neue Bestellung gelesen ist. Ein Laptop hat 20 Zeilen, lange Texte rollen also weg – gib nur die erste Zeile aus: Finde den ersten Zeilenumbruch, CHR 10, mit INSTR aus c0de/strings und schneide den Text dort mit LEFT ab.
- Nur Bestellungen deiner Nachbarn sollen zählen, nicht die von Fremden.
Lösung
Füge den Kriterien FROM hinzu, einmal für jeden Nachbarn, den du annimmst, jeweils in einer eigenen Suche: "UNSEEN SUBJECT Order: FROM alex@example.com". Die Kriterien von c0de kennen kein „oder“, also suche einmal pro Nachbar und verschiebe die UIDs jeder Suche.
Mehr dazu
- IMAP_SERVER, MAIL und MAILBOX
- IMAP_SEARCH: alle Kriterien
- Bestellungen lesen im Handbuch
- Das Postfach aufräumen