InvisibleRegion

Visually hide players inside WorldGuard regions to maximize client FPS.

📖 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.

Visible Mode (/verjugadores true)

Players with bypass permissions can toggle visibility on and off for moderation and monitoring purposes.

⚡ Commands

🔑 Permissions

⚙️ Configuration (config.yml)

# ---------------------------------------------------------------
#  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: "<gray>You are now <white>invisible</white>.</gray>"
  leave: "<gray>You are no longer <white>invisible</white>.</gray>"

# 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 (v2.11.1 or higher)
• WorldGuard & WorldEdit (matching your server version)