🎮 Hole People

A challenging puzzle game where players strategically move same-color stickmen across a grid into matching holes, then route them to MatrixHoles or Holders. Built with Unity, featuring PrimeTween polish, batch transfer systems, and the SerapKeremGameKit architecture.

---

🎮 About the Game

Hole People is a grid-based puzzle game where players tap a grid hole to send all matching-color stickmen on the grid toward that hole. Stickmen pathfind with BFS, run and jump into the hole, then get batched and routed automatically: either into capacity-based MatrixHoles (goal lanes) or into Holder racks (storage). A spaceship VFX layer visualizes transfers. The goal is to fill and close all MatrixHole lanes (win); if no valid route exists, stickmen are dropped and the player loses.

🎥 Gameplay Video

Hello.People_GitHub.1.mp4

🖼️ Screenshots

---

✨ Game Features

🧩 Core Mechanics

• 🎛️ Grid-Based Movement: Stickmen move on a tile grid with BFS pathfinding toward the selected hole.
• 🎨 Color Matching: Only stickmen whose color matches the tapped hole are sent.
• 🏃 Run & Jump: PrimeTween-powered run-to-jump arc into the hole, with optional jump particle.
• 📦 Batch Transfer: Arrived stickmen are collected per hole and routed in batches (MatrixHole capacity or Holder).
• 🚀 Spaceship VFX: Transfer to Holder or MatrixHole is visualized with a reusable spaceship (reference-counted).
• 📌 MatrixHole Lanes: Capacity-based lanes; when full, hole closes and the next one shifts forward.

🌈 Visual Features

• ✨ Particle Effects: Pooled jump/feedback particles (key-based).
• 🎞️ Smooth Animations: PrimeTween for movement, jumps, fill ring, and UI.
• 🎚️ Material System: Dynamic colors via MaterialPropertyBlock (stickmen and holes).
• 📊 Fill Ring UI: Radial fill around MatrixHoles showing capacity (event + LateUpdate fallback).
• 🔊 Audio & Haptics: Key-based registry for selection and feedback.

🧠 Technical Features

• 🧱 Component-Based Architecture: Modular, clear separation (Stickman, Hole, MatrixHole, Holder, TransferService).
• ♻️ Object Pooling: Particles, audio, pathfinding collections (Queue/Dictionary/HashSet).
• 🔄 State Management: StateManager + state-driven UI (HUD, Win, Fail, Settings, Retry).
• 🔊 Audio & Haptics: SerapKeremGameKit integration.
• 📂 Level System: Prefab-based level loading (Level_01–Level_10), LevelManager + Level init pipeline.

---

🛠️ Tools & Packages Used

📦 Unity Packages

• ⚙️ Unity Engine: 6000.0.58f2
• 🔄 PrimeTween: Tweening & animations
• 🧰 TriInspector: Enhanced Inspector UI
• 🎨 URP: Universal Render Pipeline 17.0.4
• ✨ UI Particle (ParticleEffectForUGUI): UI particle effects
• 📝 TextMeshPro: UI text

---

🎨 Custom Assets

🧱 Game Prefabs & Resources

• 🧩 Stickman, Hole, MatrixHole, MatrixHoleLine, Holder, SpaceShip prefabs
• 🎨 Level prefabs (Level_Base, Level_01–Level_10)
• 🧱 Tile and grid assets
• 📂 Resources under Assets/_Game/Resources/

🟣 Materials & Rendering

• 🎚️ MaterialPropertyBlock: Runtime color application for stickmen and holes (no material instantiation).
• 🌫️ Toon / URP: Scene load material sanitization for Toon shader (URP keyword workaround, cached per scene).

---

🧩 Custom Framework

• 🧱 SerapKeremGameKit – A personal development template used in Hole People:

  • 📝 Logging system
  • 🔊 Audio management
  • 📳 Haptic feedback
  • ✨ Particle system with pooling
  • ♻️ Level system
  • 🖼️ UI framework (HUD, Win, Fail, Retry, Settings panels)
  • 🔄 State management
  • 🧱 Tile/Grid system (grid layout, pathfinding, spawn)
  • ⌨️ Input handling (lock/unlock on win/lose)
  • 💰 Economy & time (coin rewards, completion time, star evaluation)

---

🎯 How to Play

📘 Basic Rules

1. 🧩 Select a Hole: Tap a grid hole. All same-color stickmen on the grid that can pathfind to it will move.
2. 🎨 Match Colors: Only stickmen whose color matches the hole’s color are sent.
3. 🏃 Watch the Transfer: Stickmen run, jump into the hole, then are batched and sent to MatrixHoles (if capacity) or Holders.
4. 📦 Fill MatrixHoles: MatrixHoles have a capacity; when full, they close and the next hole in the lane advances.
5. 🏆 Win: Close all required MatrixHole lanes. Lose: If stickmen cannot be placed (no holder space, no matrix capacity), they are dropped and you lose.

🕹️ Controls

• 🖱️ Mouse / Touch: Tap a grid hole to select it and start movement.
• 🎯 Raycast: Selection uses raycast; UI blocks input when pointer is over UI.

---

📦 Project Structure

Assets/
├── _Game/
│   ├── Scripts/
│   │   ├── _Core/            # Base entity patterns
│   │   ├── _Stickman/        # Stickman, movement, animator
│   │   ├── _Hole/            # Grid hole system
│   │   ├── _Holder/          # Holder (storage) system
│   │   ├── MatrixHole/       # MatrixHole lines & transfer
│   │   ├── SpaceShip/        # Spaceship VFX
│   │   ├── _Pathfinding/     # BFS + pathfinding pool
│   │   └── Editor/           # Grid Editor Tool, Level Balance
│   ├── Resources/            # Prefabs and levels
│   │   ├── Levels/           # Level prefabs
│   │   ├── Stickman/         # Stickman prefab
│   │   ├── Hole/             # Hole, MatrixHole prefabs
│   │   ├── Holder/           # Holder prefab
│   │   ├── SpaceShip/        # SpaceShip prefab
│   │   └── Tile/             # Tile prefabs
│   ├── Scenes/               # Game scene
│   └── Animation/            # Animator controllers
└── SerapKeremGameKit/        # Custom framework
    ├── Scripts/
    │   ├── Audio/            # Audio management
    │   ├── Haptics/          # Haptic feedback
    │   ├── Particles/        # Particle system + pool
    │   ├── Pools/            # BasePool
    │   ├── LevelSystem/      # Level, State, LevelManager
    │   ├── UI/               # UI framework
    │   └── ...
    └── Resources/

---

🚀 Getting Started

📥 Installation

git clone https://github.com/SERAP-KEREM/HolePeople.git

1. Open the project in Unity (6000.0.58f2)
2. Load the main scene: Assets/_Game/Scenes/GameScene.unity
3. Press Play

🛠️ Build

1. File → Build Settings
2. Choose platform
3. Click Build

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.