ec4d6a7a85
## Summary Replaces the basic `publish.cmd`/`publish.sh` scripts with an interactive **BuildTool** — a C# console app using [Spectre.Console](https://spectreconsole.net/) that guides users through publishing, prerequisite checking, and cross-compilation. ### Why The community found the existing publish scripts unhelpful for newcomers. They worked but didn't walk users through the process, didn't check prerequisites, and provided no feedback when things went wrong. ### What's New **Interactive BuildTool** (`Projects/BuildTool/`) - NativeAOT-compiled C# console app with true-color ASCII logo and ModernUO brand gold/silver palette - Guided publish wizard with step-by-step back navigation (Ctrl+C or menu "Back" to go to previous step) - Prerequisite checking: .NET SDK version, VC++ Redistributable (Windows), native libraries (Linux/macOS) - .NET SDK auto-install offer via Microsoft's official install scripts - Platform detection: Windows 10 vs 11 (build number), macOS codenames, Linux distro + kernel version - Cross-compilation support: skips native library checks, shows target prerequisites after build - Non-interactive mode for CI: `--config Release --skip-prereqs` - Backward-compatible positional args: `publish.cmd release win x64` still works **Shell Wrappers** (`publish.cmd`, `publish.ps1`, `publish.sh`) - Try native BuildTool binary first (downloaded from GitHub Releases) - Fall back to `dotnet run --project Projects/BuildTool` if unavailable - SDK bootstrapping: offer to install .NET if not found **CI/CD Updates** - Build/test workflows target `Projects/Application/Application.csproj` instead of the solution (excludes BuildTool and test projects from publish) - New `build-tool-release.yml` workflow builds NativeAOT binaries for win-x64, win-arm64, osx-arm64, linux-x64, linux-arm64 - Minimum SDK bumped to 10.0.201 (required for Serialization Generator 2.14.3 / Roslyn 5.3.0) **Other Changes** - Solution converted from `.sln` to `.slnx` - Updated README with interactive mode instructions and deployment guidance ## Screenshots <img width="320" height="378" alt="image" src="https://github.com/user-attachments/assets/83c057c5-3992-4dbd-99fa-0e3c24ef6428" /> <img width="749" height="554" alt="image" src="https://github.com/user-attachments/assets/e4ee4d6f-71d4-47f9-86b6-8fd1ca3c3e7a" />
122 lines
8 KiB
Markdown
122 lines
8 KiB
Markdown
<p align="center">
|
|
<a href="https://muo.gg"><img alt="ModernUO - Ultima Online Server Emulator for the modern era!" src="https://cdn.muo.gg/gh/muo-logo.svg" width=128px /></a>
|
|
</p>
|
|
|
|
ModernUO [](https://muo.gg/discord) [](https://muo.gg/reddit/) [](https://muo.gg/twitter)
|
|
=====
|
|
|
|
##### Ultima Online Server Emulator for the modern era!
|
|
[](https://github.com/modernuo/ModernUO/blob/master/LICENSE)
|
|
[](https://github.com/modernuo/ModernUO/stargazers)
|
|
[](https://github.com/modernuo/ModernUO/issues)
|
|
<br/>
|
|
[](https://github.com/modernuo/ModernUO/actions)
|
|
[](https://dev.azure.com/modernuo/modernuo/_build/latest?definitionId=1&branchName=main)
|
|
|
|
## Requirements
|
|
#### Supported Operating Systems
|
|
[](https://www.microsoft.com/en-US/evalcenter/evaluate-windows-server-2022)
|
|
|
|
[](https://www.debian.org/distrib/)
|
|
[](https://ubuntu.com/download/server)
|
|
<br/>
|
|
[](https://alpinelinux.org/downloads/)
|
|
[](https://getfedora.org/en/server/download/)
|
|
[](https://access.redhat.com/downloads)
|
|
[](https://www.centos.org/download/)
|
|
[](https://get.opensuse.org/)
|
|
[](https://www.suse.com/download/sles/)
|
|
[](https://linuxmint.com/download.php)
|
|
[](https://archlinux.org/download/)
|
|
|
|
#### Required Frameworks
|
|
##### All Operating Systems
|
|
[](https://dotnet.microsoft.com/download/dotnet/10.0)
|
|
|
|
##### Windows
|
|
[](https://aka.ms/vc14/vc_redist.x64.exe)
|
|
|
|
#### Development
|
|
[](https://git-scm.com/downloads)
|
|
[](https://dotnet.microsoft.com/download/dotnet/10.0)
|
|
|
|
#### Supported IDEs
|
|
<p align="left">
|
|
<a href="https://www.jetbrains.com/rider/download"><img height="64" title="Jetbrains Rider 2025.3+" alt="Jetbrains Rider 2025.3+" src="https://cdn.muo.gg/gh/jetbrains-rider.svg"></a>
|
|
<a href="#"><img alt="space" width="32" src="https://cdn.muo.gg/gh/space.png"></a>
|
|
<a href="https://code.visualstudio.com/download"><img height="64" title="VSCode" alt="VSCode" src="https://cdn.muo.gg/gh/vscode.svg"></a>
|
|
<a href="#"><img alt="space" width="32" src="https://cdn.muo.gg/gh/space.png"></a>
|
|
<a href="https://visualstudio.microsoft.com/vs/community/"><img height="64" title="Visual Studio 2026" alt="Visual Studio 2026" src="https://cdn.muo.gg/gh/vs2026.svg"></a>
|
|
</p>
|
|
|
|
## Getting Started
|
|
- Install prerequisite [requirements](https://github.com/modernuo/ModernUO#requirements)
|
|
- Clone this repository (or download the [latest](https://github.com/modernuo/ModernUO/archive/refs/heads/main.zip)):
|
|
- `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
|
|
```shell
|
|
./publish.cmd [release|debug] [os] [arch]
|
|
```
|
|
- `os` - [Supported operating systems](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md)
|
|
- `win` - [Windows](https://learn.microsoft.com/en-us/dotnet/core/install/windows)
|
|
- `osx` - [macOS](https://learn.microsoft.com/en-us/dotnet/core/install/macos)
|
|
- `linux` - [Linux](https://learn.microsoft.com/en-us/dotnet/core/install/linux)
|
|
- `arch`
|
|
- `x64` - Intel/AMD 64-bit
|
|
- `arm64` - ARM 64-bit
|
|
|
|
## Linux Prerequisites
|
|
### Fedora, CentOS, RHEL, etc
|
|
```shell
|
|
dnf upgrade --refresh -y
|
|
# CentOS does not come with EPEL enabled
|
|
dnf install -y epel-release epel-next-release
|
|
dnf install -y findutils libicu libdeflate-devel zstd libargon2-devel liburing-devel
|
|
```
|
|
|
|
### Ubuntu, Debian, etc
|
|
```shell
|
|
apt-get update -y
|
|
apt-get install -y libicu-dev libdeflate-dev zstd libargon2-dev liburing-dev
|
|
```
|
|
|
|
## OSX Requirements
|
|
```shell
|
|
brew install icu4c libdeflate zstd argon2
|
|
```
|
|
|
|
## Running the Server
|
|
- Follow the [publish](https://github.com/modernuo/ModernUO#buildingpublishing) 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](./FAQ.md)
|
|
|
|
## Want to sponsor?
|
|
Thank you for supporting us! You can find out how by visiting the [sponsors](./SPONSORS.md) page.
|
|
|
|
## Collaborators
|
|
[](https://github.com/kamronbatman)
|
|
[](https://github.com/mark1145)
|
|
|
|
## Thanks
|
|
- RunUO Team & Community
|
|
- [Voxpire](https://github.com/Voxpire), the ServUO Team & Community
|
|
- [Karasho](https://github.com/andreakarasho), [Jaedan](https://github.com/jaedan) and the ClassicUO Community
|
|
|
|
<br/><br/>
|
|
<p align=center>Development Tools & Plugins provided with ♥ by<br/><br/><a href="https://www.jetbrains.com/?from=ModernUO"><img src="https://cdn.muo.gg/gh/jetbrains.svg" height="64px" alt="JetBrains" title="JetBrains" /></a><br/>
|
|
<a href="https://material-theme.com/"><img src="https://github.com/AtomMaterialUI/material-theme-issues/raw/master/logo.svg" width="64px" alt="Material Theme" title="Material Theme"></a></p>
|