Getting Started

Overview

XSpawners is a stackable, fully-managed spawner addon for XCore. It replaces the vanilla spawner block with an ownership-aware, stackable system — every placed spawner is tracked, protected, and can be browsed, upgraded and managed through dedicated GUIs.

Key highlights:

  • Managed spawners — owner tracking, break / egg-change protection and optional silk-touch for naturally-generated spawners
  • Stacking — place on top or shift + right-click to merge, with a configurable cap (default 1000) and spawn-rate scaling
  • Upgradesrate / radius / cap tracks priced through Vault (opt-in)
  • Admin GUI — paginated list of every managed spawner with click-to-teleport and remove, refreshed live
  • Per-spawner menu — shift + left-click a block for type / owner / stack / coordinates, and extract one or the whole stack
  • Holograms — live stack count above each block via FancyHolograms (optional)
  • Integrations — WorldGuard region flag, placement limits, alerts, cross-server sync and a web dashboard
  • Folia-ready — block and entity operations run on the owning region thread, fully localized via lang.yml

Requirements

  • Paper 1.21.1+ (or Folia)
  • Java 21+
  • XCore 1.0.4+ installed as a plugin
  • Optional: FancyHolograms 2.8.0+ — for stack-count holograms
  • Optional: Vault — required only for the upgrade economy
  • Optional: WorldGuard — for the xspawners-allow region flag
  • Optional: PlaceholderAPI

Installation

  1. Install XCore in your server's plugins/ folder if you haven't already.
  2. Place XSpawners.jar in plugins/XCore/addons/.
  3. (Optional) Install FancyHolograms for stack-count holograms.
  4. Start the server. XSpawners generates its files in plugins/XCore/addons/XSpawners/.
  5. Edit config.yml to tune stacking, protection, limits, upgrades and notifications.
  6. Customize messages in lang.yml (MiniMessage format).
  7. Use /spawners reload to apply changes without a restart.

Upgrades are disabled by default. Set upgrades.enabled: true in config.yml to let owners pay Vault to level up their spawners.