GMBarrier ✦ Dynamic Per-Player Laser Barriers & Forcefields [1.20-1.21]

1. Overview: The Modern Boundary Solution

Traditional border systems rely on invisible barrier blocks or physical walls that clutter your builds, cause client-side desync (ghost blocks), and ruin visual immersion.

GMBarrier introduces a state-of-the-art visual boundary engine. Players encounter striking, customizable colored laser barriers and forcefields that are rendered per-player. Whether you need restricted access zones, spawn perimeters, PvP arena enclosures, or VIP-only sectors, GMBarrier provides an unbypassable visual and physical forcefield without altering physical world blocks.

2. Key Features

• Per-Player Dynamic Rendering: Barriers are calculated and displayed individually. Players with bypass permissions walk through undisturbed without seeing obstructive laser walls, while restricted players see the full glowing barrier.
• Zero Physical Block Modifications: GMBarrier does not place permanent barrier blocks into your world chunks. This eliminates ghost block glitches and chunk modification lag entirely.
• Interactive Selection Wand: Configure complex barriers in seconds using the admin selection wand tool. Simply left-click position 1 and right-click position 2 to define borders.
• Custom Color & Styling Engine: Customize laser colors, intensity, and particle combinations to match your server's visual theme (Cryo-Cyan, Laser-Red, Emerald-Green, Violet-End).
• Kinetic Knockback & Repulsion: Unauthorized players attempting to breach the laser wall are smoothly repelled backwards with customizable velocity, sound effects, and warning messages.
• Built for Extreme Performance: Asynchronous calculations ensure your server main thread maintains 20.0 TPS even with hundreds of active barriers across multiple worlds.
• Native Multi-Language Support: Ready-to-use localization files with full RGB gradient support and mini-message styling.

3. Commands Reference

Command	Description	Default Permission
/gmbarrier wand	Gives the visual barrier region selection wand.	gmbarrier.admin
/gmbarrier create <id> [color]	Creates a new laser barrier from wand selection.	gmbarrier.admin
/gmbarrier remove <id>	Permanently deletes an existing barrier.	gmbarrier.admin
/gmbarrier list	Displays all registered barriers and coordinates.	gmbarrier.admin
/gmbarrier tp <id>	Teleports you to the center of a barrier.	gmbarrier.admin
/gmbarrier reload	Reloads configuration files and language locales.	gmbarrier.admin

Aliases: /barrier, /gmwall

4. Permissions Hierarchy

• gmbarrier.admin — Full administrative control over all barrier creation, tools, and reloads (Default: OP)
• gmbarrier.bypass — Allows a player to bypass all configured laser barriers without repulsion (Default: False)
• gmbarrier.bypass.<barrier_id> — Grants bypass permission for one specific barrier only

5. Configuration Preview

6. Installation

1. Ensure your server runs PaperMC 1.20.4+ or 1.21+ with Java 17 or Java 21.
2. Place GMBarrier-1.0.0.jar into your server's plugins/ folder.
3. Start or restart the server.
4. Take the wand using /gmbarrier wand, select two corners, and run /gmbarrier create <id>.