---

📖 Table of Contents

---

🚀 Key Features

Icon	Section	Description
🛡️	Comprehensive Moderation	A complete suite of tools, including warnings, mutes, kicks, bans, softbans, detailed logging, and channel management.
🎟️	Advanced Ticket System	A multi-category ticket system with staff roles, transcripts, and full ticket lifecycle control.
📈	Engaging Leveling System	Reward active users with XP, levels, and automated role rewards.
💰	Fun Economy	Earn daily coins, gamble, invest, and climb the global leaderboard.
🎨	Custom Role Menus	Let users self-assign roles via interactive dropdown menus to personalize their profile.
🎉	Fun & Community	Keep your community engaged with polls, memes, suggestions, and interactive games.

---

🛠️ Installation & Setup

Follow these steps to run the Eltrix bot on your own server.

1. Prerequisites

• Python 3.11 or newer. Download Python from python.org.
• A **Discord Bot Token**. You can create a bot application and get a token via the Discord Developer Portal.
• ⚠️ **ATTENTION:** Ensure you enable the **Privileged Gateway Intents** (Server Members Intent and Message Content Intent) for your bot in the Developer Portal.

2. Repository Cloning

Download the code to your machine.

git clone https://github.com/Eltrix-Dot/Eltrix-Discord.bot
cd Eltrix-Discord.bot

3. Package Installation

The bot requires a few Python libraries to run. Execute the following command:

pip install -r requirements.txt

4. Bot Configuration

Open the ELTRIX.py file and fill in the configuration section at the top:

# =============================================================================
# 1. CONFIGURATION
# =============================================================================
# Bot Token (Keep this SECRET!)
TOKEN = "YOUR_BOT_TOKEN_HERE"
# Guild ID (The ID of your server)
GUILD_ID = 123456789012345678
# Log channel ID (The ID of the channel for logs)
LOG_CHANNEL_ID = 123456789012345678
# Staff IDs (Role IDs of your staff)
STAFF_ROLE_IDS = {
    123456789012345678, # Staff Role ID
    123456789012345679, # Admin Role ID
}
# Owner ID (Your own user ID)
OWNER_ID = "YOUR_USER_ID_HERE"
# ... (Further configuration follows in the file)

🔎 How to find IDs? Enable "Developer Mode" in Discord: User Settings > Advanced > Developer Mode. Then, right-click on a server, channel, role, or user and select "Copy ID".

5. Starting the Bot

Start the bot using the following command in your terminal:

python ELTRIX.py

If successful, you will see a confirmation in the terminal that the bot is online and has synchronized its commands.

---

📋 Command Overview

All commands are available via Discord's / Slash Commands.

🛡️ Moderation & Management (Staff Only)

Command	Description
/warn <user> <reason>	Warns a user, logs it, and sends a DM.
/warnings <user>	Views all warnings for a user.
/mute <user> <minutes> <reason>	Places a user in a timeout.
/ban <user> <reason>	Bans a user from the server.
/purge <amount>	Deletes a specified number of messages (1-100).
/lock [channel]	Locks a text channel for the @everyone role.
/history <user>	Shows a combined history of warnings and notes.

🎟️ Ticket System

Command	Description
/ticketsetup	Creates the panel for users to create tickets.
/ticketclaim	Claims the current ticket.
/ticketdelete	Permanently deletes a closed ticket channel and saves a transcript.

📈 Leveling & XP

Command	Description
/rank [user]	Displays a visual rank card with level and XP.
/levelboard	Shows the leaderboard for levels.
/setlevelrole <level> <role>	Sets a role as a reward for reaching a level. (Staff)

💰 Economy

Command	Description
/balance [user]	Checks the balance (wallet and bank).
/daily	Claims your daily coin reward.
/gamble <amount>	Takes a gamble with a 50% chance to double your stake.
/bank deposit/withdraw <amount|all>	Deposits or withdraws coins.

🎉 Fun & Community

Command	Description
/poll <question> <options...>	Creates a poll with up to 5 options.
/meme [subreddit]	Fetches a random meme from Reddit.
/ship <user1> <user2>	Calculates love compatibility.
/hug, /pat, /slap <user>	Interaction commands.
/urban <term>	Searches Urban Dictionary (NSFW channels only).

⚙️ General & Utility

Command	Description
/about	Shows information about the bot.
/ping	Checks the bot's reaction speed (latency).
/userinfo [user]	Shows detailed information about a user.
/remindme <time> <reminder>	Sets a personal reminder.
/botinvite	Generates an invite link for the bot.

---

🤝 Contributing

Contributions are greatly appreciated. If you have a suggestion, please fork the repo and create a pull request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a **Pull Request**

---

📜 License

This project is distributed under the **MIT License**. You are free to use, modify, and distribute the code, as long as you include the original license and copyright notice.

Copyright (c) 2026 [Eltrix-Dot]