跳至主要內容

10. 打磨与发布

EVOCOSMOS2026/4/14大约 9 分钟

10. 俄罗斯方块——打磨与发布

10.1 打磨——从"能玩"到"好玩"

经过前面9章的努力，我们的俄罗斯方块已经"能玩"了。但"能玩"和"好玩"之间还有一段距离。打磨（Polish） 就是填补这段距离的过程——优化动画、修复bug、添加存档、准备发布。

就像装修房子：主体结构已经建好了（能住），但还需要刷漆、装灯、铺地板，才能变成一个温馨的家（好住）。

10.2 存档系统

玩家关闭游戏后再打开，应该能看到之前的最高分。我们需要一个存档系统来保存和读取游戏数据。

Godot提供了 ConfigFile 类，可以方便地读写INI格式的配置文件。

C
using Godot;

/// <summary>
/// 存档系统——保存和读取游戏数据
/// </summary>
public static class SaveSystem
{
    // 存档文件路径
    private const string SavePath = "user://tetris_save.cfg";

    // 存档节名称
    private const string SettingsSection = "settings";
    private const string StatsSection = "stats";

    /// <summary>
    /// 保存设置
    /// </summary>
    public static void SaveSettings(GameSettings settings)
    {
        var config = new ConfigFile();

        config.SetValue(SettingsSection, "music_volume", settings.MusicVolume);
        config.SetValue(SettingsSection, "sfx_volume", settings.SFXVolume);
        config.SetValue(SettingsSection, "show_ghost", settings.ShowGhost);
        config.SetValue(SettingsSection, "screen_shake", settings.ScreenShake);

        config.Save(SavePath);
    }

    /// <summary>
    /// 读取设置
    /// </summary>
    public static GameSettings LoadSettings()
    {
        var config = new ConfigFile();
        var settings = new GameSettings(); // 默认值

        Error err = config.Load(SavePath);
        if (err != Error.Ok) return settings;

        settings.MusicVolume = (float)config.GetValue(
            SettingsSection, "music_volume", settings.MusicVolume);
        settings.SFXVolume = (float)config.GetValue(
            SettingsSection, "sfx_volume", settings.SFXVolume);
        settings.ShowGhost = (bool)config.GetValue(
            SettingsSection, "show_ghost", settings.ShowGhost);
        settings.ScreenShake = (bool)config.GetValue(
            SettingsSection, "screen_shake", settings.ScreenShake);

        return settings;
    }

    /// <summary>
    /// 保存最高分
    /// </summary>
    public static void SaveHighScore(int score)
    {
        var config = new ConfigFile();

        // 先读取已有的存档（保留其他数据）
        config.Load(SavePath);

        config.SetValue(StatsSection, "high_score", score);

        config.Save(SavePath);
    }

    /// <summary>
    /// 读取最高分
    /// </summary>
    public static int LoadHighScore()
    {
        var config = new ConfigFile();

        Error err = config.Load(SavePath);
        if (err != Error.Ok) return 0;

        return (int)config.GetValue(StatsSection, "high_score", 0);
    }

    /// <summary>
    /// 保存游戏统计数据
    /// </summary>
    public static void SaveStats(GameStats stats)
    {
        var config = new ConfigFile();
        config.Load(SavePath);

        config.SetValue(StatsSection, "total_games", stats.TotalGames);
        config.SetValue(StatsSection, "total_lines", stats.TotalLines);
        config.SetValue(StatsSection, "total_tetrises", stats.TotalTetrises);
        config.SetValue(StatsSection, "max_level", stats.MaxLevel);
        config.SetValue(StatsSection, "max_combo", stats.MaxCombo);
        config.SetValue(StatsSection, "play_time", stats.TotalPlayTime);

        config.Save(SavePath);
    }

    /// <summary>
    /// 读取游戏统计数据
    /// </summary>
    public static GameStats LoadStats()
    {
        var config = new ConfigFile();
        var stats = new GameStats();

        Error err = config.Load(SavePath);
        if (err != Error.Ok) return stats;

        stats.TotalGames = (int)config.GetValue(
            StatsSection, "total_games", 0);
        stats.TotalLines = (int)config.GetValue(
            StatsSection, "total_lines", 0);
        stats.TotalTetrises = (int)config.GetValue(
            StatsSection, "total_tetrises", 0);
        stats.MaxLevel = (int)config.GetValue(
            StatsSection, "max_level", 0);
        stats.MaxCombo = (int)config.GetValue(
            StatsSection, "max_combo", 0);
        stats.TotalPlayTime = (float)config.GetValue(
            StatsSection, "play_time", 0f);

        return stats;
    }
}

/// <summary>
/// 游戏设置数据
/// </summary>
public class GameSettings
{
    public float MusicVolume { get; set; } = -5f;
    public float SFXVolume { get; set; } = -3f;
    public bool ShowGhost { get; set; } = true;
    public bool ScreenShake { get; set; } = true;
}

/// <summary>
/// 游戏统计数据
/// </summary>
public class GameStats
{
    public int TotalGames { get; set; }
    public int TotalLines { get; set; }
    public int TotalTetrises { get; set; }
    public int MaxLevel { get; set; }
    public int MaxCombo { get; set; }
    public float TotalPlayTime { get; set; }
}

10.3 设置界面

让玩家可以调整音量、开关特效等功能。

C
using Godot;

/// <summary>
/// 设置界面
/// </summary>
public partial class SettingsScreen : CanvasLayer
{
    // 音量滑块
    private HSlider _musicSlider;
    private HSlider _sfxSlider;

    // 开关
    private CheckButton _ghostToggle;
    private CheckButton _shakeToggle;

    // 按钮
    private Button _backButton;

    public override void _Ready()
    {
        _musicSlider = GetNode<HSlider>("Panel/VBox/MusicSlider");
        _sfxSlider = GetNode<HSlider>("Panel/VBox/SFXSlider");
        _ghostToggle = GetNode<CheckButton>("Panel/VBox/GhostToggle");
        _shakeToggle = GetNode<CheckButton>("Panel/VBox/ShakeToggle");
        _backButton = GetNode<Button>("Panel/VBox/BackButton");

        // 加载设置
        var settings = SaveSystem.LoadSettings();
        _musicSlider.Value = settings.MusicVolume;
        _sfxSlider.Value = settings.SFXVolume;
        _ghostToggle.ButtonPressed = settings.ShowGhost;
        _shakeToggle.ButtonPressed = settings.ScreenShake;

        // 连接信号
        _musicSlider.ValueChanged += OnMusicVolumeChanged;
        _sfxSlider.ValueChanged += OnSFXVolumeChanged;
        _ghostToggle.Toggled += OnGhostToggled;
        _shakeToggle.Toggled += OnShakeToggled;
        _backButton.Pressed += OnBackPressed;

        Visible = false;
    }

    private void OnMusicVolumeChanged(float value)
    {
        // 实时更新音量
        var busIdx = AudioServer.GetBusIndex("Music");
        AudioServer.SetBusVolumeDb(busIdx, value);
    }

    private void OnSFXVolumeChanged(float value)
    {
        var busIdx = AudioServer.GetBusIndex("SFX");
        AudioServer.SetBusVolumeDb(busIdx, value);
    }

    private void OnGhostToggled(bool pressed)
    {
        GameManager.Instance.ShowGhost = pressed;
    }

    private void OnShakeToggled(bool pressed)
    {
        GameManager.Instance.ScreenShakeEnabled = pressed;
    }

    private void OnBackPressed()
    {
        // 保存设置
        SaveSystem.SaveSettings(new GameSettings
        {
            MusicVolume = (float)_musicSlider.Value,
            SFXVolume = (float)_sfxSlider.Value,
            ShowGhost = _ghostToggle.ButtonPressed,
            ScreenShake = _shakeToggle.ButtonPressed
        });

        Visible = false;
    }
}

10.4 动画优化清单

在发布之前，检查以下动画是否都到位：

动画描述状态
方块移动平滑的位移动画✓
方块旋转带Tween的旋转动画✓
硬降快速下落 + 落地震动✓
消行闪烁满行快速闪烁后消失✓
分数弹出飘动的分数数字✓
Ghost Piece半透明投影实时更新✓
升级特效缩放 + 粒子✓
游戏结束面板弹入 + 新纪录闪烁✓
暂停/恢复淡入淡出✓
按钮悬停颜色变化✓

10.5 Bug检查清单

发布前务必检查以下常见bug：

Bug类型检查项修复方法
死锁方块卡在墙里出不来加强碰撞检测
穿模方块穿过其他方块检查IsValidPosition
无限锁定利用锁定延迟无限拖延加MaxLockResets限制
消行错位消行后网格数据不一致从下往上消除
Hold重复一回合内多次Hold加UsedThisTurn标记
音效重叠快速操作时音效叠放使用对象池限制
内存泄漏粒子/弹出未销毁加自动销毁Timer
C
/// <summary>
/// 常见Bug修复示例
/// </summary>
public partial class BugFixExamples
{
    /// <summary>
    /// Bug修复1：确保方块不会穿到网格外面
    /// </summary>
    public static bool SafeIsValidPosition(
        int[,] cells, int[,] shape, int px, int py,
        int cols, int rows)
    {
        int shapeRows = shape.GetLength(0);
        int shapeCols = shape.GetLength(1);

        for (int r = 0; r < shapeRows; r++)
        {
            for (int c = 0; c < shapeCols; c++)
            {
                if (shape[r, c] == 0) continue;

                int gx = px + c;
                int gy = py + r;

                // 超出左右边界或底部 → 不合法
                if (gx < 0 || gx >= cols || gy >= rows)
                    return false;

                // 顶部以上（gy < 0）允许通过
                if (gy < 0) continue;

                // 格子被占据 → 不合法
                if (cells[gx, gy] != 0)
                    return false;
            }
        }

        return true;
    }

    /// <summary>
    /// Bug修复2：防止消行时索引越界
    /// </summary>
    public static int SafeClearLines(
        int[,] cells, int cols, int rows)
    {
        int cleared = 0;

        for (int y = rows - 1; y >= 0; y--)
        {
            bool full = true;
            for (int x = 0; x < cols; x++)
            {
                if (cells[x, y] == 0)
                {
                    full = false;
                    break;
                }
            }

            if (full)
            {
                cleared++;
                // 安全地上移行
                for (int moveY = y; moveY > 0; moveY--)
                {
                    for (int x = 0; x < cols; x++)
                    {
                        cells[x, moveY] = cells[x, moveY - 1];
                    }
                }
                // 安全地清空顶行
                for (int x = 0; x < cols; x++)
                {
                    cells[x, 0] = 0;
                }
                y++; // 重新检查当前行
            }
        }

        return cleared;
    }
}

10.6 项目导出

导出平台

Godot支持导出到多个平台：

平台要求说明
Windows无额外要求导出为.exe
Linux无额外要求导出为.x86_64
macOS需要Mac电脑导出为.app
Android需要Android SDK导出为.apk
iOS需要Mac电脑+Xcode导出为.ipa
HTML5（网页）无额外要求导出为HTML+JS+WASM

导出步骤

  1. 菜单 → 项目 → 导出
  2. 点击"添加"按钮，选择目标平台
  3. 配置导出参数
  4. 点击"导出项目"或"一键导出"

Windows导出配置

平台: Windows Desktop
图标: 设置游戏图标（.ico格式）
分辨率: 保持默认
启动模式: 窗口模式

网页版导出配置

平台: HTML5
HTML Shell: 使用自定义的index.html
内存: 256MB

10.7 后续扩展方向

完成基础版本后，可以考虑以下扩展功能：

扩展功能难度说明
对战模式高两个玩家对战，互相消行给对方增加垃圾行
马拉松模式低挑战150行/200行/无尽模式
方块皮肤低替换方块的颜色和纹理
背景主题低不同的背景颜色和风格
排行榜中本地或在线排行榜
触屏优化中滑动手势操作
每日挑战中每天生成相同的方块序列
成就系统中解锁各种成就

10.8 本章小结

内容说明
存档系统使用ConfigFile保存设置、最高分和统计数据
设置界面音量调节、特效开关
动画优化确保所有操作都有对应的动画反馈
Bug检查列出常见bug和修复方法
项目导出多平台导出配置
后续扩展对战模式、皮肤系统、排行榜等

恭喜你完成了俄罗斯方块的全部开发！回顾一下我们走过的路：

章节完成内容
1分析核心玩法，理解游戏循环
2搭建项目结构，创建GameManager和Grid
3实现七种方块数据和7-Bag生成器
4实现SRS旋转系统和墙踢
5实现消行检测和计分系统
6实现等级系统和速度递增
7实现Hold暂存和Next预览
8搭建完整的游戏UI
9添加音效和粒子特效
10存档、设置、导出和发布

你现在拥有了一个功能完整、体验流畅的俄罗斯方块游戏。接下来，让我们进入下一个实战项目——雷霆战机！

最近更新:
贡献者: zefeng.peng,bobokaka
EVOCOSMOS
Copyright © 2026 EVOCOSMOS