# InvisibleRegion **Visually hide players inside WorldGuard regions to maximize client FPS.** [![Minecraft](https://img.shields.io/badge/Minecraft-1.21.x-3C8527?style=for-the-badge&logo=minecraft&logoColor=white)](https://papermc.io) [![Software](https://img.shields.io/badge/Platform-Paper%20%7C%20Purpur-1976D2?style=for-the-badge)](https://papermc.io) [![Java](https://img.shields.io/badge/Java-21%2B-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white)](https://www.oracle.com/java/)

--- ## 📖 Overview **InvisibleRegion** is a high-performance solution designed to visually conceal players inside specific **WorldGuard** regions through direct network packet manipulation. Unlike traditional Bukkit API implementations (such as `hidePlayer`), visibility is handled **100% via PacketEvents**. This drastically cuts down outbound network traffic and boosts client-side FPS in high-density areas (hubs, lobbies, spawns, and AFK zones). --- ## 🎬 Showcase ### Hidden Mode (`/verjugadores false`) > Players inside the defined zone are completely culled from client rendering.

InvisibleRegion - Hidden Players

### Visible Mode (`/verjugadores true`) > Players with bypass permissions can toggle visibility on and off for moderation and monitoring purposes.

InvisibleRegion - Visible Players

--- ## ⚡ Commands | Command | Alias | Description | Default Permission | | :--- | :--- | :--- | :---: | | `/iregion reload` | `/ir reload` | Reloads the plugin configuration | `OP` | | `/iregion list` | `/ir list` | Lists all configured regions | `OP` | | `/iregion help` | `/ir help` | Displays the command help guide | `OP` | | `/verjugadores ` | — | Toggles player visibility for yourself | Configurable | --- ## 🔑 Permissions | Permission | Description | | :--- | :--- | | `invisibleregions.bypass.*` | Bypasses invisibility across all server regions *(granted to operators by default)*. | | `invisibleregions.bypass.` | Grants bypass permission exclusively for the specified region. | --- ## ⚙️ Configuration (`config.yml`) ```yaml # --------------------------------------------------------------- # InvisibleRegion — Configuration # --------------------------------------------------------------- # How often regions are checked in ticks (20 ticks = 1 second). # 1 = Instant reaction (small servers 1-50 players) # 5 = Optimal balance (medium servers 50-200 players) [default] # 10 = Minimal CPU overhead (large servers 200+ players) region-check-interval: 5 # WorldGuard regions where players become invisible. # - "region_name" -> active across all worlds # - "world_name:region" -> active only in that specific world regions: # Examples (uncomment and customize): # - "vanish-zone" # - "world_nether:secret_mine" # Messages displayed when entering/leaving invisibility (MiniMessage format). messages: enabled: true enter: "You are now invisible." leave: "You are no longer invisible." # Extra diagnostic logging (state transitions, region queries). debug: false ``` --- ## 📦 Requirements & Compatibility * **Platform:** Paper or Purpur 1.21.x *(compatible from 1.21 through 1.21.11, verified on 1.21.4)*. * **Java Runtime:** Java 21 or newer. ### Mandatory Dependencies * [PacketEvents](https://github.com/retrooper/packetevents) *(v2.11.1 or higher)* * [WorldGuard](https://enginehub.org/worldguard/) & [WorldEdit](https://enginehub.org/worldedit/) *(matching your server version)*

InvisibleRegion

Compatibility

Minecraft: Java Edition

Platforms

Tags

Creators

Details

logo

Vista de administrador / jugador con permiso

Vista de un jugador normal / sin permisos