Discord VIP Bot

This Discord bot allows users to register their player ID (Steam or Gamepass) and request temporary VIP status for a certain amount of time on connected servers. The bot integrates with an external API to manage VIP status for players and stores player information in a local SQLite database.

ToDo: Execute the following commands after downloading:

1. Copy the .env.dist file to .env and enter your values.
2. Run the command pip install python-dotenv.
3. Copy frontline-pass.service.dist to /etc/systemd/system/frontline-pass.service
4. Activate and start the service with sudo systemctl enable frontline-pass.service and sudo systemctl start frontline-pass.service.

Features

• Player Registration: Users can register their player ID (Steam-ID or Gamepass-ID) through a modal window.
• VIP Request: Users can request VIP status for a predefined number of hours. The bot communicates with an external API to grant VIP status.
• Persistent Player Data: Player information is stored in a SQLite database, allowing for easy retrieval and VIP management.
• Localized Time Support: The bot handles time zone conversion to display VIP expiration times in local time (set to Europe/Berlin by default).

Prerequisites

• Python 3.8+
• Discord account and server where the bot will be used
• API endpoint to manage VIP status
• .env file with the following keys:
  • DISCORD_TOKEN: Your Discord bot token
  • API_URL: The URL of the VIP management API
  • API_KEY: The API key for authentication
  • VIP_DURATION_HOURS: Duration of the VIP status in hours
  • CHANNEL_ID: The ID of the Discord channel where the bot will post the initial message

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/your-repository.git
   cd your-repository

2. Install the required Python dependencies:

   pip install -r requirements.txt

3. Create a .env file in the root directory with the following content:

   DISCORD_TOKEN=your-discord-bot-token
   API_URL=https://your-api-endpoint.com
   API_KEY=your-api-key
   VIP_DURATION_HOURS=24  # Example: 24 hours of VIP
   CHANNEL_ID=your-discord-channel-id

4. Run the bot:

   python frontline-pass.py

Usage

1. Registering Player ID: Once the bot is running, it will post a message in the specified Discord channel with two buttons. To register, users click the "Register" button and enter their player ID (Steam or Gamepass).

2. Requesting VIP Status: After registration, users can request VIP status by clicking the "Get VIP" button. The bot will send a request to the connected API to grant the user VIP status for the configured duration (in hours).

3. VIP Expiration: The bot will display the expiration time of the VIP status in the local time zone (Europe/Berlin by default).

Dependencies

• discord.py: For Discord bot functionality
• sqlite3: For local database management
• requests: For sending API requests
• pytz: For time zone management
• dotenv: For loading environment variables

Contributing

Feel free to fork this repository and create a pull request if you want to contribute to the project. You can also open issues if you encounter any problems or have suggestions for new features.

License

This project is licensed under the MIT License. See the LICENSE file for more details.