AeThex-Bot-Master/replit.md

AeThex Unified Bot

A complete Discord bot combining AeThex community features, Sentinel enterprise security, and multi-purpose server management in one instance.

Overview

AeThex Unified Bot handles community features, security, AND general server management:

• Community Features: User verification, profile linking, realm selection, leaderboards, community posts
• Sentinel Security: Anti-nuke protection with RAM-based heat tracking
• Federation Sync: Cross-server role synchronization across 5 realms
• Ticket System: Support tickets with automatic channel creation
• Moderation: Full moderation suite (warn, kick, ban, timeout)
• Leveling System: Unified XP across Discord and AeThex platform
• Cross-Platform: Integration with AeThex.studio and AeThex.foundation

Tech Stack

• Runtime: Node.js 20
• Framework: discord.js v14
• Database: Supabase (for verification, XP, moderation logs)
• Health Endpoint: HTTP server on port 8080

Project Structure

aethex-bot/
├── bot.js                      # Main entry point
├── package.json
├── public/
│   └── dashboard.html          # Web dashboard
├── commands/
│   ├── admin.js                # /admin status|heat|servers|threats|federation
│   ├── announce.js             # /announce - cross-server announcements
│   ├── auditlog.js             # /auditlog - admin action history
│   ├── avatar.js               # /avatar - get user avatar
│   ├── badges.js               # /badges - view earned badges
│   ├── ban.js                  # /ban - ban users
│   ├── config.js               # /config - server settings
│   ├── daily.js                # /daily - claim daily XP
│   ├── federation.js           # /federation link|unlink|list
│   ├── foundation.js           # /foundation - foundation stats
│   ├── help.js                 # /help - command list
│   ├── kick.js                 # /kick - kick users
│   ├── leaderboard.js          # /leaderboard - top contributors
│   ├── modlog.js               # /modlog - user mod history
│   ├── poll.js                 # /poll - community polls
│   ├── post.js                 # /post - community feed posts
│   ├── profile.js              # /profile - view linked profile
│   ├── rank.js                 # /rank - view level and XP
│   ├── refresh-roles.js        # /refresh-roles - sync roles
│   ├── serverinfo.js           # /serverinfo - server stats
│   ├── set-realm.js            # /set-realm - choose primary realm
│   ├── stats.js                # /stats - user statistics
│   ├── status.js               # /status - network overview
│   ├── studio.js               # /studio - studio profile
│   ├── ticket.js               # /ticket create|close
│   ├── timeout.js              # /timeout - timeout users
│   ├── unlink.js               # /unlink - disconnect account
│   ├── userinfo.js             # /userinfo - user details
│   ├── verify-role.js          # /verify-role - check roles
│   ├── verify.js               # /verify - link account
│   └── warn.js                 # /warn - warn users
├── events/
│   └── messageCreate.js        # Message event handler
├── listeners/
│   ├── feedSync.js             # Community feed sync
│   ├── welcome.js              # Welcome messages + auto-role
│   ├── goodbye.js              # Goodbye messages
│   ├── xpTracker.js            # XP tracking on messages
│   └── sentinel/
│       ├── antiNuke.js         # Channel delete monitor
│       ├── roleDelete.js       # Role delete monitor
│       ├── memberBan.js        # Mass ban detection
│       └── memberKick.js       # Mass kick detection
└── scripts/
    └── register-commands.js    # Slash command registration

Commands (29 Total)

Community Commands

Command	Description
/verify	Link your Discord account to AeThex
/unlink	Disconnect your Discord from AeThex
/profile	View your linked AeThex profile
/set-realm	Choose your primary realm
/verify-role	Check your assigned Discord roles
/refresh-roles	Sync roles based on AeThex profile
/stats	View your AeThex statistics
/leaderboard	View top contributors
/post	Create a community feed post
/help	View all bot commands

Leveling & Engagement

Command	Description
/rank	View your level and unified XP
/daily	Claim daily XP bonus
/badges	View earned badges across platforms

Moderation

Command	Description
/warn @user [reason]	Warn a user
/kick @user [reason]	Kick a user
/ban @user [reason]	Ban a user
/timeout @user [minutes] [reason]	Timeout a user
/modlog @user	View moderation history

Utility

Command	Description
/userinfo [@user]	View user information
/serverinfo	View server statistics
/avatar [@user]	Get user's avatar

Admin & Config

Command	Description
/config view	View server configuration
/config welcome #channel	Set welcome channel
/config goodbye #channel	Set goodbye channel
/config modlog #channel	Set mod log channel
/config levelup #channel	Set level-up announcement channel
/config autorole @role	Set auto-role for new members
/config levelrole @role [level]	Add level-based role reward
/announce [title] [message]	Send cross-server announcement
/poll [question] [options]	Create community poll
/auditlog	View admin action history

Cross-Platform

Command	Description
/studio [@user]	View AeThex Studio profile
/foundation [@user]	View Foundation contributions

Sentinel Security

Command	Description
/admin status	View bot status and statistics
/admin heat @user	Check heat level of a user
/admin servers	View all connected servers
/admin threats	View active threat monitor
/federation link @role	Link a role for cross-server sync
/federation unlink @role	Remove a role from sync
/federation list	List all linked roles
/ticket create [reason]	Create a support ticket
/ticket close	Close the current ticket
/status	View network status

Unified XP System

XP is earned across all platforms and stored in a single profile:

• Discord Messages: +5 XP per message (60s cooldown)
• Daily Claims: +50 XP base + streak bonus (up to +100)
• Platform Activity: Posts, likes, comments on AeThex sites

Level formula: level = floor(sqrt(xp / 100))

Supabase Tables Required

-- Server configuration
CREATE TABLE server_config (
  guild_id TEXT PRIMARY KEY,
  welcome_channel TEXT,
  goodbye_channel TEXT,
  modlog_channel TEXT,
  level_up_channel TEXT,
  auto_role TEXT,
  updated_at TIMESTAMPTZ DEFAULT NOW()
);

-- Warnings
CREATE TABLE warnings (
  id SERIAL PRIMARY KEY,
  guild_id TEXT NOT NULL,
  user_id TEXT NOT NULL,
  user_tag TEXT,
  moderator_id TEXT NOT NULL,
  moderator_tag TEXT,
  reason TEXT,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

-- Moderation actions
CREATE TABLE mod_actions (
  id SERIAL PRIMARY KEY,
  guild_id TEXT NOT NULL,
  action TEXT NOT NULL,
  user_id TEXT NOT NULL,
  user_tag TEXT,
  moderator_id TEXT NOT NULL,
  moderator_tag TEXT,
  reason TEXT,
  duration_minutes INTEGER,
  created_at TIMESTAMPTZ DEFAULT NOW()
);

-- Level roles
CREATE TABLE level_roles (
  guild_id TEXT NOT NULL,
  role_id TEXT NOT NULL,
  level_required INTEGER NOT NULL,
  PRIMARY KEY (guild_id, role_id)
);

-- Add to user_profiles (if not exists)
ALTER TABLE user_profiles ADD COLUMN IF NOT EXISTS xp INTEGER DEFAULT 0;
ALTER TABLE user_profiles ADD COLUMN IF NOT EXISTS daily_streak INTEGER DEFAULT 0;
ALTER TABLE user_profiles ADD COLUMN IF NOT EXISTS last_daily TIMESTAMPTZ;
ALTER TABLE user_profiles ADD COLUMN IF NOT EXISTS badges JSONB DEFAULT '[]';

Environment Variables

Required

• DISCORD_BOT_TOKEN - Bot token from Discord Developer Portal
• DISCORD_CLIENT_ID - Application ID

Optional - Supabase

• SUPABASE_URL - Supabase project URL
• SUPABASE_SERVICE_ROLE - Supabase service role key

Optional - Federation

• HUB_GUILD_ID, LABS_GUILD_ID, GAMEFORGE_GUILD_ID, CORP_GUILD_ID, FOUNDATION_GUILD_ID

Optional - Security

• WHITELISTED_USERS - Comma-separated user IDs to skip heat tracking
• ALERT_CHANNEL_ID - Channel for security alerts
• EXTRA_WHITELISTED_GUILDS - Additional whitelisted server IDs

Health Endpoints

GET /health - Bot health status GET /stats - Server statistics GET /dashboard - Web dashboard

Running the Bot

cd aethex-bot
npm install
npm start

Current Status

• Bot running as AeThex#9389
• 29 commands loaded
• Unified XP system active
• Welcome/goodbye system active
• Moderation suite active
• Cross-platform integration ready

Workflow

• Name: AeThex Unified Bot
• Command: cd aethex-bot && npm start
• Runtime: Node.js 20
• Status: Running