Difference between revisions of "Getting Started"

(Running Games: Updated part about no-game screen, elaborated explanation regarding .love content-only)
Line 1: Line 1:
== Get LÖVE ==
+
== LÖVE installieren ==
  
Download the latest version of LÖVE from [http://love2d.org/#download the website], and install it. If you're on Windows and don't want to ''install'' LÖVE, you can also just download the zipped executables and extract them anywhere.
+
Lade dir LÖVE herunter und installiere es. Die neueste Version findest du auf [http://love2d.org/#download der Website].  
 +
Wenn du Windows benutzt, aber nicht den Installer verwenden möchtest, lade einfach die zip-Datei herunter und entpacke sie irgendwohin.
  
You can inspect what Version of Löve you have installed like this:
+
Wenn du wissen willst, welche LÖVE-Version auf deinem Rechner installiert ist, führe folgenden Befehl aus:
  
 
<code>
 
<code>
Line 9: Line 10:
 
</code>
 
</code>
  
== Making a Game ==
+
== Das erste "Spiel" ==
  
To make a minimal game, create a folder anywhere, and open up your favorite code editor. Notepad++ is a pretty good one for Windows, and it has Lua support built in. Create a new file in the folder you just created, and name it main.lua. Put the following code in the file, and save it.
+
Erstelle irgendwo ein neues Verzeichnis und öffne deinen Lieblings-Editor. Notepad++ ist ein ziemlich guter Editor für Windows mit eingebauter Lua Unterstützung. Erstelle eine neue Datei und kopiere folgenden Text:
  
 
<source lang="lua">
 
<source lang="lua">
Line 18: Line 19:
 
end
 
end
 
</source>
 
</source>
== Running Games ==
+
Speicher die Datei als main.lua in dem Verzeichnis das du gerade erstellt hast. Herzlichen Glückwunsch, dein erstes Spiel ist fertig.
  
LÖVE can load a game in two ways:
+
== Spiele spielen ==
* From a folder.
+
 
* From a .love file (a renamed .zip-file).
+
LÖVE kann Spiele auf zwei Arten öffnen:
+
* Als ein Verzeichnis und
In both cases, there has to be a file called <code>main.lua</code> in the root path. This file will be loaded when LÖVE starts. If this file is missing, LÖVE will not recognize the folder or .love file as game, and it will complain about a wrongly packaged game. A frequently made mistake is zipping the folder rather than its contents. This stems from very old practice (because when you unzip a folder you don't want it to splash out all over your current directory), but for LÖVE doing that doesn't make sense: you need to zip the game folder's contents '''only''', to get a correct .love.
+
* als eine .love Datei (umbenannte .zip Datei).
 +
 
 +
In beiden Fällen muss die Datei <code>main.lua</code> im Hauptverzeichnis vorhanden sein. Diese Datei wird als erstes ausgeführt, wenn LÖVE startet. Fehlt sie, kann LÖVE dein Spiel nicht als solches erkennen und sich darüber beschweren. Ein häufiger Fehler ist es das Verzeichnis an Stelle der *.lua Dateien zu zippen.  
  
 
===Windows===
 
===Windows===
  
On Windows, the easiest way to run the game is to drag the folder onto love.exe, or a shortcut to love.exe. Remember to drag the folder containing <code>main.lua</code>, and not <code>main.lua</code> itself.
+
Der einfachste Weg ein Spiel unter Windows zu starten, ist das Verzeichnis oder die .love Datei auf <code>love.exe</code> (oder eine Verknüpfung darauf) zu ziehen. Wichtig: Du benötigst den ganzen Ordner, nicht nur die <code>main.lua</code>.
There's also the [[Scite]] option.
 
  
You can also call it from command line:
+
[[Scite]]-User können ihrem Editor beibringen Spiele zu starten.
 +
 
 +
Außerdem kannst du die Kommandozeile benutzen, z.B.:
  
For instance:
 
 
<pre>
 
<pre>
 
love C:\games\mygame
 
love C:\games\mygame
Line 39: Line 42:
 
</pre>
 
</pre>
  
On Windows, there is a special option which will attach a console to the Window. This allows you to see standard output.
+
Wenn du die Ausgabe deines Spiels (z.B. durch <code>print()</code>) sehen willst, starte LÖVE mit dem Parameter <code>--console</code>. Es wird ein zusätzliches Konsolenfenster geöffnet, welches die Standardausgabe zeigt.
  
<code>
 
love --console
 
</code>
 
  
 
===Linux===
 
===Linux===
  
On Linux, you can use the command line:
+
Linux-user benutzen die Kommandozeile:
  
 
<pre>
 
<pre>
Line 54: Line 54:
 
</pre>
 
</pre>
  
If you have installed the .deb, you can double click on .love files in your file manager as well.
+
Wenn du das .deb Paket installiert hast, kannst du .love Dateien aus deinem Filemanager heraus starten.
  
 
===Mac OSX===
 
===Mac OSX===
  
On Mac OSX, a folder or .love file can be dropped onto the Love.app application bundle. On the Mac OSX Terminal (commandline), you can use love like this (assuming it's installed to the Applications directory):
+
Unter Mac OSX kannst du ein Verzeichnis oder eine .love Datei auf das love.app Bundle ziehen. Im Terminal kannst du love so ausführen (vorausgesetzt es ist im Applications Verzeichnis installiert):
  
 
<code>open -a love mygame</code>
 
<code>open -a love mygame</code>
  
In some cases it may be faster to invoke the love binary inside the application bundle directly via the following:
+
In manchen Fällen kann es schneller sein die love-binary direkt auszuführen:
  
 
<code>/Applications/love.app/Contents/MacOS/love mygame</code>
 
<code>/Applications/love.app/Contents/MacOS/love mygame</code>
  
You can setup an alias in your Terminal session to call the binary when you use <code>love</code> by adding an alias to your ~/.bash_profile (<code>open -a TextEdit ~/.bash_profile</code>):
+
Du kannst dir außerdem einen alias anlegen, indem du folgendes der Datei ~/.bash_profile hinzufügst (zum öffnen: <code>open -a TextEdit ~/.bash_profile</code>):
  
 
<pre>
 
<pre>
Line 73: Line 73:
 
</pre>
 
</pre>
  
Now you can call love from the commandline like Linux and Windows:
+
Jetzt kannst du LÖVE wie unter Windows und Linux ausführen:
  
 
<code>
 
<code>
Line 79: Line 79:
 
</code>
 
</code>
  
== Next steps ==
+
== Zweite Schritte ==
* [[Tutorial:Callback_Functions]] will teach you the basic structure of a love game.
+
* [[Tutorial:Callback_Functions]] Zeigt die Basisstrukur von love Spielen.
* [[:Category:Tutorials]] are the next piece of reading
+
* [[:Category:Tutorials]] ist deine Lektüre für die nächste Zeit.
  
 
[[Category:LÖVE]]
 
[[Category:LÖVE]]

Revision as of 20:48, 11 August 2010

LÖVE installieren

Lade dir LÖVE herunter und installiere es. Die neueste Version findest du auf der Website. Wenn du Windows benutzt, aber nicht den Installer verwenden möchtest, lade einfach die zip-Datei herunter und entpacke sie irgendwohin.

Wenn du wissen willst, welche LÖVE-Version auf deinem Rechner installiert ist, führe folgenden Befehl aus:

love --version

Das erste "Spiel"

Erstelle irgendwo ein neues Verzeichnis und öffne deinen Lieblings-Editor. Notepad++ ist ein ziemlich guter Editor für Windows mit eingebauter Lua Unterstützung. Erstelle eine neue Datei und kopiere folgenden Text:

function love.draw()
    love.graphics.print("Hello World", 400, 300)
end

Speicher die Datei als main.lua in dem Verzeichnis das du gerade erstellt hast. Herzlichen Glückwunsch, dein erstes Spiel ist fertig.

Spiele spielen

LÖVE kann Spiele auf zwei Arten öffnen:

  • Als ein Verzeichnis und
  • als eine .love Datei (umbenannte .zip Datei).

In beiden Fällen muss die Datei main.lua im Hauptverzeichnis vorhanden sein. Diese Datei wird als erstes ausgeführt, wenn LÖVE startet. Fehlt sie, kann LÖVE dein Spiel nicht als solches erkennen und sich darüber beschweren. Ein häufiger Fehler ist es das Verzeichnis an Stelle der *.lua Dateien zu zippen.

Windows

Der einfachste Weg ein Spiel unter Windows zu starten, ist das Verzeichnis oder die .love Datei auf love.exe (oder eine Verknüpfung darauf) zu ziehen. Wichtig: Du benötigst den ganzen Ordner, nicht nur die main.lua.

Scite-User können ihrem Editor beibringen Spiele zu starten.

Außerdem kannst du die Kommandozeile benutzen, z.B.:

love C:\games\mygame
love C:\games\packagedgame.love

Wenn du die Ausgabe deines Spiels (z.B. durch print()) sehen willst, starte LÖVE mit dem Parameter --console. Es wird ein zusätzliches Konsolenfenster geöffnet, welches die Standardausgabe zeigt.


Linux

Linux-user benutzen die Kommandozeile:

love /home/path/to/game
love /home/path/to/packagedgame.love

Wenn du das .deb Paket installiert hast, kannst du .love Dateien aus deinem Filemanager heraus starten.

Mac OSX

Unter Mac OSX kannst du ein Verzeichnis oder eine .love Datei auf das love.app Bundle ziehen. Im Terminal kannst du love so ausführen (vorausgesetzt es ist im Applications Verzeichnis installiert):

open -a love mygame

In manchen Fällen kann es schneller sein die love-binary direkt auszuführen:

/Applications/love.app/Contents/MacOS/love mygame

Du kannst dir außerdem einen alias anlegen, indem du folgendes der Datei ~/.bash_profile hinzufügst (zum öffnen: open -a TextEdit ~/.bash_profile):

# alias to love
alias love="/Applications/love.app/Contents/MacOS/love"

Jetzt kannst du LÖVE wie unter Windows und Linux ausführen:

love /home/path/to/game

Zweite Schritte