武器技能

為原版武器加入各自的戰鬥技能，增加玩家在不同武器與戰鬥方式之間的選擇。

功能介紹安裝資訊

附魔 ID: cosmocombat:sword_wave
最高等級: V
武器技能: 10 種

DEVELOPMENT BACKGROUND

增加武器的玩法與選擇

原版武器各有基本定位，但玩家裝備逐漸成形後，常用武器與戰鬥方式容易固定。

這個插件希望在保留原版武器、附魔台與鐵砧系統的前提下，讓劍、斧頭、重錘、弓、弩等武器擁有不同技能。玩家可依攻擊距離、範圍、位移、擊退或恢復效果選擇武器，而不是只比較基礎傷害。

OVERVIEW

真正註冊到原版系統的附魔

劍氣不是透過 Lore 模擬的假附魔，而是註冊到附魔登錄表的原版附魔。

創造模式附魔書清單、附魔台、鐵砧、村民交易與戰利品系統都能直接辨識。服主可決定哪些武器加入劍氣系統，停用後技能、附魔台、鐵砧與指令都會拒絕該武器。

原版附魔登錄十種武器技能五階強度

WEAPON SKILLS

十種武器技能

近戰武器以右鍵發動；弓與弩維持原版拉弓、裝填與射擊方式，只會強化冷卻完成後射出的那一發。

鎬、鏟子與鋤頭預設關閉，其餘武器預設啟用。變更武器支援清單後需重新啟動伺服器。

ENCHANT LEVELS

五階成長

等級	傷害	範圍	冷卻	破壞方塊
I	×0.70	×0.55	×1.80	—
II	×0.80	×0.70	×1.50	—
III	×0.90	×0.85	×1.25	—
IV	×1.00	×1.00	×1.00	—
V	×1.00	×1.00	×1.00	✓

config.yml 的 skills 區塊以第四階為基準。只有 damage 與 range 會套用等級倍率；speed、angle、knockback 等參數維持原值。

LEVEL V

第五階方塊破壞

第五階的傷害、範圍與冷卻和第四階相同，額外依各武器的硬度上限破壞技能路徑上的軟方塊。

斧頭 / 重錘2.0

鎬 / 弩1.5

鏟子0.6

三叉戟0.5

劍 / 矛 / 弓0.3

鋤頭0.2

ACQUISITION

附魔取得方式

附魔台	已加入原版附魔台標籤，啟用中的武器有機率取得劍氣。
附魔書	創造模式附魔書清單可直接找到，並可透過鐵砧合成到武器。
村民與戰利品	劍氣屬於一般非寶藏附魔，會依原版規則出現。
管理指令	使用 /cc enchant 或 /cc book 直接取得。

CONFIGURATION

設定與管理指令

可調整發動條件、耐久消耗、冷卻顯示，以及每個技能的傷害、範圍、冷卻與破壞限制。

config.yml

大部分技能參數可在修改後執行 /cc reload 即時生效。

trigger:
  require-sneak: false
  cancel-vanilla-use: true
  durability-cost: 1

skills:
  sword-wave:
    enabled: true
    damage: 6.0
    range: 14.0
    cooldown-seconds: 4.0

/cc enchant [等級]替主手武器附上劍氣 /cc book [等級]取得劍氣附魔書 /cc remove移除主手武器的劍氣 /cc info查看技能數值 /cc reload重新載入設定檔

DOWNLOAD & INSTALLATION

下載與安裝

下載對應版本的 JAR 檔後，放入伺服器 plugins 資料夾並完整重新啟動。

插件版本	支援環境	檔案
v1.0.0	Paper 26.1.2 / 26.2 · Java 21+	`CosmoCombat.jar`

01
放入插件
將 CosmoCombat.jar 複製到伺服器的 plugins 資料夾。
02
重新啟動
完整重啟伺服器，讓劍氣附魔在登錄表凍結前完成註冊。

Paper 專用

本插件使用 Paper 的 Registry API 與 PluginBootstrap，Spigot 不支援。