跳至主要內容

8. 打磨与发布

EVOCOSMOS2026/4/13大约 10 分钟

打磨与发布

经过前面7章的开发，我们的麻将游戏已经具备了核心玩法。但一个"能玩"的游戏和一款"好玩"的游戏之间，差的就是"打磨"——音效、动画、光影、UI这些细节。

生活化比喻

打磨就像给蛋糕裱花——蛋糕胚已经烤好了（核心玩法），现在需要涂奶油、放水果、写字（音效、UI、动画）。这些装饰不会改变蛋糕的味道，但会让它看起来更诱人、吃起来更开心。

UI 美化

UI 布局设计

一个完整的麻将游戏UI包含以下区域：

┌─────────────────────────────────────┐
│           [对手C的手牌(背面)]         │
│                                     │
│ [对手B]   ┌───────────────┐  [对手A] │
│ (背面)    │               │  (背面)  │
│           │   牌桌中央     │         │
│           │  (弃牌区域)    │         │
│           │               │         │
│           └───────────────┘         │
│                                     │
│     [我的手牌(正面，可选择)]          │
│                                     │
│  [计分板]  [剩余牌数]  [操作按钮]    │
└─────────────────────────────────────┘

UI 元素清单

UI 元素类型位置说明
手牌区域3D场景底部中央显示玩家的手牌
弃牌区域3D场景桌面中央显示所有打出的牌
对手手牌3D场景上/左/右显示牌背
计分板Panel右上角显示每个玩家的分数
剩余牌数Label左上角牌堆还剩多少张
操作按钮Button底部中央碰/杠/胡/过
回合指示Label顶部中央显示轮到谁了
计时器ProgressBar手牌上方出牌倒计时

计分板UI代码

C
using Godot;

/// <summary>
/// 计分板UI控制器
/// </summary>
public partial class ScoreBoard : Panel
{
    /// <summary>
    /// 玩家分数标签（4个）
    /// </summary>
    [Export] public Label Player1Score { get; set; }
    [Export] public Label Player2Score { get; set; }
    [Export] public Label Player3Score { get; set; }
    [Export] public Label Player4Score { get; set; }

    /// <summary>
    /// 玩家名称标签
    /// </summary>
    [Export] public Label Player1Name { get; set; }
    [Export] public Label Player2Name { get; set; }
    [Export] public Label Player3Name { get; set; }
    [Export] public Label Player4Name { get; set; }

    /// <summary>
    /// 玩家分数数据
    /// </summary>
    private int[] _scores = new int[4];

    /// <summary>
    /// 更新某个玩家的分数
    /// </summary>
    public void UpdateScore(int playerIndex, int score)
    {
        if (playerIndex < 0 || playerIndex >= 4) return;

        _scores[playerIndex] = score;

        // 更新UI显示
        var label = playerIndex switch
        {
            0 => Player1Score,
            1 => Player2Score,
            2 => Player3Score,
            3 => Player4Score,
            _ => null
        };

        if (label != null)
        {
            label.Text = score.ToString();

            // 分数变化时的动画效果
            var tween = CreateTween();
            tween.TweenProperty(label, "modulate", new Color(1, 1, 0), 0.2f);
            tween.TweenProperty(label, "modulate", Colors.White, 0.3f);
        }
    }

    /// <summary>
    /// 设置玩家名称
    /// </summary>
    public void SetPlayerName(int playerIndex, string name)
    {
        var label = playerIndex switch
        {
            0 => Player1Name,
            1 => Player2Name,
            2 => Player3Name,
            3 => Player4Name,
            _ => null
        };

        if (label != null)
        {
            label.Text = name;
        }
    }

    /// <summary>
    /// 高亮当前玩家的计分区
    /// </summary>
    public void HighlightCurrentPlayer(int playerIndex)
    {
        // 重置所有玩家的高亮
        ResetHighlights();

        // 高亮当前玩家
        var panel = GetChild<Panel>(playerIndex);
        if (panel != null)
        {
            var stylebox = panel.GetThemeStylebox("panel").Duplicate() as StyleBoxFlat;
            stylebox.BorderColor = new Color(1, 0.85f, 0);  // 金色边框
            stylebox.BorderWidthLeft = 3;
            stylebox.BorderWidthRight = 3;
            stylebox.BorderWidthTop = 3;
            stylebox.BorderWidthBottom = 3;
            panel.AddThemeStyleboxOverride("panel", stylebox);
        }
    }

    /// <summary>
    /// 重置所有高亮
    /// </summary>
    private void ResetHighlights()
    {
        for (int i = 0; i < 4; i++)
        {
            var panel = GetChildOrNull<Panel>(i);
            if (panel != null)
            {
                panel.RemoveThemeStyleboxOverride("panel");
            }
        }
    }
}

音效系统

需要的音效

音效触发时机说明
摸牌声每次摸牌短促的"啪"声
出牌声每次出牌牌落在桌面的声音
碰牌声碰牌操作"啪啪啪"三声
杠牌声杠牌操作更响亮的"啪"声
胡牌声胡牌欢快的音效
按钮点击UI按钮轻微的点击声
背景音乐游戏进行中轻松的背景音乐

音效管理器

C
using Godot;

/// <summary>
/// 音效管理器——统一管理所有游戏音效
/// </summary>
public partial class SoundManager : Node
{
    /// <summary>
    /// 音效类型枚举
    /// </summary>
    public enum SoundType
    {
        DrawTile,       // 摸牌
        DiscardTile,    // 出牌
        Pong,           // 碰牌
        Kong,           // 杠牌
        Chi,            // 吃牌
        Win,            // 胡牌
        ButtonClick,    // 按钮点击
        GameStart,      // 游戏开始
        GameEnd         // 游戏结束
    }

    /// <summary>
    /// 音效音量（0-1）
    /// </summary>
    [Export] public float SoundVolume { get; set; } = 0.8f;

    /// <summary>
    /// 背景音乐音量（0-1）
    /// </summary>
    [Export] public float MusicVolume { get; set; } = 0.3f;

    /// <summary>
    /// 音效播放器列表
    /// </summary>
    private AudioStreamPlayer[] _soundPlayers = new AudioStreamPlayer[9];

    /// <summary>
    /// 背景音乐播放器
    /// </summary>
    private AudioStreamPlayer _musicPlayer;

    public override void _Ready()
    {
        // 创建音效播放器池
        for (int i = 0; i < _soundPlayers.Length; i++)
        {
            _soundPlayers[i] = new AudioStreamPlayer();
            _soundPlayers[i].VolumeDb = Mathf.LinearToDb(SoundVolume);
            AddChild(_soundPlayers[i]);
        }

        // 创建背景音乐播放器
        _musicPlayer = new AudioStreamPlayer();
        _musicPlayer.VolumeDb = Mathf.LinearToDb(MusicVolume);
        _musicPlayer.Bus = "Music";  // 使用独立的音频总线
        AddChild(_musicPlayer);
    }

    /// <summary>
    /// 播放音效
    /// </summary>
    public void PlaySound(SoundType type)
    {
        int index = (int)type;
        if (index < 0 || index >= _soundPlayers.Length) return;

        // 如果正在播放，先停止
        if (_soundPlayers[index].Playing)
        {
            _soundPlayers[index].Stop();
        }

        // 加载并播放音效
        string path = GetSoundPath(type);
        var stream = GD.Load<AudioStream>(path);
        if (stream != null)
        {
            _soundPlayers[index].Stream = stream;
            _soundPlayers[index].Play();
        }
    }

    /// <summary>
    /// 播放背景音乐
    /// </summary>
    public void PlayMusic(string musicPath)
    {
        var stream = GD.Load<AudioStream>(musicPath);
        if (stream != null)
        {
            _musicPlayer.Stream = stream;
            _musicPlayer.Play();
        }
    }

    /// <summary>
    /// 停止背景音乐
    /// </summary>
    public void StopMusic()
    {
        _musicPlayer.Stop();
    }

    /// <summary>
    /// 设置音效音量
    /// </summary>
    public void SetSoundVolume(float volume)
    {
        SoundVolume = Mathf.Clamp(volume, 0, 1);
        float db = Mathf.LinearToDb(SoundVolume);

        foreach (var player in _soundPlayers)
        {
            player.VolumeDb = db;
        }
    }

    /// <summary>
    /// 设置音乐音量
    /// </summary>
    public void SetMusicVolume(float volume)
    {
        MusicVolume = Mathf.Clamp(volume, 0, 1);
        _musicPlayer.VolumeDb = Mathf.LinearToDb(MusicVolume);
    }

    /// <summary>
    /// 获取音效文件路径
    /// </summary>
    private string GetSoundPath(SoundType type)
    {
        return type switch
        {
            SoundType.DrawTile => "res://resources/audio/draw.wav",
            SoundType.DiscardTile => "res://resources/audio/discard.wav",
            SoundType.Pong => "res://resources/audio/pong.wav",
            SoundType.Kong => "res://resources/audio/kong.wav",
            SoundType.Chi => "res://resources/audio/chi.wav",
            SoundType.Win => "res://resources/audio/win.wav",
            SoundType.ButtonClick => "res://resources/audio/click.wav",
            SoundType.GameStart => "res://resources/audio/game_start.wav",
            SoundType.GameEnd => "res://resources/audio/game_end.wav",
            _ => ""
        };
    }
}

3D 光影效果

牌面材质优化

真实的麻将牌有一种温润的质感——不是完全光滑的，也不是完全粗糙的。我们可以通过调整材质参数来模拟：

材质属性值效果
Albedo Color(0.98, 0.96, 0.92)象牙白
Roughness0.2光滑但不反光
Metallic0.0非金属
Clearcoat0.5清漆效果
Clearcoat Roughness0.3清漆有轻微粗糙度

清漆效果（Clearcoat）

Clearcoat 是模拟"上了一层清漆"的效果。真实麻将牌表面确实有一层保护漆，这让牌面有一种微微的光泽感。开启 Clearcoat 可以让3D牌面更真实。

环境反射

为了让牌面看起来更真实，可以添加环境贴图（Environment Map）：

  1. 在 WorldEnvironment 节点中设置环境贴图
  2. 或者使用 Godot 内置的 PanoramaSkyMaterial
  3. 环境贴图不需要太复杂——一个简单的"室内环境"就够了

桌面反光

牌桌也可以加入轻微的反光效果：

属性值说明
Roughness0.4绒布桌面有轻微反光
Metallic0.0非金属
Normal Scale0.3轻微的法线扰动

动画优化

动画性能

优化项方法说明
减少同时动画动画队列确保同一时间只有少量动画在播放
使用对象池复用节点避免频繁创建销毁牌面节点
LOD远处的简化对手的牌用简单模型
预加载资源启动时加载避免运行时卡顿

对象池模式

生活化比喻

对象池就像"租车公司"——你需要车的时候从公司租一辆，用完了还回去。公司不需要每次都造一辆新车，而是把还回来的车修一修再租给下一个人。这样既省钱又环保。

操作不用对象池用对象池
摸牌创建新牌面节点从池中取出
打牌销毁节点放回池中
碰牌创建多个节点从池中取出多个

多平台导出

支持的平台

平台导出模板注意事项
WindowsWindows Desktop默认开发平台，最简单
macOSmacOS需要在Mac上导出
LinuxLinux/X11注意依赖库
AndroidAndroid需要配置SDK和NDK
iOSiOS需要Mac电脑
WebHTML5性能受限，音效格式有限制

导出步骤（Windows）

  1. 打开 项目 → 导出
  2. 点击 添加 → 选择 Windows Desktop
  3. 配置导出设置：
设置项值
应用程序名称Mahjong2.5D
图标设置游戏图标（.ico文件）
启动画面设置启动画面图片
分辨率保持默认
  1. 点击 导出项目
  2. 选择保存位置

导出前检查

导出前确保：

  • 所有资源路径使用 res:// 而不是绝对路径
  • 没有使用编辑器专属功能（如 EditorPlugin）
  • 音频文件格式兼容目标平台
  • 所有 @export 变量都有合理的默认值

发布检查清单

功能检查

检查项状态说明
游戏能正常启动[ ]无崩溃、无报错
摸牌打牌正常[ ]操作流畅无卡顿
胡牌判定正确[ ]所有牌型都能正确识别
碰杠吃正常[ ]边界情况都处理好
AI能正常运行[ ]不会卡死或出非法操作
网络对战正常[ ]断线重连、同步正确
UI显示正确[ ]所有分辨率下正常
音效正常播放[ ]无杂音、音量合适

性能检查

检查项目标说明
帧率>= 60 FPS流畅运行
内存占用< 500MB不内存泄漏
加载时间< 3秒首次启动
包体大小< 100MB安装包体积

用户体验检查

检查项说明
新手引导第一次玩的人能看懂操作
错误提示网络断开、操作失败有明确提示
操作反馈每个操作都有视觉/音效反馈
设置选项音量、难度、语言等可调

小结

本章我们完成了游戏的最终打磨：

  1. UI美化——计分板、剩余牌数、操作按钮等界面元素
  2. 音效系统——摸牌、出牌、碰杠胡等音效管理
  3. 3D光影——牌面材质优化、桌面反光、环境反射
  4. 动画优化——对象池、动画队列、性能提升
  5. 多平台导出——Windows、macOS、Linux、Android、iOS
  6. 发布检查清单——功能、性能、用户体验全面检查

恭喜！

到这里，我们的2.5D麻将游戏开发教程就全部完成了。从项目搭建到规则引擎、从AI对手到网络对战、从音效系统到多平台发布——你已经掌握了用Godot 4开发棋牌游戏的全部核心技能。

接下来，你可以：

  • 尝试添加更多牌型（如国标麻将的全部番种）
  • 开发字牌（跑胡子）的完整版本
  • 优化AI策略，加入机器学习
  • 添加排行榜、好友系统等社交功能

祝你开发顺利！

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