LEGO Universe server written in C#

The LEGO Group has not endorsed or authorized the operation of this game and is not liable for any safety issues in relation to its operation.

Feel free to join this development discord server https://discord.gg/7vxaZ2M, to communicate with other contributors.

Uchu is built with .NET Core 3.1 which is compatible with 64-bit versions Windows, Linux, and MacOS. Although Uchu can run on both Windows and MacOS it is highly recommended that you run it on Linux if passible.

Install .NET Core 3.1 SDK for your OS using the instructions found on https://dotnet.microsoft.com/download/dotnet-core/3.1.

Run dotnet tool install --global dotnet-ef in the terminal to install the interface that is required to build the database. You might have to remove old versions of the tool if you have used Uchu on .NET Core 3.0.

Uchu uses PostgresSQL as its database provider. If and when prompted to choose a password for the "postgres" user, choose "postgres" for ease of setup later on.

sudo apt update
sudo apt install postgresql postgresql-contrib

https://www.enterprisedb.com/downloads/postgres-postgresql-downloads#windows

https://postgresapp.com/

Uchu uses Redis as its Cache service provider. If you decide to skip this step, the server will fall back to the database for caching. The latest version of Redis is only nativly supported on Linux so setting it up on MacOS or Windows requires some workarounds.

sudo apt install redis-server

https://medium.com/@petehouston/install-and-config-redis-on-mac-os-x-via-homebrew-eb8df9a4f298

https://redislabs.com/blog/redis-on-windows-10/

Go to https://docs.google.com/document/d/1v9GB1gNwO0C81Rhd4imbaLN7z-R0zpK5sYJMbxPP3Kc/ and naviage to the "Client" section to download a LEGO Universe client. IMPORTANT! Download the unpacket client.

Uchu utilizes a client mod called TcpUdp to make the server/client connection more stable.

1. Downloaded "shim_dll.zip" at https://bitbucket.org/lcdr/raknet_shim_dll/downloads/.
2. Extract it into your LEGO Universe client directory.

The only publicly available LEGO Universe clients are for Windows. So you will need a compatibility layer if you are on a operation system which is not Windows.

1. Download and install WINE using the instructions on https://wiki.winehq.org/Download.
2. To run LEGO Universe, run WINEDLLOVERRIDES="dinput8.dll=n,b" wine ./legouniverse.exe using the terminal.

Although you can build and run Uchu using the command line, it is recommaned that you utilize an IDE to make your life just a little bit easier. Here are some recommendations.

The contributors of Uchu highly recommend JetBrains Rider, https://www.jetbrains.com/rider/, it is crossplatform and free if you are a student.

Visual Studio is a great IDE for Windows users and Visual Studio Code is a great crossplatform IDE https://visualstudio.microsoft.com/.

Some IDEs comes preinstalled with git version control but most do not. For having a smooth download experience, we recommend you download git as an independent program.

sudo apt install git

https://desktop.github.com/

git clone https://github.com/yuwui/Uchu.git
git checkout master

1. https://help.github.com/en/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop
2. Change your "Current Branch" to "master"

Before running Uchu for the first time, build it once to make sure it compiles. Navigate to the Uchu.Instance, Uchu.StandardScripts, and Uchu.Master directories and run dotnet build using the terminal.

Before we can configure the server, it needs to generate a config file.

1. Navigate to where you built the Uchu.Master project. This is commonly /bin/Debug/netcoreapp3.1, relative to the Uchu.Master path, but may differ.
2. Run dotnet ./Uchu.Master.dll. This will throw errors.
3. Close the process when it says it has generated a default config file.

Uchu is not a LEGO Universe repository and you will have to supply your own game resource files for the servers to work with.

1. Navigate to where you have LEGO Universe installed and enter the "/res" directory, copy the full path to it.
2. Find the "config.default.xml" file, duplicate it, rename the new copy to "config.xml". Open the new file.
3. Find where you see <GameResourceFolder></GameResourceFolder> and copy your LEGO Universe "/res" path inbetween the tags.

If you chose something else than "postgres" from your PostgresSQL password, put your password inbetween the <Password></Password> tags.

If your operating system does not allow you to host a server on any specific network port, or you run other services that might occupy any of the network ports used by Uchu, you must tell it to bind to diffect other network ports.

1. Open the config file and find the <Networking></Networking> section.
2. To rebind the character network port, add a xml element like this (for network port 40000), <CharacterPort>40000</CharacterPort>.
3. World servers will incremently bind to network 2003(+). This might not be feasible for when you have to port-forward for every world server. You can therefore add ANY NUMBER of xml element like this (for network port 20000), <WorldPort>20000</WorldPort>, to tell Uchu where it can bind world servers.

NOTE: If Uchu runs out of specified world ports, it will not be allowed to open additional world servers.

Make sure a PostgresSQL server is running and run dotnet ef database update -c UchuContext in the terminal to build the database form the Uchu.Core directory.

Make sure a Redis Cache server is running.

Finally after this long and tedius setup process, you are ready to run Uchu!

Navigate to the Uchu.Instance, Uchu.StandardScripts, and Uchu.Master directories and run dotnet build using the terminal.

Navigate to the output directory of Uchu.Master and run dotnet ./Uchu.Master.dll using the terminal.

In the Uchu.Master console, type /adduser (username) and press enter. You will than have to enter a password which will be displayed as stars (*), and when you are done, press enter.

Using your LEGO Universe client you may now login and play what parts of LEGO Universe Uchu has to offer :)

In the Uchu.Master console, type /gamemaster (username) 2. This will make your account an Admin and will give you access to a lot of commands. Type "/" using the ingame chat to have your options displayed to you.