Create a Discord Application

View the Official Guide on how to create a Discord Application

*Please note that this Discord Bot does not require any special intents

Invite the bot to your server with the following link: https://discord.com/api/oauth2/authorize?client_id={YOUR_BOTS_ID}&permissions=242666032192&scope=applications.commands%20bot
Have a LEGO Universe client

You are not required to be hosting a LEGO Universe server to host this bot

All you are required is to have the locale.xml and the cdclient.sqlite files

The locale.xml can be found at PATH_TO_LU_CLIENT\client\locale\locale.xml

The cdclient.sqlite is not found in the client. You must create it from the cdclient.fdb which is found in unpacked clients.

If you are using a packed client, you can unpack just the cdclient.fdb using lunpack.exe with the following command:
- Make sure the contents of globs.txt is just *.fdb, otherwise you will unpack the whole client (which takes a lot more time)
- Make sure lunpack.exe and globs.txt are in the same folder
```
lunpack.exe "PATH_TO_LU_CLIENT" - g "globs.txt"
```
To convert the cdclient.fdb to the cdclient.sqlite, upload the cdclient.fdb to https://fdb.lu-dev.net/.

Setup

Run git clone https://github.com/MasterTemple/LEGO-Universe-Discord-Bot.git
Configuration

Rename .env.template to .env and fill in the data from the comments provided.

If you do not have a cdclient.sqlite create one from your cdclient.fdb at https://fdb.lu-dev.net/.
Install proper dependencies with npm install
Transpile with tsc --build

If tsc is not found, install it with npm i typescript -g and then run tsc --build.
Run ./lib/index.js

I would recommend using something that restarts if it crashes such as pm2

Install pm2 with npm install pm2 -g and run it with pm2 start .

Restart with pm2 restart all and stop with pm2 stop all

If you edit the cdclient.sqlite or locale.xml, they can be reloaded without restarting the bot by using the Slash Command /reload in Discord.

If you edit the .env file, you just need to restart the bot.

Features

Autocomplete

This allows users to search objects by their name instead of relying on knowing the internal object id.

Message Embeds

Message embeds allow for organizing and displaying data in a much more visually appealing way.

They are indicated below by the colored bar on the left and the darker background.

Normal Message

Message Embed

Message Components

Message components are the buttons underneath the embed. These allow for the user to execute related commands on an object.

For example, an item that can be earned can also be bought. Instead of having to use /earn and then /buy, the user can use /earn and then click the Buy button.

The green button indicates the current command. Disabled/faded buttons show that an item cannot be obtained through a certain method.