A Java application that uses the JDA API to connect Halo SAPP server events to Discord, providing real-time alerts, structured embeds, and a GUI interface for monitoring your servers.
 |
 |
 |
 |
SAPPDiscordBot listens for server events generated by the discord.lua, processes them, and sends rich notifications to Discord. It supports multiple servers, offers a GUI for configuration, and is optimized for performance.
⚠️ Note: This application requires GUI access to the host machine. It will not run in headless environments such as servers without a graphical interface.
- Must have Java 17 installed.
- For Windows users, you can download Java 17 here
- For Linux users, use non-headless JRE:
sudo apt install openjdk-17-jre
- 512MB RAM
- 50MB storage
- Windows or Linux with GUI access
- Halo server running SAPP
Found a bug or have a feature idea? Please check our issue templates:
- Report a Bug - For reporting problems or unexpected behavior
- Request a Feature - For suggesting new features or enhancements
- Documentation Update - For documentation improvements
- New Event Request - For requesting new Halo event types
- Performance Issue - For performance-related problems
- Discord Integration - For Discord bot-specific issues
Before creating a new issue, please:
- Check if the issue already exists in our issues list
- For bugs, include your Java version, operating system, and relevant log output
- For features, describe your use case and proposed solution
1. Download the latest release from the repository
2. Download the discord.lua and place it in the server Lua folder
3. Register an application on the Discord Developer Portal.
Follow these steps:
- Click New Application. Provide a name for your bot and click create.
- Click the Bot tab on the left-hand side menu. Set the bot's username and profile picture.
- Click Reset Token and then Yes, do it!.
- Save this token, you will need it later.
- Scroll down to Privileged Gateway Intents.
- Enable Presence Intent, Server Members Intent and Message Content Intent.
- Click the OAuth2 tab on the left-hand side menu.
- Scroll down to the OAuth2 URL Generator section.
- Under Scopes, select bot.
- Under Bot Permissions, select Administrator
- Copy the URL that gets generated and paste it into your browser.
- Select the server you want to add the bot to and click Continue.
- Complete the captcha and click Authorize.
- The bot should now be on your Discord server. Ensure the bot has the correct permissions.
⚠️ Warning: Never share the Discord Bot Token with anyone!
4. Create a new folder in your Halo server's root directory called discord_events.
5. Launch SAPPDiscordBot.exe (or SAPPDiscordBot.jar on Linux)
- Enter the Discord Bot Token you saved earlier.
- Set your watch directory to the
discord_eventsfolder you created in step 4. - Click Save Configuration
- Click the Output Configuration tab
- Select Add Server and enter the exact name of your server defined in init.txt (
sv_namecommand in init.txt). A new tab will appear with the server name - click it. - Set the General, Chat and Command Discord Channel IDs for this server, and repeat for each server you want to add.
- Click Save Configuration
- Click Start Bot
| Category | Events |
|---|---|
| Game Events | event_start, event_end, event_map_reset |
| Player Events | event_join, event_leave, event_spawn, event_team_switch |
| Chat and Commands | event_chat, event_command |
| Score Events | event_score |
| Death Events | event_death |
| Admin Events | event_login, event_snap |
The SAPPDiscordBot.exe / SAPPDiscordBot.jar application will create a file called sapp_bot_config.json in the same
directory as the application. This file contains the configuration for the bot, including the Discord Bot Token, watch
directory, and server configurations.
SAPPDiscordBot is released under the MIT License.
For licensing inquiries, collaboration proposals, or to report usage concerns, contact me:
Email (preferred):
chalwk.dev@gmail.com
Discord: (chalwk)