MapBot

v1.0.0 Discord

A Discord bot that leverages the RustMaps API to allow users to generate custom Rust maps, list configurations, and monitor generation progress directly from Discord.

MapBot - A Discord bot that leverages the RustMaps API to allow users to generate custom Rust maps, list configurations, and monitor generation progress directly from Discord. Discord Bot

Gallery

MapBot - Screenshot 1
MapBot - Screenshot 2
MapBot - Screenshot 3
MapBot - Screenshot 4
MapBot - Screenshot 5

MapBot

Version: 1.0.0 | Discord Bot
Back to Bots
MapBot

Key Features

  • Generate custom Rust maps using the RustMaps API.
  • Specify map size (1000-6000), use pre-saved RustMaps configurations, and choose staging/live generation.
  • Batch generation of multiple maps (up to 50 at a time).
  • Real-time progress updates and status messages for map generation within Discord.
  • Detailed final map information: preview image, download link, seed, size, and major monument checklist.
  • List available saved map configurations directly from your RustMaps account.
  • Autocomplete support for configuration names when using the `/generate` command.
  • Automatic handling of RustMaps API concurrency limits and queuing for batch jobs.
  • Optional role-based authorization to restrict command usage to specific Discord roles.

Installation

MapBot requires Python 3.8 or higher, a Discord bot token with `bot` and `applications.commands` scopes (plus permissions like Send Messages, Embed Links), and a RustMaps API key.

pip install -r requirements.txt

Installation Steps

  1. Clone the repository or download the bot files.
  2. Install required dependencies using pip (see above).
  3. Create a Discord bot via the Discord Developer Portal.
  4. Copy the Discord bot token and set up the configuration file.
  5. Configure your database and other settings (see Configuration section).
  6. Start the bot using the run command.

Configuration

The bot's configuration is managed through a central configuration file. Create a .env file with the following settings:

CORE_SETTINGS (.env file) = {
    'DISCORD_TOKEN': 'Your Discord bot token (required).',
    'RUSTMAPS_API_KEY': 'Your RustMaps API key (required).',
    'AUTHORIZED_ROLE_IDS': 'Comma-separated list of Discord Role IDs authorized to use bot commands (optional, leave empty for public access).',
    'RUSTMAPS_CONCURRENCY_LIMIT': 'Your RustMaps account\'s concurrent generation limit (optional, defaults to 7 in the bot, ensure it matches your API plan).',
}

Configuration Options

Option Description
CORE_SETTINGS (.env file)
Configuration object with the following properties:
  • DISCORD_TOKEN: Your Discord bot token (required).
  • RUSTMAPS_API_KEY: Your RustMaps API key (required).
  • AUTHORIZED_ROLE_IDS: Comma-separated list of Discord Role IDs authorized to use bot commands (optional, leave empty for public access).
  • RUSTMAPS_CONCURRENCY_LIMIT: Your RustMaps account\'s concurrent generation limit (optional, defaults to 7 in the bot, ensure it matches your API plan).

Bot Commands

User Commands

Command Description
/generate [size] [config] [batch_size] [staging] Generates one or more custom Rust maps. Parameters: `size` (map dimension, e.g., 4250, default: 4250), `config` (saved RustMaps configuration name, required), `batch_size` (number of maps, default: 1, max: 50), `staging` (True/False for staging environment, default: True).
/configs Lists all saved map configurations available from your RustMaps account.

Scheduled Tasks

This bot runs the following automated tasks:

Task Frequency Description
Batch Map Generation Management As needed (triggered by `/generate` with `batch_size` > 1) When multiple maps are requested, this background process manages the queue. It submits map generation jobs to the RustMaps API respecting concurrency limits, monitors their progress, and posts individual map results with details and download links to the Discord channel as they become available or if they fail.

Bot Information

Version 1.0.0
Language Python
Platform Discord
License Custom
Integration RustMaps API, Discord Servers

Need Bot Hosting?

For optimal performance, we recommend hosting your MapBot bot on our specialized Discord bot hosting platform. Starting at just $1.99/month, our Python hosting plans provide the perfect environment for running your bot with 24/7 uptime and easy management through the Pterodactyl panel.

View Hosting Plans

Get This Bot

Interested in using this Discord bot for your game server?

This bot is available for free. Click below to download.

6 downloads

Additional Information

This bot is designed specifically for Discord integration with Rust game servers and communities.

Requirements

  • Python 3.8 or higher
  • Discord Bot Token
  • RustMaps API Key

Support

For support with bot implementation or customization, please contact us.