Minor fixes in first episode.

Author: bauepete

trainingsanleitungen/minecraft-plugins/01_installationen.md

@@ -5,50 +5,61 @@ description: In dieser Übung wirst du die zum Plugin-Programmieren und -Testen
 ---
 
 # Installationen
-Um später die Funktionalität eines Minecraft-Servers erweitern zu können (z. B. neue Commands zulassen, bei bestimmten Ereignissen neue Aktionen ausführen etc.), wollen wir zuerst einen Server auf unserem eigenen Computer installieren.
+Damit du deine Plugins bequem testen kannst, ist es sinnvoll zuerst einen Minecraft-Server auf deinem eigenen Computer zu installieren.
 
 Damit dein Computer ein Minecraft-Server wird, musst du eine bestimmte Software installieren, nämlich den "Minecraft-Server". Das klingt jetzt ein wenig seltsam. Das kommt daher, dass wir Informatiker das Wort "Server" manchmal für einen ganzen Computer benutzen (z. B. "Der Web-Server ist heute wieder mal superschnell"). Aber manchmal verwenden wir das Wort "Server" auch nur für ein Programm, die Server-Software, die einen Computer zu einem Server macht.
 
 Also, um deinen Computer zu einem Minecraft-Server zu machen, musst du eine Server-Software, den "Minecraft-Server" installieren, alles klar?
 
 ## Download Java
-Minecraft ist ein Java-Programm. Um diese laufen lassen zu können, musst du die Java Virtual Machine (JVM) auf deinem Computer installiert haben. Damit sich das ganze auszahlt ist auch noch Netbeans (das Programm, mit dem wir dann Java Programmieren werden) ein Java-Programm.
+Minecraft ist ein Java-Programm. Um Java-Programme laufen lassen zu können, musst du die Java Virtual Machine (JVM) auf deinem Computer installiert haben. Damit sich die ganze Installiererei auszahlt, ist auch noch NetBeans (das Programm, mit dem wir dann Java Programme schreiben werden) ein Java-Programm.
+
+Bevor wir beginnen, wollen wir nachsehen, ob eventuell Java bereits auf deinem Rechner installiert ist. Dazu öffnest du unter Windows die Eingabeaufforderung oder am Mac das Terminal. Dann tippst du folgendes ein:
+
+    java -version
+    
+Wenn du nun eine Antwort bekommst, die so oder zumindest so ähnlich aussieht, dann kannst du sofort zum Punkt **Download NetBeans** weiterspringen:
+
+    java version "1.8.0_31"
+    Java(TM) SE Runtime Environment (build 1.8.0_31-b13)
+    Java HotSpot(TM) 64-Bit Server VM (build 25.31-b07, mixed mode)
+
+Wenn das bei dir nicht ao aussieht, dann folge bitte den Anweisungen zur Installation von Java.
 
 ### Unter Windows
-1. Zuerst wollen wir schaun, ob vielleicht Java schon installiert ist. Dazu …
 
-2. Wenn Java noch nicht installiert ist, dann überprüfen wir als nächstes, ob du ein 32 oder 46 Bit Windows installiert hast. Dazu drückst du im Start-Screen die Taste mit den Windows-Logo und gleichzeitig das 'X'. Im Administrator-Menü links unten klickst du dann auf den Punkt System. ![Step1](01_installationen/CheckWinArchitectureStep1.jpg) Im darauffolgenden Fenster kannst du dann ablesen, welche Windows-Architektur du hast. ![Step2](01_installationen/CheckWinArchitectureStep2.png)
+Zuerst überprüfen wir, ob du ein 32 oder 46 Bit Windows installiert hast. Dazu gehst du in die **Systemsteuerung**, dann wählst du den Punkt **System und Sicherheit** und hier **System**. Im darauffolgenden Fenster kannst du dann ablesen, welche Windows-Architektur du hast.
+
+![Check out Windows architecture](01_installationen/CheckWinArchitectureStep2.png)
 
-3. Nun öffen wir im Browser die Adresse <http://www.oracle.com/technetwork/java/javase/downloads/index.html> und klicken auf Java Download. Jetzt macht es sich bezahlt, wenn du dir gemerkt hast, welche Windows-Architektur du installiert hast, weil du dich hier entscheiden musst: ![SelectOs](01_installationen/SelectOs.png) Auja, und den Radio-Button mit dem du das License Agreement akzeptierst, darfst du auch nicht vergessen, sonst wirds nix mit dem Download.
+Nun öffen wir im Browser die Adresse <http://www.oracle.com/technetwork/java/javase/downloads/index.html> und klicken auf Java Download. Jetzt macht es sich bezahlt, wenn du dir gemerkt hast, welche Windows-Architektur du installiert hast, weil du dich hier entscheiden musst. Windows x86, wenn du ein 32-bit Windows hast, Windows x64, wenn du ein 64-bit Windows hast:
 
-4. Wenn das exe auf deinem Computer heruntergeladen ist, startest du es und folgst den Installationsanweisungen. Wenn dir etwas komisch vorkommt, frag einen deiner Mentoren.
+![Select your OS](01_installationen/SelectOs.png)
+
+Auja, und den Radio-Button mit dem du das License Agreement akzeptierst, darfst du auch nicht vergessen, sonst wirds nix mit dem Download.
+
+Wenn das exe auf deinem Computer heruntergeladen ist, startest du es und folgst den Installationsanweisungen. Wenn dir etwas komisch vorkommt, frag einen deiner Mentoren.
 
 ### Unter MacOS
-1. Wir öffnen das Terminal und tippen mal `ls -l /Library/Java/JavaVirtualMachines/` rein, wenn da so etwas wie
 
-    ```total 0
-    drwxr-xr-x+ 3 root  wheel  102 Jul 22  2013 jdk1.7.0_25.jdk
-    drwxr-xr-x  3 root  wheel  102 Feb 19 09:35 jdk1.8.0_31.jdk
-    ```
-    
-    rauskommt, dann hast du das jdk bereits installiert und kannst gleich bei Punkt x weitermachen.
+Du öffnest im Browser die Adresse <http://www.oracle.com/technetwork/java/javase/downloads/index.html> und klickst auf Java Download. Jetzt wählst du aus der Liste der möglichen Systeme Mac OS X x64 aus.
+
+![SelectOs](01_installationen/SelectOs.png)
 
-2. Nun öffen wir im Browser die Adresse <http://www.oracle.com/technetwork/java/javase/downloads/index.html> und klicken auf Java Download. Jetzt macht es sich bezahlt, wenn du dir gemerkt hast, welche Windows-Architektur du installiert hast, weil du dich hier entscheiden musst: ![SelectOs](01_installationen/SelectOs.png)
 Auja, und den Radio-Button mit dem du das License Agreement akzeptierst, darfst du auch nicht vergessen, sonst wirds nix mit dem Download.
 
-3. Nun machst du einen Doppelklick auf das dmg in deinem Download-Folder, startest den Installer und folgst den Anweisungen. Wenn dir etwas komisch vorkommt, frag einen deiner Mentoren.
+Wenn das dmg vollständig runtergeladen ist machst du einen Doppelklick auf das dmg in deinem Download-Folder, startest den Installer und folgst den Anweisungen. Wenn dir etwas komisch vorkommt, frag einen deiner Mentoren.
 
      
 ### Großeltern-Imponier-Wissen
-* Die Architektur eines Betriebssystems
 * Java ist eine Programmiersprache, die auf allen verschiedenen Betriebssystemen (Windows, MacOS, Linux etc.) läuft. Damit das gut funktioniert, benötigt es die JVM (Java Virtual Machine)
 * JDK ist das **J**ava **D**evelopment **K**it. Das ist die Basis-Software, die man braucht, damit man Java entwickeln kann. 
 
 ## Download NetBeans
 Damit wir unsere Plugins in Java bequem entwickeln können, werden wir NetBeans als IDE verwenden. Wenn du diese noch nicht installiert hast, werden wir das hier machen. Glücklicherweise läuft das unter Windows und MacOS und auch Linux sehr ähnlich ab:
 
 1. Du gehst zur Website  <https://netbeans.org/downloads/index.html>. Dort kannst du dir aussuchen, in welcher "Ausbaustufe" du NetBeans haben möchtest. Wenn du genug Speicher auf deiner Festplatte oder SSD hast, würde ich die Variante "All" empfehlen. Damit kannst du NetBeans auch als IDE für Web-Entwicklung und C/C++-Entwicklung verwenden. Mit einem Klick auf den Button Download lädst du das gewünschte Bundle auf deinen Computer.
-2. Abschließend müssen wir wieder das exe starten (Windows) oder das dmg öffnen und den Installer starten (Mac) und den Anweisungen im Programm folgen.
+2. Abschließend musst du wieder das exe starten (Windows) oder das dmg öffnen und den Installer starten (Mac) und den Anweisungen im Programm folgen.
 3. Abschließend kannst du dann NetBeans mal starten. Das müsste dann folgendermaßen aussehen:
 
 ![NetBeans Startup Page](01_installationen/NetBeansStartupPage.png)
@@ -59,30 +70,30 @@ Gratuliere, damit haben wir bereits den Großteil unserer Vorbereitungsarbeiten
 * Eine IDE ist eine Integrierte Entwicklungsumgebung (**I**ntegrated **D**evelopment **E**nvironment). Damit kann man sehr bequem Programme entwickeln. Bekannte Exemplare dieser Gattung sind Visual Studio, Netbeans, Eclipse, XCode, IntelliJ usw.
 
 ## Download Server-Software
-Es gibt eine Reihe von verschiedenen Servern, die wir installieren können. Die Originalfirma (Mojang) einen an. Der hat aber den Nachteil, dass er keine Plugin-Schnittstelle zur Verfügung stellt. Die bekannteste Server-Software mit der man auch Plugins erstellen kann, ist Bukkit. Gehe auf die Coderdojo Website und lade die Datei ``craftbukkit.jar`` auf deinen Computer.
+Es gibt eine Reihe von verschiedenen Servern, die wir installieren können. Die Originalfirma (Mojang) bietet zum Beispiel den Vanilla-Server an. Der hat aber den Nachteil, dass er keine Plugin-Schnittstelle zur Verfügung stellt. Die bekannteste Server-Software mit der man auch Plugins erstellen kann, ist Bukkit, welche wir auch verwenden werden. Du kannst im Internet nach der Server-Software suchen oder einfach auf die Coderdojo Website gehen und die Datei ``craftbukkit.jar`` auf deinen Computer herunterladen.
 
 Dieses ``craftbukkit.jar`` ist unsere Server-Software, die wir jetzt starten müssen. Damit wir das in gewohnter Weise mit einem Doppelklick machen können, müssen wir noch eine kleine Vorkehrung treffen. Diese unterscheidet sich wieder leicht zwischen Windows und MacOS:
 
 ### Windows
 Erstelle als erstes einen neuen Ordner mit Namen ``bukkitServer`` und bewege ``craftbukkit.jar`` da hinein. Dann starte deinen Lieblings-Texteditor (bitte nicht Word, sonder Notepad oder besser Notepad++) und tippe folgende Zeilen ab:
 
-    title run-minecraft
-    java -Xms1024M -Xmx2048M -jar minecraft_server.jar nogui
+    java -Xms1024M -Xmx2048M -jar craftbukkit.jar -o true
     pause
 
-Dann speicherst du die Datei unter dem Namen ``Start.bat`` ab. 
+Dann speicherst du die Datei unter dem Namen ``start.bat`` ab. 
+
 ### MacOS
 Erstelle als erstes einen neuen Ordner mit Namen ``bukkitServer`` und bewege ``craftbukkit.jar`` da hinein. Dann starte deinen Lieblings-Texteditor (bitte nicht Word oder Pages, sonder TextEdit oder besser Atom oder TextWrangler) und tippe folgende Zeilen ab:
 
     #!/bin/bash
     cd "$( dirname "$0")"
     java -Xmx1024M -jar craftbukkit.jar -o true
 
-Dieses File speicherst du am besten unter dem Namen start.sh. 
+Dieses File speicherst du am besten unter dem Namen ``start.sh``.
 
 ### Großeltern-Imponier-Wissen:
 * Ein Plugin ist ein Stück Software, mit dem man eine bestehende Software erweitert.
-* Eine Schnittstelle sind verschiedene Funktionen, die man benutzen kann, um 
+* Eine Schnittstelle (auf Englisch Interface) ist eine Sammlung von Funktionen, mit der man Programme benutzen kann. 
 
 ## Den Server das erste Mal starten
 Wenn du diese Datei nun mit einem Doppelklick startest müsste ein Fenster mit dem Cmd-Prompt oder dem Terminal (schwarzes Fenster mit weißem Text unter Windows oder weißes Fenster mit schwarzem Text unter MacOS) erscheinen und nach einer Weile folgende Meldungen darin angezeigt werden.
@@ -99,7 +110,7 @@ In der letzten Zeile dieses Files steht ``eula=false``. Das müssen wir in ``eul
 
     [18:24:04 INFO]: Done (1.369s)! For help, type "help" or "?"
 
-stehen sollte. Um ganz sicher zu gehen, musst du natürlich jetzt dein Minecraft starten. Dazu wählst du am Startscreen die Option **Multiplayer**. Wenn es schnell gehen soll, klickst du auf den Button **Direct Connect** und gibst als Server-Adresse ``localhost`` ein.
+stehen sollte. Um ganz sicher zu gehen, musst du natürlich jetzt dein Minecraft starten. Um auf deinem Server spielen zu können wählst du am Startscreen die Option **Multiplayer**. Wenn es schnell gehen soll, klickst du auf den Button **Direct Connect** und gibst als Server-Adresse ``localhost`` ein.
 
 Da wir den Server aber sicherlich öfter brauchen werden, zahlt es sich wahrscheinlich aus, dass du ihn zur Liste deiner Server hinzufügst. Dazu wählst du den Button **Add Server**. Dann kannst du deinem Server einen Namen geben, sodass du ihn schnell wiedererkennst und als Adresse gibst du wieder ``localhost`` an.