🌎 [English] [简体中文] [繁體中文] [한국어]
自定義cactbot時，推薦透過cactbot的使用者介面進行操作。 該介面處於 ACT -> Plugins -> OverlayPlugin.dll -> Cactbot。
它可以提供如下功能：
您可能無法透過cactbot使用者介面以配置所有您想要的更改。 但是它是最容易的方法，適合作為您定制化的第一步。 以後此介面會添加更多的選項。
此處的選項會存儲於 %APPDATA%\Advanced Combat Tracker\Config\RainbowMage.OverlayPlugin.config.json 檔案中。 但您並不需要也不應當直接修改該檔案。
在位於ACT-> 插件> OverlayPlugin.dll-> Cactbot-> Raidboss的cactbot使用者介面中， 羅列著所有的觸發器。 這裡的列表讓您可以更改每個觸發器支持外部更改的配置設置。
名稱旁邊帶有鈴鐺(🔔) 的設置項的觸發器輸出文本是可以被覆蓋的。 舉個例子，假設有一個🔔onTarget欄位，其文字為 死刑點${player}。 當某人接到死刑技能時，這個字符串將出現在熒幕上（或通過tts播報）。 ${player} 是一個將由觸發器動態設置的引數。 任何類似於 ${param} 的字符串都是動態引數。
比如，您可以將這個文字更改為 ${player} 即將死亡！。 或者，也許您不關心誰是目標，那麼您可以將其改為 死刑 以使文字更加簡短。 如果您想撤消自己的更改，只需清空文字框即可。
但這個方式有一定的限制。 例如，您無法更改邏輯。 而且在大多數情況下，您無法使 tts 的播報與 alarmText 不同。 您無法新增更多的引數。 如果您想要對觸發器做出更加複雜的覆蓋操作， 那麼您需要檢視 Raidboss觸發器自定義 小節。
若cactbot使用者介面不存在您所需的選項，您可能需要考慮以使用者檔案覆蓋的方式進行自定義。 您需要編寫JavaScript程式碼和CSS樣式，這意味著您可能需要掌握一點點程式設計知識。
Cactbot的設計哲學要求任何使用者的自定義配置應當存放於使用者資料夾的檔案中。 同時這也能防止您所做的更改在今後cactbot的更新中被覆蓋失效。 另外，目前您無法透過直接修改cactbot的檔案應用您的更改，除非您瞭解如何構建您自己的專案。
所有的cactbot模組都會從 user/ 資料夾載入使用者設定。 raidboss 模組會載入 user/raidboss.js 與 user/raidboss.css，以及所有user/raidboss/ 目錄下及其子目錄下的 .js 和 .css 檔案。 (時間軸.txt檔案必須與引用它們的.js檔案放在同一個資料夾中。) 這些使用者自定義檔案將在cactbot自身載入完畢後被載入，並可以覆蓋對應的模組的設定。
oopsyraidsy 模組會載入 user/oopsyraidsy.js 與 user/oopsyraidsy.css。 依此類推，每個模組都支援以此方式（以檔名）載入對應自定義檔案。
cactbot將按照字母順序優先載入user資料夾中的子資料夾裡的檔案，其次載入子資料夾外的檔案。 這就是為什麼user/raidboss.js檔案總是最後被載入並可以覆蓋user/raidboss/資料夾中任何檔案中的配置。 例如，user/alphascape/some_file.js 先載入， user/mystatic/some_file.js 再載入，最後是user/raidboss.js 載入。 .css 檔案遵循同樣的順序。
在本文件中，“使用者自定義js檔案”指代以上兩者。 除了載入順序以外，user/raidboss.js 和 user/raidboss/some_file.js 沒有區別。 同樣地，“使用者自定義css檔案”同時指代 user/radar.css 和 user/radar/some_file.css 二者。 使用者資料夾中分出子目錄是為了讓分享觸發器和自定義配置更容易。
當開發者模式開啟時，你可以從除錯資訊中得到更多關於載入順序的資訊。
user/ 資料夾中包含了一部分示例配置檔案，您可以對其重新命名並直接使用。 如 user/raidboss-example.js 檔案 可被重新命名為 user/raidboss.js，對其所做的更改可應用於 raidboss 模組。
在修改了這些檔案之後，單擊ACT中OverlayPlugin外掛對應懸浮窗設定中的“重載懸浮窗”按鈕，即可應用更改。
您可以透過cactbot配置介面設定使用者資料夾： ACT -> Plugins -> OverlayPlugin.dll -> Cactbot -> cactbot使用者資料夾。 單擊 選擇資料夾 按鈕，選擇磁碟上的一個資料夾。
如果沒有選擇，cactbot將自動選擇其安裝目錄下的預設資料夾。
建議您選擇cactbot安裝目錄下的 cactbot/user 資料夾。 該資料夾通常為位於 %APPDATA%\Advanced Combat Tracker\Plugins\cactbot-version\cactbot\user。 有部分示例配置檔案位於 此資料夾 下。
使用者自定義css檔案可以對UI模組的位置、尺寸、顏色等進行自定義。 可用的選擇器可以透過閱覽 ui/<name>/<name>.css 檔案找到。
例如您在 ui/raidboss/raidboss.css 中，可發現諸如 #popup-text-container 與 #timeline-container 等選擇器， 則您可以在 user/raidboss.css 中對其位置進行自定義。 您可以在 user/raidboss.css 中或其他 user/raidboss/ 下的 .css 中新增更多的樣式。
同樣地，您可以在 .info-text 類中新增新的CSS規則，對資訊文字的尺寸和顏色進行自定義。 例如：
.info-text {
font-size: 200%;
color: rgb(50, 100, 50);
}
簡單地說，您可以認為cactbot會將使用者檔案中的CSS規則新增至內建CSS檔案的末尾。 也就是說，您需要注意 CSS優先順序規則， 例如新增 !important 讓您的規則可以強制覆蓋。 另一方面，您可能需要重置某些屬性為預設的 auto 值。
我們推薦使用 Chrome DevTools 以除錯CSS問題。 您可以透過 ACT -> Plugins -> OverlayPlugin.dll -> 您的懸浮窗名字 -> 啟動Debug工具 以開啟DevTools。
注意：某些元件的自定義較為困難，甚至無法進行自定義，如時間軸的進度條等。 原因是，這些元件屬於自定義HTML元素，且沒有開放外部配置的介面。 如果您有特別的需求，但是不知道如何修改，您可以提出一個 github issue。
警告：cactbot不保證CSS的向後相容性。 在以後的更改中，cactbot可能會重新組織網頁結構，改變元素名稱和類名稱，甚至完全重構所有樣式。 因此，您需知曉您的自定義CSS有在將來出現問題的風險。
您可以透過使用者自定義js檔案(例如 user/raidboss.js 或 user/raidboss/ 目錄下的任意.js 檔案)自定義觸發器行為。 您可以修改輸出文字、適用職業、文字顯示的時間等等。
在您的raidboss模組使用者自定義js檔案中， Options.Triggers 是一個存放了觸發器集合的列表。 您可以透過此變數新增新觸發器，或修改已有的觸發器。 若使用者檔案中存在與現有觸發器 (cactbot官方提供的) 相同id的觸發器，則會將後者其覆蓋。
在您修改觸發器前，我們推薦閱讀 觸發器指南 以瞭解各觸發器的諸多屬性的含義。
一般來說，你需要將形如以下的程式碼塊加入到你的使用者自定義js檔案(例如 user/raidboss.js)中：
Options.Triggers.push({
// 在檔案開頭定義ZoneId，
// 例如 ZoneId.MatchAll (指定所有區域) 或 ZoneId.TheBozjanSouthernFront 等
zoneId: ZoneId.PutTheZoneFromTheTopOfTheFileHere,
triggers: [
{
// 這裡定義的是觸發器(trigger)物件。
// 例如 id, netRegex或infoText等
},
],
});
最簡單的定制觸發器方式是直接複製上面那一大塊程式碼粘貼到此檔案再進行修改。 您可以修改 zoneId 一行為您想要觸發器響應的區域id，這一行通常位於cactbot觸發器檔案的頂部。 該檔案 列出了所有可用的區域id。 若您定義了錯誤的id，OverlayPlugin的日誌視窗將會輸出警告資訊。 然後複製觸發器文本並粘貼至此， 按您的喜好進行修改。 當你改完所有你想改的觸發器後， 重載raidboss懸浮窗以應用更改。
注意：此方式會將原觸發器完全移除，因此請在修改時不要刪除任何邏輯。 此外，觸發器均採用JavaScript編寫，因此必須採用標準JavaScript語法。 若您不是程式設計師，您需要格外注意編輯方法。
假定您正在攻略巴哈姆特絕境戰(UCOB)， 您的固定隊採用的不是cactbot默認的火1集合吃的打法， 而是先單吃火1。 另外，您 同時 還想讓觸發器通過tts播報與文本不同的內容。 比如，您總是忘記出人群，因此您想讓它重復播報數次。
若您只是想修改 資訊文字，你可以 透過cactbot配置介面改變觸發器文字 實現。
其中一種調整方式是編輯觸發器的輸出。 您可以在 ui/raidboss/data/04-sb/ultimate/unending_coil_ultimate.js 中找到原本的 fireball #1 觸發器。
您需要將以下的程式碼貼上至您的使用者自定義js檔案底部。
Options.Triggers.push({
zoneId: ZoneId.TheUnendingCoilOfBahamutUltimate,
triggers: [
{
id: 'UCU Nael Fireball 1',
netRegex: NetRegexes.ability({ source: 'Ragnarok', id: '26B8', capture: false }),
delaySeconds: 35,
suppressSeconds: 99999,
// infoText 是綠色的文字。
infoText: {
en: 'Fire OUT',
},
tts: {
en: 'out out out out out',
},
run: function(data) {
data.naelFireballCount = 1;
},
},
],
});
此處還刪除了英語以外的語言。
目前，只有團隊成員的挑釁會觸發提示，並且不是所有職業都能收到提示。 該例子展示了如何使其適用於所有職業。 該挑釁觸發器可以在 ui/raidboss/data/00-misc/general.js 中找到。
我們需要修改 condition 函式(function)。 由於此處的id與內建的 General Provoke 觸發器一致，因此會覆蓋同名的內建觸發器。
您需要將以下的程式碼貼上至您的使用者自定義js檔案底部。
Options.Triggers.push({
zoneId: ZoneId.MatchAll,
triggers: [
{
id: 'General Provoke',
netRegex: NetRegexes.ability({ id: '1D6D' }),
condition: function(data, matches) {
// 我希望看到所有的挑釁提示，即便他們不在我的隊伍中，
// 即便我不是坦克。
return true;
},
infoText: (data, matches, output) => {
return output.text!({ player: data.party.member(matches.source) });
},
outputStrings: {
text: {
en: 'Provoke: ${player}',
de: 'Herausforderung: ${player}',
fr: 'Provocation: ${player}',
ja: '挑発: ${player}',
cn: '挑衅: ${player}',
ko: '도발: ${player}',
},
},
},
],
});
當然，您也可以直接刪除整個 condition 函式， 這是因為沒有condition的觸發器在匹配到正則時永遠會執行。
您也可以用同樣的辦法新增您的自定義觸發器。
這是一個示例觸發器，當您中了“Forked Lightning”效果時，會在1秒後顯示“Get out!!!”。
Options.Triggers.push([
{
zoneId: ZoneId.MatchAll,
triggers: [
{
// 這是一個自定義的id，因此不會覆蓋任何現有的觸發器。
id: 'Personal Forked Lightning',
regex: Regexes.gainsEffect({ effect: 'Forked Lightning' }),
condition: (data, matches) => { return matches.target === data.me; },
delaySeconds: 1,
alertText: 'Get out!!!',
},
// 您的其他觸發器……
],
},
// 其他區域的觸發器集合……
]);
我們推薦閱讀 觸發器指南 以瞭解如何撰寫cactbot的觸發器， 當然您也可以直接看 ui/raidboss/data 中現有的觸發器程式碼。
自定義時間軸與 自定義觸發器 差不多。
自定義時間軸的步驟如下：
1) 複製原有的時間軸文字檔案內容至您的使用者資料夾
例如，您可以複製
[ui/raidboss/data/05-shb/ultimate/the_epic_of_alexander.txt](../ui/raidboss/data/05-shb/ultimate/the_epic_of_alexander.txt)
至 `user/the_epic_of_alexander.txt`。
1) 在 user/raidboss.js 中新增程式碼
如同我們新增觸發器一樣，您依舊需要定義 `zoneId`、 `overrideTimelineFile: true`，
以及定義文字檔名稱的`timelineFile` 屬性。
```javascript
Options.Triggers.push({
zoneId: ZoneId.TheEpicOfAlexanderUltimate,
overrideTimelineFile: true,
timelineFile: 'the_epic_of_alexander.txt',
});
```
（假設您已經做完了第一步，並且該文本檔案的名稱為 `user/the_epic_of_alexander.txt` ）
設置 `overrideTimelineFile: true` 是為了告訴cactbot將內置的時間軸完全替換為您添加的檔案。
1) 按您的喜好編輯您自己的時間軸檔案
閱讀 [時間軸指南](TimelineGuide.md) 學習更多關於時間軸的知識。
注意：編輯時間軸檔案有一定的風險， 這是因為部分觸發器依賴於時間軸的特定文字。 例如在絕亞歷山大中，Fluid Swing 與 Propeller Wind 都有對應的時間軸觸發器。 如果這些文字被替換或移除，時間軸觸發器也同樣會失效。
這一文段將討論cactbot的其他方式。 Cactbot中有一些不在使用者介面顯示，也不是觸發器的變量。
每個cactbot模組都有一個名為 Options 的變數，它包含了若干控制選項。 可用的 Options 變數會在每個 ui/<name>/<name>.js 檔案的頂部列出。
例如在 ui/raidboss/raidboss.js 檔案中， 您可以透過 PlayerNicks 選項定義玩家的暱稱。
Options.PlayerNicks = {
// 'Firstname Lastname': 'Nickname',
'Banana Nana', 'Nana',
'The Great\'one', 'Joe', // => 這裡需要一個反斜槓轉義單引號
'Viewing Cutscene': 'Cut',
// 等等
};
警告：使用者資料夾中的檔案會靜默覆蓋cactbot使用者介面的同名選項。 該行為可能會造成一些困惑，因此您應當直接通過使用者介面設置這些變量， 僅當使用者介面不提供設置方法時採用此方式覆蓋預設行為。
您可以在 ACT -> Plugins -> OverlayPlugin.dll 找到位於該視窗的底部的OverlayPlugin日誌視窗，它是一個自動滾動的文字視窗。
當執行錯誤時，錯誤資訊會顯示在此處。
首先，您需要開啟raidboss模組的除錯模式。 開啟cactbot配置視窗，啟用 顯示開發者選項 ，然後重新載入懸浮窗。 然後，勾選raidboss模組下的 啟用除錯模式，再次重載懸浮窗。
當raidboss模組的除錯模式啟用時，OverlayPlugin的日誌視窗中會列印更多資訊。 每次本地的使用者檔案載入時都會輸出類似於這樣的資訊： [10/19/2020 6:18:27 PM] Info: raidbossy: BrowserConsole: local user file: C:\Users\tinipoutini\cactbot\user\raidboss.js
確認您的使用者檔案是否正常載入。
檔名的列印順序就是它們的載入順序。
使用者檔案採用JavaScript編寫，若程式碼語法本身有錯誤，日誌視窗會輸出錯誤，您的使用者檔案也會被跳過而不會被載入。 在檔案載入時檢查OverlayPlugin的錯誤日誌。
此處有一個例子：
[10/19/2020 6:18:27 PM] Info: raidbossy: BrowserConsole: local user file: C:\Users\tinipoutini\cactbot\user\raidboss.js (Source: file:///C:/Users/tinipoutini/cactbot/resources/user_config.ts, Line: 83)
[10/19/2020 6:18:27 PM] Info: raidbossy: BrowserConsole: *** ERROR IN USER FILE *** (Source: file:///C:/Users/tinipoutini/cactbot/resources/user_config.ts, Line: 95)
[10/19/2020 6:18:27 PM] Info: raidbossy: BrowserConsole: SyntaxError: Unexpected token :
at loadUser (file:///C:/Users/tinipoutini/cactbot/resources/user_config.ts:92:28) (Source: file:///C:/Users/tinipoutini/cactbot/resources/user_config.ts, Line: 96)