OGGY

image

OGGY 🐱

GitHub contributors GitHub issues GitHub top language GitHub repo size GitHub code size in bytes GitHub commit activity GitHub last commit GitHub release (latest by date)

📖 Mô tả / Description

OGGY là một game chạy nhảy (runner game) được phát triển bằng C# Windows Forms, lấy cảm hứng từ bộ phim hoạt hình “Oggy và những chú gián”. Người chơi điều khiển nhân vật Oggy chạy và nhảy để thu thập xu trong khi tránh các vật cản nguy hiểm.

OGGY is a runner game developed with C# Windows Forms, inspired by the “Oggy and the Cockroaches” cartoon series. Players control Oggy to run and jump, collecting coins while avoiding dangerous obstacles.

✨ Tính năng / Features

🖼️ Screenshots

image

image

📦 Tài nguyên game / Game Assets

Thư mục assets/ chứa tất cả các tài nguyên của game bao gồm: The assets/ folder contains all game resources including:

🎬 Demo Video

🖼️ Hình ảnh / Images

🐱 Nhân vật Oggy / Oggy Character

oggy/ - Sprites và animations của nhân vật Oggy / Oggy character sprites and animations

Ví dụ / Examples:

Oggy Run Oggy Jump Oggy Shadow

🪳 Nhân vật Gián / Cockroaches

cockroaches/ - Sprites của các chú gián / Cockroach sprites

Ví dụ / Examples:

Cockroach DeeDee Cockroach Joey Cockroach Marky

🏠 Nền nhà bếp / Kitchen Background

kitchen/ - Hình ảnh nền nhà bếp / Kitchen background images

Ví dụ / Examples:

Kitchen Background

Fridge Kitchen Table

🎮 Giao diện game / Game UI

game/ - UI elements và giao diện game / UI elements and game interface

Ví dụ / Examples:

Game Logo

Menu Background Coin

✨ Hiệu ứng / Visual Effects

fx/ - Hiệu ứng hình ảnh / Visual effects

Ví dụ / Examples:

Stars Effect Splash Effect Hit Effect

🎵 Âm thanh / Audio

📋 Yêu cầu hệ thống / System Requirements

🚀 Cài đặt / Installation

Cách 1: Chạy từ source code / Method 1: Run from source code

  1. Clone repository: 
    git clone https://github.com/TienNHM/OGGY.git
cd OGGY
  2. Mở project:
    • Mở file OGGY.sln bằng Visual Studio 2017 trở lên
    • Open OGGY.sln with Visual Studio 2017 or later
  3. Restore packages:
    • Visual Studio sẽ tự động restore NuGet packages
    • Visual Studio will automatically restore NuGet packages
  4. Build và chạy:
    • Nhấn F5 hoặc chọn Debug > Start Debugging
    • Press F5 or select Debug > Start Debugging

Cách 2: Chạy file đã build sẵn / Method 2: Run pre-built executable

  1. Tải file release mới nhất từ Releases Download the latest release from Releases

  2. Giải nén và chạy file OGGY.exe Extract and run OGGY.exe

🎮 Cách chơi / How to Play

Điều khiển / Controls

Mục tiêu / Objectives

Luật chơi / Game Rules

📁 Cấu trúc dự án / Project Structure

OGGY/
├── Background/          # Lớp xử lý background
│   ├── Background.cs
│   └── Kitchen.cs
├── Characters/          # Các nhân vật trong game
│   ├── Character.cs
│   ├── Oggy.cs
│   ├── Gian.cs
│   ├── Coin.cs
│   ├── VaCham.cs       # Xử lý va chạm
│   └── VatCan.cs       # Các vật cản
├── UI/                 # Giao diện người dùng
│   ├── frmMenu.cs      # Màn hình menu chính
│   ├── frmMain.cs      # Màn hình game chính
│   └── EndGame.cs      # Màn hình kết thúc game
├── assets/             # Tài nguyên game
│   ├── oggy/           # Sprite của Oggy
│   ├── cockroaches/    # Sprite của gián
│   ├── kitchen/        # Hình ảnh nhà bếp
│   ├── game/           # UI elements
│   ├── fx/             # Hiệu ứng
│   └── music/          # Âm thanh và nhạc
├── Properties/         # Cấu hình project
├── Program.cs          # Entry point
└── OGGY.csproj         # Project file

🛠️ Công nghệ sử dụng / Technologies Used

🔧 Build từ source / Building from Source

  1. Đảm bảo đã cài đặt Visual Studio 2017 trở lên với .NET Framework 4.8 Ensure Visual Studio 2017 or later with .NET Framework 4.8 is installed

  2. Mở OGGY.sln trong Visual Studio Open OGGY.sln in Visual Studio

  3. Restore NuGet packages (tự động hoặc qua Package Manager Console) Restore NuGet packages (automatically or via Package Manager Console)

  4. Build solution (Ctrl+Shift+B) Build solution (Ctrl+Shift+B)

  5. Chạy project (F5) Run project (F5)

🐛 Báo lỗi / Reporting Bugs

Nếu bạn gặp lỗi, vui lòng tạo một Issue với: If you encounter bugs, please create an Issue with:

🤝 Đóng góp / Contributing

Đóng góp luôn được chào đón! Vui lòng: Contributions are welcome! Please:

  1. Fork repository
  2. Tạo branch mới cho tính năng của bạn (git checkout -b feature/AmazingFeature) Create a new branch for your feature (git checkout -b feature/AmazingFeature)
  3. Commit các thay đổi (git commit -m 'Add some AmazingFeature') Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push lên branch (git push origin feature/AmazingFeature) Push to the branch (git push origin feature/AmazingFeature)
  5. Mở Pull Request Open a Pull Request

📝 License

Dự án này có thể được phân phối dưới giấy phép riêng. Vui lòng kiểm tra file LICENSE (nếu có) để biết thêm chi tiết. This project may be distributed under its own license. Please check the LICENSE file (if available) for more details.

👤 Tác giả / Author

TienNHM

🙏 Lời cảm ơn / Acknowledgments

⭐ Nếu bạn thích dự án này, hãy cho một star! / If you like this project, please give it a star!