Overview

• Machine Licenses are node-locked licenses which are installed to specific machines using a license code.

• They allow the licensed machine/s to run our plugin in Unreal Editor, Runtime or Packaged mode (all modes).

• They can be transfered between machines without restriction using our License Utility.

Managing your license/s on your Account page

On the Account Page of our website you can manage all your Machine Licenses:

1. All your licenses will appear in a list:

   

2. If you click the arrow to the left of each license it will open the license to show it's install/ de-install history:

   

3. You can also see on the right hand side of the row if the license is currently in use:

   

4. If you want to install that license to a machine just click the copy button and it will copy the license code to the clipboard for use in our installer or License Utility:

   

5. The Use Offline button is for installation to machines that will never be connected to the internet as part of the offline installation process using our License Utility:

   

6. If you have multiple machines associated with a single license code then you use the same code to license those machines:

   

7. If you no longer have access to the machine where the license was installed, you can use the Uninstall button to the right of the installed license information to clear the installation from our server:

   

Finding your license code

To install your license you need to have your license key ready from either your purchase email or your account page:

1. After purchasing, you will receive an email called Your Licence and Setup Instructions inside which you will find your License Key (valid for all machines you have purchased).

   

2. You can also find this license key in your account section under Licenses> Machine. Find the license you need and then click Copy Key to copy the code using your clipboard:

   

Finding our License Utility

1. You can find the License Utility either in the Utils folder of the Plugin or by clicking through from the Off World Live dropdown in Unreal Editor:

   1. In Unreal Editor open the OWL dropdown and click License Utility, it will automatically open:

      

   2. Alternatively, Find the plugin in your Engine or Project folder or alternatively download the Zip from the Downloads Center.

   3. Open the Plugin folder (unzipped) and find the Utils Folder:

      

   4. Open the folder and run the License Utility application:

      

Installing to an online machine

1. In the License Uility, click Install a License (Online), which is to install a license to a machine that is connected to the internet.

   

   1. Copy the License Key from the email or your Account page and then paste it into the box:

      

   2. The Utility will tell you that your installation has been successful:

      

2. Please close and reopen Unreal Engine to see the license take effect. The license initialises when Unreal opens…

3. Now when you open Unreal you should see green ticks in the Off World Live drop down for any licenses that you have installed:

   

Installing to a remote machine (via the command line)

You can manage your license installation from the command line using our License Utility:

1. The program owl-licensing-utility.exe can be found in the Utils directory of the Off World Live plugin.

2. All features in the License Utility can be accessed from the command line via Microsoft CMD, Powershell or another windows-based terminal interpreter.

3. Alternatively, these commands can be called from a scripting language such as Batch files, Powershell scripts etc

4. To see the full range of command line options use the following command:
   owl-licensing-utility.exe –help

5. To install a machine license, execute:
   owl-licensing-utility.exe install <license code>

6. To uninstall a machine license, execute:
   owl-licensing-utility.exe uninstall <license code>

7. To get a list of licenses installed on the current machine:
   owl-licensing-utility.exe all-licenses

8. If a command fails it will return a non-zero exit code, and in most cases an error message will be output. The last line of output will always be JSON with structured information about the error or response information for the request.

Installing to an offline machine

1. In the License Utility, select Install a License (Offline), to install a license to a machine that is not connected to the internet.

   

2. Copy the Use request code and paste into a file that you can add to a USB key/ drive to transfer it to the online machine:

   

3. On the Online Machine, input your USB drive and go to your account and select the license you want to use for your offline machine and click Use Offline in the far-right-hand of the page:

   

   1. In the box that opens, paste in the Request Code from Step 2:

      

   2. This generates the code that you need to license the offline machine. N.B. You will only generate this code once so please copy it or save it safely to a USB drive before closing the pop-up:

      

4. On the Offline Machine, input the USB drive, go to the License Utility application and paste the code into 'Paste Response Code':

   

5. You should now see the screen below which means that your offline machine has been successfully licensed:

   

6. Please close and reopen Unreal Engine to see the license take effect. The license initialises when Unreal opens.

7. Now when you open Unreal you should see green ticks in the Off World Live drop down for any licenses that you have installed:

   

Transfering a license to another machine

1. in the License Utility, select Machine Licenses:

   

2. From the list of licenses select the one you want to uninstall from the machine and click the - button:

   

3. Confirm that you want to uninstall the license:

   

4. Your license will disappear from your license list and so has been uninstalled:

   

5. Now you can follow the steps above to install the license to a new machine.

Uninstalling a license from a blocked machine

If you change the motherboard on your machine or alternatively you install your license to a machine which is taken out of service, you can uninstall your license from the Account Page of our website.

N.B. If you uninstall the license from our server, it will no longer work on the previous machine.

1. Select the license you want to uninstall and open the installation information using the concertina:

   

2. Click the Uninstall button and you will see the Used number change:

   

3. You can now use the license code to install the license to a new machine.

Trouble-shooting your license

Sometimes a Windows Update or change to your machine can affect your license. There are simple steps you can take to restore it.

1. Uninstalling and reinstalling your license is likely to work in 95% of cases. It's a highly simple process which takes 30 seconds using the License Utility.

2. If you are using a packaged project, check that Enable application licenses is unticked like in the image below, if it is ticked then the Machine license will not initiate.

   

3. If that doesn't work, then it's possible your license file has become corrupted in some way. In this case please:

   1. Click the Diagnostics section in the License Utility to see if there is an obvious cause of the issue with your license:

      

   2. Go to File Explorer and type %programdata%:

      

   3. Find the offworldlive folder and delete it:

      

   4. This will completely remove the license from your machine.

   5. Now go to your account page and uninstall your license from the server by clicking 'uninstall':

      

   6. Now reinstall your license using the License Utility.

   7. Close and reopen Unreal Engine.

   8. Your license should now work fine.

4. A final thing to check is if you have an issue with your Windows WMI which affects the fingerprint of your machine.

   1. Please follow these steps to check/ restore the integrity of your WMI.

   2. Now reinstall your license using the License Utility.

   3. Your license should now work fine.

5. If none of these things work please contact us and we can issue you with a new license.