DediPlus Plugin Description
Features
DediPlus is a configurable resource-management plugin for ARK: Survival Evolved. It provides map-wide dedicated storage intake from mounted dinos and a permission-based crafting resource pull system for nearby tribe inventories, dinos, and dedicated storage.
What It Does
DediPlus contains two separate resource systems.
The
The
Administrators may bypass command permissions when AdminBypass is enabled.
Mounted Dino Dedicated Storage Intake
Players use
DediPlus checks:
Matching resources are removed from the mounted dino and added to the correct dedicated storage.
Unsupported resources, blocked resources, and overflow remain in the dino inventory.
The plugin can fill multiple dedicated storages assigned to the same resource when FillMultipleDedisForSameResource is enabled.
Map-Wide Dedicated Storage Detection
The
To reduce repeated full-map scans, detected dedis are cached per tribe for the configured DediCacheSeconds value.
DediClassNameContains controls which structure class-name fragments are recognized as dedicated storage.
ResourceAllowList and ResourceBlockList can further control which resource classes are transferred.
Custom Dedicated Storage Items
The CustomDediItems section allows specifically configured resources to be assigned and deposited into dedicated storage even when vanilla ARK normally rejects them.
This is suitable for resources such as Organic Polymer.
Custom item matching can use:
Only explicitly configured items are allowed. Avoid adding weapons, saddles, cryopods, artifacts, or other non-resource items unless they are intentionally meant to be stored in dedicated storage.
Crafting Resource Pull
The
Create a custom inventory folder named:
Place the desired engrams or physical blueprints inside that folder, then run a command such as:
DediPlus calculates the resources needed to craft 100 of every valid recipe inside the folder.
The plugin then:
The recipes or blueprints remain in the folder.
Quality Blueprint Costs
Physical quality blueprints may require more resources than their base engram.
DediPlus reads the calculated crafting requirements from the blueprint rather than using only the base engram cost.
For example, if a quality Crossbow blueprint requires:
then
Any matching resources already inside the crafting station are subtracted before sources are scanned.
Multiple Recipes
Every valid recipe inside the
If multiple recipes require the same resource, DediPlus combines those requirements into one total.
For example:
The combined requirement is 800 Metal Ingots, not two unrelated pulls from every source.
The requested amount applies to each recipe in the folder.
Pull Sources
ResourcePull groups can independently allow pulling from:
All sources must belong to the same tribe.
PullRangeInFoundations controls the search distance for each permission group.
The plugin distributes the total missing requirement across available sources and stops as soon as the requirement is fulfilled.
It does not intentionally pull the full requested amount from every matching container.
Dedicated Storage Withdrawal
Dedicated storage does not expose its stored resources as ordinary inventory stacks.
DediPlus uses the dedicated storage blueprint's own exact
For large withdrawals, the plugin temporarily raises the player's weight capacity, withdraws the exact amount through the player inventory, transfers it into the opened crafting inventory, and restores the player's original weight settings immediately afterward.
The dedicated storage's own logic remains responsible for reducing its stored resource count.
Permission Groups
ResourcePull supports multiple permission groups.
Each group can configure:
When a player matches more than one group, DediPlus selects the strongest applicable group based on the configured capabilities and limits.
Example uses:
Protected Resources
IgnoreResourcesPullFrom prevents important resources from being drained from configured source types.
Examples include:
Source matching uses configured class-name fragments.
This protection applies only when the resource is being pulled from that source type.
Messages and Logging
DediPlus can send configurable player-facing messages for:
Optional debug logging includes:
Debug should normally remain disabled unless troubleshooting.
Commands
The chat command names can be changed in the configuration where supported.
Configuration
The plugin can be configured for:
Requirements
Features
DediPlus is a configurable resource-management plugin for ARK: Survival Evolved. It provides map-wide dedicated storage intake from mounted dinos and a permission-based crafting resource pull system for nearby tribe inventories, dinos, and dedicated storage.
- Mounted dino intake – sends matching resources from a mounted dino into tribe dedicated storage
- Map-wide dedicated storage support – /dedi can locate matching tribe dedis anywhere on the map
- Automatic resource matching – detects which resource each dedicated storage is assigned to
- Multi-dedi filling – can distribute one resource across multiple matching dedicated storages
- Overflow protection – resources that cannot fit remain in the mounted dino inventory
- Transfer limits – configurable maximum quantity moved per /dedi use
- Cooldown support – configurable player cooldown for the /dedi command
- Tribe safety – only same-tribe dedicated storage is used
- Dedicated storage caching – map-wide scans are cached per tribe to reduce server load
- Custom dedicated storage items – allows specifically configured resources that vanilla dedicated storage normally refuses
- Exact-list custom item safety – only configured item classes and blueprint paths are allowed
- Crafting folder resource pull – pulls resources for engrams and blueprints placed inside a custom inventory folder
- Quality blueprint support – calculates the actual crafting cost of quality blueprints
- Multi-recipe support – combines requirements for every recipe inside the pull folder
- Existing-resource detection – subtracts resources already present in the opened crafting inventory
- Exact craft amounts – /pull 100 pulls what is needed to craft 100 of each recipe in the folder
- Nearby source scanning – can pull from tribe structures, dinos, and dedicated storage within a configurable range
- Permission-based pull groups – different permissions can receive different ranges and maximum craft amounts
- Dedicated storage exact withdrawal – uses the dedicated storage blueprint's own withdrawal path
- Protected source resources – prevents configured resources such as generator Element from being drained
- Configurable player messages – command results, errors, cooldowns, and reload messages can be customized
- Debug logging – detailed transfer and resource-pull diagnostics
- Runtime reload – reloads the configuration without restarting the server
What It Does
DediPlus contains two separate resource systems.
The
/dedi system transfers resources from the inventory of the dino a player is currently riding into matching tribe dedicated storage.The
/pull system examines engrams and blueprints inside a configured folder in the currently opened crafting inventory. It calculates the resources required for the requested craft amount, subtracts anything already present in the crafting inventory, and pulls only the remaining amount from valid nearby tribe sources.Administrators may bypass command permissions when AdminBypass is enabled.
Mounted Dino Dedicated Storage Intake
Players use
/dedi while mounted on a dino.DediPlus checks:
- the plugin is enabled
- the player has the configured permission
- the player is mounted
- the mounted dino has an inventory
- matching same-tribe dedicated storage exists
- the dedicated storage has room
- the resource is not blocked
- the configured transfer maximum has not been reached
Matching resources are removed from the mounted dino and added to the correct dedicated storage.
Unsupported resources, blocked resources, and overflow remain in the dino inventory.
The plugin can fill multiple dedicated storages assigned to the same resource when FillMultipleDedisForSameResource is enabled.
Map-Wide Dedicated Storage Detection
The
/dedi command can find tribe dedicated storage anywhere on the current map.To reduce repeated full-map scans, detected dedis are cached per tribe for the configured DediCacheSeconds value.
DediClassNameContains controls which structure class-name fragments are recognized as dedicated storage.
ResourceAllowList and ResourceBlockList can further control which resource classes are transferred.
Custom Dedicated Storage Items
The CustomDediItems section allows specifically configured resources to be assigned and deposited into dedicated storage even when vanilla ARK normally rejects them.
This is suitable for resources such as Organic Polymer.
Custom item matching can use:
- generated class names
- exact short class names
- full loadable blueprint paths
Only explicitly configured items are allowed. Avoid adding weapons, saddles, cryopods, artifacts, or other non-resource items unless they are intentionally meant to be stored in dedicated storage.
Crafting Resource Pull
The
/pull <amount> command works with the crafting inventory currently opened by the player.Create a custom inventory folder named:
pullPlace the desired engrams or physical blueprints inside that folder, then run a command such as:
/pull 100DediPlus calculates the resources needed to craft 100 of every valid recipe inside the folder.
The plugin then:
- combines shared resource requirements
- calculates quality blueprint costs
- checks what is already inside the crafting inventory
- pulls only the missing amount
- searches allowed nearby tribe sources
- stops once every requirement is fulfilled or no more valid resources are available
The recipes or blueprints remain in the folder.
Quality Blueprint Costs
Physical quality blueprints may require more resources than their base engram.
DediPlus reads the calculated crafting requirements from the blueprint rather than using only the base engram cost.
For example, if a quality Crossbow blueprint requires:
- 68 Wood
- 240 Fiber
- 48 Metal Ingots
then
/pull 100 calculates:- 6,800 Wood
- 24,000 Fiber
- 4,800 Metal Ingots
Any matching resources already inside the crafting station are subtracted before sources are scanned.
Multiple Recipes
Every valid recipe inside the
pull folder is included.If multiple recipes require the same resource, DediPlus combines those requirements into one total.
For example:
- Recipe A needs 500 Metal Ingots
- Recipe B needs 300 Metal Ingots
The combined requirement is 800 Metal Ingots, not two unrelated pulls from every source.
The requested amount applies to each recipe in the folder.
/pull 20 means resources for 20 crafts of every recipe, not 20 items from each storage container.Pull Sources
ResourcePull groups can independently allow pulling from:
- nearby structures
- nearby dinos
- nearby dedicated storage
All sources must belong to the same tribe.
PullRangeInFoundations controls the search distance for each permission group.
The plugin distributes the total missing requirement across available sources and stops as soon as the requirement is fulfilled.
It does not intentionally pull the full requested amount from every matching container.
Dedicated Storage Withdrawal
Dedicated storage does not expose its stored resources as ordinary inventory stacks.
DediPlus uses the dedicated storage blueprint's own exact
WithdrawAmount function to remove the requested quantity safely.For large withdrawals, the plugin temporarily raises the player's weight capacity, withdraws the exact amount through the player inventory, transfers it into the opened crafting inventory, and restores the player's original weight settings immediately afterward.
The dedicated storage's own logic remains responsible for reducing its stored resource count.
Permission Groups
ResourcePull supports multiple permission groups.
Each group can configure:
- permission name
- enabled state
- pull range
- structure pulling
- dino pulling
- dedicated storage pulling
- maximum craft amount
When a player matches more than one group, DediPlus selects the strongest applicable group based on the configured capabilities and limits.
Example uses:
- normal players receive a shorter range and lower craft limit
- Patreon players receive a larger range and higher craft limit
- administrators bypass permission checks when enabled
Protected Resources
IgnoreResourcesPullFrom prevents important resources from being drained from configured source types.
Examples include:
- Element inside Tek Generators
- Element or Element Shards inside Tek Replicators
- Element or Element Shards inside Tek Stryders
Source matching uses configured class-name fragments.
This protection applies only when the resource is being pulled from that source type.
Messages and Logging
DediPlus can send configurable player-facing messages for:
- missing permission
- missing mounted dino
- command cooldown
- no dedicated storage found
- no crafting inventory open
- missing pull folder
- empty pull folder
- invalid pull amount
- partial resource pulls
- successful resource pulls
- config reload success or failure
Optional debug logging includes:
- dedicated storage discovery
- resource-class matching
- quantities requested and moved
- source inventory details
- quality blueprint requirement calculations
- dedicated storage withdrawals
- temporary weight changes
- resources already present in the crafting station
- missing resources after a pull
Debug should normally remain disabled unless troubleshooting.
Commands
/dedi– while mounted on a dino, sends matching resources from the dino inventory into same-tribe dedicated storage/pull <amount>– pulls the missing resources needed to craft the specified amount of every recipe inside thepullfolder/pullprobe– diagnostic command used to inspect the currently opened inventory and detected pull-folder recipesdediplus.reload– reloads the plugin configuration from player console, server console, or RCON
The chat command names can be changed in the configuration where supported.
Configuration
JSON:
{
"Enabled": true,
"Debug": false,
"Command": "dedi",
// Chat command without slash. Players use /dedi in game.
"Permission": "dediplus.use",
// Required ArkPermissions permission for /dedi.
"AdminBypass": true,
// Server admins can use commands without the configured permission when true.
"RequireSameTribe": true,
// Only sends resources to dedis owned by the mounted dino/player tribe.
"AllowAlliedStructures": false,
// Reserved. Current build keeps this false/same tribe for safety.
"CooldownSeconds": 10,
"DediCacheSeconds": 60,
// Map-wide dedicated storage scan is cached per tribe for this many seconds.
"MaxItemsPerUse": 500000,
// Maximum total item quantity moved per /dedi command.
"FillMultipleDedisForSameResource": true,
// Allows /dedi to continue filling additional matching dedis when one becomes full.
"LeaveOverflowOnDino": true,
// Resources that cannot fit remain in the mounted dino inventory.
"SendSummary": true,
// Sends the player a chat summary after /dedi finishes.
"IncludeEmptyDedisFromAllowList": true,
// Empty dedis cannot reveal their assigned resource from inventory.
// Add exact resource class names to ResourceAllowList if you want empty assigned dedis detected by allow-list checks.
"DediClassNameContains": [
"DedicatedStorage",
"StorageBox_Dedicated",
"StorageBox_DedicatedStorage"
],
// Actor full name must contain one of these strings.
"ResourceAllowList": [],
// Empty = only resources discovered inside matching dedis are moved.
// Optional exact classes, example: "PrimalItemResource_Stone_C".
"ResourceBlockList": [],
// Exact resource classes that should never be moved by /dedi.
"CustomDediItems": {
"Enabled": true,
"Debug": false,
"AllowManualDeposit": true,
"InjectBlueprintPathsIntoAllowList": true,
// Allows exact configured item classes to be assigned and deposited into dedicated storage,
// including resources vanilla dedicated storage normally blocks.
// Items are short/exact class names used by the validation hook.
// ItemBlueprintPaths are full loadable blueprint class paths injected into empty/unassigned dedi allow lists.
// Keep this exact-list only. Do not add saddles, weapons, cryos, or artifacts unless intentional.
"Items": [
"PrimalItemResource_Polymer_Organic_C"
],
"ItemBlueprintPaths": [
"/Game/PrimalEarth/CoreBlueprints/Resources/PrimalItemResource_Polymer_Organic.PrimalItemResource_Polymer_Organic_C"
]
},
"ResourcePull": {
"Enabled": true,
// Enables the crafting resource pull system.
"ChatCommand": "/pull",
// Command players use. Syntax: /pull <craft amount>
// Example: /pull 100 pulls the combined missing resources needed to craft 100 of every recipe in the configured folder.
"FolderName": "pull",
// Custom folder name inside the open crafting inventory.
// Place engrams or physical blueprints in this folder before using /pull.
"Groups": {
"Default": {
"Permission": "dediplus.pull",
// Required ArkPermissions permission for this pull group.
"Enabled": true,
"PullRangeInFoundations": 100,
// Search radius measured in foundation lengths. One foundation is treated as approximately 300 Unreal units.
"PullFromStructures": true,
// Allows resources to be pulled from nearby same-tribe structure inventories.
"PullFromDinos": true,
// Allows resources to be pulled from nearby same-tribe dino inventories.
"PullFromDedicatedStorage": true,
// Allows exact required amounts to be withdrawn from nearby same-tribe dedicated storage.
"MaxCraftAmount": 100
// Highest amount this group may request with /pull.
},
"PVEPatreon": {
"Permission": "PVEPatreon",
"Enabled": true,
"PullRangeInFoundations": 200,
"PullFromStructures": true,
"PullFromDinos": true,
"PullFromDedicatedStorage": true,
"MaxCraftAmount": 500
}
// Players matching multiple groups receive the strongest matching group, based on the largest pull range.
},
"IgnoreResourcesPullFrom": {
"TekGenerator": [
"PrimalItemResource_Element"
],
"TekReplicator": [
"PrimalItemResource_Element",
"ElementShard"
],
"TekStrider": [
"PrimalItemResource_Element",
"ElementShard"
]
}
// Prevents /pull from taking selected resources from matching source structure/dino class names.
// This is useful for protecting fuel such as Element in generators, replicators, and Tek Stryders.
// Keys are partial source class/name matches. Values are partial resource class-name matches.
},
"Messages": {
"Prefix": "DediPlus:",
"NoPermission": "You do not have permission to use this command.",
"PermissionsUnavailable": "Permissions plugin is not loaded. Try again later.",
"MustBeMounted": "You must be mounted on a dino to use /dedi.",
"Cooldown": "Command is on cooldown. Try again in {seconds}s.",
"NoDediFound": "No tribe dedicated storage found on the map.",
"NoInventory": "Mounted dino inventory was not found.",
"NothingMoved": "Nothing moved. No matching dedi with room was found for this dino inventory.",
"Moved": "Moved {total} items into dedicated storage.",
"Reloaded": "DediPlus config reloaded.",
"ReloadFailed": "DediPlus config reload failed. Check DediPlus.log."
}
}
The plugin can be configured for:
- global enable or disable
- debug logging
- administrator bypass
- /dedi permission
- /dedi cooldown
- map-wide dedi cache duration
- per-command transfer limits
- multiple matching dedis
- resource allow and block lists
- custom dedicated storage resources
- /pull folder name
- permission-based pull groups
- pull range
- maximum craft amount
- structure, dino, and dedi source toggles
- protected resources by source type
- player-facing messages
Requirements
- ARK: Survival Evolved Dedicated Server
- Ark Server API 3.56
- ArkPermissions / Permissions plugin when permission-gated access is used
