Razor: An Ultima Online Assistant

Razor is a free tool designed to help with simple tasks while playing Ultima Online.

Community Edition (CE)

The goal of this project is to revive and continue development and maintenance of the abandoned Razor project, focusing on "quality of life" improvements while attempting to keep the spirit and vision the original developers had for Razor and not driving down the path of advanced automation and scripting that's found in other UO assistants.

It's recommended that you use the ClassicUO client with this version of Razor, however it should will work with the original 5.x and 7.x clients though support for any bugs may be limited.

Learn more about this version of Razor by exploring the links below.

• Home
• Download
• Release Notes
• Project History
• Help Overview
• Scripting Guide

Installation & Help

• Installing Razor on Windows
• Installing Razor on Linux

If you need more help, please go here and review the documentation and/or join Discord and ask there.

Razor Scripting Engine

Building From Source (Windows)

Razor uses native helper DLLs (Crypt.dll, Loader.dll, Platform.dll) when running with the original OSI/Classic client. If you launch Razor from a folder that does not contain these DLLs, you may see errors like DllNotFoundException: Unable to load DLL 'Crypt.dll'.

• Open Razor.sln (not just Razor.csproj) in Visual Studio
• Build Release|x86 (or Debug|x86)
• Run Razor.exe from bin\Win32\<Configuration>\ (the folder must contain the native DLLs)

Downloading A Build From Your Fork (GitHub Actions)

If you just want a ready-to-run ZIP from your own fork (without setting up Visual Studio locally):

• In your fork on GitHub, go to Actions → Build Dev Preview → Run workflow
• When the workflow completes, download the artifact Razor-dev-x86-preview (for the OSI classic client)
• Extract the ZIP to a user-writable folder (recommended: C:\\Razor\\)
• Run Razor.exe from the extracted folder and configure the UO data directory to your OSI install

Introduced in 1.6.4.2, Razor supports a command-based script language. For a comprehensive guide on the language and syntax, visit the Razor Scripting Guide.

Contributing & Code of Conduct

Please read CONTRIBUTING for more information on how to contribute to this project.

Please note we have a Code of Conduct, please follow it in all your interactions with this project.

License

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

See the LICENSE file for details.