ClassicUO • Runtime API

Lee el serial numérico de un contenedor del intercambio.

UO.GetTradeContainer(TradeNum:Any, Num:Any) -> Any

• TradeNum — Número entero actual: 1..TradeCount(). Cero/negativos inválidos. No es serial.
• Num — 1 contenedor propio, 2 del compañero; otros valores devuelven 0.

Integer: los 32 bits del serial del contenedor; 0 sin ventana o con Num inválido. No es graphic/type. Se conserva el bit alto: comprobar <> 0, no > 0 ni = TRUE.

• GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade empiezan en 1; TradeContainer/TradeOpponent/TradeName y todas las formas TradeCheck en 0. Este cliente conserva esas convenciones; las referencias de distintos motores difieren.
• Lee en el hilo del juego las ventanas vivas del World actual, excluyendo las cerradas. Leer no envía paquetes ni espera respuestas. Abrir, cerrar o traer al frente cambia el orden UI; el índice no es un ID permanente.
• ConfirmTrade y escribir su TradeCheck envían solo si cambia la aceptación. El servidor controla la casilla ajena. CancelTrade envía una vez. 1/TRUE indica estado/procesamiento local, no transferencia completa. Nombres y casillas no prueban que los objetos sigan iguales.

Se explica la ruta C# y después se muestran ejemplos Basic ejecutables. Los scripts no reimplementan el protocolo de red.

El registro selecciona según cantidad de argumentos; NumberConversions convierte números. TradeCheck de dos argumentos valida 1/2 y los transforma en 0/1 del bridge. ToHex formatea serials heredados.

Integer: los 32 bits del serial del contenedor; 0 sin ventana o con Num inválido. No es graphic/type. Se conserva el bit alto: comprobar <> 0, no > 0 ni = TRUE.

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

Invoke lleva lectura/escritura al hilo del juego con cancelación del script; lee ID1/ID2, LocalSerial, OpponentName o casillas del TradingGump seleccionado.

Lee el serial numérico de un contenedor del intercambio.

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

FindNumberedTrade comprueba number>0 antes de restar 1; FindTrade rechaza índices negativos y enumera solo TradingGump abiertos de este World.

GetTradeContainer/GetTradeOpponent/GetTradeOpponentName/ConfirmTrade/CancelTrade empiezan en 1; TradeContainer/TradeOpponent/TradeName y todas las formas TradeCheck en 0. Este cliente conserva esas convenciones; las referencias de distintos motores difieren.

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

La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del personaje, no una validación de precio/contenido.

# Lectura o acción directa
#
# Lee el serial numérico de un contenedor del intercambio.
#
# Integer: los 32 bits del serial del contenedor; 0 sin ventana o con Num inválido. No es
# graphic/type. Se conserva el bit alto: comprobar <> 0, no > 0 ni = TRUE.

SUB Main()
    # Una llamada guardada en value/result. 0 es el primer índice, 1 el primer número (ver
    # sintaxis). HEX muestra serials numéricos; CStr números o texto.

    VAR value = UO.GetTradeContainer(1, 1)
    UO.Print(HEX(value))
END SUB

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

• Una llamada guardada en value/result. 0 es el primer índice, 1 el primer número (ver sintaxis). HEX muestra serials numéricos; CStr números o texto.

# Otro escenario y parámetros
#
# Lee el serial numérico de un contenedor del intercambio.
#
# Integer: los 32 bits del serial del contenedor; 0 sin ventana o con Num inválido. No es
# graphic/type. Se conserva el bit alto: comprobar <> 0, no > 0 ni = TRUE.

SUB Main()
    # total guarda la cantidad de ventanas; index es el índice/número actual. Enumerar no confirma
    # nada. GetTradeContainer lee los contenedores propio (1) y ajeno (2) de la ventana 1.

    VAR ours = UO.GetTradeContainer(1, 1)
    VAR theirs = UO.GetTradeContainer(1, 2)
    UO.Print(HEX(ours) + " / " + HEX(theirs))
END SUB

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

• total guarda la cantidad de ventanas; index es el índice/número actual. Enumerar no confirma nada. GetTradeContainer lee los contenedores propio (1) y ajeno (2) de la ventana 1.

# Función auxiliar completa
#
# Lee el serial numérico de un contenedor del intercambio.
#
# Integer: los 32 bits del serial del contenedor; 0 sin ventana o con Num inválido. No es
# graphic/type. Se conserva el bit alto: comprobar <> 0, no > 0 ni = TRUE.

SUB Main()
    # La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las
    # llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del
    # personaje, no una validación de precio/contenido.

    VAR value = ReadTradeValue(1)
    UO.Print(HEX(value))
END SUB

FUNCTION ReadTradeValue(index)
    VAR total = UO.TradeCount()
    IF index < 1 OR index >= total + 1 THEN
        RETURN 0
    END IF
    RETURN UO.GetTradeContainer(index, 1)
END FUNCTION

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

• La función está completa y Main la llama. Comprobar límites/ID reduce errores pero las llamadas no son atómicas: puede cambiar la ventana. expectedPartner es el serial guardado del personaje, no una validación de precio/contenido.

en · ru · uk · fr · de · it · es · zh-tw · ja · ko

Basic