FlowGate is a lightweight world-access firewall for Minecraft servers. It blocks unauthorized cross-world teleports, logs denied attempts, and gives staff a simple GUI to manage rules.

Why FlowGate

Many servers open worlds gradually (Nether/End later).
Players can still try to bypass progression with commands, portals, or plugin teleports.
FlowGate closes that gap with clear per-world rules.

Core Features

• Per-world access rules (open / closed / permission-based)
• Teleport cause filtering (portal, command, plugin, etc.)
• Join/respawn enforcement
• Safe fallback teleport to configured world
• GUI menus for rules and recent denied logs
• Local JSON storage (no MySQL/SQLite required)
• Fast diagnostics command: /flowgate why <player>

Commands

• /flowgate menu - open GUI
• /flowgate why <player> - show last denied attempt
• /flowgate reload - reload config

Permissions

• flowgate.admin - full access
• flowgate.menu - open GUI
• flowgate.why - use diagnostics command
• flowgate.bypass - bypass all restrictions
• flowgate.access.nether - example world access
• flowgate.access.end - example world access

Storage

• Type: json
• File: plugins/FlowGate/flowgate-data.json
• Retention: configurable by storage.log-retention-days

Compatibility

• Server cores: Spigot / Paper / Purpur
• Minecraft: 1.16.5+ (API target 1.16)
• Java: 8+ (works on Java 17)

Installation

1. Drop flowgate-0.1.0.jar into plugins/
2. Restart server
3. Edit config.yml (rules, messages, causes)
4. Use /flowgate menu to manage rules in-game

Notes

FlowGate has no required external dependencies.

Feedback & Bug Reports

If you found a bug, typo, or have ideas for new features, please write in comments/issues.
Your feedback helps make FlowGate better in every update.