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.

API · A–Z · Examples · Audit

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.