HuxBot

The official bot for the Hog jects Discord server.

---

About

HuxBot is a custom Discord bot built for the Hojects Discord server. It's main feature is being able to run code from a command. It can also handle basic moderation, information and has a basic snippet system.

---

Features

Moderation

• Kick, timeout and untimeout members
• Role management (add / remove)
• Warning system

Info

• Server, user and role information via !info
• Fast ping check

Fun

• Simple fun commands (!hello, !meow, !hog)

Projects

• List active projects and their repositories
• Fetch latest releases

Snippets

• Create, edit and delete snippets
• Lock/unlock snippets to prevent modification
• List all snippets or filter by author

Eval

Run code from:

• Python
• Go
• Brainfuck
• Rust

---

Setup

Prerequisites

• Python 3.14+
• A Discord bot token

Installation

# Clone the repository
git clone https://github.com/Saber0324/projects-bot
cd projects-bot

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate.ps1

# Install dependencies
pip install -r requirements.txt

# Create your .env file
echo "TOKEN=your_token_here" > .env

# Run the bot
python main.py

---

Commands

Information

Command	Description
!ping	Check bot latency
!info user @user	Get user information
!info server	Get server information
!info role @role	Get role information

Fun

Command	Description
!hello	Say hello
!meow	Meow back
!hog	All hail
!say <text>	Make the bot say something

Moderation

Command	Description
!kick @user [reason]	Kick a member
!timeout @user <minutes> [reason]	Timeout a member
!untimeout @user	Remove timeout
!role add @user role	Add a role
!role remove @user role	Remove a role
!warn @user	Warns an user
!warn list @user	Displays all warns from an user
!warn delete <warn id>	Deletes a warn

Projects

Command	Description
!projects list	List all projects
!projects release <name>	Get latest release link

Eval

Command	Description
!eval	Display correct usage information
!eval <code>	Runs the provided code and return the output

Snippets

Command	Alias	Description
!snippet <title>	Retrieve a snippet
!snippet add <title> <desc>	Create a snippet
!snippet edit <title> <desc>	Edit your snippet
!snippet delete <title>	Delete a snippet
!snippet lock <title>	Lock a snippet
!snippet unlock <title>	Unlock a snippet
!snippet list	List all snippets
!snippet author @user	List snippets by user

---

Made with 🩷 for Hog Projects