Skip to content

ClassicUO - an open source implementation of the Ultima Online Classic Client.

Notifications You must be signed in to change notification settings

sadoseja/ClassicUO

 
 

Repository files navigation

An open source implementation of the Ultima Online Classic Client.

Paypal

PayPal

Discord

chat on Discord

Current release

Build status

Introduction

ClassicUO is an open source implementation of the Ultima Online Classic Client. This client is intended to emulate all standard client versions and is primarily tested against Ultima Online free shards. This client will not work on the official game shards at the moment.

The client is currently under heavy development but is functional. The code is based on the FNA-XNA framework. C# is chosen because there is a large community of developers working on Ultima Online server emulators in C#, because FNA-XNA exists and seems reasonably suitable for creating this type of game.

ClassicUO is natively cross platform and supports:

  • Windows
  • Linux
  • MacOS

Running

Follow the Wiki to setup correctly ClassicUO

Building (Windows)

The binary produced will work on all supported platforms.

You'll need Visual Studio 2019. The free community edition should be fine. Once that is installed:

  1. Open ClassicUO.sln in the root of the repository.

  2. Select "Debug" or "Release" at the top.

  3. Hit F5 to build. The output will be in the "bin/Release" or "bin/Debug" directory.

Building (Linux)

Open a terminal instance and put the following commands:

  1. sudo apt-get install mono-complete

  2. sudo apt-get install monodevelop

  3. Select "Debug" or "Release" at the top.

  4. Hit F5 to build. The output will be in the "bin/Release" or "bin/Debug" directory.

Building (macOS)

All the commands should be executed in terminal. All global package installs should be done only if not yet installed.

  1. Install Homebrew, a package manager for macOS: Follow instructions on https://brew.sh/

  2. Install Mono, a cross platform, open source .NET framework (https://www.mono-project.com/): brew install mono

  3. Install NuGet, a package manager for .NET (https://www.nuget.org/): brew install nuget

  4. Navigate to your ClassicUO root folder: cd /your/path/to/ClassicUO

  5. Restore required packages: nuget restore

  6. Build:

  • Debug version: msbuild /t:Rebuild
  • Release version: msbuild /t:Rebuild /p:Configuration=Release
  1. Start ClassicUO via Mono (to properly set up all required constants use provided bash script):
  • Debug version: ./bin/Debug/ClassicUO-mono.sh
  • Release version: ./bin/Release/ClassicUO-mono.sh

X. [Optional] If you want to run a debugger for .NET (in VS Code, for example), install .NET SDK: brew cask install dotnet-sdk

Contribute

Everyone is welcome to contribute! The GitHub issues and project tracker are kept up to date with tasks that need work.

Legal

The code itself has been written using the following projects as a reference:

This work is released under the GPLv3 license. This project does not distribute any copyrighted game assets. In order to run this client you'll need to legally obtain a copy of version 7.0.59.8 or earlier of the Ultima Online Classic Client.

Ultima Online(R) © 2019 Electronic Arts Inc. All Rights Reserved.

About

ClassicUO - an open source implementation of the Ultima Online Classic Client.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.7%
  • Other 0.3%