Frequently Asked Questions

Installation & Setup

Does GAPE require any setup?

No. Drop the JAR in plugins/ and restart. Configuration auto-generates with sensible defaults.

What versions does GAPE support?

Minecraft 1.20.0 through 1.21.11. Paper, Spigot, or Leaf servers.

Can I use GAPE with other plugins?

Yes. GAPE is fully compatible with other plugins. No conflicts.

Performance

Will GAPE impact my server performance?

No. GAPE has only 300-500 nanoseconds per-packet overhead. You won't notice it.

How many players can GAPE handle?

Default configuration scales to 1000+ concurrent players with minimal impact.

What's the memory footprint?

~560 bytes per tracked player. Negligible impact even on large servers.

Configuration

Can I customize the detection sensitivity?

Yes. Adjust packet limits and violation thresholds in config.yml. Fully customizable.

My players are getting false positives. What do I do?

Increase packet limits or violation thresholds in config.yml. Adjust for your playstyle. See the Troubleshooting Guide.

Can I disable specific checks?

Yes. Set individual checks to false in the checks section.

What's the recommended configuration?

Default configuration is optimized for all server types. No changes needed for most servers.

Security Checks

What does each check do?

See our security checks documentation:

  • Rate Limit: Prevents packet floods
  • Tab Complete: Blocks tab-complete exploits
  • Sign Exploit: Detects malicious sign NBT
  • Book Exploit: Detects malicious book NBT
  • Oversized Packet: Blocks packets exceeding limits
  • Custom Payload Flood: Prevents plugin message spam
  • Packet Flood: General flood protection
  • Command Spam: Prevents command spam
  • NoCom Exploit: Blocks NoCom vulnerability
  • Crasher: Detects crash packet patterns

Can I whitelist specific plugins?

Yes. Add plugin names to whitelist-plugins in config.yml.

Does GAPE block legitimate traffic?

No. Configuration is tuned to allow all normal gameplay while blocking exploits.

Troubleshooting

Plugin not loading. What's wrong?

Check server logs for errors. Ensure config.yml is valid YAML. Verify Java 17+ is installed.

I'm seeing false positives. How do I fix this?

Increase packet limits in packet-type-limits. Adjust violation-thresholds. Add plugins to whitelist.

Performance is degraded. What should I do?

Check max-players-tracked setting. Adjust thread-pool-size for your server. Disable metrics if not needed.

How do I check logs?

Logs are in plugins/GAPE/logs/. Check most recent file for errors.

Can I report bugs?

Yes, on GitHub Issues.

Advanced

Can I tune for my specific server setup?

Yes. All settings are customizable in config.yml. See Configuration Guide for details.

What's the best batch-size for my server?

Default is 100. Increase for high-traffic servers (up to 500). Decrease if CPU bound.

Should I enable metrics?

Only if you need detailed metrics. Disabled by default for better privacy.

Can I run multiple GAPE instances?

No need. GAPE is designed as a single plugin per server. Configure appropriately for your setup.

Is source code available?

Yes, on GitHub.

Support

Where can I get help?

How often is GAPE updated?

Updates are released as needed for stability, security, and new features. Check GitHub Releases.

Is GAPE production ready?

Yes. v1.1.2 is fully production ready with 3 critical null-safety fixes and universal configuration optimization.