Darkflame Universe
Introduction
Darkflame Universe (DLU) is a server emulator for LEGO® Universe. Development started in 2013 and has gone through multiple iterations and is now able to present a near perfect emulation of the game server.
LEGO® Universe
Developed by NetDevil and The LEGO Group, LEGO® Universe launched in October 2010 and ceased operation in January 2012.
License
Darkflame Universe is licensed under AGPLv3, please read LICENSE. Some important points:
- We are not liable for anything you do with the code
- The code comes without any warranty what so ever
- You must disclose any changes you make to the code when you distribute it
- Hosting a server for others counts as distribution
Disclaimers
Setup difficulty
Throughout the entire build and setup process a level of familiarity with the command line and preferably a Unix-like development environment is greatly advantageous.
Hosting a server
We do not recommend hosting public servers. DLU is intended for small scale deployment, for example within a group of friends. It has not been tested for large scale deployment which comes with additional security risks.
Supply of resource files
Darkflame Universe is a server emulator and does not distribute any LEGO® Universe files. A separate game client is required to setup this server emulator and play the game, which we cannot supply. Users are strongly suggested to refer to the safe checksums listed in the resources tab below when checking if a client will work.
Build
Development of the latest iteration of Darkflame Universe has been done primarily in a Unix-like environment and is where it has been tested and designed for deployment. It is therefore highly recommended that Darkflame Universe be built and deployed using a Unix-like environment for the most streamlined experience.
Prerequisites
Clone the repository
git clone --recursive https://github.com/DarkflameUniverse/DarkflameServer
Python
Some tools utilized to streamline the setup process require Python 3, make sure you have it installed.
Choosing the right version for your client DLU clients identify themselves using a higher version number than the regular live clients out there. This was done make sure that older and incomplete clients wouldn't produce false positive bug reports for us, and because we made bug fixes and new content for the client.
If you're using a DLU client, then you don't need to change anything. But if you're using any other client, you'll have to go into the "CMakeVariables.txt" file and change it to match your client's version. (likely 171022)
Linux builds
Make sure packages like gcc, cmake, and zlib are installed. Depending on the distribution, these packages might already be installed. Note that on systems like Ubuntu, you will need the zlib1g-dev package so that the header files are available.
Build the repository
# Create the build directory, preserving it if it already exists
mkdir -p build
cd build
# Run CMake to generate make files
cmake ..
# Run make to build the project. To build utilizing multiple cores, append `-j` and the amount of cores to utilize, for example `make -j8`
make
MacOS builds
Download precompiled MySQL connector
# Install required tools
brew install boost mysql-connector-c++
# Symlinks for finding the required modules
sudo ln -s /usr/local/mysql-connector-c++/lib64/libmysqlcppconn.dylib /usr/local/mysql-connector-c++/lib64/libmysql.dylib
sudo ln -s /usr/local/mysql-connector-c++/lib64/libcrypto.1.1.dylib /usr/local/mysql/lib/libcrypto.1.1.dylib
Then follow the Linux build steps (gcc is not required), but before running make, run the following to make sure all the libs are available in the build folder:
sudo ln -s /usr/local/mysql-connector-c++/lib64/libssl.1.1.dylib /path/to/build/folder/libssl.1.1.dylib
sudo ln -s /usr/local/mysql-connector-c++/lib64/libcrypto.1.1.dylib /path/to/build/folder/libcrypto.1.1.dylib
Windows builds (native)
Ensure that you have either the MSVC or the Clang (recommended) compiler installed. You will also need to install CMake.
Build the repository
:: Create the build directory
mkdir build
cd build
:: Run CMake to generate make files
cmake ..
:: Run CMake with build flag to build
cmake --build .
Windows builds (WSL)
This section will go through how to install WSL and building in a Linux environment under Windows. WSL requires Windows 10 version 2004 and higher (Build 19041 and higher) or Windows 11.
Open the Command Prompt application with Administrator permissions and run the following:
# Installing Windows Subsystem for Linux
wsl --install
Open the Ubuntu application and run the following:
# Make sure the install is up to date
apt update && apt upgrade
# Make sure the gcc, cmake, and build-essentials are installed
sudo apt install gcc
sudo apt install cmake
sudo apt install build-essential
Setting up the environment
Database
Darkflame Universe utilizes a MySQL/MariaDB database for account and character information.
Initial setup can vary drastically based on which operating system or distribution you are running; there are instructions out there for most setups, follow those and come back here when you have a database up and running.
- Create a database for Darkflame Universe to use
- Run each SQL file in the order at which they appear here on the database
Resources
LEGO® Universe 1.10.64
This repository does not distribute any LEGO® Universe files. A full install of LEGO® Universe version 1.10.64 (latest) is required to finish setting up Darkflame Universe.
Known good SHA256 checksums of the client:
8f6c7e84eca3bab93232132a88c4ae6f8367227d7eafeaa0ef9c40e86c14edf5(packed client, rar compressed)c1531bf9401426042e8bab2de04ba1b723042dc01d9907c2635033d417de9e05(packed client, includes extra locales, rar compressed)0d862f71eedcadc4494c4358261669721b40b2131101cbd6ef476c5a6ec6775b(unpacked client, includes extra locales, rar compressed)
Known good SHA1 checksum of the DLU client:
91498e09b83ce69f46baf9e521d48f23fe502985(packed client, zip compressed)
How to generate a SHA256 checksum:
# Replace <file> with the file path to the client
# If on Linux or MacOS
shasum -a 256 <file>
# If on Windows
certutil -hashfile <file> SHA256
Unpacking the client
- Clone lcdr's utilities repository here
- Use
pkextractor.pywto unpack the client files if they are not already unpacked
Setup resource directory
- In the
builddirectory create aresdirectory if it does not already exist. - Copy over or create symlinks from
macros,BrickModels,chatplus_en_us.txt,names, andmapsin your clientresdirectory to the serverbuild/resdirectory - Unzip the navmeshes here and place them in
build/res/maps/navmeshes
Setup locale
- In the
builddirectory create alocaledirectory if it does not already exist - Copy over or create symlinks from
locale.xmlin your clientlocaledirectory to thebuild/localedirectory
Client database
- Use
fdb_to_sqlite.pyin lcdr's utilities onres/cdclient.fdbin the unpacked client to convert the client database tocdclient.sqlite - Move and rename
cdclient.sqliteintobuild/res/CDServer.sqlite - Run each SQL file in the order at which they appear here on the SQLite database
Configuration
After the server has been built there should be four ini files in the build director: authconfig.ini, chatconfig.ini, masterconfig.ini, and worldconfig.ini. Go through them and fill in the database credentials and configure other settings if necessary.
Verify
Your build directory should now look like this:
- AuthServer
- ChatServer
- MasterServer
- WorldServer
- authconfig.ini
- chatconfig.ini
- masterconfig.ini
- worldconfig.ini
- locale/
- locale.xml
- res/
- CDServer.sqlite
- chatplus_en_us.txt
- macros/
- ...
- BrickModels/
- ...
- maps/
- navmeshes/
- ...
- ...
- navmeshes/
- ...
Running the server
If everything has been configured correctly you should now be able to run the MasterServer binary. Darkflame Universe utilizes port numbers under 1024, so under Linux you either have to give the binary network permissions or run it under sudo.
First admin user
Run MasterServer -a to get prompted to create an admin account. This method is only intended for the system administrator as a means to get started, do NOT use this method to create accounts for other users!
Account Manager
Follow the instructions here to setup the DLU account management Python web application. This is the intended way for users to create accounts.
Admin levels
The admin level, or game master level, is specified in the accounts.gm_level column in the MySQL database. Normal players should have this set to 0, which comes with no special privileges. The system administrator will have this set to 9, which comes will all privileges. Admin level 8 should be used to give a player a majority of privileges without the safety critical once.
While a character has a gmlevel of anything but 0, some gameplay behavior will change. When testing gameplay, you should always use a character with a gmlevel of 0.
User guide
A few modifications have to be made to the client.
Client configuration
To connect to a server follow these steps:
- In the client directory, locate
boot.cfg - Open it in a text editor and locate where it says
AUTHSERVERIP=0: - Replace the contents after to
:and the following,with what you configured as the server's public facing IP. For exampleAUTHSERVERIP=0:localhostfor locally hosted servers - Launch
legouniverse.exe, throughwineif on a Unix-like operating system
Survival
The client script for the survival minigame has a bug in it which can cause the minigame to not load. To fix this, follow these instructions:
- Open
res/scripts/ai/minigame/survival/l_zone_survival_client.lua - Navigate to line
617 - Change
PlayerReady(self)toonPlayerReady(self) - Save the file, overriding readonly mode if required
Brick-By-Brick building
Brick-By-Brick building requires PATCHSERVERIP=0: in the boot.cfg to point to a HTTP server which always returns HTTP 404 - Not Found for all requests. This can be achieved by pointing it to localhost while having sudo python -m http.server 80 running in the background.
In-game commands
Here is a summary of the commands available in-game. All commands are prefixed by / and typed in the in-game chat window. Some commands requires admin privileges. Operands within <> are required, operands within () are not. For the full list of in-game commands, please checkout the source file.
| Command | Usage | Description | Admin Level Requirement |
|---|---|---|---|
| info | /info | Displays server info to the user, including where to find the server's source code. | |
| credits | /credits | Displays the names of the people behind Darkflame Universe. | |
| instance-info | /instance-info | Displays in the chat the current zone, clone, and instance id. | |
| gmlevel | /gmlevel <level> | Within the authorized range of levels for the current account, changes the character's game master level to the specified value. This is required to use certain commands. | |
| testmap | /testmap <zone> (clone-id) | Transfers you to the given zone by id and clone id. | 1 |
| ban | /ban <username> | Bans a user from the server. | 4 |
| gmadditem | /gmadditem <id> (count) | Adds the given item to your inventory by id. | 8 |
| spawn | /spawn <id> | Spawns an object at your location by id. | 8 |
| metrics | /metrics | Prints some information about the server's performance. | 8 |
Credits
Contributors to DLUv3
- DarwinAnim8or
- Wincent01
- Mick
- averysumner
- Jon002
- Jonny
- Xiphoseer
Research and tools
- lcdr
Community management
- Neal
Former contributors
- TheMachine
- Matthew
- Raine
- Bricknave
Special thanks
- humanoid24
- pwjones1969
- BlasterBuilder for the logo
- ALL OF THE NETDEVIL AND LEGO TEAMS!
4.9k Jan 2, 2023
4 Dec 15, 2022
924 Dec 27, 2022
383 Dec 31, 2022
428 Jan 9, 2023
104 Dec 28, 2022
3 Jun 7, 2022
203 Dec 20, 2022
1 Oct 25, 2021
1 Nov 15, 2022
1 Nov 11, 2021
15 Dec 12, 2022
3 Jan 23, 2022
2.3k Jan 2, 2023
22 Dec 21, 2022
174 Dec 27, 2022
6 Oct 24, 2022
2 Dec 23, 2021
1 Feb 7, 2022