GhostBlocks

GhostBlocks lets you create per-player ghost barriers, secret passages, morphing structures, and skill-gated doors on Paper and Spigot servers.

When a player doesn't have access to a zone, it acts like solid blocks. Once unlocked, the barrier disappears for that specific player with customizable animations, particles, and sound effects.

---

Features

• Structure & Marker Zones: Turn existing builds into ghost walls (/gz structure) or create from marker blocks (/gz create).
• Per-Player Access: Unlocking or closing a zone for one player never affects anyone else.
• Visual Modes (Ghost & Transform): Choose between classic client-side ghost blocks or physical world block morphing (/gz mode).
• 8 Animation Styles: Choose from wave, random, burst, split, bottom_up, top_down, gate_up, and spiral with independent open and close toggles.
• Hit-to-Unlock Barriers: Require players to physically hit the barrier X times to permanently unlock it (/gz hits).
• Projectile & Deflection Physics: Fast projectiles (arrows, tridents, ender pearls, snowballs) physically bounce off barriers.
• Timed Access: Grant temporary access to individual players or the entire server (/gz open-temp, /gz open-temp-all).
• Console & Automation: Full Console, RCON, and Command Block execution with optional silent flag (-s).
• Multi-Language Support: Built-in English and Russian localization with customizable messages_*.yml files.
• In-Game GUI: Interactive chest menu (/gz menu) to manage zones, change modes, teleport, and toggle access.
• AuraSkills Support (Optional): Gate zones behind skill levels (Mining, Fighting, etc.) or stats (Strength, Health, etc.).

---

Quick Example

1. Stand at corner 1: /gz pos1
2. Stand at corner 2: /gz pos2
3. Create structure zone: /gz structure secret_wall
4. Set animation style: /gz animation secret_wall burst
5. Test closing for yourself: /gz close secret_wall

---

Commands & Permissions

Permission: ghostblocks.admin (Default: OP)

Admin Commands

• /gz menu (or /gz gui) — Open the interactive GUI zone manager
• /gz pos1 & /gz pos2 — Set selection points
• /gz structure <name> — Save selected build as a ghost zone
• /gz create <name> <block> — Create zone from marker blocks
• /gz edit <name> — Left/right click block editing mode
• /gz open <name> [player] [-s] / /gz close <name> [player] [-s] — Toggle access for yourself or a player
• /gz open-for <name> <player> [-s] / /gz close-for <name> <player> [-s] — Toggle access for another player
• /gz open-all <name> [-s] / /gz close-all <name> [-s] — Toggle access for all online players
• /gz open-temp <name> [player] <time> [-s] — Grant temporary access (e.g. 10s, 15m, 2h)
• /gz open-temp-all <name> <time> [-s] — Grant temporary access to all online players
• /gz lock <name> / /gz unlock <name> — Change default access state (locked/unlocked)
• /gz mode <name> [ghost|transform] — Swap between ghost barrier and world transform mode
• /gz animation <name> [type] — Set animation style (wave, random, burst, split, bottom_up, top_down, gate_up, spiral)
• /gz animate-open <name> [on|off] — Toggle opening animation
• /gz animate-close <name> [on|off] — Toggle closing animation
• /gz hits <name> [count] — Set hits required to destroy barrier (0 = disabled)
• /gz name <name> <display_name> — Set player-facing custom zone name
• /gz sound <name> <sound> — Set sound effect (Bukkit sound name)
• /gz particle <name> <particle> — Set particle effect (Bukkit particle name)
• /gz info <name> — Show detailed zone info card
• /gz lang [ru|en] — Switch active language
• /gz setskill <name> <skill> <level> — Add AuraSkills skill requirement
• /gz setstat <name> <stat> <level> — Add AuraSkills stat requirement
• /gz delete <name> — Delete zone and restore original blocks
• /gz cleanup <name> — Clear real blocks replaced by ghost zone
• /gz reload — Reload zones and configuration files

Player Commands

• /gz tryopen <name> — Check requirements and attempt to unlock (no permissions needed)

---

Configuration

Click to view default config.yml

# GhostBlocks Configuration v1.7.0
# Developed by sonofstrange

# Active plugin language: "ru" (Russian) or "en" (English)
# Custom message files are stored in plugins/GhostBlocks/messages_<lang>.yml
language: "en"

defaults:
  sound: BLOCK_AMETHYST_BLOCK_BREAK
  sound-volume: 0.25
  sound-pitch: 1.5
  particle: END_ROD
  particle-count: 2

# Customizable AuraSkills skills
skills:
  farming: "Farming"
  foraging: "Foraging"
  mining: "Mining"
  fishing: "Fishing"
  excavation: "Excavation"
  archery: "Archery"
  defense: "Defense"
  fighting: "Fighting"
  agility: "Agility"
  enchanting: "Enchanting"
  alchemy: "Alchemy"
  endurance: "Endurance"
  healing: "Healing"
  forging: "Forging"
  sorcery: "Sorcery"

# Customizable AuraSkills stats
stats:
  strength: "Strength"
  health: "Health"
  regeneration: "Regeneration"
  luck: "Luck"
  wisdom: "Wisdom"
  toughness: "Toughness"
  crit_chance: "Crit Chance"
  crit_damage: "Crit Damage"
  speed: "Speed"

messages:
  prefix: "&6&l[GhostBlocks] "
  no-permission: "&cYou do not have permission to execute this command."
  zone-not-found: "&cZone '&f%zone%&c' was not found."
  zone-created: "&a✓ Zone '&f%zone%&a' created! Blocks: &e%count%"
  zone-deleted: "&c✗ Zone '&f%zone%&c' deleted."
  zone-opened: "&a✓ Opened zone '&f%zone%&a' for %target%"
  zone-closed: "&c✗ Closed zone '&f%zone%&c' for %target%"
  zone-locked: "&c🔒 Zone '&f%zone%&c' is now locked by default."
  zone-unlocked: "&a🔓 Zone '&f%zone%&a' is now unlocked by default."
  temp-opened: "&a✓ Temporary access to zone '&f%zone%&a' granted to %target% for &e%time%"
  temp-expired: "&c⌛ Temporary access to zone '&f%zone%&c' has expired."
  sound-set: "&a✓ Sound for zone '&f%zone%&a' changed to &e%sound%"
  particle-set: "&a✓ Particle effect for zone '&f%zone%&a' changed to &e%particle%"

---

Requirements & Compatibility

• Minecraft: 1.21+ (Tested on Paper 1.21.3)
• Java: Java 21+
• Server Software: Paper, Purpur, Spigot
• Optional Dependency: AuraSkills (for skill and stat gated barriers)