Lucky Money Game

Một trò chơi "Cơn Mưa Lì Xì" được xây dựng bằng React + TypeScript + PixiJS, cho phép người chơi click vào các bao lì xì rơi từ trên xuống để nhận phần thưởng.

Tính năng chính

• 🎮 Gameplay tương tác với click chuột
• 🎁 Hệ thống phần thưởng với API xác nhận
• 🎨 Hiệu ứng đồng xu nổ khi click
• 📱 Responsive design cho mobile và desktop
• 🏆 Bảng xếp hạng top người chơi
• ⏱️ Countdown timer cho game

node v21.7.3

Cài đặt

# cập nhật bảng mới nhất
lucky-money-event@latest

# cài đặt
npm i lucky-money-event
yarn add lucky-money-event

Sử dụng cơ bản

1. Import component

import { LuckyMoneyEvent } from "lucky-money-event";

function App() {
  return (
    <LuckyMoneyEvent 
        appId="your-app-id"       // appId game
        authCode="your-auth-code" // authcode xacs thực
        debug={false}             // test debug dữ liệu trả về popup
    />
  );
}

2. Props cần thiết

• appId: ID ứng dụng để xác thực API
• authCode: Mã xác thực để gọi API
• debug: Bật/tắt chế độ debug (optional, default: false)

3. Cách hoạt động

1. Khởi tạo game: Component sẽ tự động load tài nguyên và bắt đầu game
2. Click lì xì: Người chơi click vào bao lì xì rơi xuống
3. Xác nhận phần thưởng: Hệ thống gọi API để xác nhận phần thưởng
4. Kết thúc game: Sau khi hết thời gian, hiển thị modal kết quả và bảng xếp hạng

Cấu trúc thư mục

src/
├── game/
│   ├── animations/          # Animation chính của game
│   ├── components/          # UI components
│   ├── hooks/              # Custom hooks
│   ├── apis/               # API calls
│   ├── config/             # Cấu hình game
│   └── types/              # TypeScript types
├── context/                 # React context
├── services/                # API services
└── styles/                  # CSS styles

Dependencies chính

• React 18+ - UI framework
• TypeScript - Type safety
• PixiJS - 2D rendering engine
• GSAP - Animation library
• Vite - Build tool

API Endpoints

Game sử dụng các API sau:

• confirmReceiveReward - Xác nhận nhận phần thưởng
• getTopRankingResults - Lấy bảng xếp hạng

Tùy chỉnh

Thay đổi cấu hình game

Troubleshooting

Lỗi thường gặp

1. Game không load: Kiểm tra appId và authCode có đúng không
2. API lỗi: Kiểm tra network và authentication

3.1. network - đăng kí nhận thưởng lỗi: đứng game ở phần cowndown 3.2. network - nhận thưởng: Không ảnh hưởng đến game

License

MIT License - xem file LICENSE để biết thêm chi tiết.