Installationsanweisungen für den "python mit minecraft" Workshop

minecraft-python-installation.txt

-	Python programmieren mit Minecraft:
Anleitung siehe https://jandahlhaus.de/python-programmieren-mit-minecraft/
Falls das installierte Java zu neu ist und nicht unterstützt wird, bitte JDK11 von hier installieren:
https://adoptium.net/de/temurin/archive

Angepasst von Christoph Geron, Jun 2022
Änderungen:
- Anweisungen für Pycharm (Community Edition) install hinzugefügt
- Installation der python pakete in venv 
- Jupyter erfordert und Anleitung zum Install und Test hinzugefügt
- Test des python-Setups auf pycharm umgesschrieben
- Testskript um automatischen Check der python-Version ergänzt
- Andere kleinere Verbesserungen der Dokumentation

---------------

Die Installation ist teilweise Benutzeraccountabhängig und läuft nicht 100% übergreifgend - laut Software Konfigurationsliste
auf Workshop Nachmittag installieren.

0. Die erforderte Minecraft Version ist: 1.16.3

1. Python 3.10.11-64amd installieren mit Häkchen bei add to Path
https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe

2. überprüfen, ob Java installiert ist:
Kommandozeile öffnen (CMD im Windows Menü), "Java -version" eingeben, Eingabetaste drücken,
sonst von http://www.java.com/en/download/ installieren

3. Minecraft Tools herunterladen
https://nostarch.com/download/code/MinecraftTools.zip
Zip-Ordner entpacken


4. pycharm community edition installieren
Quelle: https://www.jetbrains.com/pycharm/download/#section=windows
Direkter Link: https://www.jetbrains.com/pycharm/download/download-thanks.html?platform=windows&code=PCC

Während Install folgede Häckschen setzen:
Alle vier Options-Häckchen setzen

Pycharm öffnen, "new Project" wählen
Location auf "C:\Users\NUTZER\Documents\minecraft" setzen und "Inherit global site-packages" und "make avaiabalbe to all projects" ankreuzen
-> "NUTZER" durch den Nutzer des PCs ersetzen. Bei einem deutschen Install von Windows könnte der Ordner "Documents" auch "Dokumente" heißen, kurzum: Das Projekt soll im Dokumente-Ordner liegen und "minecraft" heißen.
Create klicken

Es öffnet sich ein Fenster, welches in der Mitte einen Text-Editor enthält, welches eine Datei main.py anzeigt, die etwas von "# This is a sample Python script." erzählt.

Unten in der Leiste des Programms "Terminal" auswählen. Dort sollte nun stehen:
"(venv) PS C:\Users\NUTZER\Documents\minecraft>"


5. Python pakete installieren

"python -m pip install jupyterlab notebook mcpi minecraftstuff"
Es sollte ein "Successfully installed *ein haufen packete*" auf dem Screen erscheinen.

Warnungen, dass PIP veraltet ist, können einfach ignoriert werden ;)

Optional:
Testen mit der Eingabe von "jupyter notebook" im selben Terminal.
Es sollte sich ein Browser-Fenster öffnen, in dem eine Art Ordnerstruktur zu sehen ist, die URL sollte "localhost:XXXX/tree" sein, wobei XXXX vermutlich 8889 ist, ein anderer Wert ist aber auch okay!


6. Testen
Entpackten Ordner "Minecraft Tools" öffnen
Doppelklick auf "Start Server", 20 Sekunden warten (falls mehrer Java-Versionen auf dem Rechner installiert sind, muss der Java-Verweis in der Batch ggf. mit absoluter Pfadangabe angepasst werden, falls die Java-Version nicht richtig angesprochen wird). 

Im Texteditor von pycharm den Text aus der Datei "main.py" durch folgendes ersetzen (die Einrückung ist wichtig!!!)

# COPY FROM HERE
import sys
from mcpi.minecraft import Minecraft

mc = Minecraft.create()
mc.postToChat("Hallo Welt")

v_info = sys.version_info
if v_info.minor == 10:
    print(f"Python is installed correctly. Version: '{v_info.major}.{v_info.minor}.{v_info.micro}'")

elif v_info.minor > 10:
    print(f"This version is newer than 3.10! It should still run fine. Installed: 3.{v_info.minor}, Required: 3.9 (or higher)!")

elif v_info.minor >= 9:
    print(f"This version is older than 3.10, but still okay. Installed: 3.{v_info.minor}, Required: 3.9 (or higher)!")

else:
    print(f"Python Version is to old! Installed: 3.{v_info.minor}, Required: Min. 3.9!")

# TO HERE


Den grünen "Run" Button (recht weit oben rechts in pycharm) anklicken, um den Code auszuführen.
Der ausgeführte Code prüft selbstständig, ob die python version korrekt ist und gibt dies im Terminal aus.
Es öffnet sich ein neues Fenster (in pycharm), in welchem steht, ob die Python Version korrekt ist. Im Idealfall steht dort:
"Python is installed correctly. Version: '3.10.x'.

Im Minecraft-Server Programm im Fenster "Log and chat" (das rechte) sollte folgendes zu finden sein: "[Zeitangebe INFO] Hallo Welt"
Der Text "Hallo Welt" sollte ebenfalls im ingame-chat von minecraft stehen, wenn man zum Zeitpunkt des Ausführens des Programms auf dem Server eingeloggt ist.

Der Server ist in minecraft unter "Multiplayer"/"Direct Connection"/"localhost:25565" erreichbar.