Orion is a Discord server management and utility bot that provides various administrative and convenience features for Discord server owners and moderators.

• Message and thread management
• Manage webhooks
• Send messages as the bot or using a webhook
• Play audio files in voice channels
• Customize bot presence and activity
• Restrict commands using Discord's permission system

1. Create an application on the Discord Developer Portal
   • Click "New Application" and give it a name.
   • Note down the Application ID for later.
   • Go to the "Bot" tab and click "Add Bot".
   • Under "TOKEN", click "Copy" to copy your bot token. (You might need to reset it to see it.)

2. Enable developer mode in Discord to copy IDs
   • Go to User Settings > Advanced > Developer Mode and enable it.
   • You can now right-click on users, roles, channels, etc., and select "Copy ID" to get their IDs.
3. Invite the bot to a Discord server
   • You can use the premade link in the usage section.

Now choose one of the following methods to run the bot!

1. Pull the latest image from Docker Hub

   docker pull tibynx/orion:latest

2. Run the container with the required environment variables and volume mounts

   • See the configuration section below for details! Only required options are included in this example.
   • Change /path/to/logs to a directory on your host where you want to store the logs.

   docker run -d \
     --name=orion \
     -e BOT_TOKEN=your_bot_token_here \
     -v /path/to/logs:/app/logs \
     tibynx/orion:latest

1. Clone the repository and install all dependencies. Make sure you have at least Python 3.14 installed!

   git clone https://github.com/tibynx/orion.git
   cd orion/
   pip install -r requirements.txt

2. Copy .env.example to .env and configure your settings.
   • See the configuration section below for details!
   • Do not share your .env file publicly!
3. Invite the bot to a Discord server
   • You can use the premade link in the usage section.
4. Run python main.py to start the bot.

After setting up, invite your bot to a server using this premade link! It already contains the proper permissions. Replace <app-id> with your bot's appication ID.

https://discord.com/oauth2/authorize?client_id=<app-id>&permissions=120796048384&integration_type=0&scope=bot+applications.commands

Due to Discord limitations, you cannot directly mention users or roles in the bot's response. However, you can use their IDs to create mentions. You'll need to enable Developer Mode in Discord to copy user and role IDs. To enable Developer Mode, go to User Settings > Advanced > Developer Mode. If you want to mention @everyone or @here, simply write them in your message. But if you want to mention roles or specific users, you need to use their IDs in the following format: <@&ROLE_ID> for roles and <@USER_ID> for users.

For convenience, you can choose to ping the mentions by ticking the options in the message modal. The bot will not mention @everyone or @here by default.

Emojis can be either a Unicode emoji (e.g., ✨) or a custom emoji in the format <a:EMOJI_NAME:EMOJI_ID> (e.g., <a:star:733395207222984794>). The bot must be in the server where the custom emoji is from or added to the bot on the Discord Developer Portal to use it.

Just like normal messages, you can format your text using Markdown syntax. You can make text bold, italic, strikethrough, etc. The bot message will be formatted accordingly, but there is no preview.