module_cook1470 @ CG

Name

module_cook1470

Email

[email protected]

Link

OPEN

# 視覺小說引擎(VisualNovelEngine) 本專案主要是用來製作視覺小說用的。 <a href="cg://source/CG.VisualNovelEngine/README.ja.md" class="mat-raised-button mat-primary">日本語版を見る</a> <a href="cg://source/CG.VisualNovelEngine/README.en.md" class="mat-raised-button mat-primary">View English Version</a> 目前主要把最基本的場景、對話框、人物立繪、選項完成了，剩下的就是各種特效了，還有最麻煩的存檔系統。想要更進一步討論關於此模組的人，可以加入 **[Discord - 嘎姆討論區](https://discord.gg/hZKQzRfPJM)** ，這是我個人自行創建的非官方 Discord 伺服器。或是我的 Discord 使用者名稱（Username）為：`cook1470`，若不想加入群組的人，也可以直接加我 DC 喔！ <font color=red>**本模組仍處於測試、開發階段，如有任何 BUG、功能不完善等問題，歡迎於討論區提出、回報，或是直接 Discord 找我也可以！**</font> 為協助優化本模組，歡迎填寫協助 **[回饋問卷](https://forms.gle/PUckLReQgFK7i7Z68)** 。 **[範例遊戲專案](https://code.gamelet.com/edit/VisualNovelGame?source=CG.VisualNovelGame/example.events)** ## 相關資源 - 文章 - **[巴哈姆特 - 【教學】在網頁上做一個視覺小說遊戲](https://home.gamer.com.tw/artwork.php?sn=5866046)** - **[IT邦幫忙 - [Day 11] 在 CG 上公開自己的作品](https://ithelp.ithome.com.tw/articles/10328457)** - **[IT邦幫忙 - [Day 12] 設定專案封面、將成品發布到 Gamelet.online](https://ithelp.ithome.com.tw/articles/10328935)** - **[IT邦幫忙 - 什麼！在網頁上也可以寫視覺小說？](https://ithelp.ithome.com.tw/articles/10337454)** - 影片 - **[【遊戲設計】介紹在網頁上製作視覺小說遊戲](https://www.youtube.com/watch?v=5AUGRityOec)** - 本站討論串 - **[變數決定結局](https://code.gamelet.com/discuss/p/liaw1/issue/3698/0)** - **[分支選項設置](https://code.gamelet.com/discuss/coding/topic/3706)** ## 網友成品遊戲列表 - **[小又生日活動【異世界大冒險】](https://a2569.gamelet.online/)** - **[God](https://godblesses.gamelet.online/)** - **[平凡的一天](https://dinvmip.gamelet.online/)** ## 作者 **[酷可](/profile/64897095@github)（[Youtube](https://www.youtube.com/channel/UCe4mAxtv7eWFU2FDp6bMVVg)、[X](https://x.com/cook1470)）** ## 素材網站推薦 - 背景圖 - **[みんちりえ](https://min-chi.material.jp/)** - **[KNT graphics](http://kntgraphics.web.fc2.com/)** - 角色立繪 - **[わたおきば](https://wataokiba.net/)** - 音訊 - **[フリー音楽素材 H/MIX GALLERY](http://www.hmix.net/)** - **[魔王魂](https://maou.audio/)** <a href="cg://source/CG.VisualNovelEngine/README.ja.md" class="mat-raised-button mat-primary">日本語版を見る</a> <a href="cg://source/CG.VisualNovelEngine/README.en.md" class="mat-raised-button mat-primary">View English Version</a>

VisualNovelEngine

module_cook1470

OPEN

TwilightWarsEventsExp

module_cook1470

OPEN

module_cook1470

OPEN

# RyvexiaLib 這是一個用來製作 **[Ryvexia](https://ryvexia.gamelet.online/)** 音樂遊戲的核心模組，如果想要摳出新專案來製作遊戲，請不要摳此模組，建議摳遊戲成品。有任何問題請於 **[專案討論](https://code.gamelet.com/discuss/p/RyvexiaLib/0)** 回報，會盡快解決。 ### 遊玩方法遊戲開始後，會播放音樂，並從畫面上方落下音符，當音符與下方的判定框重合後按下對應的按鍵來打擊音符，打擊時機越準分數越高。預設為四個軌道，對應按鍵分別為 D、F、J、K。音符的種類目前分為下列幾種： - **Tap**：單壓，當音符與下方的判定框重合後，按下對應的按鍵來打擊音符。 - **Hold**：長壓，當音符與下方的判定框重合後，按住對應的按鍵直到音符結束時完成打擊。遊戲中按下 ESC 可暫停遊戲。 ## 如何開始？ ```typescript // 設置譜面檔案路徑（專案內），必須先於專案內新增譜面資料檔案。 const chartSource = `CG.${CG.Base.projectCode}/test.json`; // 加載檔案。 CG.Base.resourceManager.addAppSource(chartSource) // 初始化 RyvexiaLib。 CG.RyvexiaLib.initialize() .then(() => { // 初始化完成後 // 初始化 pixi 舞台，建議舞台寬高 1920 x 1080。 CG.Base.pixi.initialize(1920, 1080); // 新增一個譜面資料物件，並匯入譜面資料。 const chartData = new CG.RyvexiaLib.datas.ChartData(); chartData.importSource(chartSource); // 加載該譜面的音樂資料。 chartData.loadMusic(() => { // 加載完成後 // 建立 Ryvexia 遊戲物件，並加入到 root 舞台顯示於畫面上。 const game = new CG.RyvexiaLib.games.Game(); CG.Base.pixi.root.addChild(game); // 設置該遊戲的譜面資料並開始遊戲。 game.setup(chartData).start(); }) }) ``` ## 自製譜面本模組提供了具有圖形化介面的譜面編輯器，當然你也可以自己使用程式碼添加，甚至利用譜面資料可以新增資料的功能，自製一個譜面編輯器也可以。 ### 如何從編輯器開始？ #### 快捷鍵： - Ｗ、上：譜面向上移動。 - Ｓ、下：譜面向下移動。 - Shift + 移動：加速移動。 - ＋：增加每小節的拍數。 - －：減少每小節的拍數。 - Shift + 測試遊戲：啟用自動遊玩模式。（也可以拖動進度條來改變音樂進度。） ```typescript // 初始化 RyvexiaLib CG.RyvexiaLib.initialize() .then(() => { // 初始化 pixi 舞台 CG.Base.pixi.initialize(1920, 1080); // 創建譜面資料物件，BPM 為 160 const chartData = new CG.RyvexiaLib.datas.ChartData(160); // 設定譜面音樂資源名稱 chartData.musicAlias = "你的音樂資源別稱"; // chartData.musicFilename = "你的音樂資源檔名"; // 如果你的音樂是壓縮檔，就會需要用到這一條。 // 建立譜面編輯器並匯入譜面資源 const editor = new CG.RyvexiaLib.editors.ChartEditor(chartData); editor.loadByStorage(); // 於譜面編輯器建立後嘗試讀檔，若無檔案則會忽略。 editor.saveWhileTest = true; // 啟用編輯器測試遊戲時自動存檔。（只有在測試遊戲時會存檔，不是有更新就會儲存） // 建立主要遊戲（讓編輯器用於測試） const game = new CG.RyvexiaLib.games.Game(); // 建立編輯器頁面（用於控制編輯器與遊戲之間的溝通） const editorPage = new CG.RyvexiaLib.utils.pages.ChartEditorPage(editor, game); // 顯示編輯器頁面 editorPage.show(); }) ``` ### 如何從程式碼編輯？ ```typescript // 創建一個譜面資料，bpm 為 175。 const chartData = new CG.RyvexiaLib.datas.ChartData(175); // 設定一些譜面資料。 chartData.title = 'Sing My Pleasure'; // 譜面標題 chartData.musicAlias = 'RyvexiaLib.Sing My Pleasure'; // 音樂資源別稱 chartData.musicAuthor = 'Vivy (Vo.Kairi Yagi)'; // 音樂作者、歌手 chartData.chartAuthor = '酷可（cook1470）'; // 譜面作者 // 預設有 4 個軌道，於第 1 軌道，第 0 節拍，位置 0 添加音符。 chartData.tracks[1].addNote(0, new NoteData(0)); // 於第 0 軌道，第 0 節拍，位置 0.5 添加音符。 chartData.tracks[0].addNote(1, new NoteData(0.5)); // 於第 2 軌道，第 7 節拍，位置 0.5 添加音符，音符長度 8。 chartData.tracks[2].addNote(7, new NoteData(0.5, 8)); // BPM 變速設定，於第 20 小節開始，BPM 變為 160。 chartData.bpms[20] = 160; // 於第 50 小節開始，BPM 變為 160。 chartData.bpms[50] = 175; // 創建好以後，可以使用 exportJson 匯出 JSON 物件，並使用 JSON.stringify 轉換成字串。 const text = JSON.stringify(chartData.exportJson()); // 再使用 Base 的 HtmlUtil 來下載檔案。 CG.Base.utils.HtmlUtil.downloadText(text, '我的譜面.json'); // 也可以將譜面資料壓縮後直接下載，不需轉換 JSON，且檔案大小會更小。 // CG.Base.utils.HtmlUtil.downloadText(chartData.exportGzip(), '我的譜面.rvx'); ``` 如果你想要使用壓縮後的譜面檔案，匯入的方法稍有不同。 ```typescript const chartSource = 'CG.YourProject/我的譜面.rvx'; // 與 #如何開始？相同，先加載要使用的譜面，可參考上方介紹，在此省略。 // 利用 Base 的資源管理器讀取成字串。 const text = CG.Base.resourceManager.getText(chartSource); // 新增一個譜面資料物件，並匯入壓縮譜面資料。 const chartData = new ChartData(); chartData.importGzip(text); // 後續與 #如何開始？相同，建立遊戲、載入音樂並開始遊戲。 ``` ## 頁面控制器本模組提供了一個簡單的頁面控制器，以及一些預設的頁面可供使用，以下展示以編輯器為主的控制流程。包含了封面、校正頁面、編輯器頁面。 ```ts // 初始化 RyvexiaLib CG.RyvexiaLib.initialize() .then(() => { // 初始化 pixi 舞台 CG.Base.pixi.initialize(1920, 1080); // 建立頁面管理器。 const pageManager = new CG.RyvexiaLib.utils.PageManager(); // 建立封面頁面，並註冊到頁面管理器中。 const coverPage = new CG.RyvexiaLib.utils.pages.CoverPage(); // coverPage.titleText.text = "我的音樂遊戲"; // 可改變封面標題文字，預設為 Ryvexia pageManager.registerPage(coverPage); // 建立校正、設定頁面，並註冊到頁面管理器中。 const calibrationPage = new CG.RyvexiaLib.utils.pages.CalibrationPage(); pageManager.registerPage(calibrationPage); const chartData = new CG.RyvexiaLib.datas.ChartData(175); chartData.musicAlias = "你的音樂資源別稱"; const editor = new CG.RyvexiaLib.editors.ChartEditor(chartData); editor.loadByStorage(); editor.saveWhileTest = true; const game = new CG.RyvexiaLib.games.Game(); // 建立編輯器頁面（用於控制編輯器與遊戲之間的溝通），並註冊到頁面管理器中。 const editorPage = new CG.RyvexiaLib.utils.pages.ChartEditorPage(editor, game); pageManager.registerPage(editorPage); // ========== 操控個頁面之間的切換流程。 ========== // 當於封面頁面開始時。 coverPage.onStart = () => { // 顯示校準頁面。 pageManager.show(calibrationPage.code); } // 當於校準頁面返回時。 calibrationPage.onReturn = () => { // 顯示譜面編輯器頁面。 pageManager.show(editorPage.code); } // 當於譜面編輯器頁面返回時。 editorPage.onReturn = () => { // 顯示封面。 pageManager.show(coverPage.code); } // 一開始先顯示封面頁。 pageManager.show(coverPage.code); }) ``` ## 進階設定本模組將一些可設置常數放在 `CG.RyvexiaLib.Constant` 內，裡面有一些特別的參數可以調整，以下為預設值。 ```typescript // 以下可設定各判定分的範圍（時間差）。 CG.RyvexiaLib.Constant.PERFECT_TIME_RANGE = 46; CG.RyvexiaLib.Constant.GREAT_TIME_RANGE = 92; CG.RyvexiaLib.Constant.GOOD_TIME_RANGE = 138; CG.RyvexiaLib.Constant.MISS_TIME_RANGE = 200; // 以下可設定作為判定分顯示的文字，遊戲中、結算等。 CG.RyvexiaLib.Constant.SCORE_TYPES.PERFECT = "Perfect"; CG.RyvexiaLib.Constant.SCORE_TYPES.GREAT = "Great"; CG.RyvexiaLib.Constant.SCORE_TYPES.GOOD = "Good"; CG.RyvexiaLib.Constant.SCORE_TYPES.MISS = "Miss"; ``` ## 作者 **[module_cook1470](/profile/64897095@github)**

module_cook1470

OPEN

# 瓦片地圖引擎（TilemapEngine）瓦片地圖，是由一格一格的方塊所組成，本模組提供了簡單的函示庫，可以快速的渲染出一個瓦片地圖。 ## 讓我們開始吧！本模組結合了 CgEventsEngine（CG事件表引擎），提供一些簡單的事件表動作，若不寫程式的話，也可以進行一些基本的操作。 ### 如何開始？一般專案在新建完成後，都一定會有一個叫做 app.ts 的檔案，寫程式的位置如下表示。 ```typescript export class App { constructor() { // 程式寫在這裡，例如： console.log("Hello CG.") } } export const APP = new App(); ``` ### 創建瓦片地圖以下為創建瓦片地圖，並將其顯示到舞台中的程式範例。 ```typescript // 新增一個瓦片地圖的資源物件。 let mapResource = new TilemapResource(); // 新增地圖的圖片資源到資源物件中，並且等待瀏覽器加載完成。 mapResource.addTileset('TileMapEngine.image.FD_Free_Tiles') .loadTileset(() => { // 加載完後才會開始做這裡的事情。 // 初始化舞台大小。 CG.Base.pixi.initialize(600, 600); // 將地圖資源初始化一個空地圖，長寬為 10x10，瓦片大小為 48，圖層有 3 個。 mapResource.emptyMap(10, 10, 48, 3); // 把圖層 0 的所有瓦片換成瓦片集 0 中，第 3 個瓦片。 mapResource.setLayerAllTile(0, 0, 3); // 新增一個瓦片地圖，並使用剛剛的地圖資源。 let tilemap = new Tilemap(mapResource); // 將瓦片地圖放置到舞台中。 CG.Base.pixi.root.addChild(tilemap); }) ``` ### 匯出地圖資料地圖資源的資料，可以使用函數來匯出 JSON，並且將其下載成檔案。 ```typescript // 將地圖資料匯出成 JSON，並轉換成文字字串。 let text = JSON.stringify(mapResource.exportJson()); // 使用 Base 的 HtmlUtil 來下載文字檔案， map.json 為檔案名稱。 CG.Base.utils.HtmlUtil.downloadText(text, 'map.json'); ``` ### 匯入地圖資料除了生成空白地圖，也可使用檔案匯入地圖資料來生成以前儲存的地圖。你需要先在專案上新增檔案（如 map.json），並將之前下載的檔案內容複製到該檔案內。 ```typescript let mapResource = new TilemapResource(); // 定義地圖資源路徑。 let mapSource = 'test/map.json'; // 使用 resourceManager 匯入專案資源，後方填入地圖資源路徑。 CG.Base.resourceManager.addAppSource(mapSource); mapResource.addTileset('TileMapEngine.image.FD_Free_Tiles') .loadTileset(() => { CG.Base.pixi.initialize(600, 600); // 使用 resourceManager 取得專案資源的 JSON，並將其匯入地圖資源中。 let json = CG.Base.resourceManager.getJSON(mapSource); mapResource.importJson(json); let tilemap = new Tilemap(mapResource); CG.Base.pixi.root.addChild(tilemap); }) ``` ### 編輯地圖屬性、材質若要以程式對瓦片地圖進行編輯，可參考下列簡易的示範。其餘更多函示詳細說明，皆有在函示上進行備註，可自行參閱。 ```typescript // 設定座標 (1,2) 的 height 屬性為 1 mapResource.setTileAttribute(1, 2, 'height', 1); // 讀取座標 (1,2) 的 height 屬性，儲存在 height 這個變數中。 let height = mapResource.getTileAttribute(1, 2, 'height'); // 於控制台輸出() 內的內容。 console.log("座標 (1,2) 的高度為 " + height); // 座標 (1,2) 的高度為 1 // 設定圖層 0 座標 (2,2) 的瓦片為，瓦片集 0 中的第 2 個瓦片。 mapResource.setLayerTile(0, 2, 2, 0, 2); tilemap.reRender(); // 重新渲染瓦片地圖。 ``` ## Authors **[module_cook1470](/profile/64897095@github)**

瓦片地圖引擎

module_cook1470

OPEN

光暈戰記 RPG GUI 模組

module_cook1470

OPEN

# 光暈戰記 RPG 事件表模組（TwilightWarsRPGEvents）此專案為 **[TwilightWarsLib](/edit/TwilightWarsLib)** 的 RPG 功能擴充模組。大量自訂義的資料型態，搭配少量光暈本身的功能，主要是為了省略在光暈製作一個 RPG 任務時，還要先用一堆事件來製作相關系統、功能的步驟，而誕生的模組。本專案的所有功能，皆是建立在任務為開放式房間、可多人遊玩，且可跨事件表的前提下製作，也就是說整個專案共用同一個玩家資料，故如果要製作更多不同的 RPG 任務，請另建新的專案製作。有任何問題或 BUG，歡迎於討論區提出、回報。 <font color=red>**安裝此模組後，事件表會增加一些變數保留字，請避免在宣告全域變數時，使用下列名稱：**</font> **itemInfo, questInfo, {玩家代碼}_quests, {玩家代碼}_inventories, {玩家代碼}_equipmentSlot, {玩家代碼}_datas** <font color=red>**本模組不具備任何界面顯示功能，如有需要可直接安裝 [TwilightWarsRPGGUIEvents](https://code.gamelet.com/edit/TwilightWarsRPGGUIEvents) 模組，提供些許的 GUI 樣式可供使用。**</font> # 主要功能介紹 - [存讀檔功能](#存讀檔功能) <font color=grey>*ps.自動存檔、本機存/讀檔*</font> - [任務系統](#任務系統) - [自訂道具](#自訂道具) - [背包/裝備欄](#背包/裝備欄) - [跨事件表傳送](#跨事件表傳送) ## 存讀檔功能本專案所有會更動玩家資料的動作，在變更玩家資料後，皆會**自動將資料儲存到專案資料庫**中。專案任務作者只需要在玩家進入戰場後，使用動作來讀取資料即可，原則上並不需要考慮存檔的問題。若有需要，本模組也提供於本機存讀檔的功能，但不建議使用於多人遊戲中，且讓玩家可以於本機存讀檔，可能會增加玩家隨意更改資料的風險。提供可自訂玩家資料的功能，可設定例如等級、經驗值、金錢、稱號等屬性，修改數值時會自動存檔，也可隨時使用變數讀取數值。 ```typescript // 假設儲存玩家的代碼為 instance {instance.code}_datas // 使用此變數名稱可以得到該玩家的所有自訂資料。 // 若無設定資料類別，於後方加上 .資料名稱即可取得該自訂資料的數值，例如： {instance.code}_datas.level // 可以取得該玩家，自訂資料 level 的數值。 {instance.code}_datas.money // 可以取得該玩家，自訂資料 money 的數值。 // 若有設定資料類別，於後方加上 .資料類別.資料名稱即可取得該自訂資料的數值，例如： {instance.code}_datas.profile.level // 可以取得該玩家，資料類別 profile，裡面 level 的數值。 {instance.code}_datas.profile.money // 可以取得該玩家，資料類別 profile，裡面 money 的數值。 ``` ## 任務系統提供可以**儲存玩家任務狀態**的功能，每個任務皆需要有不同的任務代碼，而主要的任務狀態有「未接取」、「進行中」、「已完成」。每個任務在玩家進行中的狀態時，皆還可以**設定任務的進度**，進度的數量沒有限制，且也可以自訂進度的名稱，以及隨時更改進度的值，例如在設定某個玩家的任務狀態為「進行中」的同時，可以設定該任務的進度有「探索：0」，每當玩家到指定的地點探索後，可以讓該任務的探索進度增加，或是為擊殺型的任務時，在玩家擊殺目標對象後，使擊殺進度增加，最後在嘗試回報任務的事件中，可以在檢查的部分加上「檢查任務進度」，來檢查該任務的進度是否達到目標，以執行回報任務後會觸發的動作。由於任務進度的數量並沒有限制，所以專案作者也可以為某個任務同時設定多個進度，並檢查所有的進度都要完成時，任務才會完成。如在初始化時有執行過動作**「設置系統變數」**，可使用變數讀取任務資訊，可以參考下列格式： ```json // 假設儲存任務資訊的變數名稱為 questInfo，它會儲存所有任務的預設資訊。※ 詳細請看動作「設置系統變數」 {questInfo.questCode} // 將 questCode 改為自訂的任務代碼，可以取得該任務的所有資料。 {questInfo.main_0.name} // 可以取得任務代碼為 main_0 的名稱。 {questInfo.main_0.description} // 可以取得任務代碼為 main_0 的描述。 {questInfo.main_0.category} // 可以取得任務代碼為 main_0 的類別。 {questInfo.main_0.datas} // 可以取得任務代碼為 main_0 的自訂屬性，於後方加上 .屬性名稱即可取得該自訂屬性，例如： {questInfo.main_0.datas.returnActor} // 可以取得該任務中，自訂屬性 returnActor 的資料。 ``` 如需要在事件表中，使用變數讀取玩家任務資料，可以參考下列格式： ```json // 假設儲存玩家的代碼為 instance {instance.code}_quests // 使用此變數名稱可以得到該玩家的所有任務資料。 {instance.code}_quests.questCode // 將 questCode 改為自訂的任務代碼，可以取得玩家對於該任務的資料。 // 若是讀取該玩家未曾接取過的任務，則會得到 undefined，也無法讀取下列資料。 {instance.code}_quests.main_0.state // 取得該玩家任務代碼為 main_0 的任務狀態。（數字） // 0 - 未接取, 1 - 進行中, 2 - 已完成 {instance.code}_quests.main_0.progress // 取得該玩家任務代碼為 main_0 的當前進度資料。 // 預設為空物件 {}，需使用動作「設置任務進度」設置進度後，才會有內容可以讀取。 {instance.code}_quests.main_0.progress.talk // 取得該玩家任務代碼為 main_0 的 talk 進度值。（數字） {instance.code}_quests.main_1.progress.kills // 取得該玩家任務代碼為 main_1 的 kills 進度值。（數字） ``` ## 自訂道具提供可以**自定義道具**的動作，可設定道具的名稱、描述、最大堆疊數量、物品樣式，以及其他自訂屬性，例如傷害力、防禦力、恢復力、可否裝備等。至於定義物品道具的部分，請專門開一個事件表，將所有定義物品道具的動作放在裡面，並在玩家進入專案時執行一次即可，不需要每個事件表都重新放置動作。或是可以直接在專案的進入點，加上 new ItemInfo 來定義物品。 ```typescript /** * @param {string} code 物品代碼 * @param {string} maxStack 最高堆疊數量 * @param {string} name 物品名稱 * @param {string} description 物品描述 * @param {string} stuffCode 物品外觀道具代碼 * @param {object} datas 自訂物品屬性 * @param {string} alias 物品圖示的資源別名 * @param {string} linkage 資源的鏈接名稱 */ new ItemInfo(code: string, maxStack: number, name?: string, description?: string, stuffCode?: string, datas?: { [key: string]: number }, alias?: string, linkage?: string) // 例如以下，創建一個 apple，最高可堆疊 10 個，手持時的武器為拳頭，datas 包含了 health 為 10。 new ItemInfo('apple', 10, '蘋果', '香甜可口的水果，散發著一股淡淡的香味。', 'kongfu', datas: { 'health': 10 }); ``` 如在初始化時有執行過動作**「設置系統變數」**，可使用變數讀取物品資訊，可以參考下列格式： ```typescript // 假設儲存物品資訊的變數名稱為 itemInfo，它會儲存所有物品道具的預設資訊。※ 詳細請看動作「設置系統變數」 {itemInfo.itemCode} // 將 itemCode 改為自訂的物品代碼，可以取得該物品的所有資料。 {itemInfo.apple.name} // 可以取得物品代碼為 apple 的名稱。 {itemInfo.apple.description} // 可以取得物品代碼為 apple 的描述。 {itemInfo.apple.datas} // 可以取得物品代碼為 apple 的自訂屬性，於後方加上 .屬性名稱即可取得該自訂屬性，例如： {itemInfo.apple.datas.health} // 可以取得該物品中，自訂屬性 health 的數值。 ``` ## 背包/裝備欄提供以**陣列為架構的背包系統**，並且可以為每個玩家**設置多個不同的背包**，可用裝備不同種類的物品，或是其他用途。每個背包都可以**設置容量**，來決定這個背包可以裝多少組物品，當給予玩家物品時，若該物品的數量超過最大堆疊數量，則無法在同一欄位填裝，會自動尋找空位放入，直到背包沒有容量，且沒有可以堆疊的物品為止，並且會回傳多餘的物品數量，讓專案作者自行決定多餘的物品要怎麼處裡，例如直接丟棄，或是詢問玩家是否要替換背包中的物品，又或者是新增一個暫存用的背包，當物品數量過多時會自動裝入等等。除了給予物品以外，也可以移除物品，移除時可以決定要不要指定背包中的哪一格，或是不指定，直接移除背包中指定物品代碼的物品。提供可以檢查玩家背包物品數量的功能，可用於檢查玩家是否持有指定物品，且數量是否有達到條件，除了指定物品代碼以外，也可以檢查該物品的屬性是否符合條件。提供裝備欄系統，可以自訂玩家的裝備欄狀態，以及各部位的名稱，並且裝備上物品道具，並且提供檢查**「檢查裝備欄物品」**，可檢查玩家某個裝備欄的物品，是否符合條件，例如是否為背包上的某一物品，或是符合某些物品代碼、屬性等，也可以單純檢查該裝備欄是否存在物品道具。裝備欄的資料是直接儲存於背包資料中，故讀取背包資料時，會自動建置裝備欄的資料。另外也提供了簡易的整理背包功能，專案作者可以讓玩家自行使用，或是在背包物品改變時使用。如需要在事件表中，使用變數讀取玩家背包資料，可以參考下列格式： ```typescript // 假設儲存玩家的代碼為 instance {instance.code}_inventories // 使用此變數名稱可以得到該玩家的所有背包資料。 {instance.code}_inventories.inventoryCode // 將 inventoryCode 改為自訂的背包代碼，可以取得該背包的所有資料。 {instance.code}_inventories.myBag.slots // 可以取得背包代碼為 myBag 的容量大小。 {instance.code}_inventories.myBag.items // 可以取得背包代碼為 myBag 的所有物品資料。 {instance.code}_inventories.myBag.items.index // 可以取得該背包中，第 index 格的所有資料，index 請改為數字。 // index 是從 0 開始計算，故第一格為 0，第二格為 1，依此類推。 {instance.code}_inventories.myBag.items.0.item // 可以取得該背包中，第 0 格的物品資料。 {instance.code}_inventories.myBag.items.0.quantity // 可以取得該背包中，第 0 格的物品數量。 {instance.code}_inventories.myBag.items.0.equipped // 可以取得該背包中，第 0 格物品是否被裝備。 {instance.code}_inventories.myBag.items.0.slot // 可以取得該背包中，第 0 格物品的裝備位置。 {instance.code}_inventories.myBag.items.0.item.name // 可以取得該背包中，第 0 格物品的名稱。 // 將 name 改成其他屬性可以取得其他資料，例如： // code - 物品代碼, maxStack - 最大堆疊數量, stuffCode - 物品外型代碼, description - 物品描述 {instance.code}_inventories.myBag.items.0.item.datas // 可以取得該背包中，第 0 格物品的自訂屬性資料，於後方加上 .屬性名稱即可取得該自訂屬性，例如： {instance.code}_inventories.myBag.items.0.item.datas.damage // 可以取得該物品中，自訂屬性 damage 的數值。 ``` ```typescript // 假設儲存玩家的代碼為 instance {instance.code}_equipmentSlot // 使用此變數名稱可以得到該玩家的所有裝備欄資料。 {instance.code}_equipmentSlot.slotType // 將 slotType 改為自訂的欄位類型，可以取得該欄位的所有資料。 // 所有資料包含 item, quantity, equipped, slot {instance.code}_equipmentSlot.mainHand.item // 可以取得裝備欄中，裝備類型 mainHand 的物品資料。 // item 後面可讀取的資料，如同讀取背包內的物品資料一樣。 {instance.code}_equipmentSlot.mainHand.item.name // 可以取得裝備欄中，裝備類型 mainHand 的物品名稱，其他依此類推。 ``` ## 跨事件表傳送提供簡單的跨事件表傳送功能，可以**將玩家傳送到指定事件表的指定座標**上，只要在需要傳送玩家時，執行動作「傳送玩家」並填入事件表路徑，以及傳送座標，並且在目標事件表初始化玩家時，執行動作「讀取玩家位置」即可。儲存玩家位置，實際上是將該**玩家目前所在的事件表路徑以及座標儲存於資料庫**，也就是說事件表的位置、名稱，即是玩家所在的地點，請在一開始就確定好事件表的位置以及名稱，並不要於日後隨意更改，否則可能會導致玩家的位置資料損壞。傳送玩家，實際上就是一個會先執行「儲存玩家位置」，然後讓玩家執行目標事件表的動作。而讀取玩家位置，則是會先讀取玩家位於資料庫中的位置，並且判斷當下所在的事件表是否為資料所存的事件表，若不是的話，會自動將該玩家轉移到目標事件表，如果是的話，就會傳送玩家到資料所儲存的座標。此功能可以用於讓每張地圖都有自己的事件表，並使玩家可以在這些地圖間進行傳送，而非如同以往需要繪製一張大地圖，並使用分割區域來達成不同區域的效果，跨事件表可以有效的降低遊戲的負擔。 ## 作者 **[module_cook1470](/profile/64897095@github)**

光暈戰記 RPG 資料模組

module_cook1470

OPEN

module_cook1470

OPEN

光暈地圖格子查詢器

module_cook1470

ⒸCode.Gamelet.com | Privacy Policy | Terms of Service