TameBlock Plugin Description
Features
TameBlock is a dino restriction plugin built around wipe progression. It can block specific creatures from being tamed, claimed, or released from cryopods until their tier unlocks, while also supporting permanently disabled dinos.
What It Does
TameBlock checks dinos against configured restriction rules.
It can stop players from:
The plugin supports two main restriction styles:
Permanent restrictions
These dinos stay blocked until removed from the permanent restriction list.
### Wipe progression restrictions
These dinos stay blocked only until their configured tier unlock time is reached.
Each tier can have its own:
Cryopod Handling
TameBlock can inspect supported cryopod items and determine which dino is stored inside.
If that stored dino is currently restricted, the release is blocked and the player receives a timed or permanent-style message depending on the source of the restriction.
This makes it useful for progression servers that want to stop early access through cryopods, not just normal taming.
Announcement Behavior
When a tier unlocks, the plugin can announce it once using:
The plugin tracks whether a tier has already been announced so the same unlock does not keep rebroadcasting repeatedly.
Logging / Monitoring
Optional logging includes:
Blocked messages are also rate-limited so players and logs are not spammed repeatedly.
Admin Controls
-
Configuration
The plugin can be configured for:
Requirements
Features
TameBlock is a dino restriction plugin built around wipe progression. It can block specific creatures from being tamed, claimed, or released from cryopods until their tier unlocks, while also supporting permanently disabled dinos.
- Tame blocking – prevents configured dinos from being tamed
- Claim blocking – prevents configured dinos from being claimed
- Cryo release blocking – prevents configured dinos from being released from cryopods
- Permanent restriction lists – supports dinos that are disabled indefinitely
- Wipe progression tiers – unlocks restricted dinos over time based on minutes since wipe start
- Tier-based action control – each tier can independently block tame, claim, and cryo release
- One-time unlock announcements – announces when a tier becomes available
- Multiple announcement types – supports chat, screen, and Discord-style webhook announcements
- Optional admin bypass – server admins can be exempted if enabled
- Blocked-action logging – can log blocked tame, claim, and cryo release attempts
- Reload support – config can be reloaded without restarting
What It Does
TameBlock checks dinos against configured restriction rules.
It can stop players from:
- taming a blocked creature
- claiming a blocked creature
- releasing a blocked creature from an allowed cryopod item
The plugin supports two main restriction styles:
Permanent restrictions
These dinos stay blocked until removed from the permanent restriction list.
### Wipe progression restrictions
These dinos stay blocked only until their configured tier unlock time is reached.
Each tier can have its own:
- unlock time in minutes after wipe
- blocked dino list
- tame block setting
- claim block setting
- cryo release block setting
- announcement settings
Cryopod Handling
TameBlock can inspect supported cryopod items and determine which dino is stored inside.
If that stored dino is currently restricted, the release is blocked and the player receives a timed or permanent-style message depending on the source of the restriction.
This makes it useful for progression servers that want to stop early access through cryopods, not just normal taming.
Announcement Behavior
When a tier unlocks, the plugin can announce it once using:
- chat announcements
- on-screen announcements
- Discord/webhook announcements
The plugin tracks whether a tier has already been announced so the same unlock does not keep rebroadcasting repeatedly.
Logging / Monitoring
Optional logging includes:
- blocked tame attempts
- blocked claim attempts
- blocked cryo release attempts
- tier unlock announcements
Blocked messages are also rate-limited so players and logs are not spammed repeatedly.
Admin Controls
-
TameBlock.reloadConfiguration
JSON:
{
"_comment": "Reference config for TameBlock. Copy the real settings you want into config.json. Fields starting with _comment are only explanations and can be removed.",
"General": {
"_comment": "Basic plugin behavior.",
"Enabled": true,
"CheckUnlocksIntervalSeconds": 30,
"_comment_CheckUnlocksIntervalSeconds": "How often TameBlock checks whether a timed tier has unlocked and needs to announce.",
"LogBlockedActions": true,
"_comment_LogBlockedActions": "Writes only real blocked tame, claim, and cryo actions to the plugin log.",
"LogAnnouncements": true,
"_comment_LogAnnouncements": "Writes one line when a tier unlocks and its announcement is sent.",
"AdminBypass": false,
"_comment_AdminBypass": "If true, server admins bypass all TameBlock checks.",
"Debug": false,
"_comment_Debug": "Extra debug logging. Leave false unless you are troubleshooting."
},
"Database": {
"_comment": "Cluster-wide wipe timing is read from the database. Clearing these tables on wipe resets progression.",
"Use_Mysql": true,
"Host": "127.0.0.1",
"Port": 3306,
"Database_Name": "",
"Username": "",
"Password": "",
"Use_SSL": false
},
"Cryo": {
"_comment": "Controls the cryo items TameBlock is allowed to inspect. The blocked notification is shown on screen, not in chat.",
"Allowed_Cryo_Item_Blueprints": [
"Blueprint'/Game/Mods/WRG/BP/Items/Cryopod/PrimalItem_Cryopod_Kav_WRG.PrimalItem_Cryopod_Kav_WRG'"
],
"_comment_Allowed_Cryo_Item_Blueprints": "Only listed cryo items are checked for stored dinos before release.",
"Blocked_Message_Timed": "You cannot release that creature yet.",
"_comment_Blocked_Message_Timed": "On-screen message shown when a timed-tier blocked dino is inside a cryo and the player tries to release it.",
"Blocked_Message_Permanent": "That creature is disabled on this server.",
"_comment_Blocked_Message_Permanent": "On-screen message shown when a permanently blocked dino is inside a cryo and the player tries to release it."
},
"PermanentRestrictions": {
"_comment": "Always-blocked dinos. These ignore wipe timers and stay blocked until removed from this list.",
"Enabled": true,
"Block_Tame": true,
"Block_Claim": true,
"Block_Cryo_Release": true,
"Dinos": [
"Blueprint'/Game/PrimalEarth/Dinos/Argentavis/Argent_Character_BP.Argent_Character_BP'"
],
"_comment_Dinos": "You can use full blueprint paths, blueprint names, or class names. Full blueprint paths are recommended."
},
"WipeProgression": {
"_comment": "Timed unlock system. Each tier unlocks after the listed number of minutes from wipe_start_utc in the database.",
"Enabled": true,
"Tiers": {
"tier_1": {
"_comment": "Example first unlock tier.",
"Enabled": true,
"UnlockAfterMinutes": 360,
"_comment_UnlockAfterMinutes": "360 = 6 hours, 720 = 12 hours, 1440 = 24 hours.",
"Block_Tame": true,
"Block_Claim": true,
"Block_Cryo_Release": true,
"Dinos": [
"Blueprint'/Game/Aberration/Dinos/Nameless/Xenomorph_Character_BP_Male_Tamed.Xenomorph_Character_BP_Male_Tamed'",
"Blueprint'/Game/Aberration/Dinos/Nameless/Xenomorph_Character_BP_Female_Tamed.Xenomorph_Character_BP_Female_Tamed'"
],
"Announcements": {
"_comment": "Announcement options for this tier when it becomes available.",
"Chat": {
"Enabled": true,
"Text": "Tier 1 creatures are now enabled!",
"Color": [
70,
255,
255
],
"ServerName": "TameBlock"
},
"Screen": {
"Enabled": false,
"Text": "Tier 1 creatures are now enabled!",
"DisplayTime": 15,
"DisplayScale": 1.5,
"Color": [
70,
255,
255
]
},
"Discord": {
"Enabled": false,
"Webhook_URL": "",
"_comment_Webhook_URL": "If left empty, no Discord message is sent for this tier.",
"Message": "@everyone Tier 1 creatures are now enabled!"
}
}
},
"tier_2": {
"Enabled": true,
"UnlockAfterMinutes": 720,
"Block_Tame": true,
"Block_Claim": true,
"Block_Cryo_Release": true,
"Dinos": [],
"Announcements": {
"Chat": {
"Enabled": true,
"Text": "Tier 2 creatures are now enabled!",
"Color": [
70,
255,
255
],
"ServerName": "TameBlock"
},
"Screen": {
"Enabled": false,
"Text": "Tier 2 creatures are now enabled!",
"DisplayTime": 15,
"DisplayScale": 1.5,
"Color": [
70,
255,
255
]
},
"Discord": {
"Enabled": false,
"Webhook_URL": "",
"Message": "@everyone Tier 2 creatures are now enabled!"
}
}
}
}
},
"Messages": {
"_comment": "Plugin-side text messages.",
"Prefix": "[TameBlock]",
"ReloadSuccess": "TameBlock config reloaded.",
"ReloadFail": "Failed to reload TameBlock config."
}
}
The plugin can be configured for:
- global enable/disable
- admin bypass
- debug mode
- check interval for unlock progression
- allowed cryopod item types
- blocked messages for timed and permanent restrictions
- permanent restriction lists
- wipe progression tiers
- per-tier unlock times
- per-tier announcements
- optional MySQL-backed wipe/tier state
Requirements
- ARK: Survival Evolved Dedicated Server
- Ark Server API 3.56
