> 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/welcome.md).

# Welcome

Welcome to the official documentation for **Hide and Seek**, a feature-rich, highly customizable Hive/Hypixel-style mini-game plugin built for Minecraft Spigot & Paper servers!

## 🎮 Game Overview

In **Hide and Seek**, players are split into two teams: **Hiders** and **Seekers**.

* **The Hiding Phase**: At the start of the game, one or more players are chosen as **Seekers** and frozen in their waiting area, while **Hiders** receive a brief head start to run into the map and disguise themselves.
* **Disguise Options**: Hiders can transform into **Players**, **Blocks**, **Items**, or **Mobs**, blending into the map environment to fool the Seekers.
* **The Seeking Phase**: Once released, Seekers must hunt down and hit the disguised Hiders.
* **Elimination & Role Swap**: Tagged Hiders turn into Seekers, joining the hunt to find the remaining Hiders.
* **Victory Conditions**:
  * **Seekers Win**: Find and eliminate all Hiders before time runs out.
  * **Hiders Win**: At least one Hider survives until the game timer expires.

## ✨ Key Features

* 🎭 **4 Hiding Modes**: Disguise as Players, Blocks, Items, or Mobs!
* 🧱 **Advanced Block Solidification**: Hiders who stay still solidify into real blocks after a configurable delay.
* 📱 **Cross-Play Compatibility**: Full support for Bedrock & Mobile players via [GeyserMC](https://geysermc.org/) and [Floodgate](https://geysermc.org/download/?project=floodgate).
* 🎨 **Custom Model Data Support**: Use custom 3D model items/blocks as disguises.
* 💓 **Heartbeat & Radar System**: Dynamic heartbeat sounds and radar trackers that warn players when enemies are nearby.
* 📦 **Kit System**: Customizable Hider and Seeker Kits.
* 💾 **Flexible Storage**: Local SQLite/YML storage or network-wide MySQL database support.
* 📊 **PlaceholderAPI & Top 10 Leaderboards**: Full PlaceholderAPI integration with dynamic Top 10 leaderboards for wins, score, win-streaks, and kills.
* 🌐 **Single & Multi-Arena Support**: Run multi-arena servers or standalone single-game BungeeCord instances.

## 🌐 Test Server

Try out Hide and Seek live on our official testing network:

* **IP**: `testing.mipcraft.eu`
* **Port**: `22022` (Direct IP: `157.90.137.69:22022`)
* **Version Compatibility**: Supports Minecraft `1.8` up to `26.2` (1.21+ / Paper 26.x).

## 🧭 Navigation Guide

Explore the documentation pages:

{% stepper %}
{% step %}

## [Gameplay Mechanics](broken://pages/a436fe4aa75264b8a6c83ec05da1de7e6eadfa1b)

Learn about Hiding types, Solidification, Radar, Kits, and Decoys.
{% endstep %}

{% step %}

## [Setup Guide](broken://pages/c3ca2cbb8f0c8df335f1caf832421d6a5e587a09)

Step-by-step installation, Editor guide, Bungee setup, and Geyser/Floodgate configuration.
{% endstep %}

{% step %}

## [Configuration](broken://pages/a550b2d71c5ac6f8a1495978ce9e995acc25d933)

Complete `config.yml` reference and customization options.
{% endstep %}

{% step %}

## [Commands & Permissions](broken://pages/28e8d9a4bbfd59846c0235c6098f1443e667682c)

Detailed command index and permission node directory.
{% endstep %}

{% step %}

## [PlaceholderAPI](broken://pages/c0c311f2cea7752cb7d9387b0b58ef9e6071a086)

Player placeholders and dynamic Top 10 Leaderboards.
{% endstep %}
{% endstepper %}