Getting Started (正體中文)

下載 LÖVE

網站 下載最新的 LÖVE 版本並且完成安裝. 若您使用視窗操作系統但是不想安裝 LÖVE, 您也可以下載可攜的免安裝版本, 解開壓縮後就可以使用.

您可以執行下列指令來查驗 LÖVE 的版本:

love --version

建立第一個遊戲

建立一個最基本的遊戲, 可以先在任何位置先建立一個目錄, 接著利用您常用的程式碼編輯器建立一個程式檔案. Notepad++ 是在視窗環境中一套好用的編輯器, 同時也內建 Lua 支援. 將新增的程式檔案命名為main.lua. 將下列程式碼放入後存檔.

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

執行遊戲

LÖVE 載入遊戲的方法有下列兩種:

  • 執行目錄中的內容. 在啟動時宣告該目錄的位置.
  • 執行 .love 檔案 (其實是一個改名的 .zip-檔案). 在啟動時宣告該檔案的位置.

無論是哪一種方式, 都是從執行 main.lua 開始. LÖVE 啟動時會載入這個主檔案. 因此若所宣告的目錄或 .love 檔案中沒有這個主檔案, LÖVE 就會顯示錯誤. 常見的錯誤是只壓縮目錄而不是其內容. 這種比較老舊的做法, 對 LÖVE 來說, 只需要 zip 目錄的內容就可得到正確的 .love 檔案.

視窗版本

在視窗中, 最簡便的方式就是利用滑鼠將目錄以拖曳的方式指給 love.exe 或其捷徑. 特別注意是拖曳帶有 main.lua 的目錄, 而不是拖曳 main.lua檔案本身.

使用者也可以將遊戲執行設為 Scite 選項功能之一.

另外一種執行方法就是利用命令列執行:

例如:

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

也可以利用捷徑來進行; 直接為 love.exe 建立一個捷徑, 然後以滑鼠右鍵帶出 "Properties" 後, 將指令放入 "Target" 區. 雙點擊此一捷徑後就可以執行對應的遊戲.

視窗上還有一種特別將命令列附加到視窗的做法, 這樣的執行可以看到執行的輸出結果.

love --console

Linux版本

在 Linux 平台上, 可以利用下列指令執行:

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

假如已經安裝 .deb, 雙點擊 .love 檔案也可以直接執行.

Mac OSX版本

在 Mac OSX 平台上, 遊戲目錄或 .love 可以直接拖曳給 Love.app 就可以執行. 在 Mac OSX 命令列, 也可以利用下列指令執行:

open -n -a love "/home/path/to/game"

或者透過下列指令執行:

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


You can setup 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 commandline like Linux and Windows:

love "/home/path/to/game"


If you debug using the print command, it is useful to see this printed in realtime. In which case the following will open an extra window that will show the printed text.

xterm -e /Applications/love.app/Contents/MacOS/love "/home/path/to/game"

Note for OS X Lion Users: The above steps do not achieve the desires results under Lion. In order to run Löve and retain the print() functionality you can use a script such as the following:

#!/bin/bash
exec /Applications/love.app/Contents/MacOS/love "/home/path/to/game"


Next steps

Other Languages