WederLimits
All-in-One Modular Performance Control Suite for Paper & Folia
![[IMG]](//proxy.spigotmc.org/2ce1323529f32dd7d1361998ce0be4ae53a2f85a/68747470733a2f2f696d6775722e636f6d2f526634474f59542e706e67)
All-in-One Modular Performance Control Suite for Paper & Folia
■ Overview
WederLimits is a high-performance modular plugin designed to replace multiple heavy plugins—such as ClearLag, Item Stackers, and standalone Profilers—into a single lightweight jar.
Each of its 8 modules can be toggled on or off independently in real time. When a module is disabled, no Listeners or Tasks are registered, ensuring zero CPU and memory overhead for unused features.
■ Key Features
- 100% Modular Architecture: Individual control over every feature via config.yml or the interactive GUI menu.
- Redstone Limiter: Per-chunk redstone block limiting and dynamic TPS protection (cuts off circuits, pistons, and dispensers during lag spikes).
- Block Limiter: Independent limits for *any* Material type per chunk.
- Mob Limiter: Per-chunk entity limits covering all SpawnReasons. Preserves named, tamed, or leashed mobs. Supports predefined groups (MONSTER, ANIMAL) and custom groups.
- Item Stacker: Intelligent ground-item merging with customizable floating display names, sound effects, and item blacklists.
- Clear Lag: Scheduled or manual item/mob cleanup with configurable Chat and Action Bar warnings.
- TNT Reducer: Limits primed TNT per chunk and prevents lag-inducing chain explosions.
- TPS / RAM Meter: Automated monitoring that triggers console commands when TPS drops or RAM usage crosses thresholds.
- Profiler & Sampler: Lightweight diagnostics for main thread activity, memory usage, GC times, chunk activity profiling, and safe chunk unloading.
- Full i18n & Tiny Font Support: 5 built-in languages (EN, ES, FR, PT, IT), multi-level alerts (Chat, Action Bar, Titles), and small caps Unicode font formatting.
■ Requirements & Dependencies
| Component | Type | Notes |
| Paper / Folia | Required | Native support for 1.20 or higher (api-version: '1.20'). |
| Java 21+ | Required | Compiled with --release 21. Fully forward-compatible. |
| PlaceholderAPI | Optional | Automatically registers the %WederLimits_...% expansion. |
■ Commands
Available Aliases: /wl, /wederlimits, /lagg (Legacy)
- /wl help [page] — Displays paginated available commands based on user permissions.
- /wl version — Shows current plugin version and environment info.
- /wl check [world1 world2...] — Displays limited blocks/mobs registered per world from cache.
- /wl tpchunk <x> <z> [world] — Teleports to the center of the specified chunk.
- /wl tps — Displays estimated server TPS (1m/5m/15m).
- /wl memory — Shows real-time heap memory usage.
- /wl gc — Requests a Garbage Collection from the JVM.
- /wl admin — Opens an inventory GUI to toggle modules on the fly.
- /wl info — Shows TPS protection status and active modules.
- /wl reload — Reloads configurations, language files, and modules.
- /wl rescan — Rescans loaded chunks for blocks and mobs.
- /wl clear — Forces an immediate clear-lag execution.
- /wl killmobs — Removes all unprotected hostile mobs.
- /wl area <radius> — Clears items/mobs within a specific block radius.
- /wl performance — Monitors main-thread usage in real time.
- /wl sampleMemory <seconds> — Analyzes RAM activity and GC duration over a timeframe.
- /wl sampleTicks <ticks> [raw] — Measures average, min, and max duration of upcoming N ticks.
- /wl profile <seconds> <redstone|mobs|blocks> — Profiles and shows the top 5 most active chunks.
- /wl unloadchunks — Safely unloads loaded chunks with no nearby players.
- /wl halt — Emergency brake: stops redstone, pistons, and natural mob spawns.
■ Permission System
By default, WederLimits follows a strict security model: non-OP players without wederlimits.use cannot see or execute any commands.
Code (Text):
Base Permissions:
wederlimits.use (Default: OP) - Access gate to the base command /wl.
wederlimits.admin (Default: OP) - Total access + GUI management via /wl admin.
Command Permissions:
wederlimits.command.help
wederlimits.command.version
wederlimits.command.check
wederlimits.command.tpchunk
wederlimits.command.tps
wederlimits.command.memory
wederlimits.command.gc
wederlimits.command.admin
wederlimits.command.info
wederlimits.command.reload
wederlimits.command.rescan
wederlimits.command.clear
wederlimits.command.killmobs
wederlimits.command.area
wederlimits.command.performance
wederlimits.command.samplememory
wederlimits.command.sampleticks
wederlimits.command.profile
wederlimits.command.unloadchunks
wederlimits.command.halt
Additional Permissions:
wederlimits.warn (Default: OP) - Receive alerts for TPS/RAM warnings and emergency halts.
wederlimits.bypass.redstone-limiter (Default: False) - Bypasses redstone limiter restrictions.
wederlimits.bypass.block-limiter (Default: False) - Bypasses block limiter restrictions.
■ PlaceholderAPI Integration
When PlaceholderAPI is installed, the following placeholders are registered dynamically based on the player's current chunk:
| Placeholder | Description |
| %WederLimits_limit_<BLOCK>% | Max configured limit for the material in the current chunk (∞ if unconstrained). |
| %WederLimits_remaining_<BLOCK>% | Remaining amount of blocks that can be placed in the current chunk. |
| %WederLimits_blockcount_<BLOCK>% | Current amount of registered blocks of that type in the chunk. |
Example Usage: %WederLimits_remaining_HOPPER%
■ Configuration & File Structure
- config.yml: Global settings, module toggles, language, tiny-font, and per-module settings.
- blocks.yml & mobs.yml: Custom grouping definitions for entities and block types.
- /languages/: Auto-generated translation files (en.yml, es.yml, fr.yml, pt.yml, it.yml).
- /data/: Custom lightweight YAML storage for persistent per-chunk counters.
■ Preview
by NexuStudios
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
WederLimits is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1 and newer. Downloaded 2 times (via Spigot). Download it and open it directly in the game.