TO AVOID ISSUES WITH LICENSING PLEASE JOIN DISCORD BEFORE PURCHASING
Features
- Permission-Based Access - Block or allow permission groups from opening specific structures
- Multi-Use Control - Block Unlock/Lock/Pickup and any other multi-use radial option per permission group
- Styled Notifications - Denial messages use the pretty on-screen banner, with per-message text colour, background colour, size, duration, screen position and an optional copy to chat
- Unlimited Custom Messages - Define as many message keys as you want; each can be a plain line of text or a fully styled message
- Blueprint & Name Matching - Target modded or vanilla structures by full blueprint path or by a short partial name
- Priority Groups - Players in a higher-priority group have their rules applied over lower ones
- Commented Config - The config file supports
//comments, so you can leave notes right next to your settings
Example Usage
Unlinked players can not access Drops/Obelisks/Transmitters and thus blocking map travel until they have linked Discord and in Ark. You can also lock specific radial actions - for example disabling the "teleport" option on Tek Teleporters for everyone while the admin has public travel turned off - and show each block with its own coloured banner so players instantly know why.
Configuration
Code:
{
"licenseKey": "", // Your license key
"Debug": false, // Set to true to see access codes and BP paths in the log
// Fallback style for any message field a Messages entry doesn't set.
// Colours: #RRGGBB or #RRGGBBAA. Position/Justification: Left | Center | Right.
"NotifyDefaults": {
"TextColor": "#FFFF00FF",
"BackgroundColor": "#000000CC",
"TextScale": 1.4,
"DisplaySeconds": 5.0, // seconds on screen
"TextJustification": "Center",
"ScreenPosition": "Center",
"AlsoSendToChat": false // true = also mirror the message into chat
},
// Each entry is EITHER a plain string (text only, uses NotifyDefaults)
// OR an object with Text + any style fields to override. Add as many as you like.
"Messages": {
"Link": "You can not access any map travel structure unless you link discord.",
"Admin": "You need to be an admin to access this structure",
"PublicDisabledByAdmin": { // styled example: red text, also sent to chat
"Text": "Public Teleporter Setting has Been Disabled By Admin",
"TextColor": "#FF5555FF",
"BackgroundColor": "#000000DD",
"TextScale": 1.5,
"DisplaySeconds": 6.0,
"AlsoSendToChat": true
}
},
// Permission groups (from the Permissions plugin). Highest Priority a player
// belongs to wins; "Default" (Priority 0) applies to everyone.
"Permissions": {
"Linked": { // group name must match the in-game permission
"Priority": 1, // higher priority overrides lower groups
"Block": {}, // structures blocked from opening (none for this group)
"MultiUse": { // radial options to block on specific structures
"Blueprint'/Game/PrimalEarth/Structures/TekTier/TekTeleporter.TekTeleporter'": {
"Message": "PublicDisabledByAdmin", // message key from Messages above
"Block": [ 67313 ] // multi-use option ID to block
}
// add more structures as needed...
}
},
"Default": { // everyone
"Priority": 0,
"Block": { // structures blocked from opening; value = message key
"TributeTerminal": "Link",
"ArtifactCrate": "Link",
"SupplyCrate": "Link",
"TekTransmitter": "Link",
"CityTerminal": "Link"
},
"MultiUse": {
// same format as above...
}
}
}
}
Configuration Settings
| Setting | Description ||---------|-------------|
|
licenseKey | Your license key for the plugin ||
Debug | Set to true to see access codes and BP paths in the log ||
NotifyDefaults | Default banner style used whenever a message doesn't set its own ||
Messages | Your messages - plain text or a styled object, add as many keys as you like ||
Permissions | Permission groups with their access rules ||
Priority | Higher priority groups override lower priority ones ||
Block | Structures completely blocked from opening ||
MultiUse | Specific multi-use options to block on structures |
Message Styling
TextColor/BackgroundColor- hex,#RRGGBBor#RRGGBBAA(theAAis opacity)TextScale- size of the textDisplaySeconds- how long the banner stays on screenTextJustification/ScreenPosition-Left,CenterorRightAlsoSendToChat- also drop the message into chat- Anything you leave out falls back to
NotifyDefaults, so a plain-text message just inherits your default look
Commands
SHOpenControl.Reload- reloads the config live (RCON or admin console). No restart needed for config changes.
Notes
- The styled banners use the free AsaApiUtils mod - make sure it is installed on your server. If it isn't, blocking still works, the pretty message just won't show.
- You need a linking and permission syncing system if you want to sync a linked role from Discord to in-game
- Personal preference is Shadow Link and ShadowBot for permission syncing
- Structure types can use short names (e.g. TekTransmitter) or full blueprint paths
- Multi-use IDs can be found using debug mode or structure inspection tools
Support/Questions
I Do not Monitor the ArkApi Site on a Daily Bases
Support and Questions are done in discord only
Support and Questions are done in discord only
