Tile Rummy Prototype

Unity prototype for tile-based Rummy / Rummikub-style play with drag-and-drop meld building, a guided tutorial flow, and quick board setup tools for testing.

Highlights

• Human vs computer turn flow
• Drag-and-drop tile movement between hand and table
• Live group state feedback: VALID, INCOMPLETE, INVALID
• Guided tutorial that advances step by step after the required move
• Auto Test Setup for fast manual testing
• Runtime-friendly prototype structure with scene-based UI and prefab-driven tile rows

Current Rules Scope

This project currently supports:

• sets: same number, different colors
• runs: same color, consecutive numbers
• 4 colors with duplicate tiles
• 2 jokers

This is still a prototype, so full Rummikub table-rebuild logic and opening-threshold rules are not implemented yet.

Controls

• Drag a tile from your hand into a group on the table
• Drag a tile back to your hand to undo a bad move
• New Group creates an empty row on the table
• Sort Hand sorts the current player hand
• Draw Tile draws and ends the turn
• End Turn validates the table and passes play to the AI
• Tutorial starts a guided learning flow
• Auto Test Setup creates a near-finished board for quick testing

Tutorial Flow

The guided tutorial is isolated from the normal game loop and walks the player through specific actions:

1. finish a run
2. create a new group
3. build a valid set

While the tutorial is active, the UI shows the current step and only advances after the expected move is completed.

Project Structure

• Assets/Scripts/Rummy/RummyGameController.cs coordinates turns, buttons, tutorial start/stop, and board refresh
• Assets/Scripts/Rummy/RummyGameState.cs owns deck, players, table melds, and helper setups
• Assets/Scripts/Rummy/RummyRules.cs validates sets, runs, and preview states
• Assets/Scripts/Rummy/RummyTutorialFlow.cs holds the isolated step-by-step tutorial logic
• Assets/Scripts/Rummy/RummyUi.cs binds scene UI, buttons, hand/table rendering, and tutorial panel content
• Assets/Scripts/Editor/RummySceneBuilder.cs rebuilds the sample scene UI and prefab wiring from the editor

Run Locally

1. Open the project in Unity 6000.3.10f1
2. Open Assets/Scenes/SampleScene.unity
3. Press Play

WebGL Build

1. Switch platform to WebGL in Build Settings
2. Ensure Assets/Scenes/SampleScene.unity is included
3. Build the project

License

MIT