SSAddon SpawnerLimiter

SSAddon SpawnerLimiter

SSAddon (SmartSpawner Addon) that limits spawner placement per chunk and per player based on spawner stacks, with Folia support!

Minecraft

Paper

Java

How It Works

SSASpawnerLimiter provides two independent limit systems:

Chunk-Based Limit

<img width="549" height="70" alt="{948DB322-3CD5-4420-A4E7-C63D9DB89547}" src="https://github.com/user-attachments/assets/ecaf6c4d-5250-46bd-a1d9-8537073c83d9" />

Limits spawner stacks per chunk to prevent chunk overloading: - 1 spawner block with 64 stacks = Total in chunk - 1 spawner block with 6 stacks = Total in chunk - Total in chunk: 70 count - Default: 100 spawners per chunk

Per-Player Limit

<img width="525" height="66" alt="{0E84EBA1-B007-4303-B85C-83019086C482}" src="https://github.com/user-attachments/assets/3db751ab-6fce-4733-9153-7533ee41c627" />

Limits total spawner stacks a player can place globally: - Tracks all spawners placed by each player across the entire server - Default: 1000 spawners per player - Can be increased via permission nodes (1500, 2000, 5000, etc.) - Bypass permission for unlimited spawners

Both systems can be enabled/disabled independently in `config.yml`: ```yaml enable_chunk_limit: true # Enable chunk-based limiting enable_player_limit: true # Enable per-player limiting ```

Stack Counting Example

- Player places 1 spawner with stack size 10 → Adds 10 to both chunk and player count - Player breaks that spawner → Adds 10 from both counts - Player stacks spawner from 10 to 20 → Adds 10 more to both counts - Counts never go below 0 (zero-floor protection)

This ensures fair limiting based on actual spawner capacity, not just physical blocks.

Installation

1. Install SmartSpawner plugin 2. Download SSASpawnerLimiter 3. Place the `.jar` file in your `plugins` folder 4. Restart the server 5. Configure settings in `plugins/SSASpawnerLimiter/config.yml`

Commands

| Command | Description | Aliases | |---------|-------------|---------| | `/ssaspawnerlimiter reload` | Reload plugin configuration | `/ssalimiter reload` | | `/ssaspawnerlimiter info` | Check spawner count in current chunk | `/ssalimiter info` | | `/ssaspawnerlimiter check <player>` | Check spawner limit for player's chunk | `/ssalimiter check <player>` | | `/ssaspawnerlimiter checkplayer <player>` | Check player's global spawner count | `/ssalimiter checkplayer <player>` | | `/ssaspawnerlimiter stats` | View plugin statistics | `/ssalimiter stats` |

Permissions

Bypass Permissions

| Permission | Description | Default | |------------|-------------|---------| | `ssaspawnerlimiter.bypass` | Bypass spawner chunk limit | `false` | | `ssaspawnerlimiter.perplayer.bypass` | Bypass per-player spawner limit (unlimited) | `false` |

Per-Player Limit Tiers

You can create custom limit tiers using the permission pattern: `ssaspawnerlimiter.perplayer.<number>`

Examples: - `ssaspawnerlimiter.perplayer.1500` → Allows 1500 spawners globally - `ssaspawnerlimiter.perplayer.2000` → Allows 2000 spawners globally - `ssaspawnerlimiter.perplayer.5000` → Allows 5000 spawners globally - `ssaspawnerlimiter.perplayer.10000` → Allows 10000 spawners globally - Any number you want!

> Note: Players with multiple tier permissions will get the highest value. Default limit is configured in `config.yml` as `max_spawners_per_player`.

Command Permissions

| Permission | Description | Default | |------------|-------------|---------| | `ssaspawnerlimiter.command.use` | Base permission for all commands | `op` | | `ssaspawnerlimiter.command.reload` | Use reload command | `op` | | `ssaspawnerlimiter.command.info` | Use info command | `op` | | `ssaspawnerlimiter.command.check` | Use check command | `op` | | `ssaspawnerlimiter.command.checkplayer` | Use checkplayer command | `op` | | `ssaspawnerlimiter.command.stats` | Use stats command | `op` |

Database

The plugin uses SQLite to store spawner data in two tables: - `spawner_chunks` - Chunk spawner counts - `player_spawners` - Per-player spawner counts

SQLite Viewer - Free online tool to view and edit SQLite databases

Database location: `plugins/SSASpawnerLimiter/spawner_limits.db`