Storption

MapVote Discord Bot - Map Voting System for Rust Servers MapVote is a Discord bot designed specifically for Rust server owners who want to engage their community in choosing the next wipe map. This sophisticated system transforms the map selection process from a server admin decision into an interactive community event that builds excitement and player engagement. Gone are the days of manually asking players what map they want or making arbitrary decisions. MapVote provides a complete, automated solution that handles everything from map configuration to vote tallying, with beautiful visual presentations and detailed map information pulled directly from RustMaps.com. Key Features Real-time Vote Tracking: Live vote counts with animated progress bars Automatic Winner Selection: Handles ties with random selection when needed Standard Maps: Support for any size/seed combination Custom Maps: Full integration with custom RustMaps.com maps Staging Maps: Support for both regular and staging branch maps Map Previews: Detailed information including biomes, monuments, and terrain features Rich Map Information: Displays map size, seed, biomes, and terrain features Flexible Map Count: Support for 2-5 maps per vote How It Works 1. Initial Setup (One-Time) Server administrators configure the bot with their Discord bot token and RustMaps API key. The setup process is straightforward with clear documentation and support. 2. Creating a Vote Command Execution: Admin runs /map_vote command Map Count Selection: Choose between 2-5 maps for the vote Map Type Selection: Decide between standard maps (size/seed) or custom maps Individual Map Configuration: Configure each map with detailed information Preview & Confirmation: Review all maps before launching the vote Duration Setting: Set custom vote duration (default: 1 hour) 3. Community Voting Players see a embedded message with all map options Each map shows size, seed/type, and current vote count with progress bars Players can click buttons to vote for their preferred map Users can view detailed map information including biomes and terrain features Real-time updates show vote progress as it happens 4. Automatic Results Vote automatically ends at the specified time System calculates winner (handles ties with random selection) Setup Requirements Prerequisites: Node.js npm package manager (comes with node) Discord Application with Bot Token RustMaps.com API Key (free registration) The bot needs the following Discord permissions: View Channels Send Messages Embed Links Mention Everyone Read Message History Installation Guide Step 1: Download and Extract Download the MapVote bot files, extract to your desired directory, open terminal/command prompt in the bot folder Step 2: Install Dependencies Type npm install into the terminal/command prompt Step 3: Configuration Discord Bot Setup Visit Discord Developer Portal, create new application and bot and copy the bot token. Invite bot to server with required permissions Environment Configuration Open the .env file add your bot token: TKN=YourBotTokenHere, add RustMaps API key: RUSTMAPS_API_KEY=YourApiKeyHere User ID Configuration Open src/index.js, replace "YOUR_DISCORD_USER_ID_HERE" with your Discord User ID RustMaps API Key Visit RustMaps.com create free account generate API key from account settings add to .env file Step 4: Launch Type node src/index.js into terminal/command prompt, the bot will automatically create necessary database files and be ready for use! Ready to revolutionize your server's map voting? Get MapVote today and give your community the voice they deserve in shaping their Rust experience.