DEAL-Toolkit

KO | EN

gitlite — search

#linux #docker #bash #macos #vue #agent #claude #artificial-intelligence #git #reactjs

(★ 9)

No description available.

File Explorer

ZIP Download

- - ui_Ani_BtnChip_Disabled.anim
  - ui_Ani_BtnChip_Disabled.anim.meta
  - ui_Ani_BtnChip_Highlighted.anim
  - ui_Ani_BtnChip_Highlighted.anim.meta
  - ui_Ani_BtnChip_Normal.anim
  - ui_Ani_BtnChip_Normal.anim.meta
  - ui_Ani_BtnChip_Pressed.anim
  - ui_Ani_BtnChip_Pressed.anim.meta
  - ui_Ani_BtnChip_Selected.anim
  - ui_Ani_BtnChip_Selected.anim.meta
  - ui_Ani_BtnCommon_Disabled.anim
  - ui_Ani_BtnCommon_Disabled.anim.meta
  - ui_Ani_BtnCommon_Highlighted.anim
  - ui_Ani_BtnCommon_Highlighted.anim.meta
  - ui_Ani_BtnCommon_In.anim
  - ui_Ani_BtnCommon_In.anim.meta
  - ui_Ani_BtnCommon_Normal.anim
  - ui_Ani_BtnCommon_Normal.anim.meta
  - ui_Ani_BtnCommon_Out.anim
  - ui_Ani_BtnCommon_Out.anim.meta
  - ui_Ani_BtnCommon_Pressed.anim
  - ui_Ani_BtnCommon_Pressed.anim.meta
  - ui_Ani_BtnCommon_Selected.anim
  - ui_Ani_BtnCommon_Selected.anim.meta
  - ui_Ani_PokerCard_Back.anim
  - ui_Ani_PokerCard_Back.anim.meta
  - ui_Ani_PokerCard_FlipToBack.anim
  - ui_Ani_PokerCard_FlipToBack.anim.meta
  - ui_Ani_PokerCard_FlipToFront.anim
  - ui_Ani_PokerCard_FlipToFront.anim.meta
  - ui_Ani_PokerCard_Front.anim
  - ui_Ani_PokerCard_Front.anim.meta
  - ui_animation_Pop_In.anim
  - ui_animation_Pop_In.anim.meta
  - ui_animation_Pop_Normal.anim
  - ui_animation_Pop_Normal.anim.meta
  - ui_animation_Pop_Out.anim
  - ui_animation_Pop_Out.anim.meta
  - ui_Animator_BtnChip.controller
  - ui_Animator_BtnChip.controller.meta
  - ui_Animator_BtnCommon.controller
  - ui_Animator_BtnCommon.controller.meta
  - ui_Animator_PokerCard.controller
  - ui_Animator_PokerCard.controller.meta
  - ui_Animator_Pop.controller
  - ui_Animator_Pop.controller.meta
- - ui_bg_Landscape.png
  - ui_bg_Landscape.png.meta
  - ui_bg_Portrait.png
  - ui_bg_Portrait.png.meta
- - btn_Bet_style1.png
  - btn_Bet_style1.png.meta
  - btn_Bet_style2.png
  - btn_Bet_style2.png.meta
  - btn_Bet_style3.png
  - btn_Bet_style3.png.meta
  - btn_Common_close.png
  - btn_Common_close.png.meta
  - btn_Common_normal.png
  - btn_Common_normal.png.meta
  - btn_Common_primary.png
  - btn_Common_primary.png.meta
  - btn_Toggle_Off.png
  - btn_Toggle_Off.png.meta
  - btn_Toggle_On.png
  - btn_Toggle_On.png.meta
  - deal_01.png
  - deal_01.png.meta
  - deal_02.png
  - deal_02.png.meta
  - icon_ArrowDown.png
  - icon_ArrowDown.png.meta
  - icon_ArrowRight.png
  - icon_ArrowRight.png.meta
  - icon_Check_01.png
  - icon_Check_01.png.meta
  - icon_Check_02.png
  - icon_Check_02.png.meta
  - icon_Close.png
  - icon_Close.png.meta
  - icon_Less.png
  - icon_Less.png.meta
  - icon_Plus.png
  - icon_Plus.png.meta
  - icon_toggle.png
  - icon_toggle.png.meta
  - icon_Undo.png
  - icon_Undo.png.meta
  - Poker.meta
  - ui_betSection_01.png
  - ui_betSection_01.png.meta
  - ui_betSection_02.png
  - ui_betSection_02.png.meta
  - ui_Checkbox.png
  - ui_Checkbox.png.meta
  - ui_Chip_01.png
  - ui_Chip_01.png.meta
  - ui_Chip_02.png
  - ui_Chip_02.png.meta
  - ui_Chip_03.png
  - ui_Chip_03.png.meta
  - ui_Chip_04.png
  - ui_Chip_04.png.meta
  - ui_Chip_05.png
  - ui_Chip_05.png.meta
  - ui_Chip_light.png
  - ui_Chip_light.png.meta
  - ui_Common_Bar.png
  - ui_Common_Bar.png.meta
  - ui_common_border_enemy.png
  - ui_common_border_enemy.png.meta
  - ui_common_border_partner.png
  - ui_common_border_partner.png.meta
  - ui_common_border_player.png
  - ui_common_border_player.png.meta
  - ui_common_Card.png
  - ui_common_Card.png.meta
  - ui_Common_Dot.png
  - ui_Common_Dot.png.meta
  - ui_common_Panel.png
  - ui_common_Panel.png.meta
  - ui_common_Profile.png
  - ui_common_Profile.png.meta
  - ui_common_RewardPanel.png
  - ui_common_RewardPanel.png.meta
  - ui_common_time.png
  - ui_common_time.png.meta
  - ui_MassagePanel_01.png
  - ui_MassagePanel_01.png.meta
  - ui_MassagePanel_02.png
  - ui_MassagePanel_02.png.meta
  - ui_Pop_Panel.png
  - ui_Pop_Panel.png.meta
  - ui_Pop_TitlePanel.png
  - ui_Pop_TitlePanel.png.meta
  - ui_SectionBanker.png
  - ui_SectionBanker.png.meta
  - ui_SectionPlayer.png
  - ui_SectionPlayer.png.meta
  - ui_Switch_Dot_Off.png
  - ui_Switch_Dot_Off.png.meta
  - ui_Switch_Dot_on.png
  - ui_Switch_Dot_on.png.meta
  - ui_Switch_Off.png
  - ui_Switch_Off.png.meta
  - ui_Switch_On.png
  - ui_Switch_On.png.meta
  - ui_Switch_Panel_Off.png
  - ui_Switch_Panel_Off.png.meta
  - ui_Switch_Panel_On.png
  - ui_Switch_Panel_On.png.meta
- - BetDialog.prefab
  - BetDialog.prefab.meta
  - bg_Landscape.prefab
  - bg_Landscape.prefab.meta
  - bg_Portrait.prefab
  - bg_Portrait.prefab.meta
  - btn_Arrow_Left.prefab
  - btn_Arrow_Left.prefab.meta
  - btn_Arrow_Right.prefab
  - btn_Arrow_Right.prefab.meta
  - btn_Bet_01.prefab
  - btn_Bet_01.prefab.meta
  - btn_Bet_02.prefab
  - btn_Bet_02.prefab.meta
  - btn_Bet_03.prefab
  - btn_Bet_03.prefab.meta
  - btn_BetSection_01.prefab
  - btn_BetSection_01.prefab.meta
  - btn_BetSection_02.prefab
  - btn_BetSection_02.prefab.meta
  - btn_BetSection_03.prefab
  - btn_BetSection_03.prefab.meta
  - btn_Checkbox.prefab
  - btn_Checkbox.prefab.meta
  - btn_Chip_01.prefab
  - btn_Chip_01.prefab.meta
  - btn_Chip_02.prefab
  - btn_Chip_02.prefab.meta
  - btn_Chip_03.prefab
  - btn_Chip_03.prefab.meta
  - btn_Chip_04.prefab
  - btn_Chip_04.prefab.meta
  - btn_Chip_05.prefab
  - btn_Chip_05.prefab.meta
  - btn_Common_01.prefab
  - btn_Common_01.prefab.meta
  - btn_Dropdown.prefab
  - btn_Dropdown.prefab.meta
  - btn_Funtion_01.prefab
  - btn_Funtion_01.prefab.meta
  - btn_Funtion_02.prefab
  - btn_Funtion_02.prefab.meta
  - btn_Funtion_Close.prefab
  - btn_Funtion_Close.prefab.meta
  - btn_Menu.prefab
  - btn_Menu.prefab.meta
  - btn_Switch.prefab
  - btn_Switch.prefab.meta
  - btn_Toggle.prefab
  - btn_Toggle.prefab.meta
  - ConfirmDialog.prefab
  - ConfirmDialog.prefab.meta
  - DialogButton.prefab
  - DialogButton.prefab.meta
  - DropdownDialog.prefab
  - DropdownDialog.prefab.meta
  - groupBetSection.prefab
  - groupBetSection.prefab.meta
  - groupChips.prefab
  - groupChips.prefab.meta
  - item_Balance.prefab
  - item_Balance.prefab.meta
  - item_Card.prefab
  - item_Card.prefab.meta
  - item_deal.prefab
  - item_deal.prefab.meta
  - item_Input.prefab
  - item_Input.prefab.meta
  - item_NumberChange.prefab
  - item_NumberChange.prefab.meta
  - item_Player.prefab
  - item_Player.prefab.meta
  - item_PlayerInfo.prefab
  - item_PlayerInfo.prefab.meta
  - item_PlayerInfo_02.prefab
  - item_PlayerInfo_02.prefab.meta
  - item_SectionBanker.prefab
  - item_SectionBanker.prefab.meta
  - item_SectionPlayer.prefab
  - item_SectionPlayer.prefab.meta
  - item_Slider.prefab
  - item_Slider.prefab.meta
  - item_Timer.prefab
  - item_Timer.prefab.meta
  - itemTotal.prefab
  - itemTotal.prefab.meta
  - Menu.prefab
  - Menu.prefab.meta
  - PopPanel.prefab
  - PopPanel.prefab.meta
  - SelectDialog.prefab
  - SelectDialog.prefab.meta
  - SliderDialog.prefab
  - SliderDialog.prefab.meta
  - TimedDialog.prefab
  - TimedDialog.prefab.meta
  - UI_Landscape.prefab
  - UI_Landscape.prefab.meta
  - UI_Portrait.prefab
  - UI_Portrait.prefab.meta
- - Documentation.meta
  - Fonts.meta
  - Resources.meta
  - Shaders.meta
  - Sprites.meta
- Animation.meta
- NoPacked.meta
- Packed.meta
- Prefab.meta
- TextMesh Pro.meta
- - PHEval.dll
  - PHEval.dll.meta
- - BasicDeckSO.asset
  - BasicDeckSO.asset.meta
  - BasicTileSO.asset
  - BasicTileSO.asset.meta
  - FSM_SO.meta
  - PokerCardSO.meta
  - TraitSO.meta
- - CardChoiceDrawer.cs
  - CardChoiceDrawer.cs.meta
  - DEALGameInfoEditorWindow.cs
  - DEALGameInfoEditorWindow.cs.meta
  - DealLogConfigDrawer.cs
  - DealLogConfigDrawer.cs.meta
  - FSMGraphView.cs
  - FSMGraphView.cs.meta
  - ScriptableStateInspector.cs
  - ScriptableStateInspector.cs.meta
  - StatusPhaseDrawer.cs
  - StatusPhaseDrawer.cs.meta
  - TileSOEditor.cs
  - TileSOEditor.cs.meta
- - Determinism.meta
  - Mustaverse.DEAL.Core.asmdef
  - Mustaverse.DEAL.Core.asmdef.meta
  - Net.meta
  - Seats.meta
- - CardTrait.meta
  - Combatant.meta
  - Command.meta
  - Component.meta
  - Event.meta
  - Generic.meta
  - Helper.meta
  - Modifier.meta
  - Mustaverse.DEAL.Runtime.asmdef
  - Mustaverse.DEAL.Runtime.asmdef.meta
  - Poker.meta
  - Scoring.meta
  - ScriptableObject.meta
  - Shaders.meta
  - Status.meta
  - UI.meta
  - Utility.meta
- Assemblies.meta
- CommonSO.meta
- Editor.meta
- Lib.meta
- Runtime.meta
- QuickStart.pdf
- QuickStart.pdf.meta
- Internal.meta
- LOGGING_STANDARDS.md
- LOGGING_STANDARDS.md.meta
- PATTERN_SYSTEM_DESIGN.md
- PATTERN_SYSTEM_DESIGN.md.meta
- QUICKSTART.md
- QUICKSTART.md.meta
- STATUS_SYSTEM_DESIGN.md
- STATUS_SYSTEM_DESIGN.md.meta
- TESTING_GUIDE.md
- TESTING_GUIDE.md.meta
- - CommandSystemTests.cs
  - CommandSystemTests.cs.meta
  - DamagePipelineTests.cs
  - DamagePipelineTests.cs.meta
  - DeterminismTests.cs
  - DeterminismTests.cs.meta
  - InputSeamTests.cs
  - InputSeamTests.cs.meta
  - Mustaverse.DEAL.Tests.EditMode.asmdef
  - Mustaverse.DEAL.Tests.EditMode.asmdef.meta
  - NetTransportTests.cs
  - NetTransportTests.cs.meta
  - PatternEvaluatorTests.cs
  - PatternEvaluatorTests.cs.meta
  - Samples.meta
  - ScorePipelineTests.cs
  - ScorePipelineTests.cs.meta
  - SeededRNGTests.cs
  - SeededRNGTests.cs.meta
  - StatusSystemTests.cs
  - StatusSystemTests.cs.meta
  - TestEnvironmentSetup.cs
  - TestEnvironmentSetup.cs.meta
  - WeightedTilePoolTests.cs
  - WeightedTilePoolTests.cs.meta
- EditMode.meta
Art.meta
Core.meta
docs.meta
Documentation.meta
LICENSE.md
LICENSE.md.meta
package.json
package.json.meta
README.md
Tests.meta

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**A data-driven Unity framework for stacking-score card games.**

DEAL is the engine under [Aurayale](https://mustaverse.com), a Balatro-inspired collectible card
game. It exists because we wanted the core of that genre — *play a hand, watch bonuses trigger one
by one, see `Base × Multiplier` explode* — to be something designers assemble from data, not
something engineers re-code for every card.

- **Game flow is a state machine you can see.** Draw, select, score, resolve — each step is a
  ScriptableObject state with data-defined transitions. Changing "3 discards per round" to 2 is a
  field edit, not a code change.
- **A card is a data asset.** Effects are composed from `Condition[] + Effect[]` traits pointing at
  status objects. Adding a card means creating a `.asset` — zero code, no recompile.
- **Scoring is one pipeline: `Base × Multiplier`.** Every bonus — card traits, statuses, "joker"-style
  persistent modifiers — is a step on that pipeline, and each step can drive UI feedback in sequence.
- **The core is deterministic and headless-testable.** Seeded RNG, an immutable command log, and a
  141-test EditMode suite that runs without a scene — same seed, same result, CI-friendly.

## Build the Balatro loop in five steps

The shortest path to "numbers go up":

1. **Define cards.** Create card assets (`CardSO` subclasses) and give them suit/number traits —
   or your own trait types; the base card has no built-in poker vocabulary.
2. **Lay out the flow.** Create a `ScriptableStateMachine` with states for *deal → select →
   play-or-discard → score*. Budget mechanics (hands/discards remaining) are integer player
   properties checked by transition conditions.
3. **Score the hand.** Wire a `ScoreCounterSO` (the poker evaluator ships as one strategy; write
   your own by subclassing) and map results to base score and multiplier.
4. **Add modifiers.** Build "joker"-style effects as `ModifierTrait`s (condition + effect data) on
   cards, or as persistent `StatusSO`s that trigger at scoring phases.
5. **Watch it stack.** Score mutations flow through the command processor; hook the events to
   animate your `A × B` display per trigger.

The **samples** (Package Manager → DEAL → Samples) show working scenes for card dealing,
suit/number changes, and pattern evaluation, plus in-code samples (`Tests/EditMode/Samples/`)
demonstrating every extension seam: a custom command verb, a custom scoring strategy with no poker,
a custom property provider and status phase, and a two-client lockstep match over the in-process
loopback transport.

## Extending without forking

Every place a game needs its own rules is an open seam:

| You want to… | Use |
|---|---|
| Add a game-specific command verb | `CommandHandlerRegistry.RegisterHandler(string, handler)` |
| Score by your own rules (non-poker included) | subclass `ScoreCounterSO` |
| Add a status trigger phase beyond the built-ins | any string key; `StatusPhases` is just a preset |
| Feed FSM actions a custom system value | subclass `SystemPropertyProviderSO` |
| Add card mechanics | `ModifierCondition` / `ModifierEffect` / `StatusSO` subclasses |
| Swap how player input arrives (human, bot, remote) | `IPlayerInput` behind `SeatRegistry` |
| Run deterministic multiplayer logic in-process | `INetTransport` + `LoopbackTransport` |

## Module maturity

Be aware of what's battle-tested and what's newer:

| Module | Status |
|---|---|
| FSM engine, card/trait system, status system, scoring pipeline, command system | **Stable** — shipping in Aurayale |
| Poker evaluation (`Mustaverse.DEAL.Poker`) | **Stable** — slated to move into its own assembly so non-poker games don't reference it |
| Seats/input seam, determinism seam (`IRng`, `BattleBarrier`) | **Validated** — adopted by a second internal title |
| Net transport (loopback), damage pipeline (`IDamageModifier`) | **Preview** — proven by tests and samples; not yet exercised by a shipping game. APIs may still move. |

## What DEAL is (and isn't) good at today

DEAL targets **turn-based card games with data-driven effects**: score-stacking roguelikes
(Balatro-likes), turn-loop battlers, and classic flow games. The engine-free core assembly
(`Mustaverse.DEAL.Core` — no UnityEngine reference) holds the deterministic seams, so game logic is
testable headless.

It does **not** yet provide a priority/reaction-stack primitive (the Yu-Gi-Oh/MTG family of
interaction), a remote network driver, or server-side score verification. The command log and
seeded RNG are *designed* so a verifier could replay a match — building that verifier is on the
roadmap, not in the box.

## Tests

EditMode suite (`Mustaverse.DEAL.Tests.EditMode`): 141 tests across RNG reproducibility, command-log
integrity, scoring/damage math, status behavior, pattern evaluation, and the extension-seam samples.
Window → General → Test Runner → EditMode → Run All. No scene required.

## Roadmap

- Score-verification service (replay a match from seed + command log)
- Remote transport driver + matchmaking companions for the net seam
- Poker module split into its own assembly (`PHEval` dependency leaves core)
- Sample-content slimming: legacy casino-flow content moves fully into samples

## License

Apache-2.0 — free for commercial use, patent grant included. See [LICENSE.md](LICENSE.md).
Issues and PRs welcome.

DEAL-Toolkit

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README