StringDuper Documentation
View Project Details →Deterministic server-side string farming with strict validation and lag reduction.
Overview
StringDuper is a server-side string farming system designed to provide stable, predictable, and optimized string production. It uses strict structure validation and intelligent farm management to maintain reliable operation while reducing unnecessary entity and physics overhead.
Features
- Deterministic server-side farm processing
- Optimized item spawning
- Smart overlap-aware farm detection
- Side-by-side farm compatibility
- Strict tripwire structure validation
- Configurable active farm limits
- 64-block player proximity activation
- Reduced entity and physics lag
- Cached farm validation
- Event-assisted hook tracking
- Silent production with optional debug mode
- Multiplayer-safe farm management
- Configurable spawn intervals and batch sizes
- Lightweight tick-based processing
Required Items
To construct a standard StringDuper module, gather the following materials:
| Item | Quantity |
|---|---|
| Chest | 8 |
| Hopper | 4 |
| Glass | 8 |
| Tripwire Hook | 2 |
| Trapdoor | 2 |
| Smooth Stone | 17 |
| Water Bucket | 2 |
| Lever | 1 |
Farm Conditions & Activation
▸Required Farm Conditions:
For a farm to operate correctly:
- The tripwire chain must remain fully attached.
- The required hooks must be correctly positioned.
- Trapdoors, levers, and water must be placed correctly.
- The structure must remain fully valid.
- Farms must not overlap or intersect.
- A player must remain within 64 blocks of the farm.
- Invalid structures are automatically disabled.
▸Farm Activation:
A farm becomes active when:
- 1The structure is completely valid.
- 2All required components are correctly positioned.
- 3The farm is not overlapping another farm.
- 4A player is within 64 blocks.
- 5The farm is within its applicable active-farm limits.
Once active, the farm automatically produces string according to the configured production interval.
String Production Intervals
StringDuper uses configurable tick intervals to control production speed:
| Interval | Output | Approximate Rate |
|---|---|---|
| 20 ticks (Default) | 2 string | ≈ 2.0 string/sec |
| 15 ticks | 2 string | ≈ 2.67 string/sec |
| 10 ticks | 1 string | ≈ 2.0 string/sec |
| 5 ticks (Max Speed) | 1 string | ≈ 4.0 string/sec |
Configuration
StringDuper provides configurable farm management and production settings.
▸Default Configuration:
- Maximum active farms across the server: 32
- Maximum active farms per world: 16
- Unlimited per-player farms enabled by default
- Debug mode disabled by default
- Player feedback messages enabled
- Warning messages are rate-limited
- Default production interval: 20 ticks
- Default production amount: 2 string
▸Configuration file locations:
- Mod:
config/StringDuper.json - Plugin:
plugins/StringDuper/StringDuper.json
We recommend avoiding manual changes to the JSON configuration unless necessary.
{
"max_active_farms_server": 32,
"max_active_farms_world": 16,
"unlimited_player_farms": true,
"debug_mode": false,
"player_feedback": true,
"rate_limit_warnings": true,
"production_interval_ticks": 20,
"production_amount": 2
}Validation, Limits & Multiple Farms
▸Farm Validation:
StringDuper continuously maintains farm validity through cached validation and event-assisted hook tracking. The system checks for:
- Tripwire integrity
- Hook placement
- Required structural components
- Farm overlap & intersection
- Valid water placement
- Required trapdoors and levers
If the structure becomes invalid, production is immediately disabled.
▸Multiple Farms:
Side-by-side farms are supported as long as they remain valid and do not overlap or intersect. Overlapping or intersecting farms are intentionally suppressed to prevent conflicts and excessive processing.
Troubleshooting & Warnings
▸Farm is not producing string:
- Check that a player is within 64 blocks.
- Verify the tripwire chain is fully attached.
- Ensure hooks, trapdoors, levers, and water are placed correctly.
- Check whether the farm overlaps another structure.
- Verify the farm has not exceeded the active-farm limit (32 server / 16 world).
▸Farm suddenly stopped:
The farm may have been disabled because its structure became invalid. Check for broken tripwires, missing hooks, or modified adjacent blocks.
▸Warnings:
- Overlapping or intersecting farms are intentionally suppressed.
- Breaking tripwire structure integrity immediately disables the farm.
- Extremely large-scale farm setups may still impact server performance.
- Debug mode should remain disabled during normal gameplay.