Core Features

1. Disguise Mechanic

When a player holds a Spyglass and presses Sneak (Shift) + Use, they become disguised as the block they are looking at.

Works for all Minecraft blocks.

Disguise is visual only: no hitbox or collision changes.



2. Bedrock (Geyser) Support

Bedrock input should also trigger disguise (sneak + interact).

Config option to adjust input mapping for Geyser players.



3. Configurable Settings (config.yml)

disguise.duration_seconds (default: 60)

disguise.cooldown_seconds (default: 10)

disguise.allow_all_blocks: true/false

disguise.block_blacklist (e.g., BARRIER, STRUCTURE_VOID)

disguise.prevent_block_interaction: true/false

geyser.input_mapping (for Bedrock tweaks)

particles.enable and sound.enable



4. Commands

/hs create <arena> — create arena

/hs setlobby — set lobby

/hs join <arena> — join game

/hs leave — leave game

/hs start <arena> — start match

/hs stop <arena> — stop/reset

/hs toggleblock <block> — enable/disable disguise for a block

/hs reload — reload configs

/hs spectate — spectate match



5. Game Flow

Lobby → Countdown → Hide phase (hiders disguise) → Seek phase (seekers search).

Scoreboard/timer shown via sidebar or bossbar.

Option: disguise removed if player runs/jumps (configurable).

Option: disguise breaks on damage.



6. Visual & Audio Effects

Particles & sound when disguise applied or removed.

Only the disguised player sees themselves normally, others see them as the chosen block.



7. Arena & Persistence

Multiple arenas supported.

Save arena/lobby locations and block lists to config files.



8. Other Requirements

Compatible with Paper/Spigot 1.21.4.

Geyser compatibility for Bedrock.

Use ProtocolLib (optional) for efficient disguise packets.

Messages in messages.yml with support for Urdu + English.





--- Created by Zakir