> For the complete documentation index, see [llms.txt](https://docs.mipcraft.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mipcraft.eu/hide-and-seek/gameplay-mechanics.md).

# Gameplay Mechanics

Hide and Seek offers deep, interactive mechanics designed for fast-paced, strategic gameplay.

## 🎭 Disguise & Hiding Types

Hiders can disguise themselves using three different transformation modes:

### 🟩 Block Disguise Mode

Hiders take the visual form of a block (e.g., Crafting Table, Hay Bale, Oak Log, Anvil).

* **1.19+ Engine**: On modern servers (1.19+), blocks render cleanly as **Block Displays / Entity Blocks**.
* **1.8 - 1.18 Engine**: On legacy versions, blocks render using **Armor Stands**.
* **Lib's Disguises Integration**: If [Lib's Disguises](https://www.spigotmc.org/resources/libs-disguises-free.81/) is installed on your server, blocks automatically render as **Falling Blocks** across all versions.

### 📦 Item Disguise Mode

Hiders transform into dropped 3D items or custom resource pack items.

* Supports **Custom Model Data** via `custom_model_data` configuration tags.
* Allows server owners to create custom 3D furniture, hats, or props as hiding disguises!

### 🐷 Mob Disguise Mode

Hiders transform into passive or hostile Minecraft mobs (e.g., Pig, Cow, Chicken, Sheep, Zombie).

* Includes entity age/texture variations.
* Movement speed automatically adapts to the chosen mob's native speed.

## 🧱 Block Solidification System

When a block-disguised Hider stands still for a set period (default: `5 seconds`):

{% stepper %}
{% step %}

### Solidify into a block

The Hider freezes and **solidifies** into a real, solid block in the world.
{% endstep %}

{% step %}

### Switch camera view

The Hider's camera switches to a third-person / spectator view while disguised as the block.
{% endstep %}

{% step %}

### Seekers test the block

Seekers can hit the block to deal damage or test if it is a real player.
{% endstep %}

{% step %}

### Move to un-solidify

Moving or jumping un-solidifies the Hider back into an active entity.
{% endstep %}
{% endstepper %}

## 💓 Heartbeat & Enemy Radar

Keep players engaged with immersive proximity detection:

* **Heartbeat Sound Effects**: As Seekers approach a Hider, a rhythmic heartbeat sound plays (`BLOCK_NOTE_BLOCK_BASEDRUM`). The heartbeat accelerates as the distance closes!
* **Radar Compass / Tracker**: Seekers receive a radar tool that points toward the nearest active Hider with periodic ping sounds.

## 🧰 Kit System

Hide and Seek supports customizable kits for both teams:

{% tabs %}
{% tab title="Hider Kits" %}

* **Speedster Kit**: Extra movement speed during the hiding phase.
* **Taunter Kit**: Grants custom taunt items to play sounds and earn extra points.
  {% endtab %}

{% tab title="Seeker Kits" %}

* **Tracker Kit**: Reduced radar cooldown and enhanced particle tracking.
* **Brawler Kit**: Knockback resistance and extra sword damage.
* **Bow Master Kit**: Infinite arrows with a regenerating bow.
  {% endtab %}
  {% endtabs %}

## 📣 Decoy & Taunt Mechanics

* **Decoys**: Admins can place fake blocks/mobs to confuse Seekers.
* **Taunt Sounds**: Hiders can trigger audio taunts (meows, pops, fireworks) to taunt nearby Seekers in exchange for bonus score points!