AdminAccess Plugin Description
Features
AdminAccess is a controlled temporary-access plugin for ARK that lets approved admins unlock and access nearby locked structure containers without permanently changing their original lock state.
Commands
Chat commands:
Console / RCON command:
-
How It Works
AdminAccess searches for nearby
When
While access is active:
When the timer expires:
Access / Control Logic
Information / Status Output
Configuration
Main settings read from code:
Behavior notes from code:
Requirements
JOIN DISCORD
Features
AdminAccess is a controlled temporary-access plugin for ARK that lets approved admins unlock and access nearby locked structure containers without permanently changing their original lock state.
- Temporary nearby unlock system – scans for nearby structure containers and prepares them for admin access
- Idle-based auto relock – restores structures after the configured idle timeout expires
- Radius-based targeting – only affects containers within the configured search radius
- Plain lock and pin lock support – handles both normal locked containers and pin-locked containers
- Temporary inventory viewing access – grants access through structure and inventory access hooks
- Original state restoration – restores the original locked state, pin-locked state, and original pin code
- Per-admin tracking – active temporary access is tracked per SteamID
- Runtime reload support – reloads config without restarting
- Trace logging – writes detailed operational trace output to a log file
Commands
Chat commands:
/aainfo/aaunlock/aareload
Console / RCON command:
-
adminaccess.reloadHow It Works
AdminAccess searches for nearby
APrimalStructureItemContainer targets around the player and prepares them for temporary access.When
/aaunlock is used:- the plugin gets the admin's location
- scans for eligible structure containers inside
SearchRadius - detects whether each target is plain-locked, pin-locked, or already pending relock
- temporarily unlocks newly matched locked targets
- registers temporary target access so remote inventory viewing and structure access succeed
- starts / refreshes an idle relock timer
While access is active:
- structure access can be forced through the access hook
- inventory viewing can be forced through inventory access hooks
- expiry refreshes while the admin continues interacting
When the timer expires:
- the structure is restored to its original lock state
- the original pin-locked state is restored
- the original pin code is written back
- pending access records are removed
Access / Control Logic
- Allowed SteamID list – only SteamIDs in
AllowedSteamIDsmay use the plugin - Plugin-wide enable flag – entire system can be disabled through config
- Separate TempUnlock toggle – temporary unlock logic can be disabled independently
- Pending relock tracking – prevents repeatedly reprocessing the same active target
- Pending target-access tracking – associates active access with the admin who armed it
Information / Status Output
/aainfo reports:- whether the plugin is enabled
- whether temp unlock is enabled
- active search radius
- idle relock timeout
- pending relock count
- pending target access count
Configuration
JSON:
{
"LicenseKey": "LicenseKey",
"Enabled": true,
"AllowedSteamIDs": [
"76561198000000001",
"76561198000000002"
],
"TempUnlock": {
"Enabled": true,
"IdleRelockSeconds": 30.0,
"SearchRadius": 1000.0
},
"Logging": {
"LogToFile": false
}
}Main settings read from code:
EnabledAllowedSteamIDsTempUnlock.EnabledTempUnlock.IdleRelockSecondsTempUnlock.SearchRadius
Behavior notes from code:
IdleRelockSecondshas a minimum enforced value of1.0SearchRadiushas a minimum enforced value of100.0AutoRelockSecondsis also accepted as an alternate config key for idle relock time
Requirements
- ARK: Survival Evolved Dedicated Server
- Ark Server API 3.56
JOIN DISCORD
