Hiro Of Canton

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. CONFIGURATION.md.zip