API Manual 및 Inspector

Home · BASIC · UO API · A–Z · Examples · Languages

API Manual

현재 참조 문서에는 1103개 기호와 호출 가능한 모든 1037개 명령 이름이 있으며, 각 명령에 여러 예제가 있습니다. 클라이언트는 외부 API Manual 폴더의 편집 가능한 파일을 읽습니다. 수정 후에는 Theia에서 매뉴얼을 다시 여세요. 공통 상세 페이지는 러시아어와 일부 영어로 작성되며, 명령 식별자는 번역되지 않습니다.

API · A–Z · Examples · Audit

유일한 정보 원본

API 문서는 다음 방향으로 만들어집니다.

Runtime registration → API Manual

이전 Manual, 예제 파일 또는 과거 명령 이름은 현재 API가 존재한다는 증거가 아닙니다. 현재 Basic Runtime에 실제 등록되어 스크립트에서 사용할 수 있는 elements만 Manual에 포함합니다. Runtime에는 있지만 이전 Manual에 없던 element는 추가해야 합니다.

각 API 항목의 내용

• 정확한 이름과 element type;
• 실제 signature와 등록된 모든 overload;
• required/optional parameters;
• 구현된 default values;
• return value 또는 side effect;
• parameter 허용값과 제한;
• data source와 dispatch route;
• ClassicUO까지의 구체적인 호출 경로;
• related properties/elements;
• 실제 Basic Script 문법을 사용한 examples.

명령 이름, identifier, path, type 및 구문은 번역하지 않습니다. 선택한 언어는 Manual의 설명문에만 적용됩니다.

Runtime API에 포함되지 않는 항목

사용자가 AutoLoad 또는 Autoload\Scripts에 선언한 SUB, FUNCTION, globals 및 constants는 Runtime API가 아닙니다. 이 symbols는 선택된 파일의 Outline, references, navigation 및 static analysis에 표시됩니다.

명령 카드 보기

명령을 선택하면 정확한 이름, 유형, 간단한 시그니처 및 반환값(또는 효과)을 담은 요약 카드가 먼저 표시됩니다.

확장 정보를 열면 모든 overload, 매개변수 요구사항, 기본값, 제약, 종속성, Runtime 경로, 관련 요소 및 실행 가능한 Basic Script 예제를 확인할 수 있습니다. 두 보기 모두 구문과 return을 유지합니다.

API Inspector, debugger 및 반환값

API Inspector는 “이 명령의 정의와 사용법은 무엇인가”를 보여 주며 signature, parameters, return/effect, example 및 기술 경로를 표시합니다. 실행 중 발생한 모든 호출 결과를 누적해서 보여 주는 패널은 아닙니다.

실제 반환값을 확인하는 예:

VAR item = UO.FindType(0x0F43, -1, backpack, -1, TRUE)
UO.Print('Result: ' + CStr(item))

또는 결과를 변수에 저장하고 다음 줄에 breakpoint를 둔 뒤 멈춘 상태에서 Variables/Watch로 확인합니다. Local, global, constant, frame 및 call stack의 런타임 정보는 debugger panels에서 확인합니다.

IDE에서 문서 사용

• completion은 현재 Runtime이 지원하는 signature를 표시;
• API 항목을 한 번 클릭하면 Inspector에서 상세 정보 표시;
• 두 번 클릭하면 완전한 명령 형태 삽입;
• Ctrl+F1은 커서 위치 symbol의 문서 열기;
• Ctrl을 누른 채 hover하면 간단한 문서를 표시하고 키를 놓으면 숨김;
• tooltip은 줄바꿈되며 화면 안에 유지.

언어

Manual UI와 설명은 EU, RU, UA, FR, DE, IT, ES, ZH, JA, KO를 지원합니다. 언어를 바꿔도 UO.*, signature, Basic keywords, paths 또는 Runtime 동작은 바뀌지 않습니다.

API 일치 감사

배포 전 Runtime/Manual 검증의 예상 결과:

Missing from Manual: 0
Not registered in Runtime: 0
Invalid signatures: 0
Duplicate entries: 0
Invalid Basic Script examples: 0

이 결과는 등록 목록, signature, 중복 및 examples의 자동 일치를 나타냅니다. 모든 게임 서버가 같은 확장 데이터를 보낸다는 뜻은 아닙니다.

Manual이 비어 있을 때

창은 열리지만 navigation이 비어 있으면 frontend가 Runtime catalog를 받지 못했을 가능성이 큽니다. 전체 client를 사용하고 Basic payload가 완전하며 이전 IDE 폴더를 덮어쓰지 않았는지 확인한 뒤 전체 클라이언트를 다시 시작하십시오. 자세한 내용은 문제 해결을 보십시오.