HarvestX Plugin Description
Features
HarvestX is a targeted harvest-scaling plugin for ARK that adjusts the quantity of specific harvested item classes as they are added to inventories. It does not globally rewrite harvesting in general; instead, it watches configured resource class names and rescales only those item increments.
How It Works
For watched resources:
Example from the plugin comments:
Safeguards / Special Handling
The plugin avoids scaling in several situations:
It also opens a short suppression window during inventory transfer and stack-merge actions so items are not incorrectly rescaled when players move or merge inventory stacks.
Additional blueprint-pull handling is included:
Commands
Reload output reports:
Configuration
Main settings:
Example default resource entry:
-
Technical Notes
Requirements
JOIN DISCORD
Features
HarvestX is a targeted harvest-scaling plugin for ARK that adjusts the quantity of specific harvested item classes as they are added to inventories. It does not globally rewrite harvesting in general; instead, it watches configured resource class names and rescales only those item increments.
- Per-resource harvest scaling – scales only the resources listed in config.json
- Base-rate normalization – uses a configured BaseHarvestRate as the server's real global harvest rate, then scales target resources relative to that base
- Runtime reload command – supports reloading config and reapplying hook state with
harvestx.reload - Debug logging – logs matches, scaling decisions, and reload state when enabled
- Auto-generated config files – writes both a default config.json and a commentedconfig.json if needed
How It Works
For watched resources:
- it reads the target rate from
Resources - reads the cluster/server baseline from
BaseHarvestRate - computes
scale = target_rate / BaseHarvestRate - multiplies the incoming amount by that scale
- rounds to the nearest whole number
- enforces a minimum result of 1
Example from the plugin comments:
- if your real server-wide harvest rate is 20x
- and
PrimalItemResource_ElementShard_Cis set to 5.0 - the plugin applies a 0.25 multiplier to shard increments so that shards behave like 5x on a 20x server
Safeguards / Special Handling
The plugin avoids scaling in several situations:
- blueprint item increments
- crafting resource consumption
- item use consumption
- ARK tribute item flows
It also opens a short suppression window during inventory transfer and stack-merge actions so items are not incorrectly rescaled when players move or merge inventory stacks.
Additional blueprint-pull handling is included:
- the plugin marks certain BP increment events briefly
- then suppresses duplicate native increment handling for the matching follow-up call
- this helps avoid double-processing for watched resources
Commands
harvestx.reload(chat)harvestx.reload(console)harvestx.reload(RCON)
Reload output reports:
- configured resource count
- whether hooks are active
- matched entry count
- applied/removed scan stats
Configuration
JSON:
{
"Enabled": true,
// Enables or disables the plugin entirely.
"BaseHarvestRate": 20.0,
// IMPORTANT:
// This does NOT change your server harvest rate.
// Set this to your real server-wide harvest multiplier.
// Example: if your cluster is 20x globally, set this to 20.0.
"Resources": {
"PrimalItemResource_Element_C": 5.0
// Format:
// Example above means:
// global server rate = 20x
// element target rate = 5x
// HarvestX applies 5 / 20 = 0.25 to that resource entry.
}
}Main settings:
EnabledBaseHarvestRateResources
Example default resource entry:
-
PrimalItemResource_ElementShard_C: 5.0Technical Notes
- Built for Ark Server API
- Uses hook-based interception rather than map-wide spawn or node overrides
- Tracks a short transfer suppression window (
2000 ms) - Tracks a short BP pull marker window (
1500 ms) - Works by changing item increment quantities at the inventory layer
Requirements
- ARK: Survival Evolved Dedicated Server
- Ark Server API 3.56
JOIN DISCORD
