Trials 1.0.1

Fight through generated trap rooms and bosses against the clock, earn loot keys and climb the weekly leaderboard.

Trials is a solo gauntlet event for Rust. A player pays an entry fee and is moved into a private arena built in the sky, then fights through procedurally generated rooms and boss arenas against the clock. Each cleared room offers three random buffs for the next one. Keys drop along the way and open bronze, silver and gold crates with loot you configure.

Every run counts toward two leaderboards: a weekly challenge that resets on a fixed day with a countdown on screen, and a general ranking that covers the whole wipe. Players are ranked by how many rooms they cleared, and players who cleared the same number are ranked by total time, so the fastest full clear takes first place.

Players never risk their own gear. Their inventory and position are saved on entry and restored when the run ends, whether they clear it, fail or walk away. Every player gets their own arena, so several players can run Trials at the same time.

The default setup runs 16 rooms over 5 difficulty tiers: 11 normal rooms and 5 bosses, drawn from 20 room files and 5 boss files with no repeats inside a run.

Every room and boss is its own JSON file, so you can change the included ones or write new ones. Edit a room to change its size, challenges, lighting, timer, damage, loadout and key rewards; edit a boss to change its arena, health and skills. Add a file to create a new room or boss. Admins load the changes with /trials.rooms.reload, without reloading the plugin, and test any room or boss on its own with /tri <room name>.

How a run works

1. The player types /trials. The entry screen shows the entry cost and a Start Trial button.
2. The plugin builds a room at a height of 500 m over a random point on the map, away from monuments, safe zones, other Trials rooms and Raidable Bases or Abandoned Bases events, and moves the player into it.
3. The player wakes up with the room's loadout. The room timer starts when they break the twig wall at the entrance, or automatically after 5 minutes.
4. A normal room is cleared by picking up every glowing present before the timer runs out. Presents lie in the open, inside rotating rings of animals, fire or spikes, and behind code-locked doors.
5. A boss room is cleared by killing the boss before the arena timer runs out.
6. After each clear the player picks one of three buffs and presses Next within 5 minutes. The next room is built while they wait.
7. The run ends when honour reaches zero, a timer expires, the final boss dies, or the player leaves or disconnects. A results screen shows the outcome and the new leaderboard position.

Included content

Rooms

Each room always uses the challenges in the third column and rolls its remaining slots from the fourth, so the same room plays differently from run to run.

Bosses

Default progression

The number of tiers, the rooms per tier and whether each tier ends with a boss are set in the main configuration.

All rooms and bosses are files in oxide/data/Trials/Rooms. A file with a Boss section loads as a boss arena; any other file loads as a normal room. /trials.rooms.reload validates every file, skips invalid ones with the reason in the server log, and reports progression problems such as a tier with no rooms or too few files to fill a run without repeats.

Honour instead of health

Inside a Trial, hits do not reduce health. Every source of damage (traps, NPCs, animals, explosions, boss skills, wrong door codes) drains a 1,000-point honour bar instead, and the run ends at zero. Hunger, thirst, bleeding, wetness and temperature are held at safe values for the whole run.

• Clearing a room restores 100 honour by default before the next one.
• Damage per source is set per room: fireballs, landmines, grenades, NPC melee, NPC projectiles and each of the 14 animal types.
• Explosion damage falls off with distance from the blast.

Boss arenas

A boss file defines the arena, the player loadout, the key rewards and the boss itself.

Arena

• 5 layouts: Square, Ring, Cross, Pillars and Twin Halls.
• Duration in seconds and time of day (any hour from 0 to 23, or unchanged).
• Lighting: 5 ceiling, 7 wall and 6 floor light types, each optional (up to 16 wall and 16 floor lights), plus an optional centre torch.

Boss

• Health, opening grace period, chase speed and clothing with skins.
• The fight has three phases. At 70% and 35% health the boss's skill cooldowns drop by 15% and 25%. With Animal Summon enabled, it also howls at each threshold and summons a wave of animals (wolf, tiger, panther or bear).
• While it howls or recovers from its ring attack, it takes extra damage (1.5x by default).
• A boss health bar with configurable anchor, offset and size.

18 skills, each with its own toggle and timings

Portal Ambush is available for your own bosses; the five included bosses leave it off.

Buffs

After each cleared room the player picks one of three random buffs. The buff lasts for the next room. Every buff can be disabled, renamed and given its own value range.

Keys and crates

Keys drop from:

• Clearing a room or a boss (one roll per room, chances set in each file).
• Killing NPCs, circle animals and roaming animals (chances set per challenge).
• The guaranteed key buffs.

Keys are saved the moment they drop, so failing a later room does not take them away. By default, keys reset on a new wipe. /trials.keys opens the key inventory with three crates. Opening a crate spends one key and shows the items won.

• Each tier has its own loot file with minimum and maximum different items. Every entry has a loot chance, amount range, custom name and skin.
• Use economics or serverrewards as the shortname to pay out Economics or ServerRewards points.
• If too few entries pass their roll, the crate tops up from the highest-chance entries to reach the minimum.
• Crate art comes from bronze.png, silver.png and gold.png in oxide/data/Trials/Images; the item icon is used if an image is missing.
• With trials.loottable.view, players see an info button that lists the crate's possible items. With trials.loottable.details, the list also shows each item's chance and amount.

Leaderboards

• Weekly: resets on a configurable UTC day and hour (Monday 00:00 by default), numbers each week ("Weekly challenge #3") and shows a countdown. Players starting a run close to the reset get a warning.
• General: covers the whole wipe and can reset automatically on a new save.
• Top 100 per tab with rank, player, rooms, difficulty reached, bosses defeated, kills and total time.
• Ranking: players who finished every room come first, then the rest by rooms cleared; ties go to the fastest total time. Only each player's best run counts, and the room in progress when the run ends is not counted.

The results screen at the end of a run shows why it ended, rooms cleared, difficulty reached, active play time, honour left, NPC and animal kills, presents collected, keys earned and the change in leaderboard position.

Room challenges

Each room file lists 13 challenge types with an inclusion chance, plus the number of different challenges the room uses. Challenges set to 100% are picked first; the remaining slots are drawn by weight from the rest.

Toxic Zones is available for your own rooms; the 20 included rooms leave it off.

Animal circles and roaming animals draw from 14 types: bear, bull, cow, female and male calf, sheep, lamb, boar, chicken, stag, wolf, panther, tiger and crocodile. Setting an animal's damage to 0 removes it from that room. Ranged and melee NPCs can return to their post when they lose sight of the player, and ranged NPCs strafe after shooting for a set time.

Room generation

• New layout every run. The floor plan is a random connected grid sized by the room file (1 to 10). Rooms that only use lasers get a winding corridor instead.
• Random look. Each room rolls one of 10 grade and skin combinations across wood, stone, sheet metal and armored, including the shipping container skin in 16 colours.
• Lighting modes. Normal, Fire, Dark, Random or Flicker, with configurable dark time, flash length and flashes per burst. Flashlight entries in the loadout are only handed out in dark rooms.
• Time of day. Each room can force an hour from 0 to 23 for the player inside it, or leave the server time unchanged.
• Locked doors (0 to 10). Side closets hold a present behind a code lock. The player presses the button next to the door and its counter shows the 4-digit code one digit at a time, then enters the code on a keypad screen. A wrong code shocks the player for 5 honour, and the code changes every time a door opens.
• Loadout per room. One weapon is picked by weight (entries at 100% always win) with its own ammo amount, and every extra item rolls its own chance. Custom names and skins are supported. The loadout goes on the belt or into a starter box.

Interface

• Entry screen with the cost items (item icons, or a 3-letter currency label for Economics and ServerRewards).
• In-room HUD: honour bar, presents left, time left, room progress ("Room 4/16 - Boss next"), difficulty stars, keys earned this run and the active buff.
• Room name banner on entry, with configurable duration.
• Buff selection cards after each clear, with Next and Stop buttons.
• Keypad screen for locked doors.
• Key inventory, crate loot table and loot result screens.
• Weekly and general leaderboard tabs.
• Results screen.

Server protection

• Inventory, active tea effects and position are restored when the run ends, including on disconnect, plugin unload and server shutdown. If the next room fails to build, the plugin makes up to 6 attempts; if all fail, the run ends and the player is restored.
• During a run players cannot craft, build, deploy, open backpacks or drop their active item. The patrol helicopter ignores them.
• A configurable list of chat and console commands is blocked during a run (teleports, homes, kits, shop, remover and others by default).
• Other players cannot teleport into an active room or pick up presents in someone else's room. Leaving the room's bounds ends the run.
• Traps and room walls cannot be damaged or looted. NPC and animal corpses are removed without loot. Room landmines only go off for players in a Trial.
• Trials unlocks 60 minutes after a wipe by default, and each player has a 10-minute entry cooldown.
• Room construction is spread across frames with an 8 ms budget per frame, dropping to 3 ms when server FPS falls below 15. Cleanup runs in batches the same way.

Installation

1. Put Trials.cs in oxide/plugins.
2. Copy the included data to oxide/data.
3. Give players access: oxide.grant group default trials.join.
4. Review oxide/config/Trials.json, mainly the entry cost, progression, cooldown and wipe settings, then reload the plugin.

Integrations

None are required. The default entry cost is 1,000 scrap plus 1,000 Economics; without Economics installed, the Economics part is hidden and only the scrap is charged. ServerRewards costs work the same way.

Event plugins that call OnEventJoin are told the player is busy while a Trial is running.

API

object IsTrialsEventPlayer(BasePlayer player) // true while the player is in a Trial, otherwise null

Permissions

Server admins can use the admin commands without these permissions.

Commands

Players (chat)

Admins

<player> accepts a SteamID or an online or sleeping player's name. b, s and g work as short tier names.

trials.rooms.reload, trials.givekeys, trials.resetleaderboard and trials.resetkeys also work from the server console and RCON with the same arguments.

Menu buttons and key binds

Languages

15 languages are included: English, Brazilian Portuguese, Russian, Simplified Chinese, Ukrainian, German, Spanish, French, Dutch, Italian, Turkish, Romanian, Korean and Catalan. Each player sees Trials in their own game language; players whose language is not included see the server's default language, or English. All messages and buttons can be edited in the language files.

Data files