Veggerby.Boards 0.1.0-prerelease0157

Veggerby.Boards

Immutable, deterministic board game engine primitives: artifacts (Board, Tile, Piece, Player, Dice), immutable GameState history chain, declarative events, rules, phases, and safe transition execution.

This is the foundational package. Other domain/game modules (Chess, Backgammon) sit on top without extending internal mutable state.

Install

 dotnet add package Veggerby.Boards

When To Use

Use this package when you need to:

• Model a turn/phase based board game with deterministic replay
• Express moves as intent (IGameEvent) separated from validation and mutation
• Maintain a full immutable history for branching / analysis / undo
• Compose rules and phases declaratively

If you only need a ready-made game (e.g., Chess) and won't build custom rules, reference the game module package instead (it transitively references Core).

Quick Start

// Build a custom game (example sketch)
var builder = new GameBuilder("my-game");
// builder.AddBoard(...).AddPlayers(...).AddPieces(...).AddRules(...)
var progress = builder.Compile();

// Issue a move event (pseudo—depends on your defined artifacts)
var piece = progress.Game.GetPiece("white-pawn-2");
var from = progress.Game.GetTile("e2");
var to = progress.Game.GetTile("e4");
var pathVisitor = new ResolveTilePathPatternVisitor(progress.Game.Board, from, to);
var updated = progress.HandleEvent(new MovePieceGameEvent(piece, pathVisitor.ResultPath));

Core Concepts

Determinism & Purity

• No randomness except through explicit dice artifacts and their state.
• Same event + same state → same result. Always.
• No hidden global or time-based influences.

Validation Pipeline (High Level)

1. Submit IGameEvent
2. Active phase filters applicable rules
3. Rule conditions yield: Valid, Invalid, Ignore, NotApplicable
4. First Valid rule's mutator executes producing new GameState
5. New GameProgress returned (state chained)

Extending

Typical extension points:

• New IGameEvent + corresponding mutator & rule
• New pattern visitor for movement resolution
• New composite condition types

Keep extensions explicit and side-effect free.

Versioning

Semantic versioning aligned with repository releases. Breaking API changes bump MAJOR.

Roadmap (Selected)

• Decision plan executor (optimized rule dispatch)
• Deterministic timeline hashing
• Movement pattern compilation (DFA)
• Optional bitboard acceleration (game-specific)

Contributing

Issues & PRs: https://github.com/veggerby/Veggerby.Boards

Follow repository contribution guidelines and style rules.

License

MIT License. See repository root LICENSE.