文本是視覺系小說的根本,對以故事情節為主的遊戲來說更是重中之重。這裡說的文本可能包括使用人物名字作為標籤(label)的對話,以及不存在任何主體的旁白。(為了偷懶,我們把對話和旁白統稱為對話,除非某些場合下兩者有重大區別。)由於對話如此重要,創作者需要能夠訂製化對話的某些特性使其符合製作遊戲的特色。
在Ren’Py中,大多數對話使用say語句編寫。透過使用角色(character)對象,對話外觀可以針對每一個角色實行訂製化。
say語句被用在對話和旁白場景中。由於在Ren’Py腳本中say語句出現如此之頻繁,所以在編寫say語句的語法是一個最小化後的語法結構。這是一些樣例:
"這是一句旁白。"
"艾琳" "這是一句對話,用了完整的角色名。"
e "這是一句對話,使用了角色簡單表達式。"
"嘭!!" with vpunch
say語句的第一種形式是一個其自身組成的整個字串。這種形式用於陳述,陳述內容就是字串內容。
say語句的第二種形式是由兩個字串組成。第一個字串是發言角色的名字,第二個字串是TA正在說的內容。
say語句的第三種形式是一個簡單表達式後接一個字串。簡單表達式應該等同於一個角色名字或者一個角色(character)對象。在後面的例子中,角色對象被用於控制對話展現。
say語句的最後一種形式是一個字串及一個過渡(transition)效果。在上面的例子中,字串會顯示為對話內容,螢幕會同步抖動。
儘管say語句所處理對話的具體細節實際是由角色(character)對象所控制,say語句的通常用處是在界面上展現一個對話,直到用戶點擊滑鼠後取消對話,並在界面上移除對話內容。
某些字元對Ren’Py有特殊含義,所以不能用在對話字串中。左花括號 {
開啟一個文本標籤(tag),左方括號 [
開啟一個替換(substitution)。若需要在對話中使用這些字元,需要連續出現兩次。而轉移雙引號則需要使用反斜槓符號,不然字串會在那個引號處截斷。應用舉例:
"I walked past a sign saying, \"Let's give it 100%!\""
透過創建一個角色對象並在say語句中使用該角色對象,你可以訂製化對話外觀(甚至行為)。角色對象透過使用define語句,將角色(character)聲明為一個變數。舉例:
define e = Character("艾琳",
who_color="#c8ffc8")
完成了這步工作後,定義的角色就可以使用在say語句中:
e "Hello, world."
角色(Character)是一個python函數,該函數包含一大串的關鍵字參數。這些關鍵字參數控制著角色行為。
define語句會計算其自身的表達式,並聲明為一個給定的變數名。若 define
語句不在 init
語句塊(block)中,其會自動以與初始化相同的最高優先度(0)運行。
Character
(name, kind=adv, **args) link創建並返回了一個角色對象,其控制了對話和旁白的觀感。
None
,名字不會顯示,用於旁白。連結圖片 與某個角色關聯的圖像標籤(tag)名。這種設計,允許一個包含角色的say語句使用標籤(tag)名來展現角色圖片,也同時允許角色說話時Ren’Py自動選擇並展現一個頭像。
語音標籤(tag) 若某個聲音標籤(tag)被指定為某個角色所有,標籤下對應的聲音文件將會與該角色關聯,這些聲音文件可以在自訂設置界面被靜音或者被播放。
前綴和後綴 這個設計允許在角色名字或者展現文本上添加前綴和後綴。前綴和後綴可以用在每一行對話的前後添加引用內容。
改變角色顯示名 該可選項用於控制顯示角色名。
互動控制 這些可選項在“對話展示、發生互動、模式輸入”情況下控制顯示效果。
點擊繼續 “點擊繼續”提示是在(一段內容)所有文本均已展示完的情況下,通常出現一次,提醒用戶進入下一部分內容。
Null()
。"nestled"
,該提示會作為目前展示文本的一部分出現,在最後一個字元顯示後立即出現相應提示。若值為 "fixed"
,提示會被直接添加到界面上,其在界面上的位置由位置樣式屬性控制。界面 顯示對話使用到一個 界面 。該入參允許你選擇界面(screen),並傳入參數。
關鍵字參數以前綴 show_
開頭,去掉前綴後傳參給界面(screen)。例如, show_myflag
的值會改為變數 myflag
並傳參給界面(screen)。(myflag變數並不是預設會用參數,但可以被一個訂製對話界面使用。)
鑑於某些歷史原因,show系列變數由Ren’Py引擎處理:
樣式化文本和窗口 以 who_
、 what_
和 window_
開頭的關鍵字參數,會去掉前綴後分別用於 樣式 <styles> 角色名、對話文本和窗口內容。
例如,若一個角色被給定了關鍵字參數 who_color="#c8ffc8"
,角色名的顏色就被改變,這裡的例子中會被改成綠色。 window_background="frame.png"
是把包含該角色的對話窗口背景設置為圖片frame.png。
應用於角色名、對話文本和窗口的樣式化,也可以使用這種方式進行設置:分別對應使用 who_style
, what_style
和 window_style
參數。
設置 config.character_id_prefixes
後,就可以樣式化其他可視組件了。例如,如果使用了預設的GUI配置,帶有前綴 namebox_ 的樣式將會應用在發言角色名上。
當一個角色與一個圖像標籤(tab)關聯,包含對應角色的say語句將在角色名和第二個字串之間就可以插入圖像屬性(attribute)。
在這中情況下,如果帶有給定標籤(tag)的某個圖片需要顯示,Ren’Py會定位一條包含角色標籤(tag)和屬性(attribute)的show命令。如果圖片未顯示,Ren’Py會保存屬性(attribute)並用於頭像,但依然不會顯示圖片。
舉例:
define e = Character("艾琳", image="eileen")
label start:
show eileen mad
e "我對你有點失望。"
e happy "不過這都是過去的事了。"
等價於:
define e = Character("艾琳")
label start:
show eileen mad
e "我對你有點失望。"
show eileen happy
e "不過這都是過去的事了。"
如果在圖像屬性前面加一個 @
符號,圖像屬性的改變將是臨時性的,在執行完這行對話腳本後會恢復成上一個圖像屬性。
舉例:
define e = Character("艾琳", image="eileen")
label start:
show eileen mad
e "我對你有點失望。"
e @ happy "雖然還挺有趣的。"
e "不過別想我幫你從這檔子破事裡抽身。"
等效於:
define e = Character("艾琳")
label start:
show eileen mad
e "我對你有點失望。"
show eileen happy
e "雖然還挺有趣的。"
show eileen mad
e "不過別想我幫你從這檔子破事裡抽身。"
兩種語法可以混用,在 @
符號之前表示永久改變,符號後面表示臨時改變一次。
e happy @ vhappy "真的!一切都改變了。"
使用這個方式,若需要在圖片改變時觸發一個轉場(transition)效果的話,將config.say_attribute_transition設置為一種轉場(transition)即可。
若要設置更多控制項,可以使用 config.say_attribute_transition_callback
。
這是一些樣例角色:
# 角色的對話內容包含在一對圓括號中。
define e = Character("艾琳", what_prefix='(', what_suffix=')')
# 從一個變數中獲取角色名稱。
define p = Character("player_name", dynamic=True)
一些角色名是系統預定義的,並會在某些場合自動啟動。有意地重定義這些角色可以改變Ren’Py引擎的行為,但意外使用的話很可能會引發問題。
adv
nvl
narrator
name_only
centered
vcentered
extend
使用最近一個發言角色,在原有對話內容後追加一行台詞。快速擴展對話。這可以用於界面變更後的對話內容延續。
擴展(extend)能識別NVL模式,並正確處理該模式下的內容。
舉例:
# 展現對話的第一行台詞,等待一個點擊事件,變更角色表情,然後展示其餘台詞。
show eileen concerned
e "有時候,我會感到憂傷。"
show eileen happy
extend " 但是我通常很快就能恢復過來!"
# 與上面類似,不同之處在於,當第一行台詞結束後自動變更角色表情。
# 只有當用戶始終沒有自己設置文本顯示速度的情況下,這種設計才是合理的。
show eileen concerned
e "有時候,我會感到憂傷。{nw}"
show eileen happy
extend " 但是我通常很快就能恢復過來!"
Ren’Py中包括幾種語句,允許管理對話窗口。由於對話窗口在對話中一直是展現的,這些窗口控制語句在非對話互動的情況下控制窗口的出現或者消失。
window show
config.window_show_transition
的值。window hide
config.window_hide_transition
的值。window auto
config.window_auto_show
中列出的語句——預設是say語句前,窗口會自動展現。在 config.window_auto_hide
中列出的語句——預設是 scene
和 call screen
以及帶標題的 menu
語句前,窗口會自動隱藏。(只有直接顯式使用該語句才有效,而函數返回該語句內容相同的字串不生效。)window auto
語句分別使用 config.window_show_transition
和 config.window_hide_transition
作為顯示和隱藏窗口的轉場效果。 window auto
啟用的自動化管理可以被 window show
或者 window hide
語句關閉。
舉例:
window show # 使用默認轉場效果顯示窗口
pause # 在暫停中依然顯示窗口
window hide # 隱藏窗口
pause # 在暫停中依然隱藏窗口
window show dissolve # 使用融化(dissolve)效果顯示窗口
pause # 在暫停中依然顯示窗口
window hide dissolve # 使用融化(dissolve)效果隱藏窗口
pause # 在暫停中依然隱藏窗口
window auto
"The window is automatically shown before this line of dialogue."
pause # 在暫停中依然顯示窗口
scene bg washington # 在場景(scene)切換前隱藏窗口
with dissolve
對話窗口管理是
Preference()
特性構造器“show empty window”一項的主題。若“show empty window”特性被關閉,以上語句均不會產生任何效果。
使用語句後面圓括號包含的入參值可以傳給say語句。舉例:
e "Hello, world." (what_color="#8c8")
傳入say語句的參數首先會被 var:config.say_arguments_callback 回調函數處理,前提是入參不是None。若有回調函數無法處理的參數,將會被傳給角色(character),因為這些參數會被看作定義角色所需。上面的樣例會將對話顯示為綠色。
特殊關鍵字 _mode 和 _with_node 將在本次互動中覆蓋原設置的字元。
某些視覺小說會有大段連續的旁白,或者同一個角色的多段會話內容。這種情況下,腳本裡反覆寫入角色名稱和引號就顯得很累贅。
為了應對這些情況,Ren’Py提供了獨白模式。將對話內容放入成對的3個雙引號中,Ren’Py會根據對話內容中的空行自動分段。 分段後的每一段內容,都會創建自身的say語句。這裡的一個樣例,包含3段旁白,將分為3段對話。
"""
這是第一行旁白。第一行比其他兩行都長,所以它將換行
(補足字數補足字數補足字數補足字數)。
這是第二行旁白。
這是第三行旁白。
"""
e """
這是對話的第一行。第一行比其他兩行都長,所以它將換行
(補足字數補足字數補足字數補足字數)。
這是對話的第二行。
這是對話的第三行。
"""
say語句後面可能會有分句,並帶上入參或者屬性(attribute)。這些入參或者屬相將在獨白中分配給每一行。
如果創作者想要忽略段落之間的空行,可以在腳本文件最外層,並且第一行獨白之前寫一條 rpy monologue single
。
(譯者註:即,不使用空行自動分段。)
Note
如果你已經看過 Python語句 的內容,本節內容才可能對你有用。
當say語句的第一個參數是一個一般現在式表達式,整個語句等效於調用了角色的對話(dialogue)函數並且互動參數為True。舉例:
e "Hello, world."
等效於
$ e("Hello, world.", interact=True)
在腳本執行時,默認保存內容前,say語句會搜索 角色
名字並先保存。如果你想要在默認保存內容中有一個與角色名相同的變數,可以這樣定義:
define character.e = Character("Eileen")
這名角色可以如同變數一般使用::
label start:
# 這是個糟糕的變數名。
$ e = 100
e "我們的起始能量是 [e] 個單位。"
say語句帶入參,對應回調函數的情況,樣例:
e "Hello, world." (what_size=32)
等效於::
$ e("Hello, world.", interact=True, what_size=32)
當e是一個角色對象時,還可以進一步等效為:
$ Character(kind=e, what_size=32)("Hello, world.", interact=True)
但是,我們也可以使用 var:config.say_arguments_callback 回調函數或者外包(wrap)一個角色實現一些與眾不同的功能。
窗口管理的實現,是通過設置 _window
和
_window_auto
變數,及使用下面兩個函數:
_window_hide
(trans=False) linkpython中等效於“window hide”窗口隱藏語句。
_window_show
(trans=False) linkpython中等效於“window show”窗口展現語句。