1. Getting Started

Welcome! 🎉
This guide will help you get your first ModernUO server up and running quickly.

ModernUO is designed to be easy to set up and run across Windows, Linux, and macOS, using the latest .NET technologies.

---

✨ Requirements

Before you start, make sure you have the following installed:

🔹 All Operating Systems

• .NET 10.0 SDK

🔹 Windows (only)

https://github.com/modernuo/ModernUO/wiki/_new

• Visual C++ Redistributable v14

---

🚀 Setting Up ModernUO

Follow these simple steps to get started:

1. Download ModernUO

You can either:

• Clone the repository:

  git clone https://github.com/modernuo/ModernUO.git

• Or download the latest version as a ZIP file: Download Latest

2. Open the Project

Open ModernUO.sln with your favorite C# IDE, such as:

• Visual Studio 2026+
• JetBrains Rider 2025.3+
• VS Code (with C# extensions)

You're now ready to start developing and customizing your shard!

---

🛠️ Building and Publishing

To publish a ready-to-run server build, run:

./publish.cmd [release|debug (default: release)] [os] [arch (default: x64)]

Parameters

• release|debug: Choose build type (default is debug)
• os: Target operating system
  • win — Windows 10/11/Server 2016/2019/2022/2025
  • osx — macOS 14/15/26 (Sonoma, Sequoia, Tahoe)
  • linux — Linux distributions
• arch: Target architecture
  • x64 — Intel/AMD 64-bit
  • arm64 — ARM 64-bit (Note: Windows ARM64 not supported)

This will create a Distribution directory containing the server binaries.

---

🐧 Linux Users: Install Prerequisites

Make sure the following libraries are installed before running ModernUO:

Fedora, CentOS, RHEL, etc.

sudo dnf upgrade --refresh -y
sudo dnf install -y epel-release epel-next-release
sudo dnf install -y findutils libicu libdeflate-devel zstd libargon2-devel

Ubuntu, Debian, etc.

sudo apt-get update -y
sudo apt-get install -y libicu-dev libdeflate-dev zstd libargon2-dev

---

🍎 macOS Users: Install Prerequisites

Use Homebrew to install the required libraries:

brew install icu4c libdeflate zstd argon2

---

🏃‍♂️ Running the Server

After publishing, running the server is simple:

• Navigate to the Distribution folder
• Run the server with:

  ./ModernUO.exe

  — or —

  dotnet ModernUO.dll

You're now officially running ModernUO! 🎉

---

➡️ Next Step

👉 Once your server is running, head over to Configuration to learn how to customize and fine-tune your server settings!