API UO SetSkillLockState es

UO.SetSkillLockState

ClassicUO / Basic IDE

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

Solicita cambiar el modo de avance de la habilidad.

Sintaxis exacta

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

Parámetros

• SkillName — Habilidad obligatoria: nombre de los datos del cliente, como "Mining" o "Animal Lore", o índice decimal 0..Skills.Length−1 como número o cadena. Ignora mayúsculas, quita espacios exteriores y cambia _ por un espacio. No es un ID de objeto ni un índice desde 1. Las cadenas numéricas siempre indican un índice.
• skillState — Modo obligatorio: 0 — aumentar, 1 — disminuir, 2 — bloquear. Son tres códigos, no Boolean; true/false no describen todos los modos.

Devuelve

Unit — no devuelve valor. No interprete el resultado como éxito/error ni lo compare con true. Una lectura posterior muestra el modelo local, no una confirmación del servidor.

Comportamiento

• Una solicitud válida envía un paquete mediante GameActions y cambia de inmediato el modo local. Se aplican las reglas del servidor; el aumento no está garantizado. Habilidades desconocidas, índices/modos inválidos y personaje ausente se ignoran sin paquete.
• Habilidad obligatoria: nombre de los datos del cliente, como "Mining" o "Animal Lore", o índice decimal 0..Skills.Length−1 como número o cadena. Ignora mayúsculas, quita espacios exteriores y cambia _ por un espacio. No es un ID de objeto ni un índice desde 1. Las cadenas numéricas siempre indican un índice.
• ExecuteClientApiCompatibility elige la rama. Text lee el selector de habilidad; Arg lee números y modos. Un argumento no convertible puede producir un error de conversión.

Funciones internas: de la llamada al resultado

Estas son las etapas internas reales de C#. ApplyMode es una función auxiliar completamente definida en el ejemplo, no un comando integrado oculto.

1. ExecuteClientApiCompatibility

ExecuteClientApiCompatibility elige la rama. Text lee el selector de habilidad; Arg lee números y modos. Un argumento no convertible puede producir un error de conversión.

Unit — no devuelve valor. No interprete el resultado como éxito/error ni lo compare con true. Una lectura posterior muestra el modelo local, no una confirmación del servidor.

Código del proyecto: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; función ExecuteClientApiCompatibility.

2. Invoke

Invoke lee en el hilo del juego; un hilo de trabajo espera el procesamiento del gestor. Cancelar el script interrumpe esa espera. No añade demoras ni consultas de red.

Una solicitud válida envía un paquete mediante GameActions y cambia de inmediato el modo local. Se aplican las reglas del servidor; el aumento no está garantizado. Habilidades desconocidas, índices/modos inválidos y personaje ausente se ignoran sin paquete.

Código del proyecto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; función Invoke.

3. FindSkillUnsafe

FindSkillUnsafe comprueba primero el índice decimal y sus límites; si no es numérico, normaliza el nombre y compara exactamente Skill.Name sin distinguir mayúsculas. Un nombre desconocido produce null; no abre objetivo.

Una habilidad desconocida o un personaje ausente devuelve −1.

Código del proyecto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; función FindSkillUnsafe.

4. SetSkillLockState

Una solicitud válida envía un paquete mediante GameActions y cambia de inmediato el modo local. Se aplican las reglas del servidor; el aumento no está garantizado. Habilidades desconocidas, índices/modos inválidos y personaje ausente se ignoran sin paquete.

Unit — no devuelve valor. No interprete el resultado como éxito/error ni lo compare con true. Una lectura posterior muestra el modelo local, no una confirmación del servidor.

Código del proyecto: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; función SetSkillLockState.

5. ChangeSkillLockStatus

Una solicitud válida envía un paquete mediante GameActions y cambia de inmediato el modo local. Se aplican las reglas del servidor; el aumento no está garantizado. Habilidades desconocidas, índices/modos inválidos y personaje ausente se ignoran sin paquete.

Unit — no devuelve valor. No interprete el resultado como éxito/error ni lo compare con true. Una lectura posterior muestra el modelo local, no una confirmación del servidor.

Código del proyecto: src/ClassicUO.Client/Game/GameActions.cs; función ChangeSkillLockStatus.

Una solicitud válida envía un paquete mediante GameActions y cambia de inmediato el modo local. Se aplican las reglas del servidor; el aumento no está garantizado. Habilidades desconocidas, índices/modos inválidos y personaje ausente se ignoran sin paquete.

Ejemplos

Leer y mostrar

# Leer y mostrar
#
# Solicita cambiar el modo de avance de la habilidad.
#
# Unit — no devuelve valor. No interprete el resultado como éxito/error ni lo compare con true.
# Una lectura posterior muestra el modelo local, no una confirmación del servidor.

SUB Main()
    # El ejemplo fija selector y, para escribir, mode. La primera línea elige la habilidad por
    # nombre o el atributo por número. Print solo muestra el resultado.

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

Explicación de los parámetros y la ejecución:

• El ejemplo fija selector y, para escribir, mode. La primera línea elige la habilidad por nombre o el atributo por número. Print solo muestra el resultado.

Usar en una condición o comparación

# Usar en una condición o comparación
#
# Solicita cambiar el modo de avance de la habilidad.
#
# Unit — no devuelve valor. No interprete el resultado como éxito/error ni lo compare con true.
# Una lectura posterior muestra el modelo local, no una confirmación del servidor.

SUB Main()
    # El umbral 95.1 y los modos 0/1/2 son ajustes de ejemplo. Compruebe −1 antes de cambiar el
    # modo. Leer después de escribir muestra la copia local sin esperar al servidor.

    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

Explicación de los parámetros y la ejecución:

• El umbral 95.1 y los modos 0/1/2 son ajustes de ejemplo. Compruebe −1 antes de cambiar el modo. Leer después de escribir muestra la copia local sin esperar al servidor.

Función auxiliar completa

# Función auxiliar completa
#
# Solicita cambiar el modo de avance de la habilidad.
#
# Unit — no devuelve valor. No interprete el resultado como éxito/error ni lo compare con true.
# Una lectura posterior muestra el modelo local, no una confirmación del servidor.

SUB Main()
    # La función completa sigue a Main. selector elige habilidad/atributo; mode indica el modo de
    # escritura. ReadValue/ReadMode devuelven el número original; ApplyMode comprueba argumentos,
    # actúa y no devuelve valor. WAIT(1000) separa dos lecturas.

    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

Explicación de los parámetros y la ejecución:

• La función completa sigue a Main. selector elige habilidad/atributo; mode indica el modo de escritura. ReadValue/ReadMode devuelven el número original; ApplyMode comprueba argumentos, actúa y no devuelve valor. WAIT(1000) separa dos lecturas.

Skills / Навыки

Skills / Навыки