API UO SetSkillLockState zh tw

UO.SetSkillLockState

ClassicUO / Basic IDE

Home · API A–Z · Каталоги

要求變更技能成長模式。

完整語法

UO.SetSkillLockState(SkillName:Any, skillState:Any) -> Unit

參數

• SkillName — 必要的技能選擇器：客戶端資料中的名稱，例如 "Mining" 或 "Animal Lore"，或 0..Skills.Length−1 的十進位索引，可用數字或字串。名稱忽略大小寫、移除前後空白，並將 _ 換成空格。這不是物品 ID，也不是從 1 開始的索引。數字字串一律表示索引。
• skillState — 必要的模式：0 — 上升、1 — 下降、2 — 鎖定。這是三個代碼，不是 Boolean；true/false 無法描述所有模式。

傳回值

Unit — 無回傳值。不可當成成功/失敗或與 true 比較。後續讀取得到本機模型，不是伺服器確認。

行為

• 有效要求透過 GameActions 傳送一個封包，立即修改本機模式。仍受伺服器規則限制，不保證技能或屬性上升。未知技能、無效索引/模式或沒有角色時忽略要求，不傳送封包。
• 必要的技能選擇器：客戶端資料中的名稱，例如 "Mining" 或 "Animal Lore"，或 0..Skills.Length−1 的十進位索引，可用數字或字串。名稱忽略大小寫、移除前後空白，並將 _ 換成空格。這不是物品 ID，也不是從 1 開始的索引。數字字串一律表示索引。
• ExecuteClientApiCompatibility 選擇分支。Text 讀取技能選擇器，Arg 讀取數字編號與模式。無法轉換的引數可能觸發轉換錯誤。

內部函式：從呼叫到結果

以下為實際的 C# 內部步驟。ApplyMode 是範例中完整定義的輔助函式，不是隱藏的內建命令。

1. ExecuteClientApiCompatibility

ExecuteClientApiCompatibility 選擇分支。Text 讀取技能選擇器，Arg 讀取數字編號與模式。無法轉換的引數可能觸發轉換錯誤。

Unit — 無回傳值。不可當成成功/失敗或與 true 比較。後續讀取得到本機模型，不是伺服器確認。

專案原始碼: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; 函式 ExecuteClientApiCompatibility.

2. Invoke

Invoke 在遊戲執行緒讀取；工作執行緒等待管理器處理請求。取消腳本會中斷等待。不增加額外延遲或網路查詢。

有效要求透過 GameActions 傳送一個封包，立即修改本機模式。仍受伺服器規則限制，不保證技能或屬性上升。未知技能、無效索引/模式或沒有角色時忽略要求，不傳送封包。

專案原始碼: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; 函式 Invoke.

3. FindSkillUnsafe

FindSkillUnsafe 先驗證十進位索引與範圍；否則正規化名稱，以忽略大小寫的完整匹配查找 Skill.Name。未知名稱得到 null，不開啟目標游標。

未知技能或沒有角色時回傳 −1。

專案原始碼: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; 函式 FindSkillUnsafe.

4. SetSkillLockState

有效要求透過 GameActions 傳送一個封包，立即修改本機模式。仍受伺服器規則限制，不保證技能或屬性上升。未知技能、無效索引/模式或沒有角色時忽略要求，不傳送封包。

Unit — 無回傳值。不可當成成功/失敗或與 true 比較。後續讀取得到本機模型，不是伺服器確認。

專案原始碼: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; 函式 SetSkillLockState.

5. ChangeSkillLockStatus

有效要求透過 GameActions 傳送一個封包，立即修改本機模式。仍受伺服器規則限制，不保證技能或屬性上升。未知技能、無效索引/模式或沒有角色時忽略要求，不傳送封包。

Unit — 無回傳值。不可當成成功/失敗或與 true 比較。後續讀取得到本機模型，不是伺服器確認。

專案原始碼: src/ClassicUO.Client/Game/GameActions.cs; 函式 ChangeSkillLockStatus.

有效要求透過 GameActions 傳送一個封包，立即修改本機模式。仍受伺服器規則限制，不保證技能或屬性上升。未知技能、無效索引/模式或沒有角色時忽略要求，不傳送封包。

範例

讀取並顯示

# 讀取並顯示
#
# 要求變更技能成長模式。
#
# Unit — 無回傳值。不可當成成功/失敗或與 true 比較。後續讀取得到本機模型，不是伺服器確認。

SUB Main()
    # 範例明確設定 selector，寫入時也設定 mode。第一行以名稱選技能，或以編號選屬性。Print 僅顯示結果。

    VAR selector = 'Mining'
    VAR mode = 2
    UO.SetSkillLockState(selector, mode)
    UO.Print(CStr(UO.GetSkillLockState(selector)))
END SUB

參數與執行說明:

• 範例明確設定 selector，寫入時也設定 mode。第一行以名稱選技能，或以編號選屬性。Print 僅顯示結果。

用於條件或比較

# 用於條件或比較
#
# 要求變更技能成長模式。
#
# Unit — 無回傳值。不可當成成功/失敗或與 true 比較。後續讀取得到本機模型，不是伺服器確認。

SUB Main()
    # 門檻 95.1 與模式 0/1/2 是範例設定。變更模式前檢查 −1。寫入後讀取僅查看本機副本，不等待伺服器確認。

    VAR selector = 'Mining'
    VAR before = UO.GetSkillLockState(selector)
    IF before >= 0 AND before <= 2 THEN
        UO.SetSkillLockState(selector, 0)
        UO.Print(CStr(UO.GetSkillLockState(selector)))
    END IF
END SUB

參數與執行說明:

• 門檻 95.1 與模式 0/1/2 是範例設定。變更模式前檢查 −1。寫入後讀取僅查看本機副本，不等待伺服器確認。

完整輔助函式

# 完整輔助函式
#
# 要求變更技能成長模式。
#
# Unit — 無回傳值。不可當成成功/失敗或與 true 比較。後續讀取得到本機模型，不是伺服器確認。

SUB Main()
    # Main 後列出完整輔助函式。selector 選擇技能/屬性，mode 指定寫入模式。ReadValue/ReadMode 原樣回傳數字；ApplyMode
    # 驗證引數並執行動作，無回傳值。WAIT(1000) 分隔兩次讀取快照。

    ApplyMode('Mining', 2)
END SUB

SUB ApplyMode(selector, mode)
    IF mode < 0 OR mode > 2 THEN
        RETURN
    END IF
    IF UO.GetSkillLockState(selector) < 0 THEN
        RETURN
    END IF
    UO.SetSkillLockState(selector, mode)
END SUB

參數與執行說明:

• Main 後列出完整輔助函式。selector 選擇技能/屬性，mode 指定寫入模式。ReadValue/ReadMode 原樣回傳數字；ApplyMode 驗證引數並執行動作，無回傳值。WAIT(1000) 分隔兩次讀取快照。

Skills / Навыки

Skills / Навыки