Modular Discord Onboarding & Auto-Reply Bot

TheGreeter is a fully configurable, JSON-driven Discord bot designed to handle server onboarding, user registration, and smart auto-reply workflows with a clean and minimal architecture.

It is built to be easy to deploy, easy to maintain, and easy to extend, without relying on external AI APIs.

• Server Onboarding

  • Customizable welcome and system messages
  • Guided registration flow (name, age, preferred nickname, etc.)
  • Regex-based input validation

• Smart Auto-Reply System

  • JSON-based prompt–response matching
  • Hybrid matching logic
  • Bot mention–specific reply groups
  • Fallback responses for unmatched messages

• Server-Specific Configuration

  • Full guild_id isolation
  • Each server has its own settings and reply data
  • Multi-server support out of the box

• Command-Based Management

  • Add, remove, or list reply groups via commands
  • Toggle chatbot behavior per server
  • Customize system messages without editing code

• Clean & Minimal Architecture

  • Single entry point
  • No database required (JSON-based persistence)
  • Environment-based token management (.env)

container/ ├── Selamlayici.py # Main bot entry point ├── responder.py # Reply loading & matching logic ├── replies.json # Prompt–response data (per guild) ├── ayarlar.json # Server-specific settings ├── chatbot_settings.py # Chatbot configuration commands ├── requirements.txt └── .env # Discord token (not committed)

git clone https://github.com/yourusername/TheGreeter.git
cd TheGreeter/container

pip install -r requirements.txt

Create a .env file:

DISCORD_TOKEN=your_discord_bot_token

python Selamlayici.py

No additional setup is required. The bot initializes its configuration automatically.

• Messages are evaluated only in configured channels
• Incoming messages are matched against JSON-defined prompts
• If the bot is mentioned, a special prompt group is used
• Responses are randomly selected from matched reply pools
• All data is stored per server, not globally

Command names may vary based on server language settings.

• /yanit_ekle – Add new prompts and responses
• /yanit_sil – Remove an entire prompt group
• /yanit_sil_tek – Remove a single response from a group
• /yanitlar – List existing prompt–response groups

• No hardcoded tokens
• No external AI or paid APIs
• Predictable and transparent behavior
• Designed for long-term maintainability

• Community servers
• Writing & creative servers (Wattpad-style)
• Roleplay servers
• Moderated onboarding flows
• Lightweight chatbot interactions

TheGreeter is intentionally designed as a base system.

You can easily extend it with:

• AI integrations
• Database persistence
• Moderation tools
• Analytics & logging
• Web dashboards

This hobby project is open-source and intended for educational and community use. You are free to modify and adapt it to your needs.

TheGreeter Simple. Modular. Server-aware.