VIPAccess Rework

🛡️ VIPAccess Rework

VIPAccess Rework is a completely rewritten and improved version of the server access restriction plugin. It is the ideal solution for maintenance work, private servers, or creating exclusive access for donors.

Unlike simple whitelists, VIPAccess Rework includes powerful protection against bot attacks, beautiful message formatting (MiniMessage), Temporary Access system, and a Full In-Game GUI Dashboard.

Check out the original version of the plugin: Check out the original version of the plugin:

✨ Why the Rework version?

- Proxy Support: Forget about config files! Manage settings, anti-bot sensitivity, and players directly from the game via a beautiful inventory menu (``/vipa gui``). - Proxy Support: Grant players access for a specific time (e.g., 1 hour or 2 days) using ``/vipa grant``. The plugin automatically revokes access when time expires. - Proxy Support: A big red button in the GUI. Instantly locks down the server for everyone except admins during severe bot attacks. - Proxy Support: Full MiniMessage support. Use gradients, RGB colors, and clickable links in kick messages (e.g., ``<gradient:red:blue>Text``). - Proxy Support: Fully translatable. The plugin automatically generates translation files (EN, RU). - Proxy Support: Works perfectly on backend servers (Spigot/Paper/Purpur 1.21+) in a BungeeCord/Velocity network.

🚀 Commands and Permissions

Permission: - ``/vipa gui`` — Open the main Dashboard. - Permission: ``vipaccess.gui`` - ``/vipa reload`` — Reload configuration and languages. - Permission: ``vipaccess.reload``

Permission: - ``/vipa grant <player> <time>`` — Give temporary access (e.g., ``1h``, ``30m``, ``1d``). - Permission: ``vipaccess.admin``

Access Control - Entry Permission: ``server.vip`` (Configurable in ``config.yml``) - Bypass Check: ``vipaccess.bypass`` (Always allows entry) - Full Admin Access: ``vipaccess.admin``

🛡️ Intelligent Protection (Anti-Bot)

The plugin analyzes incoming traffic in real-time.

1. Punishment Modes: If failed login attempts exceed the threshold (default 50/sec), the plugin enables protection mode. 2. Punishment Modes: Can be triggered manually via GUI. Blocks Punishment Modes: non-admin connections instantly. 3. Punishment Modes: Switchable in-game: - ``KICK`` - Low resource usage. - ``BAN_IP`` - Temporary IP ban (10 min). - ``WHITELIST`` - Only whitelisted players can join.

📂 Configuration (config.yml)

```yaml

Is the plugin enabled

enabled: true

Message language (en, ru)

language: ru

Permission required for player entry

required-permission: "server.vip"

Anti-bot protection settings

anti-bot: enabled: true threshold: 50 # Connection threshold per second to activate protection protection-duration: 60 # Protection mode duration (sec) punishment: KICK # Punishment type: KICK, BAN_IP, or WHITELIST ```

💻 API for Developers

You can interact with VIPAccess Rework in your own plugins. Since there is no public repository, simply add ``VIPAccess.jar`` as a library to your project.

Events:

- ``VIPLoginEvent`` - Called when a player is about to be kicked due to full server/no permission. - ``TempAccessGrantEvent`` - Called when temporary access is granted.

```java import com.sunrisestudio.vipaccess.api.VIPLoginEvent;

@EventHandler public void onVipLogin(VIPLoginEvent event) { Player player = event.getPlayer();

// Example: let the player in if they have a specific advancement if (player.getAdvancementProgress(advancement).isDone()) { event.setCancelled(true); // Allow entry by cancelling the kick } } ```