快速入門

歡迎來到Ren’Py快速入門手冊。此手冊意在指導你如何從零起步， 過一系列簡單的步驟制作一個Ren’Py游戲。我們通過制作一個簡單游戲 The Question，來實現(xiàn)這一目標。

在開始制作一個游戲之前，你最好首先花點時間學習Ren’Py啟動器(launcher)的工作機制。 啟動器(launcher)允許你創(chuàng)造、管理、編輯和運行Ren’Py項目。

正式開始。 正式開始前，你會需要 下載 Ren’Py.

下載Ren’Py，然后解壓并運行。

在Windows平臺上，雙擊下載的可執(zhí)行文件。它會自動解壓Ren’Py到一個名為 renpy- 的文件夾。進入這個文件夾并運行 renpy.exe。(在擴展名隱藏的情況下，renpy.exe文件可能名字是 renpy)

在Max OS X平臺上，雙擊下載驅動器鏡像，將其掛載為一個驅動器。當驅動器打開后，將目錄命名為 renpy- 并復制到其他任意地方。(復制到哪里不重要，但不能是只讀驅動器。不要將renpy程序文件移動到其所有目錄之外的地方——不然在其他地方該程序無法工作)進入這個目錄并運行 renpy 程序。

在Linux平臺上，解tar包，進入 renpy- 目錄，然后運行 renpy.sh 。

完成以上作后，Ren’Py啟動器(launcher)應該正常運行了。

Ren’Py啟動器(launcher)已經被翻譯為多種語言。需要更改語言的話，選擇底部右側的“preferences”項，就可以更改語言了。

(譯者注：首次運行的啟動器界面默認使用英語。請進入“preferences”，將“Language”修改為“Simplified Chinese”，就能切換為簡體中文了。后續(xù)所有圖片和描述均以簡體中文界面為基礎。)

選擇和啟動一個項目。 你首先會看到游戲“The Question”完成之后的樣子。進入Ren’Py啟動器(launcher)，在彈出的第一個窗口選擇“The Question”。然后選擇“啟動項目”進入“The Question”。

通過同樣的作，你可以進入Ren’Py演示demo，不過請選擇“教程”而不是“The Question”。

Ren’Py啟動器主界面。 link

給一個新項目命名。 link

選擇項目分辨率。 link

選擇默認主題的強調顏色和背景顏色。 link

創(chuàng)建一個新項目。 在啟動器(launcher)界面選擇“創(chuàng)建新項目”創(chuàng)建一個新項目。

如果這是你第一次創(chuàng)建項目，Ren’Py可能會要求你選擇一個項目目錄。這個目錄(或者稱為文件夾)會被用于創(chuàng)建新的項目，并且會掃描已經存在的項目。目錄選擇窗口可能會彈出在Ren’Py主界面窗口后面，我們需要找到這個窗口。

然后，啟動器(launcher)會詢問項目名稱。由于“The Question”已經被占用了，你需要輸入一個不同的項目名稱，比如“My Question”，然后輸入回車確認。

之后，啟動器(launcher)會詢問項目分辨率。考慮到游戲(文件)大小和游戲畫面質量，默認的1280x720分辨率是個良好的折中方案。由于是入門演示，我們將選擇1280x720以匹配“The Question”游戲的美術資源，點擊“繼續(xù)”。

啟動器(launcher)將繼續(xù)詢問顏色主題——新GUI(用戶圖形界面)的強調色和背景色。此時你選擇什么顏色都不要緊，所以隨心所欲選擇，然后點擊“繼續(xù)”。

到了這一步，Ren’Py會處理一些(后臺)工作，然后輸出一個簡單的游戲模板。該模板使用預置的美術和文本資源，但是可以運行的，并且支持一些預置的特性，例如回滾、讀檔、存檔等。選擇“啟動項目”運行這個項目。

這是一個非常簡單的Ren’Py游戲。它不包含任何圖片和音樂，但它展示了兩個角色之間的一次對話，以及一行旁白。

如果想要嘗試，從啟動器(launcher)頂端選擇“My Question”項目，進入“編輯文件”并選擇 script.rpy 。如果這是你首次進入編輯模式，Ren’Py會詢問選用哪一款編輯器(我們向新人推薦Editra)，并下載你選擇的那款。啟動器(launcher)會使用編輯器打開 script.rpy 腳本文件。

編輯器打開后，清除script.rpy里所有內容。我們將從零開始，所以你不需要原來的那些內容。將上面案例復制到script.rpy里并保存文件。

現(xiàn)在萬事俱備，可以運行這個樣例了。回到啟動器(launcher)主界面，選擇“啟動項目”。Ren’Py會啟動運行。注意，不需要額外的工作量，Ren’Py就已經提供了可以讀檔和存檔以及改變配置項的菜單選項。當這些工作都完成時，點擊“啟動項目”，就可以玩這個樣例游戲了。

這個樣例展示了一些常用的Ren’Py語句。

第一行是一個 label語句。label語句常用于在程序中給某個腳本點命名。在這個例子中，我們創(chuàng)建了一個名為 start 的標簽。start標簽是特殊的，因為當用戶點擊主菜單的“開始游戲”時，Ren’Py腳本會從這個標簽開始運行。

其他行是 say語句。say語句有兩種格式。一種格式是，一行單獨字符串(雙引號開頭，雙引號結束，中間文字)，用于表現(xiàn)主視角角色的陳述或者內心想法。另一種格式有兩個字符串組成。常用于對話，第一個字符串是說話角色名字，第二個字符串是該角色正在說的話。

注意，所有say語句都要用4個空格(半角)縮進.這是因為say語句屬于同一個標簽語句下的語句塊(block)。在Ren’Py中，語句塊(block)必須相對于從屬的主語句縮進，并且同一個語句塊(block)的語句使用同樣的縮進量。

當文本自身包含雙引號時，需要使用反斜杠作為轉義符。例如

當然這個簡單游戲沒什么可多看的，它只是一個演示如何在Ren’Py里簡單構建框架的樣例。之后我們會添加一些圖片，不過首先，讓我們看看如何定義角色。

主要內容參見 定義角色(character)對象

在第一個樣例里存在一個問題，每當角色說話時，你需要反復輸入角色名字。在一個對話為主的游戲中，這可能是很繁重的工作。還有，游戲啟動后角色名字始終會以強調色顯示。為了解決這些問題，Ren’Py允許你在開頭就定義角色。這可以使你用一個短名關聯(lián)一個角色，并且能夠改變角色名字顯示的顏色。

第一和第二行語句定義了角色。第一行定義一個短名為“s”，長名為“希爾維亞”的角色，名字顏色為淡綠色。(如同網頁里常見的，這里的顏色使用RGB的16進制字符表示)

第二行創(chuàng)建一個短名為“m”，長名為“我”的角色，名字顏色為淡紅色。其他角色的定義可以使用“復制-粘貼”，修改角色的長名、短名和名字顏色。

我們也已經使用角色對象代替了角色名字字符串。這會告訴Ren’Py使用我們定義的對應角色。

主要內容參見 顯示圖像

一個視覺小說如果沒有圖像的話就稱不上視覺小說了。在“The Question”里還有另外一個場景。這也包含了一些語句展現(xiàn)角色圖像。如果你想嘗試的話，用這段內容完全覆蓋之前那個腳本。

這段腳本出現(xiàn)了兩種新的語句。第6行的 scene 語句清除了所有圖像并顯示了一個背景圖像。從第16行至第26行的 show 語句在背景上顯示了一個精靈(sprite)， 并根據預設改變展示的精靈。

在Ren’Py中，每個圖像都有一個名稱。該名稱包含一個tag(譯者注：圖像標簽，與label腳本標簽不同)，以及一個以上的可選屬性(attribute)。tag標簽和屬性名必須以字母開頭，包含字母、數字和下劃線。例如：

第6行的scene語句中，tag標簽是“bg”，屬性是“meadow”。按照習慣，背景圖像應該使用的bg作為tag標簽。

第16行的第一個show語句中，tag標簽是“sylvie”，屬性是“green”和“smile”。

第26行的第二個show語句中，tag標簽是“sylvie”，屬性是“green”和“surprised”。

給定tag標簽時，每次只能展示一副圖像。當擁有同樣tag標簽的第二副圖像需要展示時，它會直接替換第一副圖像，如同在第26行里發(fā)生的情況。

Ren’Py會在images目錄下搜索圖像文件，可以通過啟動器(launcher)的“打開目錄”選項里選擇“images”完成配置。Ren’Py能使用PNG或者WEBP文件作為角色美術資源，JPG、JPEG、PNG或者WEBP文件作為背景美術資源。文件的命名相當重要，Ren’py將使用除去擴展名后，強制字母變?yōu)樾懙奈募麃碜鳛閳D象名。

例如，images目錄下的這些文件，定義了下列圖像：

“bg meadow.jpg” -> bg meadow

“sylvie green smile.png” -> sylvie green smile

“sylvie green surprised.png” -> sylvie green surprised

因為文件名會被轉換為小寫字母，所以下面這種方式也可行。

“Sylvie Green Surprised.png” -> sylvie green surprised

圖像可以被放在images目錄的子目錄(子文件夾)中。目錄名忽略，只使用文件名定義圖像名。

hide語句。 Ren’Py也支持hide語句，可以用來隱藏圖像。

實際上，你需要使用hide語句的情況非常少見。show語句能用在角色情感變化，而scene語句用在所有人離開的情況。當某個角色離開但場景不變化時，你才需要使用hide語句。

image語句。 有時候，制作者可能不想讓Ren’Py自動定義圖像。這時image語句就能派上用場。它應該出現(xiàn)在文件最頂層(不縮進，在label標簽前面)，為圖像文件指定對應的圖像名稱。例如：

image語句于初始化階段就會運行，早于label標簽開始以及其他的游戲腳本與玩家交互。

image語句也用于比較復雜的任務，但我們會在 其他地方 討論這部分。

主要內容參見 轉場(transition)

在上面的腳本中，圖像的切換十分生硬。由于切換地點或者角色的出場、離場很重要，Ren’Py支持圖像的各種轉場效果。

轉場切換用于顯示在最后一個交互(對話、菜單或來源于其他語句的轉場)發(fā)生后，到下一個scene、show或hide語句運行之間。

這里的with語句決定了需要使用的轉場效果名。最常用的轉場效果是 dissolve (溶解)。 另一個有用的轉場效果是 fade (褪色)，能讓界面褪為全黑，然后逐漸亮起成新的界面。

當在多個scene、show、hide語句之后有一個轉場效果，將對以上所有語句都有效。如果你寫成這樣：

“bg meadow”和“sylvie green smile”圖像會同時使用dissolve轉場。如果想要每次只讓其中之一使用dissolve轉場，你需要寫兩個轉場語句：

場景meadow里有第一個dissolve效果，而角色sylvie里有第二個dissolve效果。如果你想要立刻展現(xiàn)meadow場景，然后使用轉場效果展現(xiàn)角色sylvie，你可以這樣寫：

這里的“None”被用于標識一個特殊轉場效果，對玩家來說主界面沒有產生任何特殊效果。

主要內容參見 變換

圖像在展示時默認水平居中，圖像底部與界面底部相接。這樣設計通常對背景和單個角色沒問題，但當界面上需要展現(xiàn)1個以上角色時，重新調整圖像位置也是十分合理的。同樣，基于劇情需要，調整單一角色的圖像位置也可以理解。

為了重新調整圖像位置，需要在show語句中添加一個at分句。at分句指定了圖像的展示位置。Ren’Py中包含了多個域定義的位置關鍵字: left 表示界面左端， right 表示屏幕右端， center 表示水平居中(默認位置)， truecenter 表示水平和垂直同時居中。

創(chuàng)作者可以自己定義位置關鍵字，甚至復雜的位置移動，不過那超過了本章“快速入門”的范疇。

主要內容參見 音頻

大多數Ren’Py游戲都會播放背景音樂。音樂播放需要使用play music語句。play music語句將語句中指定的文件名識別為一個音頻文件并播放。Ren’Py跟識別音頻文件名并在game目錄下尋找關聯(lián)文件。音頻文件應該是opus、ogg vorbis或者mp3格式的文件。

舉例:

更換音樂時，我們可以使用一個fadeout and fadein分句，fadeout and fadein分句用于舊音樂的淡出和新音樂的淡入。

queue music語句表示，在當前音樂播放完畢后播放的音頻文件。

樂播放可以使用stop music語句停止，這個語句也可選用fadeout分句。

音效可以使用play sound語句來播放。與音樂不同，音效不會循環(huán)播放。

在 game/audio 目錄中的音頻文件，如果其文件名去掉文件擴展名后符合Python變量的命名規(guī)則(以字母開頭且僅包含英文字母、數字或下劃線)， 則可以直接不帶引號，直接使用文件名播放音頻文件。

例如，存在一個音頻文件 game/audio/illurock.ogg 。我們可以直接在腳本中寫：

詳見 音頻命名空間。

pause語句可以讓整個Ren’Py進程暫停，直到出現(xiàn)鼠標單擊事件。

如果pause語句中給定一個數字，就只會暫停數字對應的秒數。

通過運行return語句，你可以結束游戲，而不需要做其他任何事。在此之前，最好設置一些東西能夠提示游戲已經結束，并且可能的話給用戶一個結局數字或者結局名稱。

這就是你制作一個動態(tài)小說(kinetic novel)所需要做的，動態(tài)小說是指沒有任何分支選項的游戲。現(xiàn)在，我們將關注如何在游戲中為用戶提供菜單。

主要內容參見 游戲內菜單 和 腳本標簽(label)和主控流程

menu語句能夠給玩家提供一個分支選項:

這個例子展示了在Ren’Py中如何使用menu語句。menu語句提供了一個游戲內的分支選項。menu語句使用一段縮進的文字，每一段文字后都跟著一個冒號。這段文字描述是提供給玩家的選項。每一個選項下面一行的縮進文字，是選擇之后對應選項后會運行的腳本內容。

在這個例子中，兩個選項中各運行一個jump語句。jump語句將控制轉換至label(腳本標簽)對應的label語句。在跳轉后，腳本會執(zhí)行l(wèi)abel下的語句。

在上面的例子中，Sylvie提出她的問題后，玩家會面臨“二選一”的分支選項。如果玩家選擇“是一種視頻游戲。”，第一個jump語句會執(zhí)行，Ren’Py會跳轉到 game label腳本位置。這會引發(fā)主視角角色說“是一種可以在電腦和主機上玩的視頻游戲。”，然后Ren’Py將跳轉到 marry label。

如果label后面相關的語句塊(block)之后沒有jump語句，Ren’Py會順序執(zhí)行后面的語句。最后的jump語句在技術上不是必須的，不過帶上一個會讓游戲流程顯得更清晰。

游戲目錄中任意后綴為 .rpy 的文件中都可以定義label。對于Ren’Py來說文件名無關緊要，只有文件里的label才是重點。你可以認為，所有這些rpy文件的合集等價于一個很大的rpy文件，用于跳轉和轉換控制。這種設計提供了你“構建一個更龐大游戲”的腳本所需的靈活度。

主要內容參見 Python語句 和 條件語句

上面那些語句已經足以用于制作某些游戲，其他一些游戲則需要保存數據及提取數據。例如，制作者需要游戲記下玩家做出的一個選擇，先返回主線流程中，并在后面的流程中根據之前的選擇出現(xiàn)對應的游戲變動，這是個合理的需求。這就是Ren’Py支持內嵌Python代碼的原因。

這一段，我們將演示如何存儲一個flag(標識)，該flag(標識)包含了玩家做過的某個選擇。我們需要先初始化flag(標識)，在start腳本標簽(label)之前，使用default語句。

名為“book”的flag(標識)被初始化為特殊值 False (請注意首字母大寫)，表示該flag還未被設置。如果label “book”對應的路徑被選擇，我們將使用一個Python賦值語句將其設置為True。

以美元標志符“$”開頭那行文本會被識別為Python語句。assignment(賦值)語句將這里的“book”判定為一個變量而不是一個值。Ren’Py已經支持一些其他包含Python代碼的辦法，例如多行的Python語句。我們將在本手冊的其他章節(jié)討論這點。 Ren’Py現(xiàn)在支持Python 2.7。不過我們還是強烈推薦寫可以同時在Python2和Python3兩個版本正常運行的Python語句。

需要檢查flag(標識)時，請使用if語句:

如果結果為True，if語句下的腳本語句塊(block)將執(zhí)行。相反，if語句下的腳本語句塊(block)將被跳過。if語句也可以包含一個else分句，當if結果為False時，將執(zhí)行else分句中的腳本語句塊(block)。:

Python變量不僅僅可以是簡單的布爾值。變量也可以存儲玩家名字、分數或者其他一些想要記錄的事情。由于Ren’Py支持Python編程語言的所有功能，許多想法都可能實現(xiàn)。

一旦你制作了一個游戲，在你發(fā)布它之前還有一些事情需要完成。

基線的新版Ren’Py通常會修復bug和添加新特性。發(fā)布前，你需要在啟動器(launcher)中點擊“更新”，更新到最新版本的Ren’Py。你也可以手動下載新版本并查看版本更新列表，以上工作可以使用這個頁面 https://www.renpy.org/latest.html。

少數情況下，Ren’Py版本升級變更后會要求你修改原來的游戲腳本。 不兼容的變更 頁面列出了這些變更明細。

在啟動器(launcher)的前端頁面，選擇“生成分發(fā)版”。基于options.rpy文件中的信息，啟動器(launcher)會建立一個或多個包含創(chuàng)作者所作游戲的歸檔文件。

在啟動器的首頁，選擇 “生成分發(fā)版”。基于 options.rpy 中所包含的信息，啟動器將會建立一個或者更多個包含有游戲文件的歸檔文件。

lint代碼檢查工具不能替代完整的使用測試。在發(fā)布你的游戲之前，你有責任進行檢查。可以考慮請求你的朋友們幫忙進行beta測試，測試者往往能發(fā)現(xiàn)你未能發(fā)現(xiàn)的問題。

一旦游戲完成并通過測試，你可以將生成的歸檔文件上傳到網上，好讓別人能找到它們。(如果你沒有自己的網站，試試 https://itch.io 該站點里有一大票視覺小說。) 恭喜，你已經完成了人生中的第一部視覺小說！

還有幾個地方可以發(fā)布游戲信息：

Ren’Py Games List 幫助我們追蹤記錄制作中的Ren’Py游戲。

Completed Games section of the Lemma Soft Forums 是個向后來人訴說關于你游戲故事的好地方。

更多定制化游戲打包的高級方式詳見 構建發(fā)行版 章節(jié)。

你可以在 這里 查看完整的“The Question”游戲腳本。

從零開始的快速入門只是Ren’Py功能的驚鴻一瞥。限于篇幅原因，我們省略了很多Ren’Py支持的特性，并盡可能地做出簡化——專注于“制作一部視覺小說”的最小功能特性集。

想要感受Ren’Py所有功能的話，請玩一些演示游戲，可能的話通過網站 Ren’Py website 了解一些游戲特性。你也可能會想要閱讀本手冊的其他內容，從GUI(用戶圖形界面)定制向導開始吧。

除此之外，我們推薦你看看 Lemma Soft Forums 論壇的Ren’Py版塊，該版塊里有三個子版塊，分別用于問答、各類庫的使用手冊以及可以用于二次開發(fā)的樣例。Lemma Soft Forums論壇是Ren’Py的交流中樞，我們非常歡迎新近入坑的創(chuàng)作者以及他們帶來的問題。

感謝你選擇Ren’Py視覺小說引擎。我們期待著您使用它創(chuàng)造出作品的那一天！