LimitPortalFarms The All-in-One Farm & Lag Limiter
----------------------------------------
About This Plugin
Are you tired of gold farms, piston lag machines, or constant raid farms bringing your server's performance (TPS) to a crawl?
LimitPortalFarms is a lightweight, powerful solution designed to give server owners full control over these common sources of lag.
This plugin intelligently limits the most abusive farm designs, protecting your server without impacting legitimate players.
Portal Farms: Stops entities from instantly teleporting (e.g., Gold/Piglin Farms).
Piston Machines: Prevents pistons from pushing massive numbers of blocks (e.g., Lag Machines).
Raid Farms: Adds a cooldown to raid triggers (e.g., Emerald/Totem Farms).
With a fully commented
config.yml, you can target only the most harmful farm designs while leaving normal player builds untouched.
----------------------------------------
Features
► Portal Farm Limiter
Teleport Delay: Set a minimum time (in ticks) a mob must be alive before it can use a portal. This effectively neutralizes "zero-tick" or instant-teleport farm designs.
Random Delay Range: Adds a random additional delay to the base timer, preventing all entities from teleporting on the exact same tick and smoothing out lag spikes.
Per-World Control: You can select which worlds the limiter is active in (e.g., only world_nether).
► Piston Limiter
Blocked Materials: Completely prevent pistons from pushing or pulling specific materials (e.g., SLIME_BLOCK).
Block Count Limit: Set the maximum number of a specific block type that a single piston action can move (e.g., "max 1 GOLD_BLOCK" or "max 3 OBSIDIAN").
► Raid Farm Limiter
Raid Cooldown: Add a server-wide cooldown (in seconds) that a player must wait between triggering new raids. This slows down AFK emerald and totem farms.
► General Features
Lightweight & Optimized: Designed to have a minimal impact on server performance.
Full Admin Control: Easy-to-use commands like reload, info, and debug.
----------------------------------------
Configuration (config.yml)
All features are easily managed through the extensively commented
config.yml.
# How long (in ticks) a mob must be alive before it can use a portal.
# This prevents mobs from instantly teleporting in high-speed farms (e.g., gold farms).
# 20 ticks = 1 second. 900 ticks = 45 seconds.
teleport-delay-ticks: 900
# Adds a random additional delay (in ticks) to the base teleport-delay-ticks.
# This helps to prevent all mobs from teleporting at the exact same time.
# A value of 40 means a random delay between 0 and 40 ticks will be added.
random-extra-delay-range: 40
# --- Raid Farm Limiter ---
# Cooldown (in seconds) a player must wait between triggering new raids.
# This is used to limit raid-based farms (e.g., emerald/totem farms).
# Set to -1 to disable this feature.
raid-farm-cooldown: 300
# --- General Settings ---
# The portal limiter will ONLY apply to worlds in this list.
# If the list is empty, the limiter will apply to ALL worlds.
enabled-worlds:
- "world"
- "world_nether"
piston:
# A list of materials that pistons are NOT allowed to push or pull.
# This is useful for banning materials commonly used in lag machines (e..g, slime blocks).
blocked-materials:
- "SLIME_BLOCK"
# The maximum number of a specific block type a single piston push/pull can move.
# This stops contraptions that move huge numbers of heavy blocks (like gold/obsidian).
# The format is: MATERIAL_NAME: <max_amount>
block-limits:
GOLD_BLOCK: 1
OBSIDIAN: 3
NETHERITE_BLOCK: 2
DIAMOND_BLOCK: 5
# --- Debug ---
# Set to true to see detailed messages in the console about what the plugin is doing.
# This is useful for debugging or checking if the limits are working correctly.
debug: false
----------------------------------------
Commands & Permissions
The base permission for all commands is
limitportalfarms.admin.
► /limitportalfarms reload
Reloads the config.yml file.
► /limitportalfarms info
Displays the current plugin settings (delays, limits, debug mode, etc.).
► /limitportalfarms debug <on|off>
Toggles debug mode on or off. Useful for diagnosing issues.
► /limitportalfarms tickrates
Shows the current mob spawn tick rates for the world you are in.
► /limitportalfarms clear
Clears the internal NMS reflection cache (advanced).
----------------------------------------
Found a bug or have a suggestion? Let me know! This plugin is provided as-is. Please back up your server before installing.