# Vtuber 鬧鐘設計模板 - 使用手冊

:::danger
:::

本篇教學將帶你如何使用 RPG Maker MZ 軟體來製作「Vtuber 鬧鐘」的設計模板，不過由於我只提供設計模板的部分，如果需要輸出成 Android APP 並上架到 Google Play 商店的話，歡迎至以下的 Email 地址跟我來信洽談後續的委託。

聯繫用 Email： [e-mail]

**※ 然後，我提供的 Vtuber 鬧鐘設計模板，可以允許您作為商業接案的委託項目之一。**

## 第一步 – 事前準備

1. 首先您需要購買 RPG Maker MZ 軟體，如果您已經購買此軟體的話，可以跳至第2點開始。

:::info
**<i class="fa fa-info-circle" aria-hidden="true"></i>** 此外，如果你本身擁有撰寫網頁程式的能力的話，可以直接跳至 [附錄：使用命令](#%E9%99%84%E9%8C%84%EF%BC%9A%E4%BD%BF%E7%94%A8%E5%91%BD%E4%BB%A4) 開始。
:::

* [Steam](https://store.steampowered.com/app/1096900/RPG_Maker_MZ/)
* [KOMODO PLAZA (US)](https://plaza-us.komodo.jp/products/rpg-maker-mz)
* [KOMODO PLAZA (JP)](https://plaza-us.komodo.jp/products/rpg-maker-mz) ([30天試用版](https://plaza.komodo.jp/collections/rpg-tkool-free-trials#rpg-tkool-mz))
* [DLsite](https://www.dlsite.com/home/work/=/product_id/RJ296831.html)

2. 解壓縮本專案之後，在以下使用的插件清單下載插件檔案，並將那些插件放入到專案根目錄的`js/plugins`資料夾裡面。

| 插件名稱 | SkipTitleScreenMZ.js |
| -------- | -------- |
| 插件作者 | [DonGang] DonF204 |
| 插件使用條款 | 未知 |
| 插件下載來源 | [https://www.youtube.com/watch?v=Q9Z-9PpNoZA/](https://www.youtube.com/watch?v=Q9Z-9PpNoZA/) |
| 插件下載方式 | 前往上述下載來源的網址，接著展開影片下方的內容資訊，
在「Download Link:」那邊的連結處點擊下載插件即可。|

| 插件名稱 | PluginCommonBase.js |
| -------- | -------- |
| 插件作者 | triacontane |
| 插件使用條款 | 未知 |
| 插件下載來源 | 有購買 RPG Maker MZ 的情況，在`x:\Steam\steamapps\common\RPG Maker MZ\dlc\BasicResources\plugins\official`的路徑之下，找到`PluginCommonBase.js`，並將該插件複製到專案的`js/plugins`資料夾裡面。|


| 插件名稱 | MPP_ChoiceEX.js |
| -------- | -------- |
| 插件作者 | Mokusei Penguin |
| 插件使用條款 | [https://woodpenguin.web.fc2.com/MV_Plugin/License.txt](https://woodpenguin.web.fc2.com/MV_Plugin/License.txt) |
| 插件下載來源 | [https://woodpenguin.web.fc2.com/MV_Plugin/ChoiceEX.html](https://woodpenguin.web.fc2.com/MV_Plugin/ChoiceEX.html)|
| 插件下載方式 | 前往上述下載來源的網址，接著在「MPP_ChoiceEX.js」右邊的按鈕「ダウンロード」按下下載插件，並將該下載的插件複製到專案的`js/plugins`資料夾裡面。|

| 插件名稱 | HIME_LargeChoices.js |
| -------- | -------- |
| 插件作者 | Hime |
| 插件使用條款 | [https://himeworks.com/terms-of-use/](https://himeworks.com/terms-of-use/) |
| 插件下載來源 | [https://himeworks.com/2015/10/large-choices-mv/](https://himeworks.com/2015/10/large-choices-mv/)|
| 插件下載方式 | 前往上述下載來源的網址，接著在「Downloads」下方按下「download here」下載插件，並將該下載的插件複製到專案的`js/plugins`資料夾裡面。|

| 插件名稱 | GALV_VisualNovelChoicesMZ.js |
| -------- | -------- |
| 插件作者 | Galv |
| 插件使用條款 | [https://galvs-scripts.com/terms-of-use/](https://galvs-scripts.com/terms-of-use/) |
| 插件下載來源 | [https://galvs-scripts.com/2020/11/17/mz-visual-novel-choices/](https://galvs-scripts.com/2020/11/17/mz-visual-novel-choices/)|
| 插件下載方式 | 前往上述下載來源的網址，接著在「Download Plugin file」下載插件，並將該下載的插件解壓縮之後，複製到專案的`js/plugins`資料夾裡面。|

| 插件名稱 | GALV_MessageStylesMZ.js |
| -------- | -------- |
| 插件作者 | Galv |
| 插件使用條款 | [https://galvs-scripts.com/terms-of-use/](https://galvs-scripts.com/terms-of-use/) |
| 插件下載來源 | [https://galvs-scripts.com/2020/09/16/mz-message-styles/](https://galvs-scripts.com/2020/09/16/mz-message-styles/)|
| 插件下載方式 | 前往上述下載來源的網址，接著在「Download Plugin file」下載插件，並將該下載的插件解壓縮之後，複製到專案的`js/plugins`資料夾裡面。|

| 插件名稱 | DTextPicture.js |
| -------- | -------- |
| 插件作者 | トリアコンタン |
| 插件使用條款 | [http://opensource.org/licenses/mit-license.php](http://opensource.org/licenses/mit-license.php) |
| 插件下載來源 | [https://github.com/triacontane/RPGMakerMV/tree/mz_master/DTextPicture.js](https://github.com/triacontane/RPGMakerMV/tree/mz_master/DTextPicture.js)|
| 插件下載方式 | 前往上述下載來源的網址，接著按下右上角的下載圖示的按鈕，並將該下載的插件複製到專案的`js/plugins`資料夾裡面。|

| 插件名稱 | Chimaki_MsgTool.js |
| -------- | -------- |
| 插件作者 | Chimamki |
| 插件使用條款 | [https://gitlab.com/mitori10feet/rpgmakermv/-/blob/master/README.md](https://gitlab.com/mitori10feet/rpgmakermv/-/blob/master/README.md) |
| 插件下載來源 | [https://gitlab.com/mitori10feet/rpgmakermv/-/blob/master/RMMZ/DevProject/js/plugins/Chimaki_MsgTool.js](https://gitlab.com/mitori10feet/rpgmakermv/-/blob/master/RMMZ/DevProject/js/plugins/Chimaki_MsgTool.js)|
| 插件下載方式 | 前往上述下載來源的網址，接著按下右上角的下載圖示的按鈕，並將該下載的插件複製到專案的`js/plugins`資料夾裡面。|

## 第二步 – 編輯模板

3. 將 ClockContents.csv 上傳至 Google 雲端硬碟，並在 Google 雲端硬碟開啟此檔編輯內容，接著編輯完成後另存下載為CSV檔，並以「ClockContents.csv」命名放在專案根目錄的`data`資料夾裡面。



4. 在專案根目錄中打開 game.rmmzproject 檔案來開啟專案，在上方點擊「資料庫」按鈕，或按下快捷鍵 <kbd>F9</kbd> 開啟資料庫，你可以在「一般劇情」頁籤，打上星號的那些事件名稱自由修改您想要的內容。



:::info
**<i class="fa fa-info-circle" aria-hidden="true"></i>** 如果您很熟悉 RPG Maker MZ 開發的話，可以自由擴充功能或是刪減不需要的功能等內容修改。
:::

5. 使用付費軟體 Photoshop 或是用開源軟體 GIMP 開啟「Vtuber - AlarmClock_UI.psd」和「Vtuber - AlarmClock_Info.psd」，接著您完成設計之後，可以在對應按鈕的圖層資料夾按右鍵另存到專案根目錄的`img/parallaxes`、`img/pictures`、`img/system`之中。



:::warning
<i class="fa fa-exclamation-triangle" aria-hidden="true"></i> 關於 Vtuber - AlarmClock_Info.psd 的「開發者資訊」部分，您可以自由新增製作名單的項目，並調整文字大小及位置等，但不要把現有的製作名單項目擅自刪除掉。
:::

6. 如果您有錄製自己的聲音，以及使用其他音樂素材的話，請分別放在專案根目錄的`audio/se`和`audio/bgm`。


## 附錄：使用命令

這邊是給擅長撰寫網頁程式的人所提供的使用命令。

//呼叫非消耗性產品的購買
window.location = "iap://rpgmaker?action=purchase&productId=" + (非消耗性產品ID) + "&personOffer=false";

//呼叫訂閱型產品(基本方案)的購買
window.location = "iap://rpgmaker?action=subscribeBasePlan&basePlanId=" + (基本方案ID);

//呼叫訂閱型產品(優惠)的購買
window.location = "iap://rpgmaker?action=subscribeOffer&basePlanId=" + (基本方案ID) + "&offerId=" + (優惠ID);

//取消訂閱型產品
window.location = "iap://rpgmaker?action=unSubscribe&productId=" + (訂閱性產品ID);

//取得非消耗性產品的價格
window.location = "iap://rpgmaker?action=getConPurchase&productId=" + (非消耗性產品ID);

//取得訂閱型產品(基本方案)的價格
window.location = "iap://rpgmaker?action=getSubscribe&basePlanId=" + (基本方案ID);

//取得訂閱型產品(優惠)的價格
window.location = "iap://rpgmaker?action=getSubscribeOffer&basePlanId=" + (基本方案ID) + "&offerId=" + (優惠ID);

//檢查非消耗性產品的購買
window.location = "iap://rpgmaker?action=inAppRestore&productId=" + (非消耗性產品ID);

//檢查訂閱型產品(基本方案)的購買
window.location = "iap://rpgmaker?action=subBasePlanRestore&basePlanId=" + (基本方案ID);

//呼叫外部網頁
window.location = "inapp://rpgmaker?action=link&urlargs=" + (網址);

//關閉應用程式
window.location = "inapp://rpgmaker?action=exit";

//呼叫應用程式評論
window.location = "inapp://rpgmaker?action=review";

//呼叫文字輸入框
window.location = "inapp://rpgmaker?action=edittext&title=" + (輸入框標題) + "&msg=" + (輸入框訊息提示) + "&varld=" + (輸入框變數ID);

//呼叫時鐘設定
window.location = "inapp://rpgmaker?action=callTimeSet&var01=" + (變數01 ID)+ "&var02=" +(變數02 ID);

//設定鬧鐘
window.location = "inapp://rpgmaker?action=setAlarm&ld=" + (鬧鐘ID) + "&sun=false&mon=false&tue=false&wed=false&thu=false&fri=false&sat=false";

//取消鬧鐘
window.location = "inapp://rpgmaker?action=cancelAlarm&ld=" + args.ld;

//檢查聲音模式
window.location = "inapp://rpgmaker?action=checkAudio";

//顯示橫幅廣告
window.location = "admob://rpgmaker?action=callBannerAd&state=true";

//隱藏橫幅廣告
window.location = "admob://rpgmaker?action=callBannerAd&state=false";

//呼叫插頁式廣告
window.location = "admob://rpgmaker?action=callIntAd";

//呼叫獎勵廣告
window.location = "admob://rpgmaker?action=callRewardInterAd&rewardId=" + (事件ID);

//回傳時間設定
function callTime(var01, var02, hour, min) {
	// var01：number
    // var02：number
    // hour：number
    // min：number
};

//回傳購買成功狀態
function BillingSuccess(productId) {
	// productId：number
};

//回傳訂閱狀態
function BillingSubscription(productId, sw) {
	// productId：number
    // sw：true/false
};

//回傳購買失敗狀態
function BillingFail(ErrorCode) {
	// price：ErrorCode
};

//回傳非消耗性產品定價
function BillingGetConPurchase(productId, price) {
	// productId：number
    // price：string
};

//回傳訂閱型產品(基本方案)定價
function BillingGetSubscribe(productId, price) {
	// productId：number
    // price：string
};

//回傳訂閱型產品(優惠)定價
function BillingGetSubscribeOffer(productId, price) {
	// productId：number
    // price：string
};

//回傳文字輸入框的訊息
function Showeditdialog(msgtext, varld) {
	// msgtext：string
    // varld：number
};

//回傳獎勵廣告
function RewardInterAd(rewardId) {
	// rewardId：number
};

//回傳聲音模式狀態
function checkAudio(boolean) {
	// boolean：true/false
};