Mail von der Farm
Du bist nicht auf dem Server, und deine Farm arbeitet weiter. Dieses Rezept lässt sie dir einen kurzen Bericht schreiben: was heute in der Scheune liegt, als echte Mail in dein Postfach, mit einer Kopie für deinen Nachbarn. Du liest sie auf dem Handy wie jede andere Nachricht.
Funktionen: SMTP_SERVER, SMTP_SEND, SECRET für das Passwort aus dem Tresor und CHR aus c0de/strings
Was du brauchst
- die Mod c0de net in deinem Spiel
- ein Mailkonto, bei dem Programme über SMTP senden dürfen – das geht bei den meisten Anbietern. Schlag den Namen seines SMTP-Servers und den Port nach, etwa
smtp.example.comund 465. Viele Anbieter wollen für Programme ein App-Passwort: ein zweites Passwort, das du in den Einstellungen deines Kontos anlegst und jederzeit zurückziehen kannst. - dieses Passwort als Geheimnis
mailPasswordin deinem dauerhaften Tresor, aufbewahrt wie der Schlüssel in Schlüssel aufbewahren - einen Auslöserblock mit Knopf, einen Laptop und Variablenkarten
server(STRING) undport(INTEGER) mit Server und Port deines Anbieters
Die Idee
Ein Mailprogramm muss wissen, worüber es sendet. In c0de ist das eine Variable vom Struct-Typ SMTP_SERVER: der Server, der Port, wie die Verbindung verschlüsselt ist, der Benutzername, das Passwort und der Absender. server und from sind nötig; der Rest hat Vorgaben, die zu den meisten Anbietern passen.
Heikel ist das Passwort. Es darf nie im Programm stehen, wo es jeder lesen kann, der sich das Blatt ansieht. Deshalb holt das Programm es mit einer SECRET-Zeile aus deinem Tresor, und das Element password von SMTP_SERVER ist sensibel: Das Debugging-Werkzeug zeigt *** statt seiner.
Dann sendet SMTP_SEND die Nachricht: an eine Adresse oder an eine Liste, mit Kopien (cc), Blindkopien (bcc) und einer Adresse für Antworten (reply_to). Es gibt die Message-ID zurück, den Namen, den dein Mailanbieter der Nachricht gibt, etwa <a1b2c3@example.com>.
Wie die Anfragen von c0de_net/http geht die Mail vom Computer des Spielers hinaus, der das Programm startet, nicht vom Minecraft-Server. Dein Anbieter sieht also deine eigene Internetverbindung, wie wenn du vom Handy aus schreibst.
Das Programm
PROGRAM farmmail
NOOP
INCLUDE c0de/strings
INCLUDE c0de_net/mail
NOOP
FUNCTION report
PARAMETER server STRING "smtp.example.com"
PARAMETER port INTEGER 0
PARAMETER wheat INTEGER 64
PARAMETER carrots INTEGER 12
RESULT id STRING
BEGIN
SECRET mailPassword STRING
VARIABLE smtp STRUCT c0de_net/mail/SMTP_SERVER
VARIABLE helpers ARRAY STRING
BEGIN
"alex@example.com"
END VARIABLE
VARIABLE text STRING
VARIABLE nl CHAR
ASSIGN smtp.server server ;
ASSIGN smtp.port port ;
ASSIGN smtp.security "tls" ;
ASSIGN smtp.user "steve@example.com" ;
ASSIGN smtp.password mailPassword ;
ASSIGN smtp.from "Farm computer <steve@example.com>" ;
CALL c0de/strings/CHR
PARAMETER code 10 ;
RESULT result nl
ASSIGN text "Good morning!" ⊕ nl ⊕ nl ⊕ "In the barn today:" ⊕ nl ;
ASSIGN text text ⊕ wheat ⊕ " wheat" ⊕ nl ⊕ carrots ⊕ " carrots" ⊕ nl ;
ASSIGN text text ⊕ nl ⊕ "Your farm" ;
CALL c0de_net/mail/SMTP_SEND
PARAMETER server smtp ;
PARAMETER to "steve@example.com" ;
PARAMETER cc helpers ;
PARAMETER subject "The farm today" ;
PARAMETER text text ;
PARAMETER reply_to "steve@example.com" ;
RESULT result id
CALL PRINT
PARAMETER value "Report sent" ;
END FUNCTIONAufbauen und ausführen
- Bewahre dein App-Passwort in deinem Tresor als
mailPasswordauf und öffne den Tresor – das Programm kann nicht nach seinem Passwort fragen. - Stelle den Auslöserblock auf
farmmail/report, leg die Variablenkartenserverundportund eine nicht initialisierte Variablenkarte für das Ergebnis hinein, und binde den Laptop an dieselbe Funktion. - Ersetze
steve@example.comdurch deine eigene Adresse undalex@example.comdurch die deines Nachbarn, und drück den Knopf. Nach einem Moment zeigt der LaptopReport sent. - Schau in dein Postfach: Dort ist eine Mail The farm today von Farm computer:
Good morning!
In the barn today:
64 wheat
12 carrots
Your farm
So funktioniert es
smtp.security "tls"verschlüsselt die Verbindung von Anfang an, wie es Port 465 erwartet. Mitstarttls, der Vorgabe, beginnt die Verbindung auf Port 587 unverschlüsselt und wird vor der Anmeldung verschlüsselt.noneschickt alles lesbar – nur für einen Server in deinem Heimnetz.port 0wählt 465 beitlsund sonst 587.smtp.fromist der Absender mit einem Namen vor der Adresse,Farm computer <steve@example.com>. Die meisten Anbieter nehmen als Absender nur Adressen deines eigenen Kontos an.SECRET mailPassword STRINGliest das Passwort aus deinem Tresor in eine Variable, die nur in dieser Funktion lebt. Fehlt es, löst die Zeile SECRET_NOT_FOUND aus – Wenn Mails scheitern prüft das vorher.nlist ein Zeilenumbruch: CHR aus c0de/strings mit dem Code 10. Der Dialog eines Literals nimmt, was du tippst, so wie es ist, deshalb lässt sich ein Zeilenumbruch nicht in einen Text tippen; das Programm hängt ihn mit⊕an. Eine Mail ist reiner Text: keine Farben, keine Bilder, keine Anhänge.tonimmt eine Adresse als Text,cceine Liste von Adressen, hier die Variablehelpersmit ihrem Wert in einem BEGIN-Block. Die Adressen vontoundccsehen alle.reply_tosagt, wohin Antworten gehen. Ohne geht es an den Absender – hier ist das dasselbe, du kannst es also weglassen; es hilft, wenn die Farm von einem anderen Konto sendet als deinem.id, die Message-ID, ist das, womit Mailprogramme eine Antwort ihrer Nachricht zuordnen. Heb sie auf, wenn du Antworten später erkennen willst.
Die Grenzen
Der Minecraft-Server sorgt dafür, dass Programme nicht zu Spamschleudern werden. Jede Nachricht hat höchstens 20 Empfänger, to, cc und bcc zusammen, und 64 KiB Text, und ein Spieler kann 10 Nachrichten pro Minute senden. Der Administrator kann diese Grenzen in config/c0de_net.properties ändern; ein Programm über einer Grenze bekommt MAIL_LIMIT. Port 25, über den Mailserver miteinander sprechen, ist gesperrt: Sende immer über deinen Anbieter.
Probier es selbst
- Schick allen Nachbarn eine Einladung zum Erntefest – ohne ihnen die Adressen der anderen zu zeigen.
Lösung
PROGRAM farminvite
NOOP
INCLUDE c0de_net/mail
NOOP
FUNCTION invite
PARAMETER server STRING "smtp.example.com"
PARAMETER port INTEGER 0
BEGIN
SECRET mailPassword STRING
VARIABLE smtp STRUCT c0de_net/mail/SMTP_SERVER
VARIABLE neighbours ARRAY STRING
BEGIN
"alex@example.com"
"sam@example.com"
END VARIABLE
ASSIGN smtp.server server ;
ASSIGN smtp.port port ;
ASSIGN smtp.security "tls" ;
ASSIGN smtp.user "steve@example.com" ;
ASSIGN smtp.password mailPassword ;
ASSIGN smtp.from "Farm computer <steve@example.com>" ;
CALL c0de_net/mail/SMTP_SEND
PARAMETER server smtp ;
PARAMETER to "steve@example.com" ;
PARAMETER bcc neighbours ;
PARAMETER subject "Harvest festival at the farm" ;
PARAMETER text "Saturday at noon, bring a friend!" ;
CALL PRINT
PARAMETER value "Invitations sent" ;
END FUNCTIONDie Nachbarn kommen in bcc: Jeder von ihnen bekommt die Nachricht, aber keiner sieht, wer sie sonst noch bekam. Die Nachricht braucht trotzdem ein to, also geht sie an dich selbst.
- Der Bericht soll erst hinausgehen, wenn die Scheune voll ist. Starte ihn mit einem Komparator.
Lösung
Stell einen Komparator hinter die Truhe der Scheune, sodass sein Signal den Auslöserblock erreicht, wenn die Truhe voll ist, und stelle Starten durch auf Alle: Andere Redstone-Signale als Knopf, Hebel oder Platte starten einen Auslöserblock nur bei Alle. Dann drückt niemand einen Knopf, und der Prozess läuft als Besitzer des Auslöserblocks. Dieser Spieler muss mit c0de net online sein und den Tresor offen haben – sein Computer sendet die Mail. Lies Wie Anfragen gesendet werden und den Auslöserblock.
Mehr dazu
- SMTP_SERVER und SMTP_SEND
- Schlüssel aufbewahren: der dauerhafte Tresor
- Einstellungen von c0de net: die Grenzen für Mails
- Der Bestellschalter: die Antworten lesen