Caged Plugin Description
Features
Caged is a player-controlled captivity timer plugin for ARK that allows players to mark themselves as caged, track the remaining time, and automatically die if they are not freed before the configured timer expires.
Commands
Player chat commands:
Console / RCON commands:
In-game admin console command:
-
How It Works
When a player types
When
While the timer is active:
When
When the player dies normally:
When the timer expires:
Admin Controls
- reloads
- lists all active caged timers in the in-game admin console
- removes an active timer without killing the player
Discord Webhook Events
Each Discord event can be enabled or disabled independently:
Webhook messages support:
Configuration
Timer data is stored in:
-
Requirements
JOIN DISCORD
Features
Caged is a player-controlled captivity timer plugin for ARK that allows players to mark themselves as caged, track the remaining time, and automatically die if they are not freed before the configured timer expires.
- Player-started caged timer – players can start their own captivity timer through chat
- Confirmation protection – optional confirmation step prevents accidental timer activation
- Remaining-time command – players can check exactly how long remains on their active timer
- Immediate uncaged command – players can clear their timer as soon as they are freed
- Automatic expiry death – kills the player when the configured caged duration ends
- Death-based cleanup – normal player death clears the active timer
- Persistent timer storage – active timers survive server restarts and player relogs
- Offline expiry handling – expired players can be killed when they reconnect
- SteamID-based tracking – timers are stored against the player's SteamID
- Admin timer controls – admins can list, remove, or force-complete timers
- Admin kill command – admins can kill an online player directly by SteamID
- Runtime reload support – reloads config without restarting the server
- Configurable player messages – all player-facing messages can be edited in config
- Discord webhook support – sends configurable event notifications to Discord
- Independent webhook switches – server owners choose which events are sent
Commands
Player chat commands:
/caged/caged confirm/caged time/uncaged
Console / RCON commands:
Caged.reloadCaged.remove <SteamID>Caged.kill <SteamID>
In-game admin console command:
-
Caged.listHow It Works
When a player types
/caged, the plugin explains the system and asks for confirmation when confirmation is enabled.When
/caged confirm is used:- the player's SteamID and character name are recorded
- an absolute expiration time is calculated from
CagedDurationMinutes - the timer is written immediately to
ActiveTimers.json - the player receives the configured timer-started message
- an optional Discord webhook notification is sent
While the timer is active:
/caged timedisplays the remaining time- relogging does not remove the timer
- restarting the server does not remove the timer
- attempting to start another timer reports the current remaining time
When
/uncaged is used:- the active timer is removed immediately
- the updated timer file is saved immediately
- the player receives the configured uncaged message
- an optional Discord webhook notification is sent
When the player dies normally:
- the active timer is removed when
ClearTimerOnDeathis enabled - an optional player-death webhook is sent
When the timer expires:
- the plugin kills the online player
- the active timer is removed
- an optional timer-ended webhook is sent
- if the player is offline, the configured reconnect behavior is applied when they return
Admin Controls
Caged.reload- reloads
config.json without restarting the serverCaged.list- lists all active caged timers in the in-game admin console
Caged.remove <SteamID>- removes an active timer without killing the player
Caged.kill <SteamID>- finds the specified online player
- kills the player immediately
- clears their active caged timer
Discord Webhook Events
Each Discord event can be enabled or disabled independently:
- player starts a caged timer
- player dies with an active timer
- caged timer reaches zero
- player uses
/uncaged
Webhook messages support:
{player}{steamid}{minutes}
Configuration
JSON:
{
"CagedDurationMinutes": 60,
"RequireConfirmation": true,
"ClearTimerOnDeath": true,
"KillExpiredPlayerOnReconnect": true,
"Debug": false,
"MessageColor": [
0.0,
1.0,
1.0,
1.0
],
"Messages": {
"CommandInfo": "This starts your caged timer. Type /caged confirm to continue. Use /caged time to check an active timer.",
"TimerStarted": "Your caged timer has started. You will die in {minutes} minutes unless you use /uncaged after being freed.",
"AlreadyActive": "You already have an active caged timer. Time remaining: {time}.",
"NoActiveTimer": "You do not have an active caged timer.",
"TimeRemaining": "Your caged timer has {time} remaining.",
"Uncaged": "Your caged timer has been cancelled. You are marked as freed.",
"TimerExpired": "Your caged timer has expired."
},
"DiscordWebhook": {
"Enabled": false,
"WebhookUrl": "",
"Username": "Caged",
"AvatarUrl": "",
"EmbedColor": 15158332,
"SendOnCagedCommand": true,
"SendOnPlayerDeath": true,
"SendOnTimerEnded": true,
"SendOnUncagedCommand": true,
"Messages": {
"CagedTitle": "Player Caged",
"CagedMessage": "**{player}** (`{steamid}`) started a caged timer for **{minutes} minutes**.",
"DeathTitle": "Caged Player Died",
"DeathMessage": "**{player}** (`{steamid}`) died with an active caged timer.",
"TimerEndedTitle": "Caged Timer Ended",
"TimerEndedMessage": "**{player}** (`{steamid}`) reached the end of the caged timer and was killed.",
"UncagedTitle": "Player Uncaged",
"UncagedMessage": "**{player}** (`{steamid}`) used `/uncaged` and cleared the active timer."
}
}
}Timer data is stored in:
-
ArkApi/Plugins/Caged/ActiveTimers.jsonRequirements
- ARK: Survival Evolved Dedicated Server
- Ark Server API 3.56
JOIN DISCORD
