LagReducer \u2014 dynamic distances, safe clearing, and smart entity caps for Paper 1.21.8
\nKeep TPS high without gutting gameplay. LagReducer dynamically lowers a player\u2019s view\/simulation distance only while they\u2019re moving fast, periodically clears clutter with safety guards, and caps entity counts per-chunk with precise, configurable rules.<\/p>\n
Why use LagReducer?
\n– Smooth performance: Reduce client\/server load only when it matters (elytra\/flying\/vehicles\/high speed).
\n– Safe cleanup: Configurable warnings, blacklists, and name exemptions protect valuables and pets.
\n– Hard caps where you need them: Per-chunk totals, categories, and per-type limits with a limiter blacklist.<\/p>\n
Features
\n– Dynamic Distance (per-player)
\n – Lowers view and simulation distance while: flying, gliding, in vehicles, or exceeding a speed threshold (blocks\/sec).
\n – Auto-restores distances after slowing down (with hysteresis and minimum switch delay).
\n – Honors a bypass permission for staff\/testing.
\n– Clear Items & Entities
\n – Automatic timed clearing with broadcast warnings (customizable times).
\n – Category toggles: items, living entities, XP orbs, projectiles, misc.
\n – Blacklists for item materials and entity types.
\n – Optional \u201cexempt named entities\u201d to protect pets and named mobs.
\n– Entity Limiter (per-chunk)
\n – Limits for total, items, living, monsters, animals, ambient.
\n – Per-entity-type caps (e.g., ZOMBIE: 12).
\n – Limiter blacklist: completely ignore certain types (don\u2019t count them and never cancel them).
\n – Ignore selected spawn reasons (e.g., CUSTOM, COMMAND, SPAWNER_EGG).
\n – Debug logging option.<\/p>\n
Commands
\n– \/lagreducer reload \u2014 Reload config and restart features
\n– \/lagreducer clear \u2014 Run an immediate clear
\n– \/lagreducer status \u2014 Show feature toggles and clear interval
\nAlias: \/lr<\/p>\n
Permissions
\n– lagreducer.admin \u2014 Use reload\/status and admin functions
\n– lagreducer.clear \u2014 Allow manual clear command
\n– lagreducer.bypass.distance \u2014 Exempt player from dynamic distance changes<\/p>\n
Config at a glance
\n– Dynamic distance tuning:
\n – sampleTicks, speedThresholdBps, restoreHysteresisFactor, minSwitchMillis
\n – fastViewDistance, fastSimulationDistance, consider: flying\/gliding\/vehicles
\n– Clearer safety:
\n – warnAtSeconds, exemptNamedEntities
\n – entityBlacklist, itemBlacklist
\n– Entity limiter controls:
\n – perChunk: total\/items\/living\/monsters\/animals\/ambient (set -1 to disable a cap)
\n – perType: per-entity-type caps
\n – blacklist: types ignored entirely by the limiter
\n – ignoreSpawnReasons, debug<\/p>\n
Example config snippet
\n“`yaml
\ndynamicDistance:
\n enabled: true
\n sampleTicks: 10
\n speedThresholdBps: 12.0
\n restoreHysteresisFactor: 0.7
\n minSwitchMillis: 1500
\n fastViewDistance: 6
\n fastSimulationDistance: 4
\n consider: { flying: true, gliding: true, vehicles: true }<\/p>\n
clearer:
\n enabled: true
\n intervalSeconds: 600
\n warnAtSeconds: [60, 30, 10, 5, 3, 2, 1]
\n exemptNamedEntities: true
\n categories: { items: true, living: true, xpOrbs: true, projectiles: false, misc: false }
\n entityBlacklist: [ARMOR_STAND, ITEM_FRAME, PAINTING]
\n itemBlacklist: [NETHER_STAR, DRAGON_EGG, SHULKER_BOX]<\/p>\n
entityLimiter:
\n enabled: true
\n blacklist: [ARMOR_STAND, ITEM_FRAME, PAINTING]
\n perChunk:
\n total: 150
\n items: 80
\n living: 100
\n monsters: 60
\n animals: 60
\n ambient: 20
\n perType: { ZOMBIE: 12 }
\n ignoreSpawnReasons: [CUSTOM, SPAWNER_EGG, COMMAND]
\n debug: false
\n“`<\/p>\n
Compatibility and requirements
\n– Server: Paper 1.21.5+ (and compatible forks)
\n– Java: 21
\n– No NMS, API-only; safe across minor patches.
\n– No external dependencies.<\/p>\n
Installation
\n– Drop LagReducer.jar into plugins\/
\n– Start the server to generate config
\n– Edit plugins\/LagReducer\/config.yml
\n– Use \/lagreducer reload to apply changes<\/p>\n
Notes
\n– Set any limiter value to -1 to disable that specific cap.
\n– Blacklists protect entities\/items from clearing or limiting.
\n– Works alongside most optimization plugins; avoid running multiple \u201cclear lag\u201d plugins at once to prevent conflicts.<\/p>\n","protected":false},"excerpt":{"rendered":"
A plugin that will help a server from lagging.<\/p>\n","protected":false},"featured_media":91570,"template":"","meta":{"_minecraft_slug":"lagreducer","_minecraft_project_id":"Ga5QsrBe","_minecraft_author":"DoomQZ","_minecraft_license":"MIT","_minecraft_downloads":352,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lagreducer.zip","_minecraft_size_bytes":19661,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:18:48.126620Z","_minecraft_date_created":"2025-08-12T03:24:06.605860Z","_minecraft_date_modified":"2025-08-11T21:07:36.602851Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lagreducer","_minecraft_icon_attachment_id":91570,"_minecraft_imported_at":"2026-06-05T05:33:45+00:00","_minecraft_import_hash":"dd8d065aa9623b301a4b373fc0f90812","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,90,127,129,92],"mod_loader":[132,134],"minecraft_version":[78,79,80,81],"class_list":["post-91569","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n