SpawnerNexus | Living Farm Evolution [1.21]

[HR]

What Makes SpawnerNexus Different?

SpawnerNexus is not only a spawner-stacking plugin. Every placed spawner is a registered machine with ownership, upgrades, fuel, statistics, access control, recovery protection, live status information, and a configurable production engine.

Multiple spawners can then be connected into a Farm Group. The group does not replace the physical spawners or move them. It creates a virtual management layer around the farm, allowing players to control routing, loot collection, storage, experience, outputs, alerts, profiles, statistics, and evolution from one clear interface.

At the center of version 3 is Living Farm Evolution. A Farm Group earns lineage from real operation. At lineage level 5, its owner chooses an identity that changes how the farm produces mobs and rewards.

• Swarm — More virtual mobs, lighter individual health, and reduced rewards per mob.
• Predator — Fewer but significantly stronger mobs with improved loot and experience.
• Refinery — Normal production volume with a strong material-drop focus and reduced experience.
• Essence — Reduced mob volume and physical drops in exchange for concentrated experience and glowing mobs.

Identity traits deepen automatically at lineage levels 5, 10, 15, and 20.

[HR]

Individual Spawner Management

Every registered spawner has its own dashboard and data.

• Custom spawner items with persistent type, stack, upgrades, charges, and ownership
• Adjacent placement stacking for matching spawner types
• Sneak-placement to force a separate spawner
• Configurable Spawner Stack production multipliers
• Range, delay, spawn-amount, nearby-entity-limit, and Mob Compression progression
• Finite or unlimited charge support
• Configurable charge consumption by cycle, virtual mob, or physical entity
• Safe entity-type switching with a confirmation screen
• Per-spawner enable and disable control
• Global and per-spawner trust permissions
• Lifetime production, kill, drop, XP, compression, charge, and economy statistics
• Safe collection with inventory-overflow recovery

Mob Compression allows multiple reward-bearing virtual mobs to be represented by fewer physical entities. This reduces entity pressure without intentionally deleting the represented mob count, drops, or experience.

[HR]

Spawn Conditioning & Automation Modules

Each spawner can be conditioned independently.

• Pre-Damage — Newly spawned mobs begin with reduced health. Every level removes one heart, and purchases stop before the result would become lethal.
• Sound Control — Unlock individual warning, countdown, successful-spawn, and preview sound control.
• Visual Burst Control — Unlock individual warning particles, spawn bursts, ambient effects, and visual previews.
• Redstone Pause Controller — Allow a powered spawner block to pause its custom spawn cycles.
• Live Holograms — Display entity type, stack, output, charges, conditioning, and clear paused-status guidance above the block.

The preview system can demonstrate enabled sound and particle feedback without spawning mobs, consuming charges, or changing upgrades.

[HR]

UI-First Farm Groups

Farm Groups connect existing owned spawners through menus. Physical controllers and linking items are not required.

• Create a group by selecting owned spawners in the GUI
• Health-first group list that moves farms needing attention to the top
• Quick-fix guidance for common setup or capacity problems
• Pause or resume group automation without disabling individual spawners
• Increase linked-spawner capacity through group progression
• Save and apply spawner-upgrade profiles across a group
• Delete a virtual group without deleting, moving, or resetting its spawners

Deleting a Farm Group preserves spawner ownership, placement, and individual upgrades. Stored loot is moved into Recovery Storage, and stored experience is returned safely.

[HR]

Routing, Loot, Experience & Outputs

Farm Groups can unlock optional reward and routing services.

• Spawn Routing — Use normal spawner areas, one selected location, round-robin locations, lowest-density routing, or random saved locations.
• Safe Routing Fallback — Invalid custom routing falls back to the original spawner area instead of silently stopping the farm.
• Loot Collection — Capture eligible drops from mobs created by linked spawners.
• Protected Virtual Storage — Hold collected ItemStacks while preserving Bukkit item metadata.
• Exact-Point XP Reservoir — Store and withdraw exact Minecraft experience points without guessing levels.
• Output Connections — Send stored loot into existing inventory blocks selected by the player.
• Reward Alerts — Optional storage, XP, routing, and rare-drop warnings with cooldown protection.

Creating a Farm Group does not automatically replace normal drops. Collection begins only when the required reward upgrades are purchased and enabled.

[HR]

Player Clarity & Recovery

SpawnerNexus is designed to explain what the system is doing.

• Compact, Detailed, and Expert interface modes
• Built-in help and glossary pages
• Human-readable paused causes and recovery instructions
• Farm-health diagnostics with the safest next action
• Compass targeting from the spawner-location browser
• Optional permission-controlled teleporting
• Recovery Storage for purchases or collected spawners that do not fit in inventory

Common pause causes are translated into direct guidance, including no nearby player, entity limit reached, no charges, redstone power, unloaded chunk, disabled spawner, another plugin cancelling the spawn event, or a routing problem.

[HR]

Performance & Data Safety

• Priority-based custom scheduling rather than repeatedly scanning every spawner
• Configurable cycle and processing-time limits
• Loaded-chunk protection
• Mob Compression and nearby-entity limits
• Bounded Farm Group maintenance
• Duplicate schedule suppression and queue compaction
• Cached runtime statistics
• Atomic YAML replacement when supported
• Rolling .bak recovery files for important persistent data
• No database required
• No resource pack required

[HR]

Quick Player Flow

Command aliases: /sn and /spn.

[HR]

Requirements

• Minecraft: 1.21
• Java: 21
• Vault: Optional soft dependency
• Economy: Vault economy when available, with configurable exact-point Minecraft XP fallback

Vault is strongly recommended when the server should use a normal money economy. The default configuration may assign different systems to Vault or Minecraft XP, and every feature can fall back according to the configured economy provider.

[HR]

Installation

1. Stop the server completely.
2. Place SpawnerNexus_3.1.2.jar inside the server's plugins folder.
3. Install Vault and a compatible economy plugin when money-based purchases are desired.
4. Start the server normally.
5. Edit plugins/SpawnerNexus/config.yml as needed.
6. Restart after configuration changes.

Do not use /reload or a plugin hot-reloader for the first installation or version upgrade.

When upgrading, stop the server, replace only the old JAR, and keep the existing plugins/SpawnerNexus folder.

[HR]

Version 3.1.2

Version 3.1.2 recompiles the hologram manager with valid Java 21 JVM verification frames. It preserves the 3.1 menu-recovery and quality-of-life work, Farm Groups, Living Farm Evolution, stored data, lineage, upgrades, economy values, loot, experience, outputs, and reward balancing.