龍之書 - Mod設置編輯與配置表前置Mod

Mod設置編輯器、配置表導出與修改

龍之書

《龍胤立志傳》Mod框架

龍，可是帝王之徵啊！

龍之書當前主要提供兩類能力：

• 在遊戲加載配置表時，導出遊戲配置表，便於分析和二次整理。
• 在不直接改遊戲資源的前提下，通過 `ModsOfLong` 目錄對 CSV 配置表做增量補丁。

開源地址：

交流與Bug反饋羣：1079986582

安裝教程

前置

該Mod需要安裝MelonLoader框架，可以手動下載或使用安裝器安裝。

官方安裝器地址：

龍之書安裝器：

手動安裝

下載該Mod，將Mod解壓到遊戲文件夾`LongYinLiZhiZhuan\Mods`下載該Mod，將Mod解壓到遊戲文件夾

或將下載的Mod拖拽到龍之書安裝器的安裝框內。

自動安裝

使用龍之書安裝器：

點擊下載按鈕，等待下載完成。

配置界面

• 進遊戲後會自動彈出一次配置界面。
• 也可以按 `F4` 打開或關閉。
• 改完會自動保存。
• 可以改開關鍵，也可以關掉“啓動後自動打開”。

功能與作用

1. 配置表導出

啓動遊戲後，會導出遊戲配置表到目錄：

```

\DataDump\Latest

```

2. 數據 Mod 增量補丁

Mod 會在遊戲 `Mods` 目錄下自動創建：

```

\Mods\ModsOfLong

```

在這個目錄下，所有以 `mod` 開頭的文件夾都會被識別爲一個數據 Mod。

使用方法

安裝 Mod

前提：

• 已安裝《龍胤立志傳》
• 已安裝 MelonLoader
• 已將構建產物放到遊戲 `Mods` 目錄，或直接使用本項目編譯自動複製

運行成功後：

• `TheBookOfLong.dll` 會位於 `\Mods`
• 導出目錄會出現在 `\DataDump\Latest`
• 數據 Mod 根目錄會出現在 `\Mods\ModsOfLong`

編寫數據 Mod

數據 Mod 目錄結構示例：

```text

Mods

└─ ModsOfLong

└─ modMyFirstMod

├─ Info.json

└─ Data

├─ NameData.csv

└─ ItemData.csv

```

`Info.json` 可選，示例：

```json

{

"Name": "我的第一個數據 Mod"

}

```

如果沒有 `Info.json`，則默認使用文件夾名去掉 `mod` 前綴後的內容作爲顯示名。

CSV 補丁規則

補丁文件路徑應與導出的配置名保持一致，例如導出得到：

```text

DataDump\Latest\GameData\NameData.csv

```

則補丁文件應放在：

```text

Mods\ModsOfLong\modMyFirstMod\Data\GameData\NameData.csv

```

合併規則：

• 第一行表頭必須與原表完全一致。
• 主鍵列會優先識別 `id`、`ID`、`編號`、`序號`、`劇情編號` 等列名。
• 主鍵相同則覆蓋原行。
• 主鍵不存在則追加新行。
• 沒有明確主鍵時，會退回到更寬鬆的首列識別邏輯。

字符串 ID 規則

由於遊戲的數據配置ID是遞增的，爲了使得Mod添加內容方便，新增一種可以使用字符串作爲ID佔位符的方式

```text

mod角色A

mod新劇情001

modMyCustomNpc

```

處理規則：

• 以 `mod` 開頭的字符串主鍵會被識別爲“符號 ID”。
• 所有數據 Mod 讀取完成後，會按字符串排序統一映射爲新的數字 ID。
• 如果同一個符號 ID 出現在多個表中，它們會映射成同一個數字 ID。
• 如果某些共享符號 ID 的表缺少對應行，Mod 會自動補空白佔位行並在日誌裏提示。

該機制使得多個Mod添加相同內容不易出現ID衝突和覆蓋問題。