Skip to content

Latest commit

 

History

History
312 lines (220 loc) · 6.43 KB

File metadata and controls

312 lines (220 loc) · 6.43 KB

⚡ 快速开始 | Quick Start

快速上手GameHub项目!

Get started with GameHub quickly!

中文 | English


中文

🎮 项目介绍

GameHub是一个包含42款精品HTML5游戏的开源项目,无需安装,本地即可运行。

💻 本地运行

方法1:直接打开(最简单)

  1. 克隆或下载项目

    git clone https://github.com/SinceraXY/GameHub.git
    cd GameHub
  2. 双击打开 index.html

    • 浏览器会自动打开网站
    • 开始玩游戏!🎉

方法2:使用本地服务器(推荐)

使用Python:

# Python 3
python -m http.server 8000

# Python 2
python -m SimpleHTTPServer 8000

使用Node.js:

# 全局安装
npm install -g http-server
http-server -p 8000

# 或使用npx(无需安装)
npx http-server -p 8000

使用PHP:

php -S localhost:8000

使用VSCode Live Server:

  1. 安装Live Server扩展
  2. 右键 index.html
  3. 选择 "Open with Live Server"

然后访问:http://localhost:8000


🚀 3分钟上手

步骤1:浏览游戏(30秒)

  • 主页展示42款游戏
  • 按分类浏览
  • 使用搜索快速定位

步骤2:玩游戏(1分钟)

  • 点击任意游戏卡片
  • 新标签页打开游戏
  • 开始游戏!

步骤3:探索功能(1.5分钟)

  • 🔍 搜索:输入游戏名称快速查找
  • 🏷️ 过滤:点击分类按钮筛选游戏
  • 📊 统计:查看各分类游戏数量
  • 🎨 主题:欣赏精美的渐变UI设计

🎯 快速导航

想要... 前往...
📖 了解项目 README.md
🤝 参与贡献 CONTRIBUTING.md
🛠️ 开发指南 docs/DEVELOPMENT.md
🚀 部署指南 docs/DEPLOYMENT.md
📝 更新日志 CHANGELOG.md
🐛 报告问题 GitHub Issues

🎮 游戏推荐

新手友好

  • 🎲 骰子模拟器 - 简单有趣
  • ♟️ 井字棋 - 经典对战
  • 🐍 贪吃蛇 - 永不过时

挑战高手

  • 🧩 2048 - 策略益智
  • 👾 太空入侵者 - 反应速度
  • 🧠 数独 - 逻辑思维

放松休闲

  • 🎯 泡泡龙 - 轻松愉快
  • 🍬 糖果消消乐 - 减压神器
  • 🎨 拼图游戏 - 悠闲时光

💡 使用技巧

键盘快捷键

  • Ctrl + F - 快速搜索
  • ↑↑↓↓←→←→BA - Konami Code彩蛋
  • Esc - 从游戏返回(部分游戏支持)

移动端优化

  • 📱 完美适配手机和平板
  • 👆 支持触摸操作
  • 🔄 自动横竖屏适配

浏览器建议

  • ✅ Chrome / Edge(最佳体验)
  • ✅ Firefox(完全支持)
  • ✅ Safari(iOS推荐)

❓ 常见问题

Q: 游戏无法加载怎么办? A: 检查网络连接,刷新页面,或清除浏览器缓存。

Q: 可以离线玩吗? A: 部分游戏支持。PWA功能正在开发中。

Q: 可以添加自己的游戏吗? A: 当然!查看贡献指南了解如何添加。

Q: 游戏数据会保存吗? A: 部分游戏使用localStorage保存进度。

Q: 支持哪些设备? A: 支持所有现代浏览器的桌面、平板和手机设备。


📱 分享给朋友

喜欢GameHub?分享给朋友吧!

分享链接:

https://sincerapxy.github.io/GameHub/

社交媒体:

  • 📘 Facebook
  • 🐦 Twitter / X
  • 💬 微信 / QQ
  • 📧 Email

🌟 支持项目

如果你喜欢这个项目:

  • ⭐ 在GitHub上给个Star
  • 🍴 Fork项目进行开发
  • 🐛 报告Bug或提建议
  • 🎮 贡献新游戏
  • 📢 分享给更多人

English

🎮 Project Introduction

GameHub is an open-source project containing 42 premium HTML5 games that can run locally without installation.

💻 Run Locally

Method 1: Direct Open (Easiest)

  1. Clone or download the project

    git clone https://github.com/SinceraXY/GameHub.git
    cd GameHub
  2. Double-click index.html

    • Browser will open automatically
    • Start playing! 🎉

Method 2: Use Local Server (Recommended)

Using Python:

# Python 3
python -m http.server 8000

# Python 2
python -m SimpleHTTPServer 8000

Using Node.js:

# Global install
npm install -g http-server
http-server -p 8000

# Or use npx (no install needed)
npx http-server -p 8000

Using PHP:

php -S localhost:8000

Using VSCode Live Server:

  1. Install Live Server extension
  2. Right-click index.html
  3. Select "Open with Live Server"

Then visit: http://localhost:8000


🚀 Get Started in 3 Minutes

Step 1: Browse Games (30s)

  • Homepage showcases 42 games
  • Browse by category
  • Use search to find games quickly

Step 2: Play Games (1min)

  • Click any game card
  • Opens in new tab
  • Start playing!

Step 3: Explore Features (1.5min)

  • 🔍 Search: Type game name to find quickly
  • 🏷️ Filter: Click category buttons to filter
  • 📊 Stats: View game counts by category
  • 🎨 Theme: Enjoy beautiful gradient UI design

🎯 Quick Navigation

Want to... Go to...
📖 Learn about project README_EN.md
🤝 Contribute CONTRIBUTING.md
🛠️ Development guide docs/DEVELOPMENT.md
🚀 Deployment guide docs/DEPLOYMENT.md
📝 Changelog CHANGELOG.md
🐛 Report issues GitHub Issues

💡 Pro Tips

Keyboard Shortcuts

  • Ctrl + F - Quick search
  • ↑↑↓↓←→←→BA - Konami Code easter egg
  • Esc - Return from game (some games)

Mobile Optimization

  • 📱 Perfect for phones and tablets
  • 👆 Touch support
  • 🔄 Auto orientation

Browser Recommendations

  • ✅ Chrome / Edge (Best experience)
  • ✅ Firefox (Fully supported)
  • ✅ Safari (iOS recommended)

🌟 Support the Project

If you like this project:

  • ⭐ Star on GitHub
  • 🍴 Fork and develop
  • 🐛 Report bugs or suggest features
  • 🎮 Contribute new games
  • 📢 Share with others

🎮 Enjoy Gaming!

Have fun and happy gaming! 🚀

🏠 Home | 📖 Docs | 🐛 Issues