Game Tools

A web-based tool to support the Liar's Bar game mode from the Steam title "Liar's Bar". This offline-capable application provides three game modes: Liar's Deck (Russian Roulette), Liar's Poker, and Card Score Tracker for Vietnamese 13 (Tiến lên).

Table of Contents

• Features
• Game Modes
• Demo
• Tech Stack
• Getting Started
  • Prerequisites
  • Installation
  • Running Locally
• Project Structure
• Contributing
• License

Features

• Liar's Deck – 6-chamber virtual revolver with Russian Roulette gameplay, sound effects, and visual effects
• Liar's Poker – 8-chamber poker-themed variant with community cards and stages (Pre-flop, Flop, Turn, River, Showdown)
• Card Score – Vietnamese 13 (Tiến lên) score tracker with:
  • 2–4 players support
  • Configurable points (rankings, catch, hold, sweep, stuck)
  • Round history with edit/delete
  • Zero-sum default scoring per round
• Offline gameplay—no external servers required once loaded
• Responsive React UI with mobile support
• Persistent state (localStorage) for mode, mute, and game data

Game Modes

Mode	Description
Liar's Deck	Pick a card, spin the cylinder, and pull the trigger. Russian Roulette with card-based odds.
Liar's Poker	Poker-themed variant with 8 chambers and community card stages.
Card Score	Track Vietnamese 13 (Tiến lên) scores with configurable rules.

Demo

Live demo: liarbar-app.vercel.app

Tech Stack

• React 19 + TypeScript
• Vite for fast builds and development server
• Tailwind CSS for styling
• Deployed on Vercel

Getting Started

Prerequisites

• Node.js >= 16.x
• npm or yarn

Installation

git clone https://github.com/lntvan166/game-tools.git
cd game-tools
npm install

Running Locally

npm run dev

Open http://localhost:5173 in your browser.

Build

npm run build

Output is in the dist/ directory.

Project Structure

game-tools/
├── public/                # Static assets (images, sounds)
│   └── assets/img/
├── src/
│   ├── components/        # React components
│   │   ├── Game.tsx       # Liar's Deck
│   │   ├── PokerGame.tsx  # Liar's Poker
│   │   ├── ScoreTracking.tsx
│   │   ├── TienLenScore.tsx
│   │   └── AddRoundModal.tsx
│   ├── lib/               # Game logic
│   │   └── tienLenScore.ts
│   ├── styles/
│   ├── App.tsx
│   ├── main.tsx
│   └── ErrorBoundary.tsx
├── vercel.json
├── package.json
└── vite.config.ts

Contributing

Contributions are welcome!

1. Fork the repository
2. Create a feature branch (git checkout -b feature/YourFeature)
3. Commit your changes (git commit -m 'Add YourFeature')
4. Push to the branch (git push origin feature/YourFeature)
5. Open a Pull Request

License

Distributed under the MIT License.