VIPAccess Rework
PluginMIT

VIPAccess Rework

Secure your server with style. VIPAccess Rework restricts entry to authorized players only, featuring intelligent bot mitigation and multi-language support.

16
Downloads
1
Followers
2 months ago
Updated
📦
2
Versions

📖About 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:
click

✨ Why the Rework version?

  • Advanced GUI Dashboard: Forget about config files! Manage settings, anti-bot sensitivity, and players directly from the game via a beautiful inventory menu (/vipa gui).
  • Temporary Access: 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.
  • Panic Mode: A big red button in the GUI. Instantly locks down the server for everyone except admins during severe bot attacks.
  • Modern Formatting: Full MiniMessage support. Use gradients, RGB colors, and clickable links in kick messages (e.g., <gradient:red:blue>Text).
  • Multilingual: 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

Management

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

Temporary Access

  • /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. Auto-Protection: If failed login attempts exceed the threshold (default 50/sec), the plugin enables protection mode.
  2. Panic Mode: Can be triggered manually via GUI. Blocks ALL 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)

# 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.
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
    }
}