Description

Want to troll cheaters you have on your server? Maybe you have taken a clip of them cheating, or want to rick roll them. Maybe you want to show an advertisement to your players?

Then this is the plugin for you!

A friend had wanted to know how he could send a video to play on a cheaters screen, because this person was streaming while cheating, and he had clipped it.

This plugin integrates with Rust’s built in “client.playvideo” command, but with the added benefit of being able to just supply a Youtube URL, or a Twitch URL. The integration with the Twitch and Youtube API is offloaded onto my web server, to minimize outside web calls, and to minimize load on your server.

WARNING! Be careful of the length of the video that you add! Player will have NO input, will NOT be able to F1 kill, or even log out of server until the video is completed! They will need to ALT+F4 if they want to leave before video finishes.

Known Issues:

• Video “could” be closed by a player if they know the client commands and send a video to themselves
• thinking of implementing a “close” button that you can enable on ads etc to allow the user to close the video

Any comments, concerns, questions, or suggestions are greatly appreciated 

To show video on first join of wipe:

Config set both Show a welcome video,  Show welcome video ONLY on first join of the wipe to true. Make sure to delete the file “data/AdminVideo.json” each wipe

"Show a welcome video": true,
"Show welcome video ONLY on first join of the wipe": true,
"Welcome Video URL": "https://www.youtube.com/shorts/hT5BqdjT1Hs",

Links Supported:

• Direct .mp4 link – eg. https://archive.org/download/rick-roll/Rick Roll.mp4
• Youtube Video Link – eg. https://www.youtube.com/watch?v=OvQkif96CTg
• Youtube Shorts Link – eg. https://www.youtube.com/shorts/8sTHiZI_tus
• Twitch Clip Link – eg. https://www.twitch.tv/camomo_10/clip/NastySleepyCockroachFutureMan-ihrWpONnkxv4ayv4

Command works from both ingame console, and RCON console.

Safety Checks:
Commands with safety checks will only send video if the player is:

1.  In a SafeZone AND not mounted (such as on a mini) OR TC Authorized and INSIDE AND not mounted (such as on a mini)
2. AND Has not been in combat for at least 20 seconds

These are to limit the possibility of players being killed while frozen and unable to move. Additional safety checks can be added if needed

Command format:

Send a forced video to a player (no safety checks, perfect for forcing on cheaters):
	adminvideo {steam_id|displayname} {url|shortname}

Send a video to all players (has some safe checks):
	adminvideo all {url|shortname}

Send a video to all players (has NO safe checks):
	adminvideo allunsafe {url|shortname}

Send an ad video to a player (has some safe checks): 
	adminvideo ad {steam_id|displayname} {url|shortname}

Send an ad video to all players (has some safe checks):	
	adminvideo ad all {url|shortname}


Add a video shortname into the config:
	adminsavevideo add {shortname} {url}

Remove a video shortname from the config:
	adminsavevideo remove {shortname}


Example:

Send video to specified steamID (no safety checks)
	adminvideo 123456789 https://www.youtube.com/shorts/8sTHiZI_tus

Send video to player name (no safety checks)
	adminvideo sickness https://www.youtube.com/shorts/8sTHiZI_tus

Send RickRoll video to player name based on saved shortname 
	adminvideo sickness rickroll

Send RickRoll video to all online players based on saved shortname (has safety checks)
	adminvideo all rickroll


Send ad video to specific player (has safety checks)
	adminvideo ad sickness https://www.youtube.com/shorts/8sTHiZI_tus

Send ad video to all online players (has safety checks)
	adminvideo ad all https://www.youtube.com/shorts/8sTHiZI_tus


Add a video shortname into the config:
	adminsavevideo add boom https://www.youtube.com/shorts/8sTHiZI_tus

Remove a video shortname from the config:
	adminsavevideo remove boom

Permissions:

adminvideo.use - to be able to issue videos to players
adminvideo.admin - allows you to use the shortname creation command
adminvideo.adbypass - allows you to bypass "ad" videos

Default Config:

{
  "Admin Bypass Ads/Welcome": false,
  "Show a welcome video": false,
  "Show welcome video ONLY on first join of the wipe": false,
  "Welcome Video URL": "https://www.youtube.com/watch?v=ScMzIvxBSi4",
  "ShortNameVideos": {
    "rickroll": "https://archive.org/download/rick-roll/Rick Roll.mp4"
  }
}

NOTICE:
The backend API for converting youtube/twitch videos, is to be used by the Admin Video Plugin.
Using it for any other purposes, eg. integrating into a bot, or integrating it into another plugin, without express consent/permission from SiCkNeSs, can result in blocking of access to the IP address’s/services that are integrating it, with no notice, or refund.