ModernUO/README.md at a4104d07684f93a2d6807d0ba021f035afab9816

chore: drop the liburing prerequisite, which was never used (#2560 )

## Why

`IORingGroup` issues io_uring syscalls directly rather than linking `liburing`, so the package has
never been needed — but we ask operators to install it in the README, install it in CI, and check
for it in `build-tool`.

Verified against the **shipped** `IORingGroup` 1.0.9 assembly, not just the source:

| Symbol | Occurrences in `IORingGroup.dll` |
|---|---|
| `libc`, `libSystem.dylib`, `kernel32.dll`, `kernelbase.dll`, `ws2_32.dll` | present |
| `liburing` | **0** |
| `io_uring_queue_init` — liburing's entry point | **0** |
| `io_uring_setup` — the raw syscall | 1 |

If it linked liburing it would call `io_uring_queue_init` / `io_uring_submit`. It calls neither.

## What changes

Nine lines across three files, removing `liburing-dev` / `liburing-devel` from:

- `README.md` — both the dnf and apt prerequisite blocks
- `.github/workflows/build-test.yml` — both install steps
- `Projects/BuildTool/Prerequisites/NativeLibraryChecker.cs` — the cross-compile target text, the
  apt and dnf package lists, and the `ldconfig` fallback map

Nothing else is touched. `zstd` and the `-dev` packages are a separate discussion and a separate PR.

## Risk

None to the build. `liburing` was only ever installed, never linked or loaded — removing it cannot
change resolution behaviour. `build-tool` builds clean.

This was found while investigating why Linux requires `-dev` packages at all; that fix lives in the
binding packages (modernuo/LibDeflate.Bindings#4, modernuo/Argon2.Bindings#13) and lands separately
once those publish. This piece is independent and unblocked, hence its own PR.

2026-08-06 21:32:25 -07:00

8.7 KiB

Raw Blame History

Ultima Online Server Emulator for the modern era!

Requirements

Supported Operating Systems

Required Frameworks

All Operating Systems

Windows

Development

Supported IDEs

Getting Started

Install prerequisite requirements
Clone this repository (or download the latest):
- git clone https://github.com/modernuo/ModernUO.git
Open ModernUO.sln to start developing

Building/Publishing

Interactive Mode (Recommended for new users)

Run ./publish.cmd (Windows) or ./publish.sh (Linux/macOS) with no arguments to launch the guided build tool. It will:

Check prerequisites (.NET SDK, native libraries)
Walk you through configuration and platform selection
Build and publish the server to the Distribution directory
Show deployment instructions for cross-compiled builds

Command Line

./publish.cmd [release|debug] [os] [arch]

os - Supported operating systems
- win - Windows
- osx - macOS
- linux - Linux
arch
- x64 - Intel/AMD 64-bit
- arm64 - ARM 64-bit

Linux Prerequisites

Fedora, CentOS, RHEL, AlmaLinux, Rocky, etc

dnf upgrade --refresh -y
# RHEL-family distributions (CentOS Stream, AlmaLinux, Rocky, RHEL) need CRB and EPEL enabled.
# Fedora skips this block.
dnf install -y dnf-plugins-core
dnf config-manager --set-enabled crb
dnf install -y epel-release
# Prerequisites
dnf install -y findutils libicu libdeflate-devel zstd libargon2-devel

Ubuntu, Debian, etc

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

OSX Requirements

brew install icu4c libdeflate zstd argon2

Running the Server

Follow the publish instructions
The Distribution directory is portable — copy it to your production server for deployment
Run ModernUO.exe or dotnet ModernUO.dll from the Distribution directory
On first run, the server will prompt you to configure game data file locations

Troubleshooting / FAQ

See FAQ

Thank you for supporting us! You can find out how by visiting the sponsors page.

Collaborators

Thanks

RunUO Team & Community
Voxpire, the ServUO Team & Community
Karasho, Jaedan and the ClassicUO Community

Development Tools & Plugins provided with ♥ by

Code Signing Policy

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it

Teams & Roles

Approvers & Committers: Development Team

8.7 KiB Raw Blame History

ModernUO