IT API Manual - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki
API Manual e Inspector — Italiano
Home · BASIC · UO API · A–Z · Examples · Languages
API Manual
Il riferimento aggiornato contiene 1103 simboli e tutti i 1037 nomi dei comandi richiamabili, con più esempi per comando. Il client legge i file modificabili dalla cartella esterna API Manual; riaprire il manuale in Theia per caricare le modifiche. Le schede dettagliate comuni sono in russo e in parte in inglese. I nomi dei comandi non vengono tradotti.
Il Runtime è l’unica fonte
Il contenuto segue questa direzione:
Runtime registration → API Manual
Una vecchia descrizione non dimostra che il comando esista. Nel Manual entrano soltanto gli elementi realmente registrati dal Runtime. Un comando storico assente nel Runtime va escluso; un elemento registrato ma precedentemente non documentato va aggiunto.
Contenuto di una voce API
Ogni voce include, quando esposto dalla registrazione:
- nome esatto e tipo dell’elemento;
- firma reale e tutti gli overload registrati;
- parametri obbligatori e facoltativi;
- valori predefiniti;
- valore restituito oppure effetto;
- valori ammessi;
- fonte dei dati e percorso fino alla chiamata ClassicUO;
- proprietà ed elementi correlati;
- esempi validi in sintassi Basic Script.
Nomi di comandi, identificatori e parametri non vengono tradotti.
Le procedure utente non sono Runtime API
Le SUB e FUNCTION personali da AutoLoad o Autoload\Scripts non vengono aggiunte al catalogo Runtime. Rimangono disponibili in Outline, navigazione dei simboli e analisi statica del file selezionato.
Modalità della scheda comando
Selezionando un comando viene mostrata una scheda compatta con nome esatto, tipo, sintassi breve e valore restituito (o effetto).
Informazioni estese mostra overload, parametri, valori predefiniti, vincoli, dipendenze, percorso Runtime, elementi correlati ed esempio Basic Script valido. Sintassi e return restano visibili in entrambe le viste.
API Inspector e debugger
Inspector spiega l’elemento selezionato: firma, parametri, return/effetto, esempio e percorso tecnico. Non è un flusso live che elenca il risultato di ogni comando.
Per vedere il risultato concreto:
SUB Main()
VAR hp = UO.GetHP()
UO.Print('HP: ' + CStr(hp))
END SUB
In alternativa salvare il risultato in una variabile, fermarsi con un breakpoint dopo la chiamata e leggerlo in Variables o Watch. locals, globals, stack frames e watches appartengono ai pannelli Debug.
Navigazione e lingue
Il Manual supporta EU, RU, UA, FR, DE, IT, ES, ZH, JA e KO. Le spiegazioni possono essere localizzate; UO.*, firme, percorsi e codice restano invariati. Ctrl-hover, API Inspector e Manual condividono gli stessi metadata Runtime e lo stesso renderer.
Verifica di parità
Il controllo automatico deve produrre:
Missing from Manual: 0
Not registered in Runtime: 0
Invalid signatures: 0
Duplicate entries: 0
Invalid Basic Script examples: 0
Il controllo impedisce voci obsolete, comandi non registrati, overload errati ed esempi con sintassi non supportata.
Manual vuoto
Controllare di usare l’edizione completa, che tutti i file Basic/Theia siano accanto a ClassicUO.exe e che nessun vecchio file IDE sia stato copiato sopra. Una navigazione sinistra vuota indica spesso che il frontend si è aperto ma il catalogo Runtime non è stato caricato. Vedere Risoluzione problemi.