lucky-money-event/README.md

Lucky Money event

# 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

```bash
# 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

```tsx
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
5. **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](LICENSE) để biết thêm chi tiết.