UltimateCases is a customizable Rust case-opening system featuring animated roulette, RP-powered cases, free daily rewards, rarity-based loot, player vaults, jackpots, and an in-game case editor. Integrated with ServerRewards and ImageLibrary, it provides a complete case shop experience with configurable rewards, drop chances, permissions, and player tracking.

UltimateCases — Advanced Rust Case Opening System

UltimateCases is a fully customizable case-opening and reward system for Rust servers, featuring animated roulette spins, RP-powered cases, free daily rewards, rarity-based loot, jackpots, and a powerful in-game editor.

Give your players a new way to spend their Reward Points, earn valuable loot, and compete for rare rewards — all through a modern, interactive case shop.

Features

🎰 Animated Case Opening & Roulette

• Smooth, animated roulette-style case openings.
• Configurable spin speed, duration, and visual effects.
• Preview available rewards before opening a case.
• View actual winning probabilities for each reward.
• Five rarity tiers: Common, Uncommon, Rare, Epic, and Legendary.
• Customizable case artwork, reward icons, and rarity colors.

💰 ServerRewards Integration

• Full integration with the ServerRewards RP currency system.
• Set individual RP prices for each case.
• Automatically deduct RP when purchasing case openings.
• Award RP directly as a case reward.
• Support for completely free and premium cases.
• Track RP spent and earned through case openings.

🎁 Free Daily Cases

• Give players free case openings every 24 hours.
• Configure how many free openings each case allows.
• Rolling 24-hour cooldowns for each player.
• Automatically remind players when free cases become available.
• Dedicated Free Cases section in the storefront.
• Optional global and individual case opening limits.

💎 Rare Rewards & Custom Loot

• Add virtually any standard Rust item as a reward.
• Configure item quantities, skins, and individual drop chances.
• Support bundled rewards containing multiple items.
• Create custom command-based rewards.
• Award ServerRewards RP instead of physical items.
• Customize reward names and images.
• Automatically normalize weighted probabilities.

🏆 Jackpot System

• Optional progressive jackpot system.
• Automatically contribute a configurable percentage of paid case RP costs to the jackpot.
• Configure which reward rarity triggers a jackpot win.
• Award jackpot payouts through the RP system.
• Broadcast jackpot wins to the server.
• Track jackpot winners, payouts, and historical statistics.

The jackpot system is disabled by default and can be enabled in the configuration.

📦 Player Reward Vault

• Store unclaimed rewards in a dedicated player vault.
• Claim individual rewards whenever convenient.
• Claim all available rewards with one action.
• Configure maximum vault capacity.
• Optionally drop rewards at the player's feet when inventory and vault storage are full.
• Persistent reward storage across player disconnects.

🛠️ In-Game Case Editor

Manage your case shop directly from Rust without manually editing JSON files.

• Create and delete cases.
• Edit case names and descriptions.
• Adjust RP prices and daily opening limits.
• Enable or disable free daily openings.
• Configure case-specific permissions.
• Add, edit, and remove rewards.
• Modify reward quantities and drop probabilities.
• Manage reward icons and item shortnames.
• Save changes directly to the plugin configuration.

👑 VIP & Permission-Based Cases

• Create exclusive cases for VIPs, donors, or special groups.
• Assign custom Oxide permissions to individual cases.
• Display restricted cases in a dedicated VIP section.
• Configure exclusive rewards and RP pricing.
• Control access independently for each case.

📢 Automated Announcements

• Automatically advertise the case shop in server chat.
• Configurable announcement intervals and messages.
• Notify players about available free cases.
• Display current jackpot information in announcements.
• Announce rare and valuable wins.
• Optional Discord webhook integration.
• Allow authorized staff to send announcements manually.

📊 Statistics & Tracking

• Track total case openings.
• Separate paid and free opening statistics.
• Monitor RP spent and RP awarded.
• Track item and command rewards.
• Record recent case activity.
• Maintain individual player statistics.
• Monitor jackpot contributions and payouts.
• Configure which statistics are retained during server wipes.

🎨 Customizable Interface

• Modern, dark-themed case storefront.
• Dedicated Shop, Free Cases, VIP, and Vault sections.
• Customizable accent colors.
• ImageLibrary integration for case thumbnails and reward artwork.
• Native Rust item icon support.
• Reward rarity indicators and color-coded displays.
• Paginated case listings and vault inventory.

Player Commands

/cases

• Opens the UltimateCases storefront.
• Browse available cases and rewards.
• Open paid or free cases.
• Access VIP cases when permitted.
• View and claim rewards from the vault.

/opencases

• Alternative command for opening the case shop.
• Provides the same functionality as /cases.

All other player interactions are handled through the in-game interface.

Staff & Administration

UltimateCases includes a permission-protected administration panel and case editor.

ultimatecases.edit

• Grants access to the in-game case editor.
• Allows authorized staff to manage cases and rewards.
• Provides access to administrative controls and statistics.

uc.diag — Console command

• Runs plugin diagnostics.
• Reports configured case and reward counts.
• Checks ServerRewards and ImageLibrary availability.
• Identifies invalid item shortnames and configuration warnings.

Additional Staff Features

• Enable or disable automatic announcements.
• Toggle free-case reminders for joining players.
• Broadcast custom messages.
• Trigger announcements manually.
• Edit case configurations through the in-game UI.
• Review case opening statistics.

Dependencies

ServerRewards

• Used for RP purchases and RP-based rewards.
• Required for RP currency functionality.

ImageLibrary

• Used for custom case images and reward icons.
• Optional; native item icons and fallback visuals are supported.

Configuration

UltimateCases provides extensive configuration options, including:

• Case names, descriptions, and thumbnails.
• RP costs and daily opening limits.
• Free daily case eligibility and cooldowns.
• Item rewards, command rewards, and RP rewards.
• Reward quantities, skins, and winning probabilities.
• Custom rarity thresholds and colors.
• Progressive jackpot settings.
• Storefront appearance and accent colors.
• Player vault capacity and reward handling.
• Automatic announcements and chat messages.
• Discord webhook settings.
• Player data retention and wipe behavior.

Configuration file: oxide/config/UltimateCases.json

Data file: oxide/data/UltimateCases_Data.json

Why UltimateCases?

UltimateCases provides more than a basic random loot system. It combines an interactive player-facing case shop with flexible reward configuration, RP economy integration, daily engagement mechanics, and staff management tools.

Whether you're rewarding daily activity, creating VIP perks, introducing high-value loot cases, or offering players another way to spend RP, UltimateCases gives you the flexibility to build a case-opening experience around your server.

Plugin: UltimateCases
Version: 3.7.0
Platform: Rust / Oxide / uMod
Player Commands: /cases, /opencases
Admin Permission: ultimatecases.edit