Difference between revisions of "Getting Started"

(Next steps)
m (Windows: Added note about lovec.exe)
(7 intermediate revisions by 5 users not shown)
Line 30: Line 30:
 
===Windows===
 
===Windows===
  
[http://studio.zerobrane.com ZeroBrane Studio], [[Sublime Text 2]], [[Notepad++]], and [[SciTE]] allow you to launch the game from within their code editors.
+
[http://studio.zerobrane.com ZeroBrane Studio], [[Sublime Text]], [[Notepad++]], and [[SciTE]] allow you to launch the game from within their code editors.
  
 
Otherwise, the easiest way to run the game is to drag the folder onto either 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.
 
Otherwise, the easiest way to run the game is to drag the folder onto either 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.
Line 43: Line 43:
 
You can create a shortcut to do this; simply make a shortcut to love.exe, right-click on it and select "Properties", and then put the command line you want in the "Target" box for the shortcut.
 
You can create a shortcut to do this; simply make a shortcut to love.exe, right-click on it and select "Properties", and then put the command line you want in the "Target" box for the shortcut.
  
On Windows, there is a special command-line option which will attach a console to the window, allowing you to see the result of <code>print</code> calls (equivalent to setting <code>t.console=true</code> in [[conf.lua]]):
+
On Windows, there is a special command-line option which will attach a console to the window, allowing you to see the result of <code>print</code> calls (equivalent to setting <code>t.console=true</code> in [[conf.lua]] or running <code>lovec.exe</code> (since [[0.10.2]])):
 
<source lang="bash">
 
<source lang="bash">
 
"C:\Program Files\LOVE\love.exe" --console
 
"C:\Program Files\LOVE\love.exe" --console
Line 49: Line 49:
  
 
----
 
----
 +
 
===Linux===
 
===Linux===
  
Line 94: Line 95:
 
----
 
----
 
=== Android ===
 
=== Android ===
As long as you have the love app installed from the playstore or another source the following methods will work:
+
As long as you have LÖVE for Android installed from the Play Store or another source and assume you didn't download/use the "embed" suffix flavor, the following methods will work:
 
 
*Method 1 Transfer your game folder to /sdcard/lovegame where main.lua is found at /sdcard/lovegame/main.lua. Then run the app.
 
  
*Method 2 Transfer a .love of your game to the device and click on it. Most file explorers will run the .love using the love app. If it does not you can install ES File Explorer which will. If you use Dropbox, you can use that to open .love files.
+
* Transfer your game folder to <code>/sdcard/lovegame</code> where <code>main.lua</code> is found at <code>/sdcard/lovegame/main.lua</code>. Then run LÖVE for Android. In Android Marshmallow or later, you have to grant LÖVE for Android storage permission (will be prompted).
  
 +
* Transfer/download a .love of your game to the device and click on it. Most file explorers will run the .love using LÖVE for Android. If it does not you can install ES File Explorer which will. If you use Dropbox, you can use that to open .love files. May not work in Android Nougat or later due to some changes.
  
 
----
 
----
Line 107: Line 107:
 
In order to run LÖVE for iOS, it must first be compiled and installed. To do that, you’ll need Mac OS X, [https://developer.apple.com/xcode/ Xcode 7 or newer], and the LÖVE for iOS source code downloadable from the [https://love2d.org home page].
 
In order to run LÖVE for iOS, it must first be compiled and installed. To do that, you’ll need Mac OS X, [https://developer.apple.com/xcode/ Xcode 7 or newer], and the LÖVE for iOS source code downloadable from the [https://love2d.org home page].
  
* If the <code>include</code> and <code>libraries</code> folders are not present in the <code>love/platform/xcode/ios</code> folder, [https://bitbucket.org/rude/love/downloads/love-0.10.0-ios-libraries.zip download them] and place them there. They contain the third-party library dependencies used by LÖVE.
+
* If the <code>include</code> and <code>libraries</code> folders are not present in the <code>love/platform/xcode/ios</code> folder, [https://github.com/love2d/love/releases/download/11.3/love-11.3-ios-libraries.zip download them] and place them there. They contain the third-party library dependencies used by LÖVE.
  
 
* Open the Xcode project found at <code>love/platform/xcode/love.xcodeproj</code> and select the <code>love-ios</code> target in the dropdown menu at the top of the window.
 
* Open the Xcode project found at <code>love/platform/xcode/love.xcodeproj</code> and select the <code>love-ios</code> target in the dropdown menu at the top of the window.
Line 119: Line 119:
 
* To put a .love file on the iOS Simulator after LÖVE is installed, drag the file onto the iOS Simulator’s window while it’s open. LÖVE will launch if it’s not running already. If another game is currently active you may need to quit LÖVE for the new game to show up (press Shift-Command-H twice to open the App Switcher menu on the iOS Simulator.)
 
* To put a .love file on the iOS Simulator after LÖVE is installed, drag the file onto the iOS Simulator’s window while it’s open. LÖVE will launch if it’s not running already. If another game is currently active you may need to quit LÖVE for the new game to show up (press Shift-Command-H twice to open the App Switcher menu on the iOS Simulator.)
  
* To put a .love file or game folder on your iOS device after LÖVE is installed, you can either download it with the Safari, or transfer it from your computer through iTunes when your device is connected: open iTunes, go to the iOS device which has LÖVE installed, go to the ‘Apps’ section and scroll down and find LÖVE, and add the .love file or game folder to LÖVE’s Documents section.
+
* To put a .love file or game folder on your iOS device after LÖVE is installed, you can either download it with the Safari, or transfer it from your computer through iTunes when your device is connected: open iTunes, go to the iOS device which has LÖVE installed, go to the ‘Apps’ section and scroll down and find LÖVE, and add the .love file or game folder to LÖVE’s Documents section. On more recent iOS and Mac versions, you can use Airdrop to transfer your .love file from your Mac to where LÖVE is installed.  
  
 
See the [[Game Distribution]] page for creating Fused LÖVE games on iOS and distributing them.
 
See the [[Game Distribution]] page for creating Fused LÖVE games on iOS and distributing them.
Line 126: Line 126:
 
* [[Tutorial:Callback_Functions]] will teach you the basic structure of a love game.
 
* [[Tutorial:Callback_Functions]] will teach you the basic structure of a love game.
 
* [[:Category:Tutorials]] are the next piece of reading.
 
* [[:Category:Tutorials]] are the next piece of reading.
* [https://love.2d.org/wiki/love Wiki] The LÖVE wiki.
+
* [[Main Page|Wiki]] The LÖVE wiki.
  
 
== Other Languages ==
 
== Other Languages ==

Revision as of 13:28, 18 June 2020

Get LÖVE

Download the latest version of LÖVE from 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.

To find out which version of LÖVE is installed, run the following command:

love --version

Making a Game

To make a minimal game, create a folder anywhere, and open up your favorite text editor. Sublime Text is a pretty good one for all operating systems, 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.

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

Running Games

LÖVE can load a game in two ways:

  • From a folder that contains a main.lua file.
  • From a .love file that has a main.lua file in the top-most directory level (aka root)

For creating .love files see Game Distribution.


Windows

ZeroBrane Studio, Sublime Text, Notepad++, and SciTE allow you to launch the game from within their code editors.

Otherwise, the easiest way to run the game is to drag the folder onto either love.exe or a shortcut to love.exe. Remember to drag the folder containing main.lua, and not main.lua itself.

You can also launch the game from the command line:

"C:\Program Files\LOVE\love.exe" "C:\games\mygame"
"C:\Program Files\LOVE\love.exe" "C:\games\packagedgame.love"

You can create a shortcut to do this; simply make a shortcut to love.exe, right-click on it and select "Properties", and then put the command line you want in the "Target" box for the shortcut.

On Windows, there is a special command-line option which will attach a console to the window, allowing you to see the result of print calls (equivalent to setting t.console=true in conf.lua or running lovec.exe (since 0.10.2)):

"C:\Program Files\LOVE\love.exe" --console

Linux

On Linux, you can use one of these command lines:

love /home/path/to/gamedir/
love /home/path/to/packagedgame.love

If you installed LÖVE system-wide, you can double click on .love files in your file manager as well.


Mac OS X

On Mac OS X, a folder or .love file can be dropped onto the love application bundle. On the Mac Terminal (command line), you can use love like this (assuming it's installed to the Applications directory):

open -n -a love "~/path/to/mygame"

However, the above method will not output printed text to the terminal window. To do that, you will need to execute the love binary inside the application bundle directly:

/Applications/love.app/Contents/MacOS/love ~/path/to/mygame

You can set up an alias in your Terminal session to call the binary when you use love by adding an alias to your ~/.bash_profile.

Open the file with

open -a TextEdit ~/.bash_profile

You may have to run

touch ~/.bash_profile

first if the file does not yet exist.

Then paste in the following code and save the file:

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

Now you can call love from the command line like Linux and Windows:

love ~/path/to/mygame

Android

As long as you have LÖVE for Android installed from the Play Store or another source and assume you didn't download/use the "embed" suffix flavor, the following methods will work:

  • Transfer your game folder to /sdcard/lovegame where main.lua is found at /sdcard/lovegame/main.lua. Then run LÖVE for Android. In Android Marshmallow or later, you have to grant LÖVE for Android storage permission (will be prompted).
  • Transfer/download a .love of your game to the device and click on it. Most file explorers will run the .love using LÖVE for Android. If it does not you can install ES File Explorer which will. If you use Dropbox, you can use that to open .love files. May not work in Android Nougat or later due to some changes.

iOS

In order to run LÖVE for iOS, it must first be compiled and installed. To do that, you’ll need Mac OS X, Xcode 7 or newer, and the LÖVE for iOS source code downloadable from the home page.

  • If the include and libraries folders are not present in the love/platform/xcode/ios folder, download them and place them there. They contain the third-party library dependencies used by LÖVE.
  • Open the Xcode project found at love/platform/xcode/love.xcodeproj and select the love-ios target in the dropdown menu at the top of the window.
  • You may want to change the Build Configuration from Debug to Release for better performance, by opening the "Edit Scheme..." menu from the same dropdown selection.
  • Choose either an iOS Simulator device or your plugged-in iOS device in the dropdown selection to the right of the previous one, and click the Build-and-Run ▶︎ button to the left, which will install LÖVE on the target device after compiling it.

LÖVE on iOS includes a simple list interface of games that are installed (until you fuse a .love to it for distribution.)

  • To put a .love file on the iOS Simulator after LÖVE is installed, drag the file onto the iOS Simulator’s window while it’s open. LÖVE will launch if it’s not running already. If another game is currently active you may need to quit LÖVE for the new game to show up (press Shift-Command-H twice to open the App Switcher menu on the iOS Simulator.)
  • To put a .love file or game folder on your iOS device after LÖVE is installed, you can either download it with the Safari, or transfer it from your computer through iTunes when your device is connected: open iTunes, go to the iOS device which has LÖVE installed, go to the ‘Apps’ section and scroll down and find LÖVE, and add the .love file or game folder to LÖVE’s Documents section. On more recent iOS and Mac versions, you can use Airdrop to transfer your .love file from your Mac to where LÖVE is installed.

See the Game Distribution page for creating Fused LÖVE games on iOS and distributing them.

Next steps

Other Languages