# Admin Bot System

## 🤖 SL-Bot

### Advanced Discord Bot Management System for FiveM

Complete Discord bot integration for your FiveM server featuring ban system, warning system, player management, and powerful administrative commands. Execute server commands directly from Discord with full permission control and logging.

***

### Features

**Core Features**

* **Ban System** - Complete ban management with offline bans, ban IDs, and expiration
* **Warning System** - Track player warnings with automatic expiration
* **Player Management** - Kick, view online players, detailed player info
* **Server Control** - Restart/stop server, txAdmin integration
* **Permission System** - Role-based command access control
* **Discord Logging** - Comprehensive webhook logging for all actions

**Advanced Features**

* **Multi-Language** - English and Polish support
* **Screenshot System** - Take screenshots of players remotely
* **Export System** - Use ban/warn functions from other scripts
* **MySQL Integration** - Persistent data storage (oxmysql)
* **Framework Support** - ESX, QB-Core, QBox auto-detection
* **Player Control** - Heal, revive, freeze, teleport, spawn vehicles
* **Unlimited Commands** - Create your own commands (fully open source file)

***

### 📋 Documentation

* README - This file
* Installation - Setup guide
* Configuration - Main config options
* Commands - Available Discord commands
* Custom Commands - Create unlimited commands
* Exports - Available exports for developers
* Logs - Discord webhook logging
* Localization - Multi-language support

***

### 🔗 Links

* **Documentation**: [GitBook](https://scriptlock.gitbook.io/script-lock-docs)
* **Support**: [Discord](https://discord.gg/zZj4bNMuf7)
* **Store**: [Tebex](https://scriptlock.tebex.io/)
* **CFX Portal**: [portal.cfx.re](https://portal.cfx.re/assets/granted-assets)

***

### 📁 File Structure

```
sl-bot/
├── fxmanifest.lua                 # Resource manifest
├── package.json                   # Node.js dependencies
├── .env                           # Bot configuration (TOKEN, ROLES)
├── client/
│   └── client.lua                 # Client-side events
├── server/
│   ├── server.lua                 # Main server logic
│   ├── bot.js                     # Discord.js bot
│   └── locale.lua                 # Translation system
├── shared/
│   └── config.lua                 # Lua configuration
├── editable/                          # 🔓 OPEN SOURCE - fully editable!
│   ├── custom_commands.lua        # Create unlimited custom commands
│   ├── help.lua                   # Help message config
│   └── logs.lua                   # Webhook logging config
└── data/
    └── locale/
        ├── en.json                # English translations
        └── pl.json                # Polish translations
```

***

### 💰 Pricing

**Price**: €22.22+ VAT

*Developed with ❤️ by ScriptLock*