Skip to content

README.md

Latest commit

 

History

History
23 lines (15 loc) · 1.27 KB

README.md

File metadata and controls

23 lines (15 loc) · 1.27 KB

Merge

Neo.Merge is a generic pure C# merge engine for connected groups. It is not tied to Unity scenes, grids, inventory slots, or any specific game.

Use it when a mechanic needs to find equivalent connected items, choose the result item, compute a new value, clear the rest, and optionally continue cascading from the result.

Runtime API

  • MergeRequest<TItem, TValue> defines items, seeds, value access, neighbors, match rules, result selection, merged value, cascade mode, MaxCascadeIterations, and mutate/dry-run mode.
  • MergeResolver.Resolve(request) returns MergeResult<TItem, TValue>.
  • MergeResult contains resolved groups, changed items, and CascadeLimitReached (set when a cascade hit the safety limit).
  • For grids, GridMergeRequest.Increment(...) is a ready-made preset for the common "merge equal content into content+step at the seed, cascade from result" rule.

Examples

  • Grid games: use Neo.GridSystem.Merge.GridMergeResolver to adapt FieldGenerator cells.
  • Dice games: use Neo.GridSystem.Dice.DiceBoardService for dice placement and dice-specific merge rules.
  • Custom systems: pass any graph/list/inventory nodes as TItem and provide a neighbor callback.

See also