🌿 SilverLeaf Bot

A custom Discord bot for the 🌿SilverLeaf🌿 guild community.
Features include:

🎉 Auto-greetings in #introduce channel
👋 Welcome messages for new members
⚙️ Slash commands for guild management (roles, intro channel, status)
🔄 Rotating bot status every 5 minutes
🛡️ Basic moderation commands (kick, ban)

📦 Requirements

Python 3.10 or higher
A Discord bot token (from Discord Developer Portal)
(Optional) Git for version control

🚀 Fresh Install

1. Clone the repository

git clone https://github.com/archytech99/silverleaf-bot.git
cd silverleaf-bot

2. Create a virtual environment

python -m venv venv
source venv/bin/activate   # Linux/macOS
venv\\Scripts\\activate    # Windows PowerShell

3. Install dependencies

pip install -r requirements.txt

4. Configure environment

Create a .env file in the project root:

DISCORD_TOKEN=your_discord_bot_token_here

5. Run the bot (development)

python silverleaf-bot.py

🔄 Development Mode (auto-reload)

For auto-restart on file changes:

pip install watchdog
watchmedo auto-restart --pattern="*.py;*.env" --recursive -- .venv/bin/python silverleaf-bot.py

⚡ Deployment (Debian/Ubuntu)

1. Create a systemd service /etc/systemd/system/silverleaf-bot.service

[Unit]
Description=SilverLeaf Discord Bot
After=network.target

[Service]
Type=simple
WorkingDirectory=/your-path/silverleaf-bot
ExecStart=/your-path/silverleaf-bot/.venv/bin/python silverleaf-bot.py
Restart=on-failure
User=youruser
Environment=\"DISCORD_TOKEN=your_token_here\"

[Install]
WantedBy=multi-user.target

2. Enable and start service

sudo systemctl daemon-reload
sudo systemctl enable silverleaf-bot
sudo systemctl start silverleaf-bot

3. Manage

sudo systemctl restart silverleaf-bot
sudo systemctl status silverleaf-bot
journalctl -u silverleaf-bot -f

🛠️ Useful Commands

/guild setintrochannel #channel → set introduction channel
/guild removeintrochannel → clear intro channel
/guild addrole @user @role → add role to member
/guild removerole @user @role → remove role
/guild setstatus [type] [message] → set bot status (playing, watching, listening, competing, custom)