Installation

Requirements

Before installing SmartSpawner, make sure your server meets these requirements:

Requirement	Specification
Minecraft Version	1.21.5+
Server Software	Paper, Folia, Purpur or compatible forks
Java Version	Java 25+

Download

Choose your preferred download source:

Modrinth SpigotMC Hangar

Installation Steps

1. Install the Plugin

1. Stop your server completely
2. Download the latest .jar file from any source above
3. Place it in your server's plugins/ folder
4. Start your server (avoid using /reload, it can cause issues)

2. Verify Installation

Run the following in your server console or in-game to check that the plugin loaded:

/plugins

SmartSpawner should appear in the list with a green status.

3. Configuration Files

The plugin automatically creates its configuration files in plugins/SmartSpawner/:

File	Description
config.yml	Main configuration: spawner behavior, economy, visuals
spawners_settings.yml	Drop tables and XP values for each mob type
item_spawners_settings.yml	Drop tables for item spawners
item_prices.yml	Custom sell prices for items
spawners_data.yml	Persistent spawner data (YAML mode)
language/	Language folder with translatable message files
gui_layouts/	GUI layout folder
auraskills.yml	AuraSkills integration settings (if AuraSkills is installed)

Updating

1. Download the new version
2. Stop your server
3. Replace the old .jar file with the new one
4. Start your server

Automatic Migration

SmartSpawner automatically migrates your configuration files to the latest format on startup and creates backups of your old files.

Getting Help

If you run into issues:

1. Check your console logs for error messages
2. Join the Discord server for community support
3. Report bugs on GitHub Issues