Skip to content

劇本命令

這個章節將會介紹如何使用控制劇本演出的命令。

命令表

  • BG
    更換 背景圖片BG
  • BGM
    更換 背景音樂BGM
  • SE
    播放一個 效果音SE
  • CG
    顯示或消除CG
  • EF
    爲畫面元素添加 特效effect
  • VIDEO
    播放一段 視頻video

詳細介紹

先說一下，用豎線分割的漢字是爲「看到英文就頭大的開發者」提供的中文寫法，效果和英文完全一樣。

然後，語法欄目裏，大括號 {} 裏面的是參數的名字。如果名字後有等號 =，說明參數有默認值——也就是你不填這個參數就自動使用 = 後面的值。

BG | 背景

BG 會把當前的背景圖片BG換成你指定的文件。
(當然你得在圖片文件夾裏把圖片放好)

  • 語法:
> BG {文件名} {淡入時間=1} {位置="0% 0%"} {漸變方法='_淡出'}
  • 樣例:
> BG 魔王城內
> 背景 染紅的街道.png
> BG 潘大爺神殿 1.5 "50% 50%"

漸變方法參數是由對應的CSS屬性指定的，在「前端/樣式/特效.css」中實現了幾個預置的漸變。

位置參數就是background-position。

如果不指定擴展名，則會按 webp, png, jpg 的順序挑選存在文件的擴展名。

背景圖片BG文件不存在的場合，背景會變成黑色，控制檯會出現警告。

BGM | 背景音樂 | 背景音乐

BGM 會更換當前的背景音樂BGM爲你指定的文件。

如果指定爲 None，背景音樂BGM會消除，會有一點淡出時間。但總是沒有淡入。

  • 語法:
> BGM {文件名} {音量=1}
  • 樣例:
> BGM 愉快的音樂.mp3
> 背景音樂 不愉快的音樂 0.5
> BGM None

如果不指定擴展名，則會按 opus, mp3, ogg 的順序挑選存在文件的擴展名。

背景音樂BGM文件不存在的場合，背景音樂會停止，控制檯會出現警告。

SE | 效果音

SE 會播放一個你指定的 效果音SE。

  • 語法:
> SE {文件名} {音量=1}
  • 樣例:
> SE 跳的聲音.mp3

如果不指定擴展名，則會按 opus, mp3, ogg 的順序挑選存在文件的擴展名。

文件不存在的場合，控制檯會出現警告。

CG

CG 進入CG模式並立即使用指定的CG。

在CG模式下，CG佔據整個畫面，立繪char和背景圖片BG也會被擋住。
如果指定爲 None，會解除CG。

  • 語法:
> CG {文件名} {淡入時間=1} {漸變方法='_淡出'}
  • 樣例:
> CG 極夜大戰
> CG None

漸變方法參數是由對應的CSS屬性指定的，在「前端/樣式/特效.css」中實現了幾個預置的漸變。

如果不指定擴展名，則會按 webp, png, jpg 的順序挑選存在文件的擴展名。

CG文件不存在的場合，控制檯會出現警告。

EF | 特效

EF 改變畫面元素的特效effect。

  • 語法:
> EF {元素ID} {特效名}
  • 樣例:
> EF bg 灰

樣例使背景圖片BG變得灰暗，需要參考 進階/特效 。

VIDEO | 視頻 | 视频

VIDEO 插入一個視頻，用於OP、ED之類的場合。

  • 語法:
> VIDEO {影片名} {可以跳過=False}
  • 樣例:
> VIDEO OP.webm
> 視頻 ED.mp4 True

在指定 可以跳過 爲True後，可以點擊視頻來跳過。

不要在默認格式的語法中再顯式指定False，因爲是字符串，反而會變成True。
(如果你不知道上面這句話在說什麼就當作它不存在吧……)

python風格的寫法

如果你有編程經驗的話，可能會喜歡類似函數調用風格的寫法。

> BG 家裏.png
> BGM 打架的聲音.mp3

也可以寫成

> BG('家裏.png')
> BGM('打架的聲音.mp3')

這些命令都可以直接寫成python語句，參數和原本的寫法是一樣的。
因爲直接調用了 eval 所以其實可以調用系統函數……不過好在每句都使用獨立的運行環境，不會互相干擾。

注意

  • 命令都是大小寫敏感的(當然對簡化字也是敏感的所以我定義了兩次別名……)。

  • 應該可以支持所有主流文件格式(因爲不是我寫的我也不知道)。

  • 文件中的空行總是被忽略，在adv的表現上沒有任何影響。

  • 多餘的空格會被忽略。 

    > BG   河上.png
>BG 河上.png

    這兩種寫法都可以。

  • 在默認寫法中，你的文件名裏含有空格的話，得用引號把它包起來。

    > BG "教室 夜.png"

    就像在命令列裏那樣。