About RandomSystem
-
RandomSystem is a plugin that Give players random items—on a global timer or whenever they jump. Includes per-item limits, blacklist, DLC/hidden item filtering, multiple UI countdown styles, and full in-game configuration via chat commands.
-
Features :
- - Two modes: timed (global countdown) and jump-triggered (per player).
- - Timed mode gives items to all online players (toggle with /random giveall).
- - Jump mode gives items only to the player who jumps, with a per-player delay.
- - Amount control: fixed stack size or random up to a max. You can also set per-item max when using a curated list.
- - Item sources:
- * Config-only pool (shortname => max random)
- * All game items (respecting blacklist/DLC/hidden filters)
- - Blacklist: exclude any item shortnames.
- - DLC & hidden item filtering: optionally include DLC/skin/hidden items (WARNING: enabling DLC items may risk server ban—use at your own discretion). Optional PlayerDLCAPI integration for accurate filtering.
- - Countdown UI options: Off / GameTip / ProgressUI / SimpleTimerUI.
- - Inventory aware: tries to place in main, then belt; if full, drops at player’s feet. Optional "received item" chat messages.
- - Live tweaking via chat: toggle give-all, edit delays & countdown, switch amount mode, manage blacklist/items, toggle DLC/hidden filtering, etc.
- - Customizable chat prefix and permission name in config.
-
- Built-in /random help prints all available commands.
-
Permission :
-
- Default:
randomsystem.use
(You can override the permission name via the config key: Plugin Settings -> Use Permission.)
-
Commands :
-
Quote
- CHAT COMMANDS (type /random help in game for a list)
-
/random time start - Start the timed random event /random time stop - Stop the timed random event /random jump start - Enable jump-based item rewards /random jump stop - Disable jump-based rewards /random giveall true|false - Give timed rewards to all players (timed mode requires this ON) /random jumpdelay <seconds> - Delay between jump rewards per player /random countdown <seconds> - Global countdown for timed mode /random showmsg true|false - Toggle "received item" chat messages /random limitconfig true|false - Limit to config items (true) or allow all items (false) (Blacklist/DLC/hidden filters still apply) /random dlcitems true|false - Include DLC/skin items (WARNING) /random hiddenitems true|false - Include hidden items /random amount fixed <n> - Fixed stack size /random amount random <max> - Random stack size [1..max] /random blacklist list /random blacklist add <shortname> /random blacklist remove <shortname> /random items list /random items add <shortname> <max> - Add/override a config item with per-item max random /random items remove <shortname>
- CONSOLE COMMANDS
-
random.time start/stop random.jump start/stop
-
Example config :
Quote
{
"Plugin Settings": {
"Prefix Text": "[RandomSystem]",
"Prefix Color": "#00FF00",
"Use Permission": "randomsystem.use",
"Give To All Players": true,
"Jump Item Delay (seconds)": 2.0,
"Countdown Time (seconds)": 10,
"Countdown UI (0=Off, 1=GameTip, 2=ProgressUI, 3=SimpleTimerUI)": 1,
"Show Item Message": true,
"Limit To Config Items Only": true,
"Include DLC Items (WARNING: your server may be banned for this)": false,
"Include Hidden Items": false
},
"Limits": {
"Enable Random Amounts": false,
"Max Random Amount (when random enabled)": 50,
"Fixed Item Amount (when random disabled)": 10,
"Config Items (shortname => max random)": {
"wood": 1000,
"stone": 500,
"metal.fragments": 250
},
"Blacklist (shortnames)": [
"motorbike"
]
},
"Config Version": "1.1.0"
} -
Example Lang :
Quote
{
"NoPermission": "You don't have permission to use this command.",
"EventAlreadyRunning": "The timed random event is already running.",
"NoActiveEvent": "There is no active timed random event.",
"EventStarted": "Timed random event started! Countdown begins...",
"EventStopped": "The timed random event has been stopped.",
"RandomJumpAlready": "Random jump mode is already enabled.",
"NoActiveJump": "Random jump mode is not enabled.",
"RandomJumpStarted": "Random jump mode enabled. Jump to receive random items.",
"RandomJumpStopped": "Random jump mode has been disabled.",
"ReceivedItem": "You received {0} {1}!",
"InventoryFull": "Your inventory is full! {0} {1} has been dropped on the ground.",
"NoValidItems": "No valid items to give (check blacklist/DLC/hidden filters)."
}
