Installation.md

Installation Guide

Requirements

• Minecraft Server: 1.18 or newer (tested up to 1.20.6)
• Server Software: Spigot, Paper, or Purpur
• Java: 17 or newer
• RAM: At least 1GB free

Step-by-Step Installation

1. Download the Plugin

Download the latest SpawnChestPlugin-X.X.X.jar from:

• SpigotMC
• GitHub Releases
• Modrinth

2. Install the Plugin

1. Stop your Minecraft server
2. Copy SpawnChestPlugin-X.X.X.jar to the plugins folder
3. Start the server

3. First Launch

On first launch, the plugin will create:

plugins/SpawnChestPlugin/
├── config.yml          # Main configuration
├── custom_loot.yml     # Custom loot tables
├── timer.txt           # Spawn timer state
├── statistics.yml      # Player statistics
└── lang/               # Language files
    ├── en.yml
    ├── ru.yml
    ├── ua.yml
    ├── es.yml
    ├── de.yml
    ├── fr.yml
    ├── zh.yml
    ├── pt.yml
    ├── pl.yml
    └── it.yml

4. Configure the Plugin

Edit /plugins/SpawnChestPlugin/config.yml:

Minimum Configuration:

# Change language (en, ru, ua, es, de, fr, zh, pt, pl, it)
language: "en"

# Spawn interval in seconds (default: 600 = 10 minutes)
settings:
  spawn-interval-seconds: 600
  
# Enabled worlds
settings:
  enabled-worlds:
    - "world"
    - "world_nether"
    - "world_the_end"

5. Reload Configuration

/reloadchestconfig

6. Test the Plugin

/chestnow  # Spawn a chest immediately

Verification

After installation, verify everything works:

1. Check console for [SpawnChestPlugin] Plugin enabled
2. Run /chestconfig list features - should show settings
3. Run /chestnow - chest should spawn
4. Open chest - should contain loot

Next Steps

• Configure - Customize all settings
• Set Permissions - Give players access
• Create Custom Loot - Design your own loot tables
• Learn Commands - Master all commands

Updating

1. Stop the server
2. Backup /plugins/SpawnChestPlugin/ folder
3. Replace the old JAR with new version
4. Start the server
5. Check console for migration messages

Note: Configuration files are preserved during updates!

Troubleshooting

If chest doesn't spawn:

• Check /nextchest - how much time remaining?
• Check enabled worlds in config
• Check console for errors
• See Troubleshooting page