BetterWaterfall v1.0

---

BetterWaterfall is an advanced Waterfall fork focused on security, authentication flow, backend control, and better player handling directly on the proxy layer.

It is designed for server owners who want more than a standard proxy setup and need built-in systems for login flow, verification, anti-bot protection, queue handling, and backend health management without relying on multiple separate plugins.

Supported client versions: 1.8.x - 26.1.x

Main Features​

• Built-in proxy auth system
• Premium and non-premium account handling
• Limbo verification flow
• Captcha-based registration protection
• Session system with fingerprint validation
• Queue system with priorities and backend waiting flow
• Backend health monitoring
• Maintenance and backend control tools
• Anti-bot and connection heuristics
• Storage support for SQLite and MySQL
• Multi-file configuration structure
• Admin auth management commands

Auth & Verification​

BetterWaterfall includes a proxy-side authentication system that allows login and registration before players reach the backend server.

It supports:

• premium account bypass
• non-premium login/register flow
• captcha required only for registration
• session persistence
• optional session risk validation based on connection details
• account limit per IP
• auth administration tools such as /auth, /logout, /changepassword

Queue & Backend Control​

The fork includes a backend queue system with support for:

• queue priorities
• queue ETA
• drained backend mode
• backend health states
• controlled release into backend servers

This makes it suitable for networks that need more stable join flow and better backend protection.

Security​

BetterWaterfall includes several built-in protection layers, such as:

• anti-bot logic
• handshake sanity checks
• subnet heuristics
• adaptive challenge flow
• connection screening support
• auth and security logging

Configuration​

The fork uses a split configuration structure to keep the setup organized and easier to manage.

Examples include:

• storage.yml
• auth.yml
• auth-messages.yml
• captcha.yml
• antibot.yml
• queue.yml
• backend-health.yml
• retention.yml

Storage​

BetterWaterfall supports:

• SQLite
• MySQL

Both auth and security systems can work on the selected shared storage backend.

Notes​

This fork is intended for users who want a more feature-rich and security-oriented Waterfall setup than the default project provides.

It is especially useful for:

• premium + non-premium networks
• protected PvP networks
• custom proxy-side login flow
• networks that want queue, limbo, auth, and security in one fork