Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

파일 / JSON / 데이터

파일, JSON, 배열 및 컬렉션 C#, 호환 도우미 UO. 내장 기능 C#은 UO 없이 작성됩니다.

섹션

주제	명령 및 설명
파일	C# 및 표준 라이브러리
JSON 구문 분석	C# 및 표준 라이브러리
JSON 로드	C# 및 표준 라이브러리))
JSON 저장	C# 및 표준 라이브러리
JSON 문자열화	C# 및 표준 라이브러리
목록	C# 및 표준 라이브러리
사전	C# 및 표준 라이브러리
배열	C# 및 표준 라이브러리 · C# 및 표준 라이브러리
MemoryStream	C# 및 표준 라이브러리

모든 테마 명령

호환성 컬렉션

UO.GetArrayLength · UO.GetWord · UO.GetWordCount

Random 값

UO.Random

C# 및 표준 라이브러리 · C# 및 표준 라이브러리 · C# 및 표준 라이브러리

주제에 대한 예

각 명령 카드에는 직접 코드, 함수 및 클래스 등 여러 가지 독립적인 시나리오가 있습니다. 다음은 선택된 짧은 시나리오입니다. 제한사항과 전체 분석이 카드에 포함되어 있습니다.

UO.GetArrayLength

매개변수, 결과 및 모든 시나리오

dynamic[] amounts = new dynamic[checked((int)(2) + 1)];
amounts[0] = 50;
amounts[1] = 75;
amounts[2] = 25;
var total = 0;
for (int index = (int)(0); index <= UO.GetArrayLength(amounts) - 1; index += (int)(1))
{
    total += amounts[index];
}
return total;

UO.GetWord

매개변수, 결과 및 모든 시나리오

return ReadX("move   1445 1690");

dynamic ReadX(dynamic text)
{
    if (Truth(UO.GetWordCount(text) != 3))
    {
        return -1;
    }
    if (Truth(UO.GetWord(text, 0) != "move"))
    {
        return -1;
    }
    var xText = UO.GetWord(text, 1);
    if (!(Truth(IsNumeric(xText))))
    {
        return -1;
    }
    var x = Convert.ToDouble(xText);
    if (Truth(Convert.ToString(x) == "NaN") || Truth(x < 0) || Truth(x > 65535))
    {
        return -1;
    }
    if (Truth(x != Math.Truncate(x)))
    {
        return -1;
    }
    return Convert.ToInt32(x);
}

bool IsNumeric(object? value) => double.TryParse(Convert.ToString(value), System.Globalization.NumberStyles.Float, System.Globalization.CultureInfo.InvariantCulture, out _);
bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

전체 명령 참조

UO.GetArrayLength

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

C# 시그니처

dynamic UO.GetArrayLength(object? arg);

제한된 반복과 안전한 인덱스 읽기를 위해 즉시 배열 셀을 계산합니다.

매개변수

반환값

int >= 0. 빈 배열과 다른 종류의 값은 0를 제공합니다. 결과만으로는 유형을 확인할 수 없습니다. 이는 bool도 아니고 마지막 지수도 아닌 수량입니다.

동작

로컬 확인: 서버에 요청을 보내지 않고 항목을 이동하거나 배열을 수정하지 않습니다. 예시에는 실시간 인벤토리가 아닌 교육 데이터가 포함되어 있습니다.
값 유형을 확인하고 순회 또는 합산 없이 Array.Length를 읽습니다. 변수 값(2)을 선언하면 빈 셀을 포함하여 인덱스 0..2라는 세 개의 셀이 생성됩니다.
중첩된 요소는 재귀적으로 계산되지 않습니다. 문자열의 경우 Len이 있고 목록/사전의 경우 Count이 있습니다. UO.GetArrayLength는 동일한 로컬 검사에 대해 호환되는 이름입니다.

독립 실행 C# 스크립트

각 예제는 별도의 파일 .csx로 저장하고 IDE에서 실행할 수 있습니다. UO 개체와 대기 기능은 현재 게임 세션의 호스트를 제공합니다. 데모 serial 이름, 좌표, 주소를 자신의 것으로 바꾸세요.

간단한 예제

이 코드를 별도의 .csx 파일로 실행하세요. 인수는 호출에 직접 표시됩니다. 예제의 이름, serial, 주소를 자신의 값으로 바꾸세요.

한 번의 호출 결과를 저널에 표시합니다. 숫자를 bool로 변환하지 않으며, 배열이면 요소 수를 표시합니다.

object? result = UO.GetArrayLength(new[] { 10, 20, 30 });
UO.Print(result is Array values ? "Count: " + values.Length : Convert.ToString(result));

1. 제한된 목록에서 수량 추가 - 직접 스크립트

매개변수와 실행 흐름:

변수 금액(2)을 선언하면 세 개의 항목이 생성됩니다. 루프는 인덱스 0..2를 반복하고 150를 반환합니다. 수량은 ArrayLength가 아닌 주기에 따라 추가됩니다.
로컬 확인: 서버에 요청을 보내지 않고 항목을 이동하거나 배열을 수정하지 않습니다. 예시에는 실시간 인벤토리가 아닌 교육 데이터가 포함되어 있습니다.

dynamic[] amounts = new dynamic[checked((int)(2) + 1)];
amounts[0] = 50;
amounts[1] = 75;
amounts[2] = 25;
var total = 0;
for (int index = (int)(0); index <= UO.GetArrayLength(amounts) - 1; index += (int)(1))
{
    total += amounts[index];
}
return total;

2. 포인트와 좌표 필드를 별도로 계산 - 스크립트 기능

매개변수와 실행 흐름:

경로에는 2개의 배열 포인트가 있으며 각각 3개의 좌표 셀이 있습니다. 결과는 6이 아닌 2|3입니다. 캐릭터가 움직이지 않습니다.
로컬 확인: 서버에 요청을 보내지 않고 항목을 이동하거나 배열을 수정하지 않습니다. 예시에는 실시간 인벤토리가 아닌 교육 데이터가 포함되어 있습니다.

return  RunScenario();
 object? RunScenario()
{
    dynamic[] first = new dynamic[checked((int)(2) + 1)];
    first[0] = 100;
    first[1] = 200;
    first[2] = 0;
    dynamic[] second = new dynamic[checked((int)(2) + 1)];
    second[0] = 101;
    second[1] = 200;
    second[2] = 0;
    dynamic[] route = new dynamic[checked((int)(1) + 1)];
    route[0] = first;
    route[1] = second;
    return Convert.ToString(UO.GetArrayLength(route)) + "|" + Convert.ToString(UO.GetArrayLength(route[0]));
    return null;
}

3. 첫 번째 인덱스 확인 - 스크립트 클래스

매개변수와 실행 흐름:

이 줄은 0; Main은 인덱스에 액세스하기 전에 경로를 반환하지 않습니다. 검사는 빈 배열에도 적합하지만 이러한 경우를 구분하지 않습니다.
로컬 확인: 서버에 요청을 보내지 않고 항목을 이동하거나 배열을 수정하지 않습니다. 예시에는 실시간 인벤토리가 아닌 교육 데이터가 포함되어 있습니다.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        var route = "not an array";
        if (Truth(UO.GetArrayLength(route) == 0))
        {
            return "no route";
        }

        return route[0];
        return null;
    }

    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

명령 구현

C#은 대소문자를 구분합니다. 정확한 UO 이름을 사용하세요. 숫자 플래그는 0과 비교하고 반환 형식이 bool일 때만 bool을 사용하세요.

`UO.GetArrayLength(arg)` — `UO.GetArrayLength(Any)`

매개변수: arg (Any)

결과: dynamic / Any.

호출 시:

InjectionScript.Runtime.InternalSubrutines.GetArrayLength.

내부 구현 코드이며 독립 스크립트로 실행할 수 없습니다.

public static InjectionValue GetArrayLength(InjectionValue arg) => arg.Kind==InjectionValueKind.Array?new InjectionValue(arg.Array.Length):InjectionValue.Zero;

UO.GetWord

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

C# 시그니처

string UO.GetWord(object? value, object? wordIndex);
string UO.GetWord(object? value, object? wordIndex, object? delimiter);

텍스트에서 단일 단어나 필드를 가져옵니다. 좌표, 우선순위 목록 또는 저장된 스크립트 설정을 구문 분석하는 데 유용합니다.

매개변수

value — 소스 문자열. 이 기능은 전송된 텍스트를 정확하게 구문 분석합니다. 잡지, 파일, 장비 또는 세계를 자체적으로 읽지 않습니다.
wordIndex — 0 단어의 전체 인덱스: 0가 첫 번째이고, 1가 두 번째입니다. 음수 인덱스와 단어 수 이상의 인덱스는 빈 문자열을 반환합니다.
delimiter — 선택적 구분 기호입니다. "" 또는 단일 공백 " "이 없으면 텍스트는 탭과 줄 바꿈을 포함한 유니코드 공백 문자로 구분됩니다. 또 다른 구분 기호는 전체의 정확한 순서입니다. "::"는 모든 콜론이 아니라 연속된 두 개의 콜론을 의미합니다. 빈 부품은 폐기됩니다. 비어 있지 않은 부분은 잘리지 않습니다.

반환값

string — 비어 있지 않은 부분을 선택하거나 색인이 없는 경우 ""입니다. ID, type 또는 숫자가 아닌 텍스트입니다. 숫자의 경우 IsNumeric를 별도로 확인하고 값을 변환하세요.

동작

패키지나 게임 작업 없이 로컬에서 작동합니다. GetWord 및 UO.GetWord는 동일한 핸들러를 호출합니다. GetWordCount 및 UO.GetWordCount도 동일합니다. 호출할 때마다 전체 텍스트가 다시 분할됩니다. 루프에서 수량을 미리 저장하십시오. 대규모 반복 구문 분석의 경우 이미 구문 분석된 필드를 배열에 저장하는 것이 좋습니다. 이것은 CSV 파서가 아닙니다. 따옴표는 구분 기호를 보호하지 않으며 빈 열은 손실됩니다.
GetWord · GetWordCount · IsNumeric

독립 실행 C# 스크립트

간단한 예제

이 코드를 별도의 .csx 파일로 실행하세요. 인수는 호출에 직접 표시됩니다. 예제의 이름, serial, 주소를 자신의 값으로 바꾸세요.

한 번의 호출 결과를 저널에 표시합니다. 숫자를 bool로 변환하지 않으며, 배열이면 요소 수를 표시합니다.

var result = UO.GetWord("red green blue", 1);
UO.Print("GetWord: " + Convert.ToString(result));

1. UO.GetWord - 1 - 직접 스크립트

매개변수와 실행 흐름:

ReadX는 "move 1445 1690" 문자열을 받습니다. 세 단어와 이름 이동을 테스트합니다. 색인 1는 X를 선택합니다. IsNumeric는 텍스트를 확인하고 변환합니다. ToInt32은 1445을 반환합니다. 이것은 설정에 대한 분석일 뿐입니다. 캐릭터가 움직이지 않습니다. 양식이 올바르지 않으면 -1가 반환됩니다.
ReadX에서는 또한 Convert.ToInt32 전에 0..65535 범위의 전체 X가 필요합니다. NaN, 무한대 및 분수 X는 거부됩니다. Y는 여기서 테스트되지 않았습니다.

return ReadX("move   1445 1690");

dynamic ReadX(dynamic text)
{
    if (Truth(UO.GetWordCount(text) != 3))
    {
        return -1;
    }
    if (Truth(UO.GetWord(text, 0) != "move"))
    {
        return -1;
    }
    var xText = UO.GetWord(text, 1);
    if (!(Truth(IsNumeric(xText))))
    {
        return -1;
    }
    var x = Convert.ToDouble(xText);
    if (Truth(Convert.ToString(x) == "NaN") || Truth(x < 0) || Truth(x > 65535))
    {
        return -1;
    }
    if (Truth(x != Math.Truncate(x)))
    {
        return -1;
    }
    return Convert.ToInt32(x);
}

bool IsNumeric(object? value) => double.TryParse(Convert.ToString(value), System.Globalization.NumberStyles.Float, System.Globalization.CultureInfo.InvariantCulture, out _);
bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

2. UO.GetWord — 2 — 스크립트 기능

매개변수와 실행 흐름:

PriorityAt는 "mage||tank|archer|" 목록을 얻습니다. 그리고 인덱스=1. 구분자 | 빈 요소를 버리므로 결과는 탱크입니다. 이름은 임의적입니다. 여기서는 ClassMask을 등록하거나 옷을 확인하지 않습니다. 계산하고 선택할 때 동일한 분할 규칙을 사용하십시오.

return  RunScenario();
 object? RunScenario()
{
    return PriorityAt("mage||tank|archer|", 1);
    return null;
}

dynamic PriorityAt(dynamic names, dynamic index)
{
    return UO.GetWord(names, index, "|");
}

3. UO.GetWord - 3 - 시나리오 수업

매개변수와 실행 흐름:

ReadPlace는 "Britain::Bank:west"를 정확한 구분 기호 ::로 나눕니다. 인덱스 1는 Bank:west를 반환하며 내부 단일 콜론은 그대로 둡니다. 비어 있지 않은 부분이 정확히 두 개가 아닌 경우 도우미는 ""를 반환합니다. 부품 주위의 공간은 보존됩니다.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        return ReadPlace("Britain::Bank:west");
        return null;
    }

    dynamic ReadPlace(dynamic text)
    {
        if (Truth(UO.GetWordCount(text, "::") != 2))
        {
            return "";
        }

        return UO.GetWord(text, 1, "::");
    }

    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

명령 구현

C#은 대소문자를 구분합니다. 정확한 UO 이름을 사용하세요. 숫자 플래그는 0과 비교하고 반환 형식이 bool일 때만 bool을 사용하세요.

`UO.GetWord(value, wordIndex)` — `UO.GetWord(String,Integer)`

매개변수: value (String), wordIndex (Integer)

결과: string / String.

호출 시:

InjectionScript.Runtime.InjectionApi.GetWord.
InjectionScript.Runtime.InjectionApi.GetWord: GetWord(value,wordIndex," ").

내부 구현 코드이며 독립 스크립트로 실행할 수 없습니다.

private static string GetWord(string value,int wordIndex) => GetWord(value,wordIndex," ");

`UO.GetWord(value, wordIndex, delimiter)` — `UO.GetWord(String,Integer,String)`

매개변수: value (String), wordIndex (Integer), delimiter (String)

결과: string / String.

호출 시:

InjectionScript.Runtime.InjectionApi.GetWord.
InjectionScript.Runtime.InjectionApi.SplitWords: SplitWords(value,delimiter).

내부 구현 코드이며 독립 스크립트로 실행할 수 없습니다.

private static string GetWord(string value,int wordIndex,string delimiter)
        {
            var words=SplitWords(value,delimiter);return wordIndex>=0&&wordIndex<words.Length?words[wordIndex]:string.Empty;
        }

UO.GetWordCount

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

C# 시그니처

int UO.GetWordCount(object? value);
int UO.GetWordCount(object? value, object? delimiter);

비어 있지 않은 텍스트 필드의 수를 셉니다. 구문 분석하기 전에 좌표 수를 확인하고 목록 열거 범위를 결정할 수 있습니다.

매개변수

value — 소스 문자열. 이 기능은 전송된 텍스트를 정확하게 구문 분석합니다. 잡지, 파일, 장비 또는 세계를 자체적으로 읽지 않습니다.
delimiter — 선택적 구분 기호입니다. "" 또는 단일 공백 " "이 없으면 텍스트는 탭과 줄 바꿈을 포함한 유니코드 공백 문자로 구분됩니다. 또 다른 구분 기호는 전체의 정확한 순서입니다. "::"는 모든 콜론이 아니라 연속된 두 개의 콜론을 의미합니다. 빈 부품은 폐기됩니다. 비어 있지 않은 부분은 잘리지 않습니다.

반환값

int — 비어 있지 않은 부분의 수. 빈 문자열과 구분된 문자열만 있으면 0가 생성됩니다. 이는 bool이 아닌 카운터입니다. 2도 유효한 결과입니다. 개수 확인 > 0 또는 필요한 정확한 수량을 확인하세요.

동작

패키지나 게임 작업 없이 로컬에서 작동합니다. GetWord 및 UO.GetWord는 동일한 핸들러를 호출합니다. GetWordCount 및 UO.GetWordCount도 동일합니다. 호출할 때마다 전체 텍스트가 다시 분할됩니다. 루프에서 수량을 미리 저장하십시오. 대규모 반복 구문 분석의 경우 이미 구문 분석된 필드를 배열에 저장하는 것이 좋습니다. 이것은 CSV 파서가 아닙니다. 따옴표는 구분 기호를 보호하지 않으며 빈 열은 손실됩니다.
GetWord · GetWordCount · IsNumeric

독립 실행 C# 스크립트

간단한 예제

이 코드를 별도의 .csx 파일로 실행하세요. 인수는 호출에 직접 표시됩니다. 예제의 이름, serial, 주소를 자신의 값으로 바꾸세요.

한 번의 호출 결과를 저널에 표시합니다. 숫자를 bool로 변환하지 않으며, 배열이면 요소 수를 표시합니다.

var result = UO.GetWordCount("red green blue");
UO.Print("GetWordCount: " + Convert.ToString(result));

1. UO.GetWordCount - 1 - 직접 스크립트

매개변수와 실행 흐름:

HasPoint는 "1445 1690 0"를 허용합니다. 각각 정확히 세 단어와 숫자 텍스트가 필요하며 1를 반환합니다. 그렇지 않으면 0. 이는 지도의 유효성, 좌표 경계 또는 통행 가능성이 아닌 형식의 확인일 뿐입니다. GetWordCount는 3을 반환하고 bool는 도우미를 반환합니다.
HasPoint는 IsNumeric 자체가 허용할 수 있는 NaN 및 무한대를 추가로 거부합니다. 분수 유한 숫자가 허용됩니다. 이동 전, 게임 전체 좌표에 대한 별도의 확인이 필요합니다.

return HasPoint("1445 1690 0");

dynamic HasPoint(dynamic text)
{
    if (Truth(UO.GetWordCount(text) != 3))
    {
        return 0;
    }
    var i = 0;
    while (Truth(i < 3))
    {
        if (!(Truth(IsNumeric(UO.GetWord(text, i)))))
        {
            return 0;
        }
        var value = Convert.ToString(Convert.ToDouble(UO.GetWord(text, i)));
        if (Truth(value == "NaN") || Truth(value == "Infinity") || Truth(value == "-Infinity"))
        {
            return 0;
        }
        i = i + 1;
    }
    return 1;
}

bool IsNumeric(object? value) => double.TryParse(Convert.ToString(value), System.Globalization.NumberStyles.Float, System.Globalization.CultureInfo.InvariantCulture, out _);
bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

2. UO.GetWordCount — 2 — 스크립트 기능

매개변수와 실행 흐름:

JoinPriorities는 "mage||tank|archer|"를 얻습니다. 비어 있지 않은 세 개의 요소를 한 번 계산하고, 인덱스 0..2를 반복하고 "mage > Tank > Archer"를 반환합니다. 시작, 끝 및 반복 | 별도의 우선순위를 만들지 마세요.

return  RunScenario();
 object? RunScenario()
{
    return JoinPriorities("mage||tank|archer|");
    return null;
}

dynamic JoinPriorities(dynamic names)
{
    var count = UO.GetWordCount(names, "|");
    var i = 0;
    var result = "";
    while (Truth(i < count))
    {
        if (Truth(i > 0))
        {
            result = result + " > ";
        }

        result = result + UO.GetWord(names, i, "|");
        i = i + 1;
    }

    return result;
}

bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;

3. UO.GetWordCount - 3 - 시나리오 수업

매개변수와 실행 흐름:

CountPlaces는 "Britain::Bank:west::"를 얻습니다. :: 구분 기호는 두 개의 필드를 제공하고 뒤따르는 빈 필드는 제거됩니다. 결과는 2입니다. 단일: Bank:west는 내부에서 텍스트를 분할하지 않습니다. 이는 클라이언트의 도시 목록이 아니라 설정 형식의 예입니다.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        return CountPlaces("Britain::Bank:west::");
        return null;
    }

    dynamic CountPlaces(dynamic text)
    {
        return UO.GetWordCount(text, "::");
    }
}

명령 구현

C#은 대소문자를 구분합니다. 정확한 UO 이름을 사용하세요. 숫자 플래그는 0과 비교하고 반환 형식이 bool일 때만 bool을 사용하세요.

`UO.GetWordCount(value)` — `UO.GetWordCount(String)`

매개변수: value (String)

결과: int / Integer.

호출 시:

InjectionScript.Runtime.InjectionApi.GetWordCount.
InjectionScript.Runtime.InjectionApi.GetWordCount: GetWordCount(value," ").

내부 구현 코드이며 독립 스크립트로 실행할 수 없습니다.

private static int GetWordCount(string value) => GetWordCount(value," ");

`UO.GetWordCount(value, delimiter)` — `UO.GetWordCount(String,String)`

매개변수: value (String), delimiter (String)

결과: int / Integer.

호출 시:

InjectionScript.Runtime.InjectionApi.GetWordCount.
InjectionScript.Runtime.InjectionApi.SplitWords: SplitWords(value,delimiter).

내부 구현 코드이며 독립 스크립트로 실행할 수 없습니다.

private static int GetWordCount(string value,string delimiter) => SplitWords(value,delimiter).Length;

UO.Random

Українська · Русский · English · Deutsch · Français · Italiano · Español · 繁體中文 · 日本語 · 한국어

C# 시그니처

int UO.Random(object? max);
int UO.Random(object? min, object? max);

임의의 정수를 반환합니다. 새로운 양식 UO.Random(min, max)는 최소부터 최대까지의 숫자를 선택합니다. 이전 형식 UO.Random(max)은 그대로 유지됩니다. 즉, 0에서 max−1까지 선택됩니다. 결과는 변수에 저장되어 지연, 좌표, 인덱스 또는 조건으로 사용될 수 있습니다.

매개변수

min — 2개 인수 형식의 첫 번째 인수만 포함된 하한이며, −2147483648부터 2147483647까지의 정수입니다. 음수, 0 또는 양수일 수 있습니다. 최대값을 초과할 수 없습니다. 단일 인수 형식에는 최소값이 없으며 전달된 숫자는 최대값을 의미합니다.
max — 두 개의 인수 형식에서 −2147483648에서 2147483647까지의 상한 int를 포함하는 두 번째 인수입니다. 이전의 단일 인수 형식에서는 단일 인수, EXCLUDED 상한, 0에서 2147483647까지의 정수; Random(0)는 0을 반환합니다. 단일 인수 형식의 음수 최대값은 허용되지 않습니다.

반환값

int는 하나의 의사 난수 정수입니다. 두 개의 인수 min ≤ result ≤ max; 두 테두리가 모두 빠질 수 있습니다. 하나의 긍정적인 인수를 사용하면 0 ≤ 결과 < 최대값입니다. 이전에 추첨된 숫자를 반복하는 것은 허용됩니다. 팀은 반복 없이 숫자를 선택하지 않습니다.

동작

정확히 두 가지 형식, 즉 UO.Random(max) 및 UO.Random(min, max)이 지원됩니다. 인수가 없는 호출은 등록되지 않습니다. "시작 및 끝" 범위의 경우 두 개의 인수를 사용합니다.
Random(5, 5)은 항상 5를 반환합니다. Random(10, 1)은 범위 오류를 보고합니다. 경계는 자동으로 교환되지 않습니다. Random(-10, -1)은 −10이 −1보다 작기 때문에 정확합니다.
두 경계 모두 정수 int입니다. 소수의 경우 원하는 척도의 전체 단위를 선택한 다음 나눌 수 있습니다. 예를 들어, Random(0, 100) / 100.0는 0부터 1까지 0,01 단위로 이산 값을 제공합니다.
전체 범위 Random(-2147483648, 2147483647)가 유효합니다. 구현 시 int의 최대값에 1를 추가하지 않으므로 상한에서 오버플로되지 않습니다. 넓은 범위의 경우 분할의 나머지 부분이 선택을 편향시키지 않도록 추가 값을 버리는 것이 사용됩니다.
호출은 로컬에서 번호를 계산하고, 패킷을 보내지 않으며, 자체적으로 일시 중지되지 않습니다. 무작위로 일시중지하려면 결과를 UO.Wait에 전달하세요. 스크립트는 서버에 필요한 최소 대기 시간을 유지해야 합니다.
동일한 숫자가 여러 번 필요한 경우 결과를 var에 저장하세요. Random에 대한 두 번의 개별 호출은 서로 다른 값을 반환할 수 있습니다. 이 명령은 선택한 사각형이 이동 또는 이동에 유효한지 확인하지 않습니다. 이는 해당 게임 명령으로 확인합니다.

독립 실행 C# 스크립트

간단한 예제

이 코드를 별도의 .csx 파일로 실행하세요. 인수는 호출에 직접 표시됩니다. 예제의 이름, serial, 주소를 자신의 값으로 바꾸세요.

한 번의 호출 결과를 저널에 표시합니다. 숫자를 bool로 변환하지 않으며, 배열이면 요소 수를 표시합니다.

var result = UO.Random(10);
UO.Print("Random: " + Convert.ToString(result));

1. 1부터 6까지의 난수 - 직접 스크립트

매개변수와 실행 흐름:

최소값은 낮아짐=1, 최대값은 높아짐=6. 가능한 값은 정확히 6개입니다: 1, 2, 3, 4, 5 및 6.
롤에는 수신된 번호가 하나 저장됩니다. Print는 정확히 이것을 표시합니다. Convert.ToString는 int를 문자열로 변환합니다. 다시 실행하면 같은 숫자가 나올 수 있습니다.

var lower = 1;
var upper = 6;
var roll = UO.Random(lower, upper);
UO.Print("Roll: " + Convert.ToString(roll));

2. 350 및 700 밀리초 사이의 무작위 일시 중지 - 스크립트 기능

매개변수와 실행 흐름:

min=350 및 max=700는 활성화된 지연 제한을 정의합니다. 350, 512 또는 700와 같은 결과가 지연에 기록됩니다.
UO.Wait는 밀리초 단위로 하나의 지연 인수를 받습니다. 일시 중지는 UO.Wait에서 발생합니다. Random는 숫자만 계산합니다.
서버의 작업 및 요구 사항에 따라 하한을 선택하십시오. 무작위 지연은 다음 작업에 해당 응답이 필요한 경우 서버가 응답할 때까지 기다리는 것을 대체하지 않습니다.

return  RunScenario();
 object? RunScenario()
{
    var delay = UO.Random(350, 700);
    UO.Print("Waiting " + Convert.ToString(delay) + " ms");
    UO.Wait(delay);
    UO.Print("Wait finished");
    return null;
}

3. 세 가지 작업 중 하나를 조건으로 선택 - 시나리오 클래스

매개변수와 실행 흐름:

min=1, max=3: 선택은 1, 2 또는 3입니다. 각 분기는 유효한 숫자 중 하나에 해당합니다.
Random에 대한 호출은 if 전에 한 번 실행됩니다. 각 조건에서 다시 호출하면 다른 선택이 됩니다.
Print를 스크립트에서 원하는 작업으로 바꾸고 해당 작업에 대한 조건, 범위 및 서버 응답 확인을 유지합니다.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        var choice = UO.Random(1, 3);
        if (Truth(choice == 1))
        {
            UO.Print("First action");
        }
        else
        {
            if (Truth(choice == 2))
            {
                UO.Print("Second action");
            }
            else
            {
                UO.Print("Third action");
            }
        }

        return null;
    }

    bool Truth(object? value) => value is bool flag ? flag : value is string text ? !string.IsNullOrEmpty(text) : value != null && Convert.ToDouble(value) != 0;
}

4. 배낭 내부 MassMove 위치 선택 - 직접 스크립트

매개변수와 실행 흐름:

첫 번째 Random: min=50, max=90, 결과 x. 두 번째: min=60, max=100, 결과 y. 이는 화면 좌표나 지도 좌표가 아닌 컨테이너 내부의 두 개의 독립적인 좌표입니다.
MassMove 지연=350 ms, 수량=10 정수 항목에서 type=0는 첫 번째 수동 전송인 목적지=backpack에 의해 결정되며 x/y는 변수 z=0에서 가져옵니다.
명령 후 원본 컨테이너에서 마우스로 샘플을 드래그합니다. MassMove 전체 포함은 하나의 선택된 위치를 사용합니다. 각 개별 항목의 위치를 무작위로 지정하려면 MassMove에 대한 단일 호출이 아닌 별도의 MoveItem를 사용하는 루프가 필요합니다.
배낭의 사용 가능한 영역 내에서 X/Y 범위를 선택합니다. 서버는 아이템의 배치를 변경할 수 있습니다.

var x = UO.Random(50, 90);
var y = UO.Random(60, 100);
UO.MassMove(350, 10, 0, "backpack", x, y, 0);
UO.Print("Drag a source item; position: " + Convert.ToString(x) + ", " + Convert.ToString(y));

5. 원래 좌표를 기준으로 음수 오프셋 - 스크립트 기능

매개변수와 실행 흐름:

min=−2 및 max=2 호출 모두에서: −2, −1, 0, 1, 2이 가능합니다. GetX/GetY 인수 없이 캐릭터의 좌표를 읽습니다.
x/y는 문자 주위의 사각형에 있는 계산된 셀입니다. 이 예에서는 물체를 움직이거나 던지기 시작하지 않습니다.
무작위 셀은 통과할 수 없거나 지도 경계를 넘어설 수 있습니다. 게임 동작 전에 적절한 좌표와 경로 확인을 사용하십시오.

return  RunScenario();
 object? RunScenario()
{
    var offsetX = UO.Random(-2, 2);
    var offsetY = UO.Random(-2, 2);
    var x = UO.GetX() + offsetX;
    var y = UO.GetY() + offsetY;
    UO.Print("Candidate tile: " + Convert.ToString(x) + ", " + Convert.ToString(y));
    return null;
}

6. Random(max) - 시나리오 클래스와의 호환성 유지

매개변수와 실행 흐름:

Random(count)에는 max=10만 있습니다: 상한 없음, 0..9 가능합니다. 숫자 10가 표시되지 않습니다.
Random(0, count−1) min=0 및 max=9 포함: 유효한 범위는 동일하지만 호출은 새로운 독립적 선택을 만듭니다.
인덱스를 선택하려면 count가 양수여야 합니다. 특별한 호환 사례인 Random(0)=0은 빈 컬렉션의 인덱스 0에 요소가 있다는 의미는 아닙니다.

return  new ScriptScenario(UO, WaitAsync, Args, Cancellation, Checkpoint).RunScenario();
class ScriptScenario
{
    private readonly global::ClassicUO.CSharp.CSharpGameApi UO;
    private readonly Func<int, Task> WaitAsync;
    private readonly string[] Args;
    private readonly CancellationToken Cancellation;
    private readonly Action Checkpoint;
    public ScriptScenario(global::ClassicUO.CSharp.CSharpGameApi api, Func<int, Task> wait, string[] args, CancellationToken cancellation, Action checkpoint)
    {
        UO = api;
        WaitAsync = wait;
        Args = args;
        Cancellation = cancellation;
        Checkpoint = checkpoint;
    }

     public object? RunScenario()
    {
        var count = 10;
        var index = UO.Random(count);
        var equivalent = UO.Random(0, count - 1);
        UO.Print("Index 0..9: " + Convert.ToString(index));
        UO.Print("Another independent index: " + Convert.ToString(equivalent));
        return null;
    }
}

7. 동일한 경계 및 전체 범위 int - 직접 스크립트

매개변수와 실행 흐름:

min=7 및 max=7는 단일 결과 7를 제공합니다.
min=−100 및 max=−50는 두 경계를 모두 포함하여 음수만 제공합니다.
마지막 호출은 서명된 전체 32비트 int을 다룹니다. 그 결과는 양수, 음수 또는 0일 수 있습니다.
경계는 더 작은 것에서 더 큰 것으로 전달됩니다. Random(10, 1)에 대한 잘못된 호출은 min must not also max; 메시지와 함께 중지됩니다. 반전된 범위에는 사용할 필요가 없습니다.

var fixedValue = UO.Random(7, 7);
var negative = UO.Random(-100, -50);
var signedValue = UO.Random(-2147483648, 2147483647);
UO.Print("Fixed: " + Convert.ToString(fixedValue));
UO.Print("Negative: " + Convert.ToString(negative));
UO.Print("Signed Integer: " + Convert.ToString(signedValue));

명령 구현

C#은 대소문자를 구분합니다. 정확한 UO 이름을 사용하세요. 숫자 플래그는 0과 비교하고 반환 형식이 bool일 때만 bool을 사용하세요.

`UO.Random(max)` — `UO.Random(Integer)`

매개변수: max (Integer)

결과: int / Integer.

호출 시:

InjectionScript.Runtime.InjectionApiUO.Random.

내부 구현 코드이며 독립 스크립트로 실행할 수 없습니다.

public int Random(int max)

        {

            lock (randomSync) return random.Next(max);

        }

`UO.Random(min, max)` — `UO.Random(Integer,Integer)`

매개변수: min (Integer), max (Integer)

결과: int / Integer.

호출 시:

InjectionScript.Runtime.InjectionApiUO.Random.

내부 구현 코드이며 독립 스크립트로 실행할 수 없습니다.

public int Random(int min, int max)

        {

            if (min > max)

                throw new NativeSubrutineException("UO.Random(min, max): min must not exceed max.");

            if (min == max) return min;

            long count = (long)max - min + 1;

            lock (randomSync)

            {

                if (count <= int.MaxValue)

                    return (int)(min + (long)random.Next((int)count));



                // Inclusive Int32.MaxValue and the full signed range must not

                // overflow. Rejection avoids modulo bias; reuse the four bytes.

                const ulong domain = 1UL << 32;

                ulong limit = domain - domain % (ulong)count;

                uint sample;

                do

                {

                    random.NextBytes(randomRangeBytes);

                    sample = BitConverter.ToUInt32(randomRangeBytes, 0);

                } while (sample >= limit);

                return (int)(min + (long)(sample % (ulong)count));

            }

        }

KO UO Topic files json data - LIHACHTETAN/ClassicUO-Bad-Newbie-CSharp-Scripts-IDE GitHub Wiki

파일 / JSON / 데이터

섹션

모든 테마 명령

호환성 컬렉션

Random 값

주제에 대한 예

UO.GetArrayLength

UO.GetWord

전체 명령 참조

UO.GetArrayLength

C# 시그니처

매개변수

반환값

동작

독립 실행 C# 스크립트

간단한 예제

1. 제한된 목록에서 수량 추가 - 직접 스크립트

2. 포인트와 좌표 필드를 별도로 계산 - 스크립트 기능

3. 첫 번째 인덱스 확인 - 스크립트 클래스

명령 구현

UO.GetArrayLength(arg) — UO.GetArrayLength(Any)

UO.GetWord

C# 시그니처

매개변수

반환값

동작

독립 실행 C# 스크립트

간단한 예제

1. UO.GetWord - 1 - 직접 스크립트

2. UO.GetWord — 2 — 스크립트 기능

3. UO.GetWord - 3 - 시나리오 수업

명령 구현

UO.GetWord(value, wordIndex) — UO.GetWord(String,Integer)

UO.GetWord(value, wordIndex, delimiter) — UO.GetWord(String,Integer,String)

UO.GetWordCount

C# 시그니처

매개변수

반환값

동작

독립 실행 C# 스크립트

간단한 예제

1. UO.GetWordCount - 1 - 직접 스크립트

2. UO.GetWordCount — 2 — 스크립트 기능

3. UO.GetWordCount - 3 - 시나리오 수업

명령 구현

UO.GetWordCount(value) — UO.GetWordCount(String)

UO.GetWordCount(value, delimiter) — UO.GetWordCount(String,String)

UO.Random

C# 시그니처

매개변수

반환값

동작

독립 실행 C# 스크립트

간단한 예제

1. 1부터 6까지의 난수 - 직접 스크립트

2. 350 및 700 밀리초 사이의 무작위 일시 중지 - 스크립트 기능

3. 세 가지 작업 중 하나를 조건으로 선택 - 시나리오 클래스

4. 배낭 내부 MassMove 위치 선택 - 직접 스크립트

5. 원래 좌표를 기준으로 음수 오프셋 - 스크립트 기능

6. Random(max) - 시나리오 클래스와의 호환성 유지

7. 동일한 경계 및 전체 범위 int - 직접 스크립트

명령 구현

UO.Random(max) — UO.Random(Integer)

UO.Random(min, max) — UO.Random(Integer,Integer)

⚠️ **GitHub.com Fallback** ⚠️

`UO.GetArrayLength(arg)` — `UO.GetArrayLength(Any)`

`UO.GetWord(value, wordIndex)` — `UO.GetWord(String,Integer)`

`UO.GetWord(value, wordIndex, delimiter)` — `UO.GetWord(String,Integer,String)`

`UO.GetWordCount(value)` — `UO.GetWordCount(String)`

`UO.GetWordCount(value, delimiter)` — `UO.GetWordCount(String,String)`

`UO.Random(max)` — `UO.Random(Integer)`

`UO.Random(min, max)` — `UO.Random(Integer,Integer)`

⚠️ GitHub.com Fallback ⚠️