StackPlus

A Paper plugin for mob stacking, spawner management, item stacking, and automated lag clearing.

Requirements

• Paper 1.21+
• Java 21+
• PlaceholderAPI (optional, for spawner give command)

Installation

1. Drop StackPlus.jar into your server's plugins/ folder.
2. Restart the server.
3. Configure mobs via /splus settings or by editing data.yml.

Features

• Mob Stacking — Nearby mobs of the same type from the same spawner merge into a single stacked entity with a visible count label. Stacks unwind one-by-one on death.
• Spawner Management — Custom spawn logic with configurable frequency, stack size, and mob AI. Supports clustered spawner setups.
• Item Stacking — Dropped items merge into stacks up to a configurable limit within a merge radius.
• ClearLag — Periodic entity/item clearing with countdown broadcast and exempt lists.
• Mob AI Control — Per-mob AI toggle using ragdoll mode (speed=0, aware=false) so mobs stay in grinders without pathfinding out.
• Natural Spawner Protection — Dungeon, fortress, and stronghold spawners are detected and left untouched.

Commands

All commands require the splus.admin permission (default: op).

Command	Description
/splus settings [mob]	Open the settings GUI, optionally for a specific mob
/splus reload	Reload config and data
/splus mobs add <mob>	Add a mob to the managed list
/splus mobs remove <mob>	Remove a mob from the managed list
/splus mobs <mob> ai <enabled|disabled>	Toggle mob AI
/splus mobs <mob> stacking <enabled|disabled>	Toggle mob stacking
/splus mobs <mob> lightbypass <enabled|disabled>	Ignore light level for spawning
/splus mobs <mob> stacksize <n>	Set max stack size
/splus mobs <mob> spawnfreq <time>	Set spawn frequency (e.g. 10s, 200)
/splus items stacklimit <n>	Set item stack limit
/splus items mergeradius <n>	Set item merge radius
/splus items toggle <enabled|disabled>	Toggle item stacking
/splus spawner give <mob> [amount]	Give yourself a spawner
/splus spawner give <player> <mob> <qty>	Give a spawner to another player
/splus replace [MOBTYPE]	Convert spawners in a chest to StackPlus format
/splus clearlag addexempt [type]	Exempt an entity/item from ClearLag
/splus clearlag removeexempt [type]	Remove a ClearLag exemption
/splus clearlag run	Trigger ClearLag immediately
/splus clearlag reload	Restart the ClearLag task

Configuration

config.yml — default settings loaded at startup. Changes applied via /splus reload.

data.yml — per-mob settings saved by the GUI and commands. Edited at runtime; do not edit while the server is running.

Key config.yml sections:

spawner:
  cluster-radius: 16.0       # Radius to detect nearby spawners
  max-spawns-when-isolated: 3
  max-spawns-when-clustered: 2

default-mob-settings:
  ai: false
  stacking: true
  max-stack: 100
  ignore-light: false
  spawn-interval: 80         # ticks