Difference between revisions of "Installation Instructions"

From Legends of Aria Admin and Modding Wiki
Jump to: navigation, search
m (Cluster Web Launcher (Multi Region Server))
m (Self Hosted Cluster Python Launcher (Multi Region Server))
Line 32: Line 32:
  
 
# Download and extract the server build that includes the cluster server. <br>A link to the latest server build can be found in the "'''LoA Worlds'''" Discord, in the channel '''#download-links''' <br> (Outdated version of the server build: http://adminwiki.legendsofaria.com/downloads/9jde033q/PublicServer-1.4.0.2.zip)
 
# Download and extract the server build that includes the cluster server. <br>A link to the latest server build can be found in the "'''LoA Worlds'''" Discord, in the channel '''#download-links''' <br> (Outdated version of the server build: http://adminwiki.legendsofaria.com/downloads/9jde033q/PublicServer-1.4.0.2.zip)
# Put '''Server Access Code''' (This is the long key found on the dashboard) and ''Cluster ID'' (This is your User Id from the dashboard in the format XX-XXXX) into the '''ClusterConfig.xml'''
+
# Put '''Server Access Code''' (This is the long key found on the dashboard) and '''Cluster ID''' (This is your User Id from the dashboard in the format XX-XXXX) into the '''ClusterConfig.xml'''
# Add an entry into the '''AccessList.xml''' for your User ID and make sure you add the RegionAdmin True line. (see below) <pre><AccessList> &#10;    <Entry>&#10;          <UserId>00-0000</UserId>&#10;          <AccessLevel>God</AccessLevel>&#10;          <RegionAdmin>True</RegionAdmin>&#10;          <Name>YOUR NAME</Name>&#10;    </Entry>&#10;</AccessList></pre>
+
# Add an entry into the '''AccessList.xml''' for your User ID and make sure you add the '''RegionAdmin True''' line. (see below) <pre><AccessList> &#10;    <Entry>&#10;          <UserId>00-0000</UserId>&#10;          <AccessLevel>God</AccessLevel>&#10;          <RegionAdmin>True</RegionAdmin>&#10;          <Name>YOUR NAME</Name>&#10;    </Entry>&#10;</AccessList></pre>
 
# Run the application "'''launch.exe'''" through its shortcut "'''Cluster Launcher'''".
 
# Run the application "'''launch.exe'''" through its shortcut "'''Cluster Launcher'''".
 
# Start the cluster first, then start your regions.
 
# Start the cluster first, then start your regions.

Revision as of 13:05, 16 June 2022

Currently only support for Windows will be provided. Running the server on other systems is planned but with no ETA.

See Official_Tutorial_Videos for a video setup guide

  1. Extract the server installation package to a folder you have write permissions to. Don't put it in program files. (Download link is in Private Admin Forum)
  2. NOTE: Latest versions of NODE will error when starting up the server. Use Node 10 (https://nodejs.org/dist/latest-v10.x/)
  3. NOTE: You may need to install .NET 4.5 runtime and the 2017 Microsoft x64 C++ runtime (https://aka.ms/vs/15/release/vc_redist.x64.exe) if not already present on your system.
  4. NOTE: You may also need to install the 64bit 2013 C++ runtime depending on your OS. (https://download.microsoft.com/download/2/E/6/2E61CFA4-993B-4DD4-91DA-3737CD5CD6E3/vcredist_x64.exe)

Networking Setup

  1. You will want to open up and forward if necessary UDP ports 3000-3100 in general. (Range is dependent on your server index, but starts typically at 3000+)
  2. You'll likewise want to make sure you have a firewall rule allowing this traffic in case you are running a firewall, or have the Windows OS default one enabled.

Standalone Shard (Single Region Server)

  1. Edit the ClusterConfig.xml file for your setup. READ THE comments in the config file explaining each option.
  2. Add an entry in the AccessList.xml for you user id to grant you god access
  3. Run the game using the "Shard Server" shortcut or StandaloneServerLauncher.exe. If you have issues with the shortcut, create your own running Build/ShardServer.exe with the main folder as the working directory.
  4. To connect to your server, enter the IP address you used in you the ServerAddresss field of your ClusterConfig.xml.

Troubleshooting:

  • If you see "globals.lua import failed: error loading module 'LuaXML_lib' from file './Build/base\luatools\x64\LuaXML_lib.dll'", make sure you are running StandaloneServerLauncher.exe as administrator.

Cluster Web Launcher (Multi Region Server)

  1. To get started with clusters, you'll need to use Web Launcher. See the Web Launcher Quick Start Guide for details.

GENERAL WARNING​: The Web Launcher currently seems to be flawed: even if you have set up your cluster server correctly, the Web Launcher might not recognize your cluster server (status as per June 2022)

MODDER WARNING​: Mixing different mods on different regions can have unpredictable results so make sure all the regions are running the exact same mod files!

Self Hosted Cluster Python Launcher (Multi Region Server)

  1. Download and extract the server build that includes the cluster server.
    A link to the latest server build can be found in the "LoA Worlds" Discord, in the channel #download-links
    (Outdated version of the server build: http://adminwiki.legendsofaria.com/downloads/9jde033q/PublicServer-1.4.0.2.zip)
  2. Put Server Access Code (This is the long key found on the dashboard) and Cluster ID (This is your User Id from the dashboard in the format XX-XXXX) into the ClusterConfig.xml
  3. Add an entry into the AccessList.xml for your User ID and make sure you add the RegionAdmin True line. (see below)
    <AccessList>	
         <Entry>
              <UserId>00-0000</UserId>
              <AccessLevel>God</AccessLevel>
              <RegionAdmin>True</RegionAdmin>
              <Name>YOUR NAME</Name>
         </Entry>
    </AccessList>
  4. Run the application "launch.exe" through its shortcut "Cluster Launcher".
  5. Start the cluster first, then start your regions.