Installation Guide

Get GAPE running on your Minecraft server in under 2 minutes. Zero configuration required.

Quick Start

1. Download

Download GAPE-1.1.2.jar from GitHub Releases

2. Install

Place the JAR in your server's plugins/ directory:

your-server/
├── plugins/
│   ├── GAPE-1.1.2.jar
│   └── ... other plugins
└── server.properties

3. Restart

Restart your server. Configuration will auto-generate.

4. Done

Zero additional setup required. Plugin works out of the box.

System Requirements

  • Minecraft: 1.20.0 - 1.21.11
  • Server: Paper, Spigot, or Leaf
  • Java: Java 17+
Note: GAPE requires PacketEvents API, which is bundled in the JAR. No additional dependencies needed.

Configuration

Configuration file auto-generates at: plugins/GAPE/config.yml

Customization

All settings can be customized:

  • Packet rate limits per type
  • Violation thresholds
  • Logging levels and retention
  • Performance tuning
  • Security settings
  • Compatibility options

Default Configuration

The default configuration is optimized for:

  • ✅ Small servers (10-50 players)
  • ✅ Medium servers (50-500 players)
  • ✅ Large servers (500-2000+ players)
  • ✅ All playstyles (Survival, PvP, Creative, Minigames)
No adjustments needed for most servers. Default settings provide comprehensive protection without false positives.

Verification

After restart, verify GAPE is running:

# Check server console for:
[GAPE] Enabling GAPE v1.1.2
[GAPE] Loaded 10 security checks
[GAPE] Configuration loaded successfully

Next Steps

Troubleshooting

Plugin Not Loading

  • Ensure config.yml is properly formatted YAML
  • Check server logs for error messages
  • Verify Java 17+ is installed: java -version

False Positives

  • Increase packet rate limits in config.yml
  • Adjust violation thresholds
  • Add custom plugins to whitelist-plugins if needed

Performance Issues

  • Check max-players-tracked setting
  • Adjust thread-pool-size for your server
  • Enable cache-enabled for better performance

For detailed troubleshooting, see the Troubleshooting Guide.

Support

For issues or questions: