Usare una libreria Moongate

Inizia con una piccola applicazione console. Servono l’SDK .NET 10 e l’accesso a NuGet; questo primo esempio non richiede un server Moongate, un database o i file del client UO.

1. Crea un progetto e installa il pacchetto

Esegui questi comandi dalla directory in cui conservi i tuoi progetti:

dotnet new console -n MoongateLibraryDemo -f net10.0
cd MoongateLibraryDemo
dotnet add package Moongate.Core

NuGet registra la versione installata in MoongateLibraryDemo.csproj. Mantieni quella versione quando condividi o distribuisci l’applicazione. Se usi più pacchetti Moongate, scegli versioni della stessa release.

2. Esegui il primo esempio

Sostituisci Program.cs con:

using Moongate.Core.Geometry;

var position = new Point3D(100, 200, 5);
Console.WriteLine($"Position: {position.X}, {position.Y}, {position.Z}");

Eseguilo dalla directory del progetto:

dotnet run

Risultato atteso:

Position: 100, 200, 5

Hai usato un tipo Moongate nella tua applicazione. La guida Core aggiunge esempi di configurazione, identità e indirizzi di rete.

Scegli una libreria per la tua attività

Ogni guida elenca i prerequisiti e include un esempio. NuGet risolve le dipendenze dei pacchetti; installa il pacchetto che usi direttamente.

Voglio…	Inizia qui
Usare geometria, identità o funzioni di configurazione	Core
Creare un client o server TCP	Network, poi le ricette TCP
Leggere o scrivere pacchetti UO	Network.Packets
Salvare entità in PostgreSQL	Persistence e il tutorial sulle entità
Validare un catalogo di migrazioni SQL versionate	Persistence.Migrations
Integrare Lua in un’applicazione	Scripting
Costruire un host con servizi di avvio, bus degli eventi e plugin	Hosting
Usare i contratti del server di gioco	Server.Core
Creare un client di amministrazione	Admin.Contracts
Leggere o renderizzare i dati del client UO	Ultima

Per estendere un server Moongate in esecuzione, segui Scrivere un plugin. Per modificare e validare i pacchetti stessi, usa la guida per i contributori alla verifica dei pacchetti.