Tetris Game | 俄罗斯方块

一个使用 Go 语言和 Ebitengine 游戏引擎实现的经典俄罗斯方块游戏，支持中英文双语界面。

A classic Tetris game implemented in Go using the Ebitengine game engine with bilingual support (Chinese/English).

✨ 特性 | Features

🎮 游戏特性 | Game Features

• ✅ 经典俄罗斯方块玩法 | Classic Tetris gameplay
• 👻 半透明幽灵方块预览 | Transparent ghost piece preview
• 🔮 下一个方块预览 | Next piece preview
• 💥 消除行数计分系统 | Line clearing with scoring system
• 📈 渐进式难度等级 | Progressive difficulty levels
• 🎯 平滑控制与踢墙系统 | Smooth controls with wall kicks
• ⚡ 硬降落特效 | Hard drop visual effects
• 🎨 彩色方块显示 | Colorful block rendering

🌍 多语言支持 | Multi-language Support

• 🇺🇸 English - 完整英文界面 | Full English interface
• 🇨🇳 中文 - 完整中文界面 | Full Chinese interface
• 🔄 实时语言切换 | Real-time language switching (Press L key)

🖥️ 平台支持 | Platform Support

• 🪟 Windows (64-bit) - 包含安装包和启动脚本
• 🍎 macOS (10.15+) - 原生 .app 应用包
• 🐧 Linux (64-bit) - 支持 X11/Wayland 显示系统

🎯 游戏控制 | Game Controls

键位	功能	Key	Function
← →	左右移动方块	← →	Move piece horizontally
↑	顺时针旋转方块	↑	Rotate piece clockwise
↓	软降落 (加速下降)	↓	Soft drop (faster falling)
空格	硬降落 (瞬间落底)	Space	Hard drop (instant drop)
L	切换中英文界面	L	Switch language
R	重新开始游戏	R	Restart game (when game over)
Esc	退出游戏	Esc	Exit game

🏗️ 项目结构 | Project Structure

tetris/
├── main.go                    # 应用程序入口 | Application entry point
├── go.mod                     # Go 模块定义 | Go module definition
├── go.sum                     # Go 模块校验和 | Go module checksums
├── Makefile                   # 构建系统 | Build system
├── BUILD.md                   # 构建说明文档 | Build documentation
├── build.sh                   # 构建脚本 | Build script
├── assets/                    # 游戏资源文件 | Game assets
│   ├── fonts/                 # 字体文件 | Font files
│   │   └── HYSongYunLangHeiW-1.ttf  # 中文字体
│   └── icons/                 # 图标文件 | Icon files
├── internal/                  # 内部包 | Internal packages
│   ├── game/                  # 核心游戏逻辑 | Core game logic
│   │   └── game.go           # 游戏状态和渲染 | Game state and rendering
│   ├── tetromino/            # 俄罗斯方块逻辑 | Tetromino logic
│   │   └── tetromino.go      # 方块形状、旋转、移动 | Piece shapes, rotation, movement
│   ├── types/                # 共享类型定义 | Shared type definitions
│   │   └── types.go          # 方块类型和颜色 | Block types and colors
│   ├── font/                 # 字体渲染系统 | Font rendering system
│   │   └── font.go           # 字体渲染器 | Font renderer
│   └── i18n/                 # 国际化支持 | Internationalization
│       └── i18n.go           # 多语言文本 | Multi-language text
├── pkg/                      # 公共包 | Public packages
│   └── config/               # 配置常量 | Configuration constants
│       └── config.go         # 游戏配置和常量 | Game configuration
└── dist/                     # 分发文件 | Distribution files (generated)
    ├── TetrisGame-Windows-v1.0.zip    # Windows 分发包
    ├── TetrisGame-macOS-v1.0.dmg      # macOS 分发包
    └── TetrisGame-Linux-v1.0.tar.gz   # Linux 分发包

🏛️ 架构设计 | Architecture

项目遵循 Go 语言最佳实践，采用清晰的包结构设计：

The project follows Go best practices with a clean package structure:

• main.go: 应用程序入口，初始化游戏 | Entry point that initializes the game
• pkg/config: 包含所有游戏配置常量 | Contains all game configuration constants
• internal/types: 定义核心数据类型和枚举 | Defines core data types and enums
• internal/tetromino: 处理俄罗斯方块逻辑 | Handles tetromino piece logic
• internal/game: 核心游戏机制 | Core game mechanics (board state, input handling, rendering)
• internal/font: 字体渲染系统 | Font rendering system for multi-language support
• internal/i18n: 国际化和本地化支持 | Internationalization and localization support

🚀 快速开始 | Quick Start

开发环境运行 | Development

# 克隆项目 | Clone the repository
git clone <repository-url>
cd tetris

# 下载依赖 | Download dependencies
go mod download

# 运行游戏 | Run the game
go run .

# 测试字体渲染 | Test font rendering
go run . --test-font

构建分发版本 | Build Distribution

# 构建所有平台版本 | Build for all platforms
make all

# 构建特定平台 | Build for specific platform
make windows    # Windows 版本
make macos      # macOS 版本
make linux      # Linux 版本

# 查看构建帮助 | View build help
make help

# 清理构建文件 | Clean build files
make clean

构建完成后，分发文件将保存在 dist/ 目录中。

After building, distribution files will be saved in the dist/ directory.

📦 系统要求 | System Requirements

开发环境 | Development Environment

• Go: 1.19 或更高版本 | 1.19 or higher
• 操作系统: Windows 10+, macOS 10.15+, Linux (64-bit)

运行环境 | Runtime Environment

• Windows: Windows 10/11 (64-bit)
• macOS: macOS 10.15 Catalina 或更高版本 | or higher
• Linux: 64-bit Linux 发行版，支持 X11 或 Wayland | distributions with X11/Wayland support

🛠️ 主要依赖 | Dependencies

require (
	github.com/hajimehoshi/ebiten/v2 v2.8.8  // 2D 游戏引擎 | 2D game engine
	golang.org/x/image v0.20.0               // 图像处理库 | Image processing
)

• Ebitengine: 现代 Go 语言 2D 游戏引擎 | Modern 2D game engine for Go
• golang.org/x/image: Go 官方图像处理扩展库 | Official Go image processing extensions

🎨 特色功能 | Special Features

🌟 视觉效果 | Visual Effects

• 幽灵方块: 半透明预览方块将要落下的位置 | Transparent preview of where piece will land
• 硬降落特效: 硬降落时的闪烁动画效果 | Flashing animation during hard drop
• 网格线: 清晰的游戏区域网格显示 | Clear game area grid display
• 渐变背景: 美观的背景色彩搭配 | Beautiful background color scheme

💯 计分系统 | Scoring System

• 基础分数: 根据消除行数计算 | Based on lines cleared
• 等级系统: 随着分数增加难度递增 | Progressive difficulty with score
• 实时显示: 分数和等级实时更新 | Real-time score and level updates

🎯 游戏机制 | Game Mechanics

• 7种标准方块: I、O、T、S、Z、J、L 形方块 | Standard 7 tetromino pieces
• 踢墙算法: 智能旋转碰撞检测 | Smart rotation collision detection
• 行消除: 满行自动消除和分数计算 | Automatic line clearing and scoring
• 渐进速度: 等级越高下降速度越快 | Progressive drop speed increase

🎮 游戏截图 | Screenshots

(游戏支持实时中英文切换，界面简洁美观)

(The game supports real-time Chinese/English switching with a clean and beautiful interface)

🔧 故障排除 | Troubleshooting

常见问题 | Common Issues

中文字体显示异常 | Chinese Font Display Issues

# 检查字体文件是否存在 | Check if font file exists
ls -la assets/fonts/HYSongYunLangHeiW-1.ttf

# 重新运行字体测试 | Re-run font test
go run . --test-font

构建失败 | Build Failures

# 检查 Go 环境 | Check Go environment
go version

# 清理并重新构建 | Clean and rebuild
make clean && make all

# 检查依赖 | Check dependencies
go mod verify

运行时错误 | Runtime Errors

• 确保在支持的操作系统上运行 | Ensure running on supported OS
• 检查显卡驱动是否支持 OpenGL | Check if graphics drivers support OpenGL
• 确保有足够的系统资源 | Ensure sufficient system resources

🤝 贡献指南 | Contributing

欢迎提交 Issue 和 Pull Request！

Welcome to submit Issues and Pull Requests!

1. Fork 本项目 | Fork the project
2. 创建特性分支 | Create a feature branch
3. 提交更改 | Commit your changes
4. 推送到分支 | Push to the branch
5. 创建 Pull Request | Create a Pull Request

📄 许可证 | License

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

This project is licensed under the MIT License - see the LICENSE file for details.

📞 联系方式 | Contact

如有问题或建议，请通过以下方式联系：

For questions or suggestions, please contact via:

• 📧 提交 Issue | Submit an Issue
• 🐙 GitHub Discussions
• 📝 Pull Request

---

享受游戏！| Enjoy the game! 🎮✨