Merge Toolkit - Base

The ultimate, most functional, and flexible Merge Toolkit - Base! Build your dream game with seamless scalability and dynamic visuals, all while keeping the core architecture intact. Extensions & Customization: Designed with extensibility at its core, allowing you to build unique mechanics on a stable foundation. VContainer Integration -- swap any service (moving logic, grid management, etc.) by simply registering your implementation in a custom LifetimeScope. Custom Chips -- extend the base Chip class to create specialized logic (like the included Generators and Containers). Modular Effects -- chips bind to effect interfaces, not implementations; replace or add visual feedback via independent prefabs without touching core logic. Test-Driven Extensions -- included recommended workflow for building and verifying new mechanics using the integrated testing framework. Chips: Chip Merging & Progression -- Combine two compatible chips to create a result chip determined by their types and merge rules (with weighted random outcomes if multiple results are possible). If merge rules specify an extra chip, there is a chance an extra chip spawns on a nearby free cell. Chip Generator -- Manual & Auto: Flexible generation system supporting both manual (player-triggered) and automatic modes. Charge-based progression with configurable recharge timers and total lifespan. Generators evolve into different chip types after specified recharge cycles. Built-in free-cell detection ensures optimal chip placement; generators intelligently transform when grid space is unavailable. Chip Containers: Collect specific chips to complete containers through flexible requirements based on type or ID. Track completion with the visual effect system. Containers transform into result chips upon fill. Chip Power Booster: A special chip that boosts parameters of neighboring chips -- for example, speeding up nearby generators. Automatically tracks neighbors and visualizes active connections. Multi-cell Chips: Chips can occupy any NxM area on the grid. Top-left anchor: position always refers to the anchor cell. Secondary cells reference back to the chip. Clicking anywhere on a large chip resolves correctly. Chip Relocation: when a merge result needs more space than its parents occupied, neighboring chips move aside automatically. Chips are sorted by size before relocating -- larger chips are placed first to reduce fragmentation. If any neighbor has nowhere to go, the whole operation cancels cleanly. No partial field state. Effects: Effect base class with Animator integration (Activate/Deactivate triggers, safe trigger reset). Ready-to-use effects included: Blocker effects: BoxEffect -- blocks chip actions; progressively destroyed by neighboring merges. ChainsEffect -- blocks chip actions; destroyed on the first neighboring merge. Move Locked -- prevents chip from being dragged; triggers shake feedback on attempt. Other effects: Merge Available -- activates when chip is valid for merge. Cell Highlight -- highlights cells under chip. Container Requirements -- displays item icons required by container. Generator Charged -- activates when generator is fully charged. Generator Charging -- shows generator charging progress. Power Booster Connector -- highlights neighboring chips boosted by booster. Power Booster Join Links -- dynamic links between booster and boost targets. Shadow -- permanent shadow under chip that reacts to movement. Quality Assurance & Testing: Comprehensive integration test suite running against real field prefabs (full pipeline, no mocks). Stress Testing -- Validated via 2000+ random drag operations. Logic Validation -- Tests for evolution, free space detection, and complex interactions. Per-Mechanic Testing -- Every core mechanic (Chips, Generators, Containers) comes with its own dedicated test suite. Documentation & Guides: Comprehensive documentation is available in English and Ukrainian, covering every aspect of the toolkit. Main Documentation Hub -- central navigation for all guides and technical details. Quick Start Guide -- get your first merge game running in minutes. Extension Guide -- detailed instructions on creating custom chips and mechanics. Technical Design -- deep dive into architecture and core abstractions. Full API Reference -- automatically generated documentation for the entire codebase. Unity Version: Unity 6 LTS (6.0+, including 6.4) -- fully compatible with all LTS versions (recommended). Unity 2022.3 LTS -- full support available (excluding integrated tests). Requires: VContainer -- a free, open-source dependency injection framework (MIT license). Input System -- official Unity package for handling modern input. Shader Graph -- official Unity package for creating visual effects via nodes.