About RaidSelector
WHAT IS RAIDSELECTOR?
A user-friendly raid base purchasing system for Rust servers that transforms how
players engage with raidable content. Featuring an intuitive UI, multilingual
support, and seamless integration with popular server plugins.
Perfect for server owners who want:
• Professional player experience with modern UI
• Monetization through VIP raid access
• Multi-language support for international players
• Easy integration with existing economy systems
═══════════════════════════════════════════════════════════════════
WHY CHOOSE RAIDSELECTOR?
═══════════════════════════════════════════════════════════════════
PLAYER EXPERIENCE
• Intuitive point-and-click interface - no complex commands
• Automatic per-player language via Oxide's lang system
• Beautiful image previews of raid bases
• Clear cost display with multiple currency support
• Instant raid spawning after purchase
MONETIZATION FEATURES
• VIP-only difficulty tiers (Expert, Nightmare)
• Permission-based purchase restrictions
• Tiered access system for progression servers
• Browse-only mode for non-VIP players
MULTILINGUAL SUPPORT (NEW!)
• Full localization system with external JSON files
• Translates ALL UI text, errors, and base descriptions
• Automatic language detection per player
• Easy translation management for server admins
• Admin command to generate language templates
PROFESSIONAL INTEGRATION
• Works standalone OR with ServerPanel unified menu
• Seamless Economics, ServerRewards, and Custom Costs integration
• Automatic base detection from RaidableBases profiles
• No manual cost configuration needed
• Russian RaidableBases config support (auto key translation)
COMPLETE CUSTOMIZATION
• 24+ customizable UI colors for branding
• Custom base names, descriptions, and credits
• Image preview support via ImageLibrary/ImageDatabase
• Unlimited difficulty levels - automatically detected from RaidableBases profiles
• Individual permission control per difficulty tier• Five difficulty levels with individual permission control
PERFORMANCE OPTIMIZED
• Memory-efficient object pooling
• Cross-platform: Oxide AND Carbon support
• Minimal server impact
• Tested on high-population servers
• Difficulties auto-sorted by cost (cheapest first)
• New bases auto-detected from RaidableBases profiles
═══════════════════════════════════════════════════════════════════
FLEXIBLE PERMISSION SYSTEM
═══════════════════════════════════════════════════════════════════
Granular permissions for complete control:
✓ raidselector.can.use Open the UI
✓ raidselector.admin Manage translations & admin tools
✓ raidselector.difficulty.easy Access Easy raids
✓ raidselector.difficulty.medium Access Medium raids
✓ raidselector.difficulty.hard Access Hard raids (VIP)
✓ raidselector.difficulty.expert Access Expert raids (VIP)
✓ raidselector.difficulty.nightmare Access Nightmare raids (VIP)
✓ raidselector.buyraidspecific Purchase selected bases
✓ raidselector.buyraidrandom Purchase random bases
Smart UI: Buttons automatically hide when players lack permissions
Perfect for VIP tiers: Grant higher difficulties to premium players
Flexible control: Allow browsing but restrict purchasing
═══════════════════════════════════════════════════════════════════
GETTING STARTED - 5 MINUTES TO LAUNCH
═══════════════════════════════════════════════════════════════════
INSTALLATION (2 minutes)
1. Install RaidableBases plugin (required)
2. Drop RaidSelector.cs into oxide/plugins/ or carbon/plugins/
3. Server automatically loads plugin and creates config
4. Done! Players can immediately use /rs
FOR PLAYERS (30 seconds)
1. Type /rs in chat (or click RAID SELECTOR in ServerPanel)
2. Pick a difficulty level from the left panel
3. Browse bases in the middle or click "Random"
4. Hit "Buy" button - raid spawns instantly!
FOR ADMINS (Optional customization)
• Grant basic access: o.grant group default raidselector.can.use
• Create VIP tiers: o.grant group vip raidselector.difficulty.expert
• Add translations: /rsinitlang es (Spanish, French, German, etc.)
• Customize colors and base info in config file
• Add base images via ImageLibrary/ImageDatabase
• Enable Debug mode in config for detailed startup diagnostics and troubleshooting logs
MULTILINGUAL SETUP (1 minute per language)
1. Run: /rsinitlang <language> (e.g., /rsinitlang es)
2. Edit: oxide/lang/es/RaidSelector.json
3. Reload: o.reload RaidSelector
4. Players see their Steam language automatically!
PLUGIN INTEGRATION
REQUIRED
• RaidableBases - Core raid system and base configurations
OPTIONAL (Enhance functionality)
• Economics - Use server currency ($) for purchases
• ServerRewards - Use reward points (RP) for purchases
• ImageLibrary (Oxide) - Show base preview images
• ImageDatabase (Carbon) - Show base preview images
• ServerPanel - Unified menu integration (/info command)
Works with ANY combination of optional plugins
Costs automatically detected from RaidableBases config
Supports dual currency: Economics + ServerRewards together!
KEY CONFIGURATION OPTIONS
Config automatically created at: oxide/config/RaidSelector.json
BRANDING & APPEARANCE
• ChatCommand - Change /rs to your preferred command
• Colors - 24+ RGBA colors for complete UI theming
• Base info - Custom names, descriptions, builder credits
• Images - Add preview images via URLs
ACCESS CONTROL
• RequiresOxidePermission - Public or permission-based access
• DifficultyPermissions - Enable/disable difficulties, require permissions
• BuyButtonPermissions - Control who can purchase raids
INTEGRATION
• ServerPanelConfig - Enable/configure ServerPanel integration
- Works standalone, embedded, or both modes
- Perfect for unified server menu systems
All settings hot-reload with: o.reload RaidSelector
SMART PAYMENT SYSTEM
AUTOMATIC COST DETECTION
• Reads costs from RaidableBases config (no duplicate setup!)
• Supports Economics, ServerRewards, Custom Costs, or any combination
• Plugin-based currencies supported via RaidableBases custom costs
• Free raids supported (no payment required)
FLEXIBLE DISPLAY
• Economics only: "Easy ($500)"
• ServerRewards only: "Easy (100 RP)"
• Dual currency: "Easy ($500 + 100 RP)"
• Custom costs: item and plugin currency amounts displayed
• Free raids: "Easy"
PLAYER-FRIENDLY
• Clear cost display before purchase
• Payment handling delegated to RaidableBases (balance checks, charges, refunds)
• Supports free raids with no payment required
USE CASES & SERVER TYPES
PERFECT FOR:
• PvE servers wanting organized raid content
• PvX servers with economy-based raid access
• VIP/donor servers with tiered content access
• International servers needing multi-language support
• High-population servers requiring performance optimization
• Servers using ServerPanel for unified menu systems
POPULAR CONFIGURATIONS:
• Public Easy/Medium, VIP-only Hard/Expert/Nightmare
• Browse free, purchase requires VIP subscription
• Progressive unlocking: rank up to access harder raids
• Multi-language: Spanish, French, German, Russian supported
• Branded UI matching your server's color scheme
WHAT PLAYERS WILL LOVE
✓ No complicated commands - just /rs or click ServerPanel
✓ See exactly what you're buying with images and descriptions
✓ Know the cost before clicking - clear pricing display
✓ Interface in their own language automatically
✓ Instant raid spawning - no waiting
✓ Professional, polished experience
WHAT ADMINS WILL LOVE
✓ 5-minute setup, works immediately out of box
✓ No manual cost configuration - reads from RaidableBases
✓ Permission system perfect for VIP monetization
✓ Easy translation management for international players
✓ Extensive customization without code editing
✓ Works on both Oxide AND Carbon servers
✓ Detailed configuration documentation included
✓ Debug mode for troubleshooting configuration issues
✓ Automatic Russian config key translation for RaidableBases
✓ New bases auto-detected on reload - zero maintenance
DOCUMENTATION & SUPPORT
INCLUDED DOCUMENTATION:
• CONFIGURATION.md - Complete setup guide with examples
• User changelog - All features and updates
• Design documents - Technical architecture details
FULL CONFIGURATION GUIDE:
Comprehensive 1900+ line documentation covering:
• Installation walkthrough
• Permission system examples
• Color customization guide
• Multi-currency setup
• Localization system
• ServerPanel integration
• Troubleshooting solutions
• Real-world configuration examples
Base Image Library
I've started a git repository with images we've started collecting of different bases. Feel free to create a pull request if you have any additional base images you'd like to share with others. See the README for information about contributing and creating the pull request.
