Lion is a modular Discord bot that utilizes Discord.js and TypeScript. Lion was created originally to satisfy the needs of server automation within the UCF CS Discord.

Getting Started

The simplest way to get started off with developing the Lion codebase is by cloning the project: git clone https://github.com/cs-discord-at-ucf/lion.git

Install dependencies via NPM: npm install

Create a Discord Bot in the Discord Developer Portal. Make sure that your bot has the "Server Members Intent" enabled.

Create a .env file within the root directory of the project (reference the .env.sample sample file) with your Discord application token: DISCORD_TOKEN=your_token_here. Be sure to remove any secrets from the .env that you are not using, ex. MONGO_PASS=x.

Execute the following command to launch Lion: npm run watch

All subsequent saved changes made within the /src directory will make Lion automatically rebuild while the watch command is running.

Your first command

Navigate to the /src/app/commands directory and create a new file following the specific schema: example.command.ts

Your command name needs to be in all lowercase and only use alphabetic characters.

Your command must be the default export of the file: e.g. export default { ... } satisfies Command

Here's a skeleton for how a basic command should look:

import { Command } from '../../common/slash';

export default {
  name: 'example',
  description: 'An example command to show how awesome Lion is!',
  async execute({ interaction, container }) {
    // Your logic here.
  },
} satisfies Command;

Again, this is a basic skeleton. It is suggested to read the Command type to fully know what is possible within a command, which is located in /src/common/slash.ts.

And that's it! You have successfully created your first command with Lion!