繁體中文 | English
將邊獄公司（Limbus Company）的 E.G.O 武器與 E.G.O 飾品一併帶進 Minecraft 的單一 Paper 插件。
- 版本：1.4.1
- Minecraft 版本：1.21.4
- 平台：Paper
- Java：21
- 軟相依：ProtocolLib（可選，攔截莊嚴哀悼周圍他人聽到的原版弓箭聲）
LimbusEGO-1.4.1.jar 是由兩個舊插件合併而成的單一插件：
- Limbus E.G.O Weapons v3.2.0 → 12 屬性體系、理智值（SAN）系統、8 種 E.G.O 武器
- Limbus E.G.O Gifts v2.5.0 → 80 件 E.G.O 飾品＋4 種殘影升級材料、抽取箱／紡錘抽獎箱／購買商店箱
主類改名為 me.yisang.limbusego.LimbusEGO；原飾品插件主類降級為內部模組 GiftsModule，由主插件持有並委派生命週期。兩側原本的 PDC（物品 / 玩家資料）namespace 全數保留（見下方「安裝與資料遷移」），舊物品、舊玩家升級進度無痛沿用。
Phase 2 已完成（v1.1.0）：80 件飾品效果全面重構，攻擊／受擊／擊殺／被動等鉤子直接串接武器側 12 屬性體系與理智值（SAN），效果強度隨飾品升級等級（殘影）放大。
Phase 3 已完成（v1.3.0）：兩個資源包合併為單一 Limbus-E.G.O-ResourcePack，插件改用單一 PACK_URL / PACK_HASH。
本專案取代下方兩個舊 repo，屬於它們的延續與整合。
全部指令收斂進單一指令樹 /limbusego（別名 lego），僅 /accessories 保留為玩家日常捷徑。
| 指令 | 說明 | 權限 |
|---|---|---|
/limbusego weapon give <玩家> <id> [數量] |
給予玩家武器（主控台可執行） | limbus.admin |
/limbusego weapon catalog |
開啟玩家武器圖鑑 | 所有人 |
/limbusego weapon admin |
開啟武器管理員 GUI | limbus.admin / OP |
/limbusego weapon <id> |
直接給自己一把指定武器 | limbus.admin / OP |
/limbusego gift menu |
開啟飾品選單（與 /accessories 相同；給物品請用 /limbusego gift give menu） |
所有人 |
/limbusego gift give <id> [數量] |
給自己一件指定飾品 | limbus.admin / OP |
/limbusego gift give <玩家> <id|menu|thread|lunacy> [數量] |
給指定玩家飾品／道具（相容舊 /getgift give 語法） |
limbus.admin |
/limbusego gift category |
開啟飾品圖鑑（依等級／依體系兩種排序模式） | 所有人 |
/limbusego gift admin |
開啟飾品管理員 GUI（點擊快速取得） | limbus.admin / OP |
/limbusego chest gacha <set|remove> |
設定／移除所看之箱子為飾品提取箱 | limbus.admin / OP |
/limbusego chest thread <set <消耗> [thread|lunacy] <名稱...>|remove> |
設定／移除紡錘抽獎箱 | limbus.admin / OP |
/limbusego chest shop <set <消耗> [thread|lunacy] <名稱...>|remove> |
設定／移除購買商店箱 | limbus.admin / OP |
/limbusego reload |
重新載入設定與兩體系語言檔 | limbus.admin |
/limbusego language [代碼] |
顯示目前語言 / 切換語言（同時套用於武器與飾品兩體系） | limbus.admin |
/accessories |
開啟飾品欄位 GUI（/limbusego gift menu 的捷徑，效果為開啟選單而非給物品） |
所有人 |
全層 Tab 補完皆已支援（root → weapon give → 線上玩家 → 武器 id；gift give → 飾品 id／玩家名；chest thread set → 貨幣種類；language → 可用語言代碼……）。
| 舊指令 | 新指令 |
|---|---|
/getego give <玩家> <id> [數量] |
/limbusego weapon give <玩家> <id> [數量] |
/getego catalog / admin / <id> |
/limbusego weapon catalog / admin / <id> |
/accessories |
/limbusego gift menu（/accessories 捷徑保留） |
/getgift <id> [數量] |
/limbusego gift give <id> [數量] |
/egogift category |
/limbusego gift category |
/gachachest <set|remove> |
/limbusego chest gacha <set|remove> |
/threadchest <set …|remove> |
/limbusego chest thread <set …|remove> |
/shopchest <set …|remove> |
/limbusego chest shop <set …|remove> |
/getego reload ＋ /egogift reload |
/limbusego reload（同時重載兩體系語言） |
/getego language <代碼> |
/limbusego language <代碼> |
每個實體身上追蹤 (potency, count) 雙軸狀態，potency 是威力、count 是剩餘觸發次數。全 in-memory 追蹤，mob unload / 死亡自動清除，不寫入 NBT。
| 屬性 | 效果 |
|---|---|
| 流血 BLEED | 帶血者攻擊時消耗 1 count → 對自己造 potency × 0.5 真傷 |
| 燒傷 BURN | 每 2 秒（40 tick）消耗 1 count → potency 真傷（DoT） |
| 易損 FRAGILE | 承傷乘 (1 + potency × 15%) 乘區 |
| 強壯 POWER | 出手乘 (1 + potency × 10%) 乘區；每次出手 −1 count |
| 沉淪 SINKING | 受擊消耗 1 count → potency 真傷 + 玩家 SAN −1（SAN 觸底轉憂鬱 ×1.5）；potency 越高移速越低（−2%/potency，上限 −50%） |
| 破裂 RUPTURE | 受擊消耗 1 count → potency × 2 真傷（速殺高血量目標用） |
| 震顫 TREMOR | 累積 potency；受擊且 potency ≥ 5 → 爆發：消耗全部 potency 造 potency × 3 真傷 + 派生燒傷 5p/3c |
| 守護 PROTECTION | 承傷乘 (1 − potency × 5%)，在易損之前套用 |
| 迅捷 HASTE | Speed potion wrapper：amplifier = potency−1，duration = count 秒 |
| 束縛 BIND | Slowness potion wrapper，同上 |
| 呼吸法 POISE | 出手 min(60%, potency × 5%) 機率爆擊 ×1.75；每次出手 −1 count |
| 充能 CHARGE | 出手乘 (1 + potency × 3%)；每次出手 −1 count |
理智值 SAN：每位玩家一條 BossBar 常態顯示（範圍 −45 ~ +45），命中／受擊／沉淪增減 SAN，脫戰後負值自動回升、進食可回 SAN，並微調攻擊力與移速；觸底（−30 以下恐慌、−45 理智觸底）會疊加負面狀態效果。
- 移除舊插件：從
plugins/移出LimbusEGOWeapons-*.jar與LimbusEGOGift-*.jar（建議備份而非直接刪除）。 - 放入新插件：把
LimbusEGO-1.4.1.jar放進plugins/。 - 資料遷移：把舊
plugins/LimbusEGOGift/資料夾內的gacha_chests.yml、thread_chests.yml、shop_chests.yml、config.yml複製到新的plugins/LimbusEGO/（若舊plugins/LimbusEGOWeapons/config.yml有自訂語言設定，注意合併language欄位，避免被覆蓋）。 - 啟動伺服器——舊物品與玩家升級資料自動相容：武器側 PDC 固定落在
limbusegoweapons:namespace、飾品側固定落在limbusegogift:namespace（與舊兩插件產生的資料完全一致），玩家背包裡的舊武器／舊飾品、飾品欄位裡已升級的等級都無需任何轉檔即可繼續使用。
Phase 3（v1.3.0 起）改用單一合併資源包，插件啟動時自動下載並以 SHA-1 校驗到 plugins/LimbusEGO/resourcepack.zip，交由外部 ResourcePackManager 合併分發（本插件不主動推送、不踢人）；舊的兩個分包檔會在啟動時自動清除。
| 資源包 | 用途 | 目前版本 | data folder 檔名 |
|---|---|---|---|
| Limbus-E.G.O-ResourcePack | 武器＋飾品外觀與音效 | v1.0 | resourcepack.zip |
v1.0 = 舊武器包 v.2.17 ＋ 舊飾品包 v2.6 的內容完整合併，無任何變更。兩個舊資源包 repo 已由上述新 repo 取代。
- 升級改綁定飾品物品：升級等級寫入飾品 ItemStack PDC（
item_upgrade_level），拖出選單、轉交他人、存箱子等級都跟著物品走；背包中同 ID 未升級飾品不繼承等級 - Lore 隨升級變動：等級 > 0 的飾品描述末尾顯示「▲ 升級 Lv.N (效果 ×M)」（新 lang 鍵
msg.upgrade_lore_mult，舊語言檔自動回退 jar 內建值） - 裝備格等級持久化：玩家 PDC 新增
slot_<i>_level，關選單時從物品讀等級存入、開選單時烙回重造物品；效果倍率改讀裝備格等級（同 ID 裝多格取最大），40+ 飾品效果檔零改動 - 舊資料一次性遷移：登入時將舊玩家 PDC
upgrade_<id>轉寫到目前裝備格並清除舊鍵；已升級但未裝備的 ID 等級作廢
- 狀態傷害改走原版傷害管線：護甲、附魔、抗性藥水、領地/PvP 保護全部自動生效；DoT 擊殺正確歸屬施術者。修復禁 PvP 領地內可疊 DoT 掛人的漏洞（傷害監聽加
ignoreCancelled與零傷閘） - 層數/級數上限：potency/count 疊加各設上限（config
status-caps，預設 10/20）；守護（PROTECTION）與易損（FRAGILE）改為受擊消耗層數，減傷數學上限 40%，杜絕掛機無敵 - 20HP 基準重平衡：狀態係數以「未穿甲玩家中等致命度」重排（燒傷/流血/沉淪 ×0.5、破裂 ×0.75、震顫爆發 ×1.5、強壯/易損 5%、守護 4%、充能 3%、呼吸法爆率 5%/上限 50%/爆傷 ×1.5）
- 狀態施加冷卻：同效果對同目標的重複施加有最短間隔（config
status-cooldowns，預設 1000ms） - PlaceholderAPI 支援：
%limbusego_san%、%limbusego_effects%、%limbusego_<效果>_potency|count%（軟依賴，未裝不影響） - 新增
/limbusego status apply|get管理指令：控制台/管理員施加與查詢狀態，支援目標選擇器，含 Tab 補完 - 修復：無來源 DoT 使用會穿甲的
generic傷害型別，改用MOB_ATTACK讓護甲正確生效（拋棄式伺服器實測驗證，與原版護甲公式吻合） - 文件：新增狀態重平衡設計文件與罪孽屬性抗性系統企劃書（
docs/plans/）
- 武器（v.2.17）與飾品（v2.6）兩資源包合併為單一 Limbus-E.G.O-ResourcePack v1.0（內容不變；
assets/minecraft/atlases兩包原本即相同） - 插件改用單一
PACK_URL/PACK_HASH，下載到plugins/LimbusEGO/resourcepack.zip；啟動時自動清除舊的resourcepack-weapons.zip/resourcepack-gifts.zip
- 圖鑑切分頁／切排序模式改為原地重繪：不再整個視窗關閉重開，消除切換時的卡頓與閃爍
- 新增
/limbusego gift admin正式子指令開啟飾品管理 GUI（原本只能用舊相容路徑gift give admin，usage 與 Tab 補完都找不到）；Tab 補完僅對管理員顯示
- 修復：伺服器 data folder 的舊語言檔缺少新版鍵時，GUI 與 lore 會顯示原始鍵名（如
gui.sort_mode、gui.tier_line）——兩側 LangManager 加入「內建 jar 資源」最終回退，插件更新後無需手動補語言檔 - 新增：死亡復活後理智值（SAN）歸零，命中／受擊計數與戰鬥計時一併重置
- 飾品圖鑑新增排序模式切換按鈕（左下角）：依等級（Tier I–IV 分頁，原有模式）／依體系（九大體系分頁：燒傷、流血、沉淪、破裂、震顫、呼吸法、輔助、便利、原創），體系內再按等級排序
- 每件飾品 lore 首行新增等級標示（等級代表色＋羅馬數字）
- 所有等級顯示統一改為羅馬數字（I / II / III / IV）
80 件飾品效果依重構設計表全面改寫，按屬性分九組完成，全面串接屬性體系與 SAN：
- 🔥 燒傷組（8 件）：施加／疊加／引爆燒傷，含真傷引爆與燒傷目標增傷
- 🩸 流血組（6 件）：施加流血、流血目標增益（呼吸法／吸血／回血轉化）
- 🌊 沉淪組（10 件）：施加沉淪與 SAN 攻防（扣目標 SAN、自身回 SAN、抑鬱增傷）
- 💥 破裂組（11 件，含束縛掛靠）：施加破裂、破裂目標增傷、擊殺擴散
- 🔨 震顫組（6 件）：施加震顫、震顫閾值增傷、死亡反制
- 🎯 呼吸法組（7 件）：攻擊累積呼吸法、閾值轉化強壯／SAN
- 💪 輔助組（15 件）：強壯／守護／迅捷／充能／脆弱等自增益與反制
- 🕊 便利組（12 件）：免死、處決、脫戰回血、磁吸、掉落翻倍等體驗向重製
- 🌸 原創組（5 件）：原創飾品補完接入（保留原特色被動）
通用規則：增傷封頂 +30%、單次施加 potency 封頂 p3、升級倍率（1.0/1.25/1.5/2.0）依各飾品標注作用於威力／機率／數值／冷卻；全部 84 條效果文案中英同步。
/limbusego gift give（缺參數）與/limbusego chest gacha|thread|shop（缺set/remove）不再靜默無回應，改回覆用法提示gift give的「用法／找不到玩家」訊息改走語言檔，隨/limbusego language切換雙語- 移除合併殘留死碼：
GiftsModule中已無指令對應的舊/egogift、/gachachest等 Tab 補完與 reload/language 分支（功能已由/limbusego reload、/limbusego language統一承接），並清除無主語言鍵 config.yml註解與缺語言檔警告訊息的路徑修正
- Weapons v3.2.0 + Gifts v2.5.0 合併為單一插件，行為不變；統一指令樹
/limbusego
本專案（Limbus-E.G.O）取代並整合以下兩個舊插件 repo，舊 repo 不再更新：
- 舊武器插件：https://github.com/Crossing-Dead-Development/Limbus-E.G.O-Weapons
- 舊飾品插件：https://github.com/Crossing-Dead-Development/Limbus-E.G.O-Gifts
兩個舊資源包 repo 也已由 Limbus-E.G.O-ResourcePack 取代（Phase 3），不再更新：
- 舊武器資源包：https://github.com/Crossing-Dead-Development/Limbus-E.G.O-weapon-plugin-ResourcePack
- 舊飾品資源包：https://github.com/Crossing-Dead-Development/Limbus_E.G.O_Gifts_plugin_ResourcePack
角色、飾品名稱、原始設定等版權屬 Project Moon / Limbus Company 所有；本專案為非商業性同人插件。