━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

TABLE OF CONTENTS

1. Getting Started
2. Configuration Files
3. Commands & Permissions
4. Features Guide
5. Optimization Profiles
6. Entity Stacking System
7. Death Chest System
8. Integration Support
9. Troubleshooting

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. GETTING STARTED

Requirements:
• Minecraft 1.17.x - 1.21.x
• Spigot, Paper, or Purpur
• Java 16 or higher
• 2GB+ RAM recommended

Installation:
1. Download ExitsLag-1.2.0.jar
2. Place in plugins/ folder
3. Restart server
4. Configure in plugins/ExitsLag/
5. Use /exitslag reload

First Steps:
• Set your server RAM profile in config.yml (active-profile)
• Choose your language in config.yml (language)
• Review entity limits in configs/entities.yml
• Configure cleanup intervals in configs/cleanup.yml

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2. CONFIGURATION FILES

Main Configuration (config.yml):
Entity Configuration (configs/entities.yml):
• World settings (whitelist/blacklist mode)
• Entity removal settings
• Entity limits per type
• Priority scores
• Distance-based removal
• Experience orb merging
• Projectile cleanup
• Vehicle management
• TNT optimization
• Entity stacking system

Item Configuration (configs/items.yml):
• Auto-merge settings
• Despawn times per item type
• Stack size limits
• Item blacklist/whitelist
• Protected items

Cleanup Configuration (configs/cleanup.yml):
• Scheduled cleanup times
• Warning intervals
• Cleanup types
• Emergency thresholds
• Protection settings

Optimization Configuration (configs/optimization.yml):
• Profile definitions
• View distance settings
• Simulation distance
• Mob spawn limits
• Entity activation ranges
• Redstone optimizations
• Hopper optimizations

World Border Configuration (configs/worldborder.yml):
• Per-world border sizes
• Warning distances
• Pushback settings
• Border effects

Death Chest Configuration (configs/deathchest.yml):
• Enable/disable system
• Chest duration
• Protection settings
• Visual effects
• Max chests per player
• Particle trail settings

Tab List Configuration (configs/tablist.yml):
• Header/footer formatting
• Platform detection
• Update intervals
• Player info display

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

3. COMMANDS & PERMISSIONS

Main Commands:
Command Aliases:
• /elag
• /el

Permission Nodes:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

4. FEATURES GUIDE

Performance Monitoring:
• Real-time TPS tracking
• Memory usage monitoring
• Entity count tracking
• Chunk analysis
• Automatic alerts when TPS drops below threshold
• Emergency mode activation on critical TPS

Cleanup System:
• Scheduled automatic cleanups
• Manual cleanup commands
• Types: items, entities, experience, all
• Protection for named, tamed, and equipped entities
• Distance-based priority (farther from players = removed first)
• Configurable warning system

Chunk Management:
• View loaded chunks per world
• Force unload idle chunks
• Problematic chunk detection
• Automatic optimization

World Border System:
• Set custom borders per world
• Automatic player pushback
• Warning messages near border
• Prevents excessive chunk generation

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

5. OPTIMIZATION PROFILES

4GB Profile:
• View Distance: 6
• Simulation Distance: 4
• Monster Limit: 40
• Animal Limit: 30
• Best for: Small servers, 5-15 players

8GB Profile:
• View Distance: 8
• Simulation Distance: 6
• Monster Limit: 50
• Animal Limit: 40
• Best for: Medium servers, 15-30 players

16GB Profile:
• View Distance: 10
• Simulation Distance: 8
• Monster Limit: 70
• Animal Limit: 60
• Best for: Large servers, 30-60 players

32GB Profile:
• View Distance: 12
• Simulation Distance: 10
• Monster Limit: 100
• Animal Limit: 80
• Best for: Very large servers, 60-100 players

64GB Profile:
• View Distance: 14
• Simulation Distance: 12
• Monster Limit: 150
• Animal Limit: 120
• Best for: Networks, 100+ players

CUSTOM Profile:
• Configure all values manually
• Advanced users only
• Full control over optimization

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

6. ENTITY STACKING SYSTEM

What is Entity Stacking?
Entity stacking combines multiple entities of the same type into a single entity with a counter, drastically reducing server load while maintaining gameplay.

How it Works:
• Entities of same type within 4 blocks automatically stack
• Red hologram displays stack count (e.g., "x15")
• When killed, stack reduces by 1
• Drops and XP work normally
• New entity spawns with remaining stack

Configuration:
Stackable Entities:
• Hostile: zombie, skeleton, creeper, spider, enderman, etc.
• Passive: cow, pig, sheep, chicken, rabbit
• Neutral: zombified_piglin
• Aquatic: squid, cod, salmon, tropical_fish

Never Stacks:
• Named entities
• Tamed pets
• Entities with equipment
• Entities with passengers
• Leashed entities
• Boss mobs (Ender Dragon, Wither)
• Entities with different attributes (baby vs adult)

Benefits:
• 50-80% reduction in entity processing
• Massive performance boost in mob farms
• Maintains vanilla gameplay feel
• Configurable per entity type

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

7. DEATH CHEST SYSTEM

Features:
• Automatic chest creation on death
• Timer-based expiration
• Boss bar tracking with countdown
• Particle trail to chest location
• Protection from other players
• Multiple chests per player (configurable limit)
• GUI selector for multiple chests
• Hologram display above chest

How to Use:
1. Die anywhere in the world
2. Chest automatically created with your items
3. Boss bar shows time remaining and distance
4. Follow particle trail to find chest
5. Open chest to collect items
6. Use /exitslag deathchest to manage multiple chests

Configuration Options:
• Duration (default: 20 minutes)
• Max chests per player (default: 3)
• Protection enabled/disabled
• Visual effects (particles, holograms)
• Global announcements
• Explosion protection

Commands:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

8. INTEGRATION SUPPORT

PlaceholderAPI:
ExitsLag provides placeholders for TPS, memory, entities, and more.
Placeholders automatically register when PlaceholderAPI is detected.

Protection Plugins:
• WorldGuard - Region protection compatibility
• GriefDefender - Claim system support
• GriefPrevention - Claim integration
• Towny - Town protection
• Residence - Residence areas

Death chests respect protected regions from these plugins.

Geyser (Bedrock Support):
• Automatic detection of Bedrock players
• Platform indicators in tab list
• Compatible with Geyser-Spigot

Vault (Future):
Ready for future economy/permission features.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

9. TROUBLESHOOTING

Plugin Not Loading:
• Check Java version (16+ required)
• Verify Minecraft version compatibility (1.17-1.21)
• Check console for error messages
• Ensure plugin file is not corrupted

Performance Issues:
• Lower active-profile to match your RAM
• Reduce entity limits in entities.yml
• Enable entity stacking
• Increase cleanup frequency
• Check for problematic chunks with /exitslag analyze

Death Chests Not Working:
• Check if enabled in deathchest.yml
• Verify player has permission
• Check if location is in protected area
• Review console for errors

Entities Not Stacking:
• Verify stacking.enabled: true in entities.yml
• Check if entity type is set to true in stackable-entities
• Entities must be within stack-radius
• Named/tamed/equipped entities don't stack by default

Commands Not Working:
• Check permission nodes
• Verify command syntax
• Use /exitslag help for command list
• Check console for permission errors

Database Errors:
• SQLite: Check file permissions in plugin folder
• MySQL: Verify credentials in config.yml
• Ensure database exists and is accessible
• Check auto-save-interval setting

Language Not Loading:
• Verify language code in config.yml (e.g., en_US)
• Check if language file exists in languages/ folder
• Use /exitslag reload after changing
• Default fallback is en_US

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PERFORMANCE TIPS

Best Practices:
1. Start with recommended profile for your RAM
2. Enable entity stacking for mob-heavy servers
3. Set appropriate cleanup intervals (300 seconds recommended)
4. Use world borders to limit world size
5. Monitor TPS regularly with /exitslag stats
6. Enable emergency mode for automatic intervention
7. Review entity limits per world
8. Use distance-based entity removal
9. Enable auto-merge for items and XP orbs
10. Regular performance analysis with /exitslag analyze

Advanced Optimization:
• Adjust view distance per world needs
• Fine-tune mob spawn limits
• Configure entity activation ranges
• Optimize redstone/hopper settings
• Use simulation distance control
• Enable adaptive optimization

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━