Trucker Event

Try Before You Buy at Karuza's Plugin Corner - https://discord.gg/jxwVpn9mEq

The Trucker Event brings utility and some role play fun to the custom vehicle truck/trailer combos from Karuza's Plugin Corner.

Trailers will spawn at configured monuments, marked on the map, ready to be picked up.

Trailers automatically spawn at configured monuments and must be picked up by the trucks. Players then transport them to randomized delivery zones within a specified time limit, earning trucker XP and spendable trucker points for successful deliveries. Additionally, if all trailers during the event runtime are delivered, a configurable bonus of trucker points and XP can be given to all players that successfully delivered a trailer.

The plugin features a flexible route system, allowing fully random deliveries (default) or predefined routes between specific monuments. You can configure different delivery types which can yield different XP, trucker point rewards, trailer prefabs, time limits, and spawn locations.

Players receive guidance through map markers that display trailer locations, as well as marking delivery locations when towed.

The built-in progression system allows players to rank up through configurable trucker ranks, earn spendable trucker points, and use those points in the integrated trucker item store. Store items can be locked behind specific ranks, allowing you to create a full delivery-based progression loop directly inside the plugin.

Several vanilla monuments are pre-configured with trailer spawn positions and drop off locations. You can easily change the locations or add additional monuments in the config file. I recommend using RustEdit to define positions relative to the monument.

With built-in commands, you can create custom monument positions, add trailer spawn points, and define delivery zones in-game.

The plugin is aimed at PVE/RP servers, however PVP action can still take place in the form of destroying trailers to prevent players getting rewarded, or hijacking towed trailers from other players.

The plugin also includes a full trucker UI, allowing players to view their profile, rank, XP progress, total deliveries completed, distance towed, leaderboards, and spendable points, as well as browse and purchase items from the point store.

An optional Outpost restock extension is also included, allowing NPC vending machines to only get restocked when a delivery is made to the Outpost (does not affect vending machines modified via custom vending setup).

Core concept:

• Trailers spawn at configured monuments
• Players attach them to their trucks
• Deliver to a randomized destination within a time limit
• Earn trucker XP and spendable trucker points for successful deliveries
• Rank up and spend earned points in the built-in trucker store

Spawn and delivery points:

• Supports all vanilla monuments with several pre-configured
• Optionally add custom positions anywhere on the map using commands
• Multiple spawn points and delivery zones per monument are supported
• Configure monument delivery type restrictions, or leave them empty to allow all delivery types

Route system:

• Fully random routes between available monuments
• Optionally configure delivery routes between specific monuments
• Control which delivery types can spawn where
• Delivery types can optionally force a specific trailer prefab, or use a random trailer from the configured list

Visual and audio cues:

• Trailer locations, their destination and remaining time will be displayed on the map
• When a trailer is attached, driver will see the destination on the map, in addition to a visible marker
• If the trailer is lost/detached, an audio cue will warn the driver, and a chat message will advise the trailer has detached
• Successful delivery, attachment, and detachment all support built-in event feedback cues

Progression and point store:

• Successful deliveries award configurable trucker XP and spendable trucker points
• Distance towed awards configurable XP
• Optional XP penalty can be applied if a trailer is lost while towing
• Bonus trucker XP and points can be awarded to all participating players if all trailers are delivered
• Players rank up through configurable trucker ranks
• Built-in item store allows players to spend trucker points on configured rewards
• Store items can optionally require a specific trucker rank before they can be purchased

Trucker UI and leaderboards:

• Built-in trucker UI is included directly in the Trucker Event plugin
• Players can open the UI with configurable chat commands
• Profile panel shows current rank, XP progress, total deliveries, towing distance, and spendable points
• Leaderboards display delivery and towing stats across players
• Store panel allows players to browse and purchase configured point-store rewards

Admin Commands:

kot.start - forces the event to start (works in chat and console)

kot.stop - forces the event to end (works in chat and console)

truckercreate "position name" - allows you to create a custom position anchor, for example at a custom monument

truckeraddspawn "position name" - adds a trailer spawn point relative to the custom position name configured above. Spawn rotation will be the direction you are looking when running this command.

truckerdrop "position name" - add a delivery zone relative to the custom position name configured above.

Hooks:

void OnTruckerStart(int eventId) - called when the event starts

void OnTruckerEnd(Dictionary<string, object> summary) - called when the event ends, where summary contains:

• eventId (int)
• spawned (int)
• completed (int)
• failed (int)
• completedByUser (Dictionary<ulong, object>)

API:

bool IsTruckerActive() - returns true if the event is currently running

Example config for use with my Euro Trucks: