ServerBox Discord Utility Bot

Functions

calc <expression>  - Calculate the expression
should             - Basically a dice
server <function>  - Server related functions:
    status              - Show server status
    ip                  - Show server local IP address
    cockpit             - Show Cockpit link
    restart bot / rebot - Restart the bot process
    reboot              - Reboot the server (Requires confirmation)
    shutdown            - Shutdown the server (Requires confirmation)
    aliases: svr, srv, sv, s
hotspot            - Turn on Wi-Fi hotspot
                     aliases: wifi
ping               - Pong ♪
help               - Show built-in help message
commands           - Show this command list
                     aliases: hepp, cmds, cmd
statusRainbow      - Show every color ">server status" will send
author             - Show bot author information

Installation

sudo apt install -y python3 python-is-python3 
git clone https://github.com/theArnoll/serverboxDCutil.git
cd serverboxDCutil
chmod +x setup.sh
chmod +x main.py

Bot Setup Instruction

1. Go to Discord Developer Portal
2. Click New Application, give it a name, and create it.
3. Click Bot at the left sidebar
4. Find Presence Intent, Server Members Intent and Message Content Intent and enable it.
5. Click Reset Token and copy the token to .env file.
6. Invite the bot to your server:
   1. Click OAuth2 at the left sidebar → OAuth2 URL Generator.
   2. Have bot checkbox checked.
   3. Check Send Messages and Read Message History in the Bot Permissions field below.
   4. Copy the generated URL, paste it to your browser, and invite the bot to your private server.
7. Open your Discord app, go to Settings → Advanced, and enable Developer Mode.
8. Go to your private Discord server, right click on your profile picture, and click Copy User ID. Paste it to the ALLOWED_USER_ID field in the .env file.
9. Run setup.sh to install dependencies and set up the systemd service.

Confirm if the bot is running

Run

systemctl status discord-bot.service 

The output should be something like

● discord-bot.service - Discord util
     Loaded: loaded (/etc/systemd/system/discord-bot.service; enabled; preset: enabled)
     Active: active (running) since Sun 2026-01-25 19:29:33 UTC; 17s ago
   Main PID: 2271 (python)
      Tasks: 3 (limit: 9165)
     Memory: 31.8M (peak: 32.1M)
        CPU: 543ms
     CGroup: /system.slice/discord-bot.service
             └─2271 /home/user/serverboxDCutil/venv/bin/python /home/user/serverboxDCutil/main.py

The "light bulb" (Big dot) before "discord-bot.service" should be green, and there shouldn't be any error message such as (code=exited, status=1/FAILURE) in the end of Process: line (or maybe there should be a line start with Process:) or Main PID: line.

---

Used Gemini for rapid prototyping; logic and system integration verified by human.

Tested in:

• VMWare Ubuntu Server 24.04 LTS environment.
• Intel N100 mini PC Currently running Spec:
  • Intel N100
  • 8GB DDR5
  • 120GB 2.5" SSD (connected via USB)
  • Ubuntu Server 24.04 LTS