# VideoTriggers

Create interactive video trigger zones on your Rust server. Players can automatically watch MP4 videos when entering configured areas, with support for replay buttons, item-based videos, rewards, and configurable help videos.

Features

* Create video trigger zones at any location.
* Automatically play an MP4 video when a player enters a trigger.
* Players who have already watched a video receive a Replay button instead.
* Create item-based video triggers requiring a specific item and Skin ID.
* Consumes the required item when the item video is triggered.
* Optional configurable rewards can be given after watching an item video.
* Track which players have watched each video.
* Reset video views for individual trigger zones.
* Remove video triggers in-game.
* Optional hidden trigger spheres.
* Configurable replay button position, text, size, colour, icon and transparency.
* Optional help video interface with thumbnails and titles.
* Help videos support multiple pages with Next/Back navigation.
* Trigger points can optionally be cleared automatically when a new save occurs.
* Configuration is stored automatically in the plugin config.

Permissions

The plugin uses:

videotriggers.use

Admins automatically have access. Non-admin players require the permission to create and manage video triggers.

Commands

Create a Video Trigger

/CreateVideo MP4_URL Trigger_Radius

Creates a trigger at your current position. Players entering the configured radius will automatically play the video.

Create an Item Video

/CreateVideoItem MP4_URL ItemID SkinID

Run this while inside an existing video trigger. The configured item will be consumed when the player triggers the video.

Item videos can also be configured with a reward item, reward Skin ID, custom reward name and reward amount.

Clear Video Views

/ClearVideoViews

Resets the watched status for players on the video trigger you are currently inside, including completed item videos.

Remove Video Trigger

/RemoveVideo

Removes the video trigger you are currently inside.

Help Videos

The plugin supports configurable help videos with:

* Video URL
* Title
* Thumbnail
* Multiple pages
* Next/Back navigation

Players can select a video from the CUI interface to play it.

Configuration

The configuration allows you to customize:

* Replay button location
* Replay text
* Text size and colour
* Replay icon Skin ID
* Icon transparency
* Trigger sphere visibility
* Whether trigger points are cleared on a new save
* Custom video trigger points
* Help videos