UO.GetScriptsList

ClassicUO • Runtime API

현재 숫자 스크립트 인덱스를 반환합니다.

정확한 구문

UO.GetScriptsList() -> Array

매개변수

매개변수가 없습니다.

반환값

Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

동작

• 실행 중 및 일시 정지된 실행을 포함하며, 끝났거나 취소가 요청된 실행은 제외합니다. 호출 스크립트는 보통 자신도 셉니다. 로드만 한 IDE 탭은 실행이 아닙니다.
• 인덱스는 시작 순서에 따른 현재 위치입니다. 시작/중지로 위치가 바뀔 수 있습니다. 별도 호출은 하나의 원자적 스냅샷이 아니므로 나중에 제어하기 전에 목록을 다시 읽으세요.
• Basic IDE를 닫아도 활성 실행은 사라지지 않습니다. 이 명령들은 다른 클라이언트나 Windows 프로세스가 아닌 이 클라이언트를 조회합니다.
• GetScriptsList는 인덱스, GetScriptsCount는 개수, GetScriptState는 세 상태 코드를 반환합니다. 서로 바꾸어 쓰거나 모든 0이 아닌 값을 true로 해석하지 마세요.
• 인수가 없습니다. 각 숫자를 이름, 경로 또는 상태 조회 함수에 전달합니다. 반환 배열은 별도 스냅샷이며, 수정해도 스크립트를 제어하지 않습니다.

내부 함수: 호출부터 결과까지

아래는 클라이언트의 실제 메서드입니다. Basic 예제에는 완전한 보조 함수가 있으며 내부 C# 메서드 이름은 추가 스크립트 명령이 아닙니다.

1. ExecuteStealthCompatibility

Runtime은 등록된 UO 호출을 실행하고 브리지 결과를 Integer, String 또는 Array로 감쌉니다.

Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

프로젝트 소스: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; 함수 ExecuteStealthCompatibility.

2. GetScriptsList

브리지는 이 클라이언트의 실행 관리자에 위임합니다.

인수가 없습니다. 각 숫자를 이름, 경로 또는 상태 조회 함수에 전달합니다. 반환 배열은 별도 스냅샷이며, 수정해도 스크립트를 제어하지 않습니다.

프로젝트 소스: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; 함수 GetScriptsList.

3. GetScriptsList

Enumerable.Range(0, GetScriptsCount()).ToArray()

인덱스는 시작 순서에 따른 현재 위치입니다. 시작/중지로 위치가 바뀔 수 있습니다. 별도 호출은 하나의 원자적 스냅샷이 아니므로 나중에 제어하기 전에 목록을 다시 읽으세요.

프로젝트 소스: src/ClassicUO.Client/Game/Managers/YokoInjectionManager.cs; 함수 GetScriptsList.

Basic IDE를 닫아도 활성 실행은 사라지지 않습니다. 이 명령들은 다른 클라이언트나 Windows 프로세스가 아닌 이 클라이언트를 조회합니다.

예제

첫 호출과 결과

# 첫 호출과 결과
#
# 현재 숫자 스크립트 인덱스를 반환합니다.
#
# Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

SUB Main()
    # Sub Main을 실행합니다. 전달한 0은 인덱스이며 빈 괄호는 인수가 없다는 뜻입니다. Print 문자열은 예제 메시지일 뿐입니다.
    # 인수가 없습니다. 각 숫자를 이름, 경로 또는 상태 조회 함수에 전달합니다. 반환 배열은 별도 스냅샷이며, 수정해도 스크립트를 제어하지 않습니다.
    # Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

    Dim indices=UO.GetScriptsList()
    For Each index In indices
        UO.Print(CStr(index) & ": " & UO.GetScriptName(index))
    Next
END SUB

매개변수 및 실행 설명:

• Sub Main을 실행합니다. 전달한 0은 인덱스이며 빈 괄호는 인수가 없다는 뜻입니다. Print 문자열은 예제 메시지일 뿐입니다.
• 인수가 없습니다. 각 숫자를 이름, 경로 또는 상태 조회 함수에 전달합니다. 반환 배열은 별도 스냅샷이며, 수정해도 스크립트를 제어하지 않습니다.
• Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

반복문 또는 조건에서 사용

# 반복문 또는 조건에서 사용
#
# 현재 숫자 스크립트 인덱스를 반환합니다.
#
# Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

SUB Main()
    # 여러 명령을 조합한 독립적인 예제입니다. 배열 인덱스는 0부터 시작하므로 접근 전에 길이를 확인하세요. Wait(250)이 있으면 250밀리초 기다립니다.
    # 인수가 없습니다. 각 숫자를 이름, 경로 또는 상태 조회 함수에 전달합니다. 반환 배열은 별도 스냅샷이며, 수정해도 스크립트를 제어하지 않습니다.
    # Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

    Dim indices=UO.GetScriptsList()
    If GetArrayLength(indices)>0 Then
        Dim firstIndex=indices[0]
        UO.Print(UO.GetScriptPath(firstIndex))
    End If
END SUB

매개변수 및 실행 설명:

• 여러 명령을 조합한 독립적인 예제입니다. 배열 인덱스는 0부터 시작하므로 접근 전에 길이를 확인하세요. Wait(250)이 있으면 250밀리초 기다립니다.
• 인수가 없습니다. 각 숫자를 이름, 경로 또는 상태 조회 함수에 전달합니다. 반환 배열은 별도 스냅샷이며, 수정해도 스크립트를 제어하지 않습니다.
• Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

완전한 보조 함수

# 완전한 보조 함수
#
# 현재 숫자 스크립트 인덱스를 반환합니다.
#
# Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

SUB Main()
    # Main 아래에 함수 전체가 있습니다. 이 함수의 인수와 반환값은 내부에서 쓰는 API 명령과 구분해 설명합니다.
    # FindNamedScript는 표시 이름이 정확히 같은 첫 현재 인덱스, 없으면 -1을 반환합니다. 이름은 중복될 수 있고 인덱스도 나중에 바뀔 수 있습니다.
    # Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

    Dim index=FindNamedScript("Mining")
    If index>=0 Then
        UO.Print(CStr(index))
    Else
        UO.Print("Name not found")
    End If
END SUB

Function FindNamedScript(wanted) As Integer
    Dim indices=UO.GetScriptsList()
    For Each index In indices
        If UO.GetScriptName(index)=wanted Then
            Return index
        End If
    Next
    Return -1
End Function

매개변수 및 실행 설명:

• Main 아래에 함수 전체가 있습니다. 이 함수의 인수와 반환값은 내부에서 쓰는 API 명령과 구분해 설명합니다.
• FindNamedScript는 표시 이름이 정확히 같은 첫 현재 인덱스, 없으면 -1을 반환합니다. 이름은 중복될 수 있고 인덱스도 나중에 바뀔 수 있습니다.
• Integer의 Array: 인덱스 0..N-1 또는 빈 배열입니다. 요소는 이름이나 텍스트 레코드가 아닌 숫자입니다.

---

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

Basic