Skip to main content

​
ancSpawners Plugin Configuration

This guide provides comprehensive instructions for configuring the ancSpawners plugin for your Minecraft server to create an advanced spawner management system.

​
Overview

ancSpawners is a powerful mob spawner management plugin that allows players to collect, place, and upgrade mob spawners. UXPLIMA offers optimized configuration files tailored for different server sizes and gameplay styles.

​
Setup Tutorial

​
Prerequisites

  • Minecraft server running Spigot, Paper, or a compatible fork
  • ancSpawners plugin installed
  • Server operator permissions
  • Basic understanding of YAML configuration
  • Economy plugin (optional, for spawner purchases)

​
Installation Steps

  1. Purchase the ancSpawners plugin from Our Store
  2. Download the plugin JAR file from your account or email
  3. Place the plugin JAR file in your server’s plugins directory
  4. Start your server to generate the default configuration files
  5. Adjust the configuration files as needed (optional)
  6. Restart your server to apply any configuration changes

​
Configuration Files

ancSpawners uses a modular configuration system with multiple files:
  • config.yml: Main settings including language, database, and global options
  • modules/*.yml: Feature-specific configurations (auto-kill, boosts, friends, etc.)
  • loottables/*.yml: Custom drop tables for different mob types
  • lang/*.yml: Language files for customizing all plugin messages

​
Main Configuration (config.yml)

The main configuration file controls the plugin’s core behaviors: 
config:
  # Language for messages (en, tr, pl, de, fr available)
  lang: en

database:
  # Currently only SQLite is supported
  type: SQLITE

disabled-worlds:
  # Worlds where spawners cannot be placed or broken
  - testWorld

nerf-spawner-mobs:
  # Disables AI for mobs from spawners (reduces lag)
  enabled: false

use-modern-autokill:
  # More efficient autokill for 1.16+ servers
  # Generates loot without spawning entities
  enabled: true

​
Spawner Types

This section defines different spawner behaviors. The default configuration applies to all spawners unless overridden: 
spawners:
  default:
    name: "&c&l{entity_name} &8-- &7Spawner"
    # How spawners function
    spawnerInfo:
      mode: ENTITY  # ENTITY or ITEM mode
      material: {entity_name}
      range: 16     # Activation range in blocks
      delay: 8      # Seconds between spawns

​
Key Features

​
Auto-Kill System

The auto-kill feature automatically kills spawned mobs and collects their drops, eliminating the need for kill chambers:
Auto-Kill System Diagram
 Configuration (modules/autokill.yml): 
auto-kill:
  enabled: true
  force: false  # Force on all spawners
  permission: ancSpawners.autokill

​
Virtual Storage

Spawners can store dropped items and XP, which players can collect or sell later: Configuration (modules/settings.yml): 
virtual-storage:
  default: true  # Enabled by default on new spawners
  force-default: false
  permission: ancSpawners.settings.togglestorage
Storage Limits (modules/storage_limits.yml): 
storage-limit:
  enabled: true
  default: 2000  # Default item storage per spawner
  xpLimit: 10000 # Default XP storage limit
  
  # Permission-based storage limits
  permissions:
    ancSpawners-storage1: 5000
    ancSpawners-storage2: 10000

​
Boost System

Boosts temporarily enhance spawner performance: Boost Types:
  1. SPAWN_AMOUNT: Increases the number of mobs per spawn
  2. SPAWN_TIME: Reduces the time between spawns
Example Configuration (modules/boosts.yml): 
boosts:
  list:
    boost1:
      material: "DIAMOND"
      type: "SPAWN_AMOUNT"
      amount: 2
      duration: "1d"  # 1 day

​
Friends System

Players can grant others access to their spawners: Configuration (modules/friends.yml): 
friends:
  enabled: true
  permission: ancSpawners.friends

​
Hologram Display

Displays key information above spawners: Configuration (modules/hologram.yml): 
hologram:
  plugin: DecentHolograms
  enabled: true
  hologram-height: 2.85
Default Hologram Content: 
(5x) Zombie Spawner
  
☻ OWNER ➡ PlayerName
❦ STORAGE ➡ [■■■■■□□□□□]
  
Right-click to access menu

​
Custom Loottables

Define custom drops for each mob type when using auto-kill: Example (loottables/zombie.yml): 
drops:
  itemDrops:
    - ROTTEN_FLESH:70:1-3  # 70% chance for 1-3 rotten flesh
    - GOLD_INGOT:10:1-1     # 10% chance for 1 gold ingot
  xpDrops: 1-15             # 1-15 XP per kill
  xpDropChance: 100         # 100% chance to drop XP

​
GUI Menu System

ancSpawners provides an intuitive menu system for managing spawners: Accessed by right-clicking a spawner, the main menu provides:
  • Spawner information (type, level, owner)
  • Storage access for items and XP
  • Auto-kill toggle
  • Hologram toggle
  • Friend management
  • Spawner upgrades
  • Settings access
Main Menu

​
Storage Menu

Allows players to collect or sell stored items:
  • Take items
  • Sell all items at once with multipliers
  • View storage capacity and limits

​
Friends Menu

Manage players who can access your spawner:
  • Add friends
  • Remove friends
  • View current friends

​
Economy Integration

ancSpawners integrates with server economies for:
  1. Selling drops: Converts spawner drops into currency
  2. Multipliers: Permission-based multipliers increase selling profits
  3. Spawner purchase: Buy spawners if configured
Multiplier Configuration (modules/multipliers.yml): 
multipliers:
  enabled: true
  permissions:
    ancSpawners-1-25x: 1.25  # 25% bonus
    ancSpawners-1-50x: 1.50  # 50% bonus

​
Spawner Upgrading

Players can stack spawners of the same type to increase efficiency: 
1. Place a spawner
2. Hold another spawner of the same type
3. Right-click on the placed spawner
4. Confirm the upgrade in the GUI
Benefits:
  • Consolidated storage
  • Single access point
  • Improved server performance
  • Enhanced spawning rates

​
Permission System

​
Basic Permissions

  • ancSpawners.use - Access to use spawners
  • ancSpawners.autokill - Toggle auto-kill feature
  • ancSpawners.friends - Add friends to spawners
  • ancSpawners.settings.togglestorage - Toggle virtual storage
  • ancSpawners.settings.togglexp - Toggle XP storage
  • ancSpawners.breakallspawners - Break any player’s spawner

​
Storage Limit Permissions

  • ancSpawners-storage1: 5,000 item capacity
  • ancSpawners-storage2: 10,000 item capacity
  • ancSpawners-storage3: 20,000 item capacity

​
XP Storage Permissions

  • ancSpawners-xpstorage1: 15,000 XP capacity
  • ancSpawners-xpstorage2: 20,000 XP capacity
  • ancSpawners-xpstorage3: 25,000 XP capacity

​
Multiplier Permissions

  • ancSpawners-1-25x: 1.25× sell multiplier
  • ancSpawners-1-50x: 1.50× sell multiplier

​
Commands

CommandDescriptionPermission
/ancSpawners give <player> <spawner> [amount]Give spawners to a playerancSpawners.admin
/ancSpawners reloadReload configurationancSpawners.admin
/ancSpawners giveboost <player> <boost_key>Give a boost to a playerancSpawners.admin
/ancSpawners givepickaxe <player> <uses>Give a spawner pickaxeancSpawners.admin

​
Troubleshooting

​
Common Issues

​
Spawners Not Working

  • Ensure the player is within the activation range (default: 16 blocks)
  • Check if the spawner’s mob type is correctly configured
  • Verify the world is not in the disabled-worlds list

​
No Drops from Auto-Kill

  • Check if custom loottables are configured correctly
  • Ensure auto-kill is enabled for that spawner
  • Verify storage limits aren’t reached

​
Plugin Conflicts

ancSpawners is compatible with most plugins, but possible conflicts include:
  • Other spawner management plugins
  • Custom mob plugins that modify vanilla spawn behavior
  • Economy plugins not properly hooked

​
Performance Optimization

For servers experiencing lag:
  1. Enable use-modern-autokill (requires 1.16+)
  2. Reduce spawner activation range
  3. Increase spawn delay times
  4. Limit max spawners per chunk
  5. Enable the nerf-spawner-mobs option

​
Best Practices

  1. Balance Economy: Adjust item prices and multipliers to maintain server economy
  2. Set Reasonable Limits: Configure storage and spawner level limits based on your server’s performance capabilities
  3. Custom Loottables: Create balanced loottables that don’t generate excessive items
  4. Plugin Integration: Ensure proper integration with your economy, protection, and hologram plugins
  5. Regular Maintenance: Periodically check and optimize spawner configurations as your server grows

​
Support and Contact

For additional assistance with ancSpawners configuration: