FlowGate

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.