EU Installation

Installation

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

Requirements

• Windows x64;
• the extracted distribution archive;
• legally obtained Ultima Online game data;
• access details for the game server you intend to use.

The ready client is built as a NativeAOT Windows application. The .NET SDK is not required for ordinary use of the ready client.

Choose an edition

The distribution contains two client editions:

• client — Bad Newbie plus Basic IDE Runtime, IDE and API Manual;
• client-without-yoko — Bad Newbie without the Basic interface and Runtime.

The matching source trees are project and project-without-yoko. Optional client-private fonts are stored in open-font-pack; build and test evidence is stored in verification.

Install the ready client

1. Extract the complete archive to a separate writable directory. Do not run the executable from inside the ZIP.
2. Open either client or client-without-yoko.
3. Start ClassicUO.exe without moving it away from the adjacent libraries and payload directories.
4. When requested, select the directory containing your Ultima Online data files.
5. Configure the server address, port, account and profile in the normal client workflow.

Game data is not distributed with this project. The selected data set must be compatible with the server.

Verify a downloaded archive

Compare its SHA-256 value with the .sha256.txt file published beside that archive:

Get-FileHash .\ClassicUO-BadNewbie-BasicIDE.zip -Algorithm SHA256

The displayed hash must match the published value exactly. The exact archive name may differ.

First Basic start

In the full client:

1. open Options → Basic IDE;
2. choose an AutoLoad file for the current character and press Apply;
3. open Basic IDE;
4. create or open a script containing SUB Main();
5. validate it with F6;
6. run the current script with F5, or start SUB Main() without debugging with Ctrl+F5.

See Basic Runtime and IDE and AutoLoad and macros.

Updating an existing installation

Back up your own profiles, AutoLoad files, Autoload\Scripts and custom Fonts before replacing the client. Extract the new package into a clean directory and copy back only personal data. Do not overlay old executables, IDE extensions or generated dependencies onto the new payload, because mixed files can restore old defects.