Windows

Client Support

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

When using ClassicUO, some features in Razor are disabled since they either won't work and/or may cause conflicts with ClassicUO.

Install: Razor and ClassicUO

First, we need to download and install ClassicUO.

1. Download the ClassicUO Launcher and extract the .zip file to any location of your choosing (ie: C:\CUOLauncher)
2. Run ClassicUOLauncher.exe
3. When ClassicUOLauncher.exe opens, it will automatically download the latest version of ClassicUO and install it in a sub-folder called ClassicUO in the folder you extracted the launcher (ie: C:\CUOLauncher\ClassicUO). This process should only takes a few seconds.
4. Setup a profile to connect to your shard by clicking Edit Profiles
5. On the Profile tab click Add
   • Give your profile a name
   • Enter your username and password if you'd like it to be saved
   • Enter the server IP and port number of the shard you're connecting to
   • Enter (or search for) the path to your UO files. These are the actual game files for the shard you're connecting to
   • Enter the client version number if it isn't auto-detected

Example of a completed profile:

Now, we need to install Razor.

1. Download the latest version of Razor and extract the .zip file to C:\CUOLauncher\ClassicUO\Data\Plugins\Razor (replacing C:\CUOLauncher with the location you selected above if you picked something different)

   Hint

   If the Data and/or Plugins folders don't exist (most likely scenario on a new install) you can just create them first.

2. In the ClassicUO Launcher, go to the Plugins tab and click Add

3. Browse to the \Data\Plugins\Razor folder and select Razor.exe

   

4. Click Save Profile and then Back

5. Select your profile and click Launch

If everything was setup correctly, you should see ClassicUO along with Razor open.

Advanced: settings.json

If you would like to configure ClassicUO and Razor without the launcher, create a file called settings.json and copy/paste this template into it and change the following values: ip, port, ultimaonlinedirectory, clientversion, plugins

{
  username: "",
  password: "",
  ip: "login.myshard.com",
  port: 2593,
  ultimaonlinedirectory: "C:/Path/To/UO/Files",
  clientversion: "5.0.8.3",
  lastcharactername: "",
  cliloc: "Cliloc.enu",
  lastservernum: 1,
  fps: 60,
  window_position: null,
  window_size: null,
  is_win_maximized: true,
  saveaccount: false,
  autologin: false,
  reconnect: false,
  reconnect_time: 30,
  login_music: true,
  login_music_volume: 30,
  shard_type: 0,
  fixed_time_step: true,
  run_mouse_in_separate_thread: true,
  force_driver: 0,
  use_verdata: false,
  encryption: 0,
  plugins: [
  "C:/Path/To/Razor/Razor.exe"
  ]
}

Update: Razor and ClassicUO

These steps assume that you already have obtained and installed the Ultima Online game asset files in the local system and are already using ClassicUO.

• Download the latest release of Razor.

  Warning

  Windows will sometimes block .dll and .exe files from being ran after they're downloaded so you may have to open up a Powershell prompt from within the Razor folder and run gci | Unblock-File

• Extract the .zip into your existing Razor location (ie: C:\CUOLauncher\ClassicUO\Data\Plugins\Razor), overwriting all files, with the exception of one file:

  • counters.xml - This is the default counters file used to display items in your titlebar. If you've added any new counters, they would be lost if overwritten.
• Open ClassicUO back up and verify Razor is running the version you upgraded to.

Standard OSI Client

The upgrade steps above should also work if you're using the standard OSI client, follow these steps.

• Right-click on the Razor shortcut or Razor.exe, go to Properties. On the Compatibility tab, select Run this program in compatibility mode for and select Windows XP SP2. Also select Run this program as an administrator
• Run Razor either via the shortcut or clicking the Razor.exe directly.
• Razor should prompt to Run As Administrator. You must allow this for Razor to function correctly.

Welcome Screen (OSI Client Only)

ClassicUO Users

If you're using ClassicUO, you should never see this screen. If you're trying to open ClassicUO and see this screen, click Quit and launch ClassicUO.

The first time you run Razor, it will open with a Welcome Screen and give you an option to import your exising

Browse to your client.exe that you want to run along with Razor. Set the UO Data Directory (most likely the same path as your client.exe). Either use the pre-configured servers or enter your own server in the list here.

You can also edit Razor.exe.Config and add your own servers or just enter the server name and port in this format: server.name.com,port

Click OK to open Razor and Ultima Online.

Configuration File

The Welcome Screen will control some of these settings, but some settings can only be changed by editing .\Razor.exe.config.

<appSettings>
    <add key="PatchEncy" value="1" /> <!-- Patch client encryption -->
    <add key="ServerEnc" value="0" /> <!-- Use OSI encryption -->
    <add key="MaxOrganizerAgents" value="20" /> <!-- Override the default Organizer agent count -->
    <add key="MaxBuyAgents" value="10" /> <!-- Override the default Buy agent count -->
    <add key="MaxRestockAgents" value="10" /> <!-- Override the default Restock agent count -->
    <add key="ImportProfilesAndMacros" value="false" />  <!-- If true, will import macros and profiles from %AppData%\Razor -->
    <add key="LastProfile" value="Test" /> <!-- Last profile used in Razor -->
    <add key="LastServer" value="test.server.com" /> <!-- Last server connected to in Razor -->
    <add key="LastPort" value="2597" /> <!-- Last server port connected to in Razor -->
    <add key="LastServerId" value="1" /> <!-- Index of the server selected in the dropdown -->
    <add key="ShowWelcome" value="1" /> <!-- Show the Welcome Screen when loading Razor -->
    <add key="UOClient" value="D:\Games\UO\client.exe" /> <!-- Location to Ultima Online client -->
    <add key="UODataDir" value="D:\Games\UO" /> <!-- Location to Ultima Online data directory -->
</appSettings>

<!-- You can define a list of servers here by adding values between <Servers></Servers> -->
<Servers>
    <add key="Custom Server" value="server.someserver.com,2593" />
</Servers>

---

Last update: 2022-01-13