Projekt: die bewachte Tür
In der Lektion Entscheidungen treffen konnte dein Türwächter die Leute nur begrüßen. Jetzt bekommt er echte Macht: Er öffnet die Tür. Der Eingang von Oak Hill bekommt eine Eisentür, die niemand mit der Hand öffnen kann. Davor liegt eine Druckplatte. Wenn du oder einer deiner Freunde darauftritt, geht die Tür auf. Fremde bleiben draußen. Und das Willkommensschild zeigt, wie viele Besucher an der Tür stehen.
Neue Wörter
- Zeitgeber: etwas, das ein Programm immer wieder startet, in einem festen Abstand – hier jede Sekunde.
- Welt: alles rund um das Programm in Minecraft: Blöcke, Türen, Spieler. Dieses Programm liest die Welt und verändert sie.
Was du brauchst
- ein neues, leeres Blatt in der c0de-Dimension und den Schraubenschlüssel
- eine Eisentür in der Wand deiner Basis, eine Druckplatte, einen Knopf und einen Hebel
- einen Zeitgeberblock
- deine Anzeigewand am Eingang (das Willkommensschild)
- die Blöcke, die du kennst, darunter INCLUDE, EACH, IF, RETURN und die Typblöcke ARRAY, STRUCT und BOOLEAN
Braucht einen Operator
Eisentüren lassen sich nicht mit der Hand öffnen, darum darf ein Programm sie nur öffnen, wenn der Besitzer des Zeitgeberblocks ein Operator ist. In der Welt der Tutorials bist du ein Operator, also funktioniert es. Auf einem Server kann der Administrator es mit allowBlockChanges=true in config/c0de.properties für alle erlauben. Ohne dieses Recht stürzt das Programm mit PERMISSION_DENIED ab. Eine Holztür funktioniert für alle – aber dann kann jeder sie mit der Hand öffnen, und der Wächter kann nur begrüßen.
Die Idee
Stell dir eine Wache am Tor einer Burg vor. Alle paar Augenblicke schaut sie sich um: Wer steht auf der Fußmatte? Ist es der Burgherr oder einer seiner Freunde? Dann öffnet sie das Tor. Ist es ein Fremder? Dann bleibt das Tor zu. Dann wartet sie einen Moment und schaut wieder.
Die Wache entscheidet nicht einmal; sie prüft immer wieder. Genau das macht ein Zeitgeber: Ein Zeitgeberblock startet dein Programm jede Sekunde. Jeder Durchlauf schaut sich die Welt an, entscheidet und handelt – und ist nach einem Moment vorbei. Eine Sekunde später startet der nächste Durchlauf.
Jeder Durchlauf fängt frisch an. Wie eine Wache, die am Ende ihrer Runde alles vergisst, weiß ein Durchlauf nicht, was der Durchlauf davor gesehen hat. Darum zeigt das Schild, wer gerade jetzt an der Tür ist: Das Programm zählt in jedem Durchlauf die Spieler in der Nähe der Tür.
Das Programm
Das Programm door kommt auf ein neues Blatt.
PROGRAM door
NOOP
INCLUDE c0de/minecraft
CONSTANT BASE STRING "Oak Hill"
VARIABLE friends ARRAY STRING
BEGIN
"Alex" "Kai"
END VARIABLE
VARIABLE plate STRUCT c0de/minecraft/POSITION
BEGIN
x 100
y 64
z 198
END VARIABLE
VARIABLE door STRUCT c0de/minecraft/POSITION
BEGIN
x 100
y 64
z 200
END VARIABLE
NOOP
FUNCTION isFriend
PARAMETER name STRING
RESULT friend BOOLEAN
BEGIN
IF name = SHEET.owner ;
BEGIN
ASSIGN friend TRUE ;
END IF
EACH someone friends
BEGIN
IF someone = name ;
BEGIN
ASSIGN friend TRUE ;
END IF
END EACH
END FUNCTION
NOOP
FUNCTION watch
BEGIN
VARIABLE visitors ARRAY STRUCT c0de/minecraft/ENTITY
VARIABLE count INTEGER
VARIABLE strength INTEGER
VARIABLE known BOOLEAN
VARIABLE letIn BOOLEAN
CALL c0de/minecraft/FIND_ENTITIES
PARAMETER position door ;
PARAMETER radius 5 ;
PARAMETER type "minecraft:player" ;
RESULT result visitors
CALL LEN
PARAMETER value visitors ;
RESULT result count
CALL CLS
CALL COLOR
PARAMETER foreground COLOR_YELLOW ;
CALL PRINT
PARAMETER value "Welcome to " ⊕ BASE ⊕ "!" ;
CALL COLOR
PARAMETER foreground COLOR_WHITE ;
CALL PRINT
PARAMETER value "Visitors at the door: " ⊕ count ;
CALL c0de/minecraft/GET_PRESSURE_PLATE
PARAMETER position plate ;
RESULT result strength
IF strength = 0 ;
BEGIN
RETURN
END IF
EACH visitor visitors
BEGIN
IF visitor.position.x = plate.x AND visitor.position.y = plate.y AND visitor.position.z = plate.z ;
BEGIN
CALL isFriend
PARAMETER name visitor.name ;
RESULT friend known
IF known ;
BEGIN
ASSIGN letIn TRUE ;
END IF
END IF
END EACH
CALL c0de/minecraft/SET_OPEN
PARAMETER position door ;
PARAMETER open letIn ;
END FUNCTION
So baust du es
Bau zuerst die Tür, damit du ihre Position ablesen kannst:
- Setz eine Eisentür in den Eingang deiner Basis.
- Lass draußen vor der Tür einen Block frei und leg die Druckplatte auf den Block danach. Die Platte darf die Tür nicht berühren: Eine Druckplatte direkt vor einer Eisentür öffnet sie mit Redstone – für alle.
- Bring drinnen einen Knopf an der Wand neben der Tür an. Er öffnet die Tür mit Redstone, damit du hinauskommst.
- Drücke F3 und schau die Druckplatte an. Der Debug-Bildschirm zeigt ihre Position unter „Targeted Block“, drei Zahlen x, y und z. Schreib sie auf. Mach dasselbe für die untere Hälfte der Tür.
Bau jetzt das Programm. Die Zeilen 0 bis 3 und die NOOP-Zeilen sind wie bisher. Neu sind:
- Zeilen 4 bis 7: die Liste
friends, wie die Notizen der Lektion Listen: VARIABLEfriends, die Typblöcke ARRAY und STRING und zwischen BEGIN und END VARIABLE eine Zeile mit zwei LITERAL-Blöcken,"Alex"und"Kai". Trag die Namen deiner Freunde ein. - Zeilen 8 bis 13: die Position der Druckplatte. VARIABLE
plate, ein STRUCT-Typblock und ein LABELc0de/minecraft/POSITION: Das ist ein Strukturtyp der Bibliothek c0de/minecraft, mit den Elementen x, y und z. Zwischen BEGIN und END VARIABLE steht eine Zeile pro Element, wie beim Angebot der Lektion Tabellen und eigene Typen: ein LABELxund ein LITERAL mit deiner Zahl, dannyundz. Nimm deine Zahlen, nicht die aus dem Beispiel. - Zeilen 14 bis 19: dasselbe für
door, mit der Position der unteren Hälfte der Tür. - Zeilen 21 bis 36: die Funktion
isFriend. Sie antwortet mit wahr für den Besitzer des Blatts und für jeden Namen infriends. - Zeilen 38 bis 85: die Funktion
watch, die in jedem Durchlauf die Arbeit macht. Die neuen Funktionen von c0de/minecraft werden unten erklärt.
Starten
- Stell den Zeitgeberblock irgendwo in der Nähe des Eingangs auf, wo weder die Druckplatte noch der Knopf ihn berührt – ein Redstone-Signal pausiert einen Zeitgeberblock. Setz den Hebel direkt daneben, ausgeschaltet.
- Öffne den Dialog des Zeitgeberblocks. Stelle ihn auf das Programm
doorund die Funktionwatchein und den Abstand auf 20 Ticks: eine Sekunde. - Öffne den Dialog deiner Anzeigewand und binde sie an
doorundwatch. Die Wand gehört jetzt der Tür statt dem Schild.
Innerhalb einer Sekunde zeigt das Schild:
Welcome to Oak Hill!
Visitors at the door: 1Wenn du in der Nähe der Tür stehst, bist du der eine Besucher. Tritt auf die Druckplatte: Die Tür geht auf. Geh hinein. Drinnen drückst du den Knopf, um wieder hinauszugehen.

Wenn jemand anderes auf die Platte tritt – auf einem Server ein Spieler, der nicht auf deiner Liste steht, oder einfach ein Schwein –, geht die Tür zu: Auf der Platte steht kein Freund.
Um das Programm zu ändern, schalte zuerst den Hebel ein. Er pausiert den Zeitgeberblock, und wenn der letzte Durchlauf vorbei ist, kannst du das Blatt ändern. Solange ein Prozess läuft, ist sein Blatt gesperrt – und bei einem Zeitgeber, der jede Sekunde startet, ist das fast immer.
So funktioniert es
- Der Zeitgeberblock startet
watchalle 20 Ticks. Ein neuer Durchlauf startet erst, wenn der letzte zu Ende ist. - Positionen. Die Funktionen von c0de/minecraft müssen wissen, wo etwas ist. Eine
c0de/minecraft/POSITIONist eine Struktur mit x, y und z.plateunddoorenthalten die Positionen, die du mit F3 abgelesen hast. - Wer ist da? FIND_ENTITIES (Zeilen 45 bis 49) sucht alles im Umkreis von
radiusBlöcken um eine Position. Mittype "minecraft:player"findet es nur Spieler. Sein Ergebnis ist eine Liste von ENTITY-Strukturen. Jede hat einenname, einentypeund eineposition, die selbst eine POSITION ist. - Zählen. LEN (Zeilen 50 bis 52) gibt die Zahl der Elemente der Liste: die Spieler im Umkreis von 5 Blöcken um die Tür. Das Schild zeigt sie in den Zeilen 53 bis 61.
- Die Druckplatte. GET_PRESSURE_PLATE (Zeilen 62 bis 64) gibt die Signalstärke der Platte: 0, wenn niemand darauf steht. Dann gibt es nichts zu tun, und RETURN beendet den Durchlauf in Zeile 67. Die Tür bleibt, wie sie ist.
- Wer steht auf der Platte? Die EACH-Schleife geht alle Spieler in der Nähe der Tür durch. Ein Spieler steht auf der Platte, wenn seine Position die Position der Platte ist: x, y und z müssen alle gleich sein.
visitor.position.xliest das Elementxdes Elementspositionvonvisitor. - Freund oder Fremder? Für jeden Spieler auf der Platte prüft
isFriendden Namen. Ist einer von ihnen ein Freund, wirdletInwahr. - Die Tür. SET_OPEN (Zeilen 82 bis 84) öffnet die Tür, wenn
letInwahr ist, und schließt sie, wenn es falsch ist. Ein Freund öffnet sie also, und ein Fremder auf der Platte schließt sie wieder.
Das Programm handelt im Namen des Besitzers des Zeitgeberblocks – in deinem. Darum darf es eine Eisentür öffnen, siehe den Kasten oben.
Probier es selbst
- Die Tür bleibt offen, nachdem ein Freund hineingegangen ist, bis ein Fremder auf die Platte tritt. Schließ sie nach fünf Sekunden wieder.
Lösung
Nachdem die Tür aufgegangen ist, wartet das Programm 100 Ticks – fünf Sekunden – mit SLEEP aus der Bibliothek c0de/time und schließt dann die Tür. Das Programm braucht dafür eine dritte INCLUDE-Zeile.
PROGRAM door
NOOP
INCLUDE c0de/minecraft
INCLUDE c0de/time
CONSTANT BASE STRING "Oak Hill"
VARIABLE friends ARRAY STRING
BEGIN
"Alex" "Kai"
END VARIABLE
VARIABLE plate STRUCT c0de/minecraft/POSITION
BEGIN
x 100
y 64
z 198
END VARIABLE
VARIABLE door STRUCT c0de/minecraft/POSITION
BEGIN
x 100
y 64
z 200
END VARIABLE
NOOP
FUNCTION isFriend
PARAMETER name STRING
RESULT friend BOOLEAN
BEGIN
IF name = SHEET.owner ;
BEGIN
ASSIGN friend TRUE ;
END IF
EACH someone friends
BEGIN
IF someone = name ;
BEGIN
ASSIGN friend TRUE ;
END IF
END EACH
END FUNCTION
NOOP
FUNCTION watch
BEGIN
VARIABLE visitors ARRAY STRUCT c0de/minecraft/ENTITY
VARIABLE count INTEGER
VARIABLE strength INTEGER
VARIABLE known BOOLEAN
VARIABLE letIn BOOLEAN
CALL c0de/minecraft/FIND_ENTITIES
PARAMETER position door ;
PARAMETER radius 5 ;
PARAMETER type "minecraft:player" ;
RESULT result visitors
CALL LEN
PARAMETER value visitors ;
RESULT result count
CALL CLS
CALL COLOR
PARAMETER foreground COLOR_YELLOW ;
CALL PRINT
PARAMETER value "Welcome to " ⊕ BASE ⊕ "!" ;
CALL COLOR
PARAMETER foreground COLOR_WHITE ;
CALL PRINT
PARAMETER value "Visitors at the door: " ⊕ count ;
CALL c0de/minecraft/GET_PRESSURE_PLATE
PARAMETER position plate ;
RESULT result strength
IF strength = 0 ;
BEGIN
RETURN
END IF
EACH visitor visitors
BEGIN
IF visitor.position.x = plate.x AND visitor.position.y = plate.y AND visitor.position.z = plate.z ;
BEGIN
CALL isFriend
PARAMETER name visitor.name ;
RESULT friend known
IF known ;
BEGIN
ASSIGN letIn TRUE ;
END IF
END IF
END EACH
CALL c0de/minecraft/SET_OPEN
PARAMETER position door ;
PARAMETER open letIn ;
IF letIn ;
BEGIN
CALL c0de/time/SLEEP
PARAMETER ticks 100 ;
CALL c0de/minecraft/SET_OPEN
PARAMETER position door ;
PARAMETER open FALSE ;
END IF
END FUNCTIONWährend das Programm schläft, ist der Durchlauf nicht vorbei, also startet der Zeitgeberblock keinen neuen, und das Schild wird nicht aktualisiert. Nach den fünf Sekunden geht alles weiter wie vorher.
Mehr dazu
- Drei Auslöserblöcke in der Anleitung und der Zeitgeberblock im Handbuch Auslöser
- c0de/minecraft, Die Welt verändern und Besitzer und Berechtigungen in der Anleitung
- Die Funktionen dieser Lektion: FIND_ENTITIES, GET_PRESSURE_PLATE, SET_OPEN, LEN und SLEEP
- Geschützte Programme in der Anleitung: warum das Blatt gesperrt ist, solange das Programm läuft