Ferry Terminal Event

A timed fight over the Ferry Terminal. Guards, snipers, drones and zombies hold the monument. The best loot sits in a locked crate, and starting the hack calls in a Chinook full of elite soldiers.

Runs on Oxide and Carbon. Needs NpcSpawn.

How a round plays out

1. Every two hours by default, the server announces the event. Five minutes later the monument fills up.
2. Guards patrol the yard, snipers hold the rooftops, and a mad scientist waits in the main building with his zombies.
3. Drones circle the terminal. If one spots a player, the alarm goes off and a patrol helicopter comes in and holds the monument.
4. Starting the hack on the locked crate is the point of no return. A Chinook comes in and drops an elite squad on top of whoever is hacking.
5. Looting the hackable crate wins the event. The monument clears five minutes later, so there's still time to grab what's left.

If nobody gets that far, the event ends on its own after 90 minutes.

What you can change

• NPCs. Count, health, damage, loadout and skins for guards, snipers, the scientist and the elite squad. Zombies get a count, health and damage.
• Spawn points. Stand where you want something and type /ftepos. It prints coordinates you paste into the config.
• Crates. Where military, elite and hackable crates spawn, how many, and how long the hack takes.
• Reinforcements. Turn the patrol helicopter or the elite squad off if your player base is small.
• Markers. Map marker, a vending machine marker with a countdown, and visible event borders.

PVE servers

Two options, and you pick one. PveMode by KpucTaJl is the one I recommend. SimplePVESphere is lighter, just a sphere and an owner.

With PveMode, the first player to deal enough damage becomes the event owner, and you decide what everyone else can do: loot crates, hack the locked crate, hurt the NPCs, or even enter the zone.

Leave both off and the event is plain PvP.

Separate switches stop players outside the zone from damaging the NPCs, the drones or the helicopters, so nobody farms the event from a hill.

Rewards and stats

Pays out through Economics, ServerRewards or SkillTree XP. You set an amount for each crate, the hackable crate, each NPC kill, each zombie kill and the patrol helicopter. The plugin splits the helicopter reward evenly between everyone in the event. Rewards are off by default, so installing the plugin doesn't start printing currency.

Players can check their own numbers with /ftestats, and /ftetop opens a top 20 leaderboard.

Notifications

Chat, GUIAnnouncements or UINotify. You pick one in the config. There's also a Discord webhook, off by default.

Commands

Admin chat commands, which need ferryterminalevent.admin:

• /ftestart starts the event now
• /ftestop stops it
• /ftepos prints your position for the spawn point config
• /fte.admin opens the admin panel

For everyone:

• /ftestats shows your lifetime stats. Admins can add a player name to look someone up.
• /ftetop opens the leaderboard

Console:

• ftestart [steamID] starts the event. The Steam ID is optional and makes that online player the event owner, which is handy for testing PVE rules.
• ftestop
• fte.validate checks your config and reports anything wrong

Config you'll probably touch first

"Time to run the event every [sec]": 7200,
"Duration of the event once it start [sec]": 5400,
"Delay after the event start is announce to spawn the event [sec]": 300,
"Delay after the event end is announce to despawn the event [sec]": 300,
"Start the Event ONLY through command and remove Timer ": false,
"Reinforcement: Add a Patrol Helicopter": true,
"Reinforcement: Add Elite Squad": true,
"Amount of Elite Squad to spawn": 5

Already running KpucTaJl's Ferry Terminal plugin?

Both plugins are called FerryTerminalEvent, so they can't load together. The download includes FerryTerminalYacVaguer.cs, a renamed copy that runs alongside his. Install that file instead of FerryTerminalEvent.cs. Its permission is ferryterminalyacvaguer.admin.

Requirements

NpcSpawn is required. Without it nothing spawns.

Everything else is optional. PveMode or SimplePVESphere for PVE rules, Economics, ServerRewards or SkillTree for rewards, and GUIAnnouncements or UINotify for on-screen messages.

For plugin developers

Two hooks:

void OnYVFerryTerminalEventStarted(Vector3 eventCenter, float zoneRadius)
void OnYVFerryTerminalEventEnded(Vector3 eventCenter, float zoneRadius,
                                 ulong ownerSteamId, List<ulong> participantSteamIds)

ownerSteamId is the PveMode owner if there is one, otherwise whoever looted the hackable crate first, otherwise 0.

Two API methods:

bool IsYVFerryTerminalEventActive()
void ResetYVFerryTerminalEventInterval()

ResetYVFerryTerminalEventInterval restarts the countdown to the next automatic event, so event manager plugins can stagger events.