牛乐歌马游戏功能分析

这是一个名为"牛乐歌马"的三消类游戏模块，实现了类似消消乐的游戏机制。以下是详细的功能分析和注释：

核心功能概述

游戏类型：三消类益智游戏
游戏目标：通过点击相同类型的块，将其移动到槽位中，当槽位中有3个相同类型的块时自动消除
游戏机制：分层叠放的块结构，只能点击最上层的块

详细代码注释

local NiuLeGeMaOBJ = {}

NiuLeGeMaOBJ.__cname = "NiuLeGeMaOBJ"

-- 定义12种不同类型的块资源图片路径
NiuLeGeMaOBJ.blocks = {
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_1.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_2.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_3.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_4.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_5.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_6.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_7.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_8.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_9.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_10.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_11.png",
    "res/custom/ShuangJieHuoDongMain/NiuLeGeMa/icon_12.png",
}

-- 游戏核心配置参数
NiuLeGeMaOBJ.gameConfig = {
    randomBlocks = { 14, 14 }, -- 随机块配置（用于高级关卡）
    levelBlockNum = 40,        -- 每层的块数量
    levelNum = 8,              -- 总层数
    slotNum = 7,               -- 下方槽位数量
    composeNum = 3,            -- 消除所需的相同块数量（三消机制）
    typeNum = 12,              -- 块的类型总数
}

-- 游戏网格单元尺寸配置
NiuLeGeMaOBJ.widthUnit = 18   -- 每个格子的宽度单位
NiuLeGeMaOBJ.heightUnit = 18  -- 每个格子的高度单位（图标高度56/3=18，实现层叠覆盖效果）

-- 游戏状态追踪变量
NiuLeGeMaOBJ.opHistory = {}      -- 操作历史记录（用于撤回功能）
NiuLeGeMaOBJ.clearBlockNum = 0   -- 已消除的块数量统计

-- 游戏主入口函数
function NiuLeGeMaOBJ:main(objcfg)
    self.objcfg = objcfg           -- 保存对象配置
    self.blocksDataTable = {}      -- 块数据表（用于网络数据接收）
    self.gameTime = 0              -- 游戏时间计数器
    self:OpenUI()                  -- 打开游戏界面
end

-- 开始游戏时间统计功能
function NiuLeGeMaOBJ:startGameTime()
    GUI:Button_setBrightEx(self.ui.Button_shuffle, true)  -- 启用打乱按钮
    GUI:Text_setString(self.ui.Text_1, "游戏时间：")        -- 设置时间标签
    GUI:Text_setString(self.ui.Text_2, "1秒")             -- 初始化时间显示
    
    -- 每秒更新一次游戏时间显示
    GUI:schedule(self.ui.Layout, function()
        self.gameTime = self.gameTime + 1
        local timeStr = secondsToVariedChineseHMS(self.gameTime)  -- 转换为中文时间格式
        GUI:Text_setString(self.ui.Text_2, timeStr)
    end, 1)
end

-- 网络消息响应处理（用于多关卡数据接收）
function NiuLeGeMaOBJ:Response(arg1, arg2, arg3, data)
    if arg2 == 0 then
        -- 单次数据接收完成
        self.blocksData = data[1]
        self.totalBlockNum = arg1
        self:StartGame()
        return
    end
    
    -- 多次数据接收拼接
    table.insert(self.blocksDataTable, data[1])
    self.blocksData = table.concat(self.blocksDataTable)
    if #self.blocksDataTable > 1 then
        self.totalBlockNum = arg1
        self:StartGame()
    end
end

-- 游戏UI界面初始化
function NiuLeGeMaOBJ:OpenUI()
    -- 创建游戏主窗口
    local parent = GUI:Win_Create(self.__cname, 0, 0, 0, 0, false, false, true, true, true)
    self._parent = parent
    GUI:LoadExport(parent, self.objcfg.UI_PATH)  -- 加载UI布局
    self.ui = GUI:ui_delegate(parent)            -- 获取UI控件代理
    ssrSetWidgetPosition(parent, self.ui.img_bg) -- 设置窗口位置
    
    -- 绑定关闭按钮事件（多个关闭入口）
    GUI:addOnClickEvent(self.ui.CloseLayout, function()
        self:messagebox("确定退出？退出后将重新开始", function()
            GUI:Win_Close(self._parent)
        end)
    end)
    
    GUI:addOnClickEvent(self.ui.CloseButton, function()
        self:messagebox("确定退出？退出后将重新开始", function()
            GUI:Win_Close(self._parent)
        end)
    end)
    
    GUI:addOnClickEvent(self.ui.Button_exit, function()
        self:messagebox("确定退出？退出后将重新开始", function()
            GUI:Win_Close(self._parent)
        end)
    end)
    
    -- 游戏辅助功能按钮
    
    -- 移出功能：从槽位移出三个道具（每局限用一次）
    GUI:addOnClickEvent(self.ui.Button_remove, function()
        self:messagebox("从下放移出三个道具，并且每局游戏只有一次机会，确定继续？", function()
            self:doRemove()
        end)
    end)
    
    -- 打乱功能：重新排列所有块（需要20万元宝）
    GUI:addOnClickEvent(self.ui.Button_shuffle, function()
        self:messagebox("打乱所有道具，需要20W元宝，确定继续？", function()
            ssrMessage:sendmsg(ssrNetMsgCfg.NiuLeGeMa_RequestDoShuffle)
        end)
    end)
    
    -- 撤回功能：撤销上一次操作（每局限用一次）
    GUI:addOnClickEvent(self.ui.Button_back, function()
        self:messagebox("撤回上一次操作，并且每局游戏只有一次机会，确定继续？", function()
            self:doRevert()
        end)
    end)
    
    -- 初始状态下禁用所有辅助功能按钮
    GUI:Button_setBrightEx(self.ui.Button_remove, false)
    GUI:Button_setBrightEx(self.ui.Button_back, false)
    GUI:Button_setBrightEx(self.ui.Button_shuffle, false)
    
    self:StartGameLevel1()  -- 开始第一关
end

-- 第一关游戏初始化
function NiuLeGeMaOBJ:StartGameLevel1()
    -- 游戏状态初始化
    self.isRemove = false      -- 是否已使用移出功能
    self.isBack = false        -- 是否已使用撤回功能
    self.noClicks = true       -- 禁用点击（动画播放期间）
    self.slotImageList = {}    -- 槽位图像列表
    self.gameStatus = 0        -- 游戏状态：0=未开始，1=进行中，2=失败，3=胜利
    self.currSlotNum = 0       -- 当前占用的槽位数量
    self.clearBlockNum = 0     -- 已清除的块数量
    self.totalBlockNum = 18    -- 第一关总块数
    
    -- 生成第一关的游戏数据（18个块，每种类型6个，确保能够三消）
    local gameData = {}
    for i = 1, 18 do
        table.insert(gameData, (i - 1) % 3 + 1)  -- 生成1,2,3,1,2,3...的循环
    end
    
    -- 随机打乱块的顺序
    for i = #gameData, 2, -1 do
        local j = math.random(i)
        gameData[i], gameData[j] = gameData[j], gameData[i]
    end
    
    self.level = 1
    local level1AllBlocks = {}
    
    -- 创建18个块对象
    for i = 1, 18 do
        local newBlock = {
            id = i - 1,         -- 块的唯一ID
            status = 0,         -- 块状态（0=正常，1=已选中等）
            level = 0,          -- 所在层级
            type = gameData[i], -- 块的类型（1-3）
            H = {},             -- 上层块列表（Higher blocks）
            L = {}              -- 下层块列表（Lower blocks）
        }
        table.insert(level1AllBlocks, newBlock)
    end
    
    -- 设置上层9个块的位置和层级关系
    local level1BlockX = 70   -- 起始X坐标
    local level1BlockY = 50   -- 起始Y坐标
    for i = 1, 9 do
        level1AllBlocks[i].x = level1BlockX
        level1AllBlocks[i].y = level1BlockY
        level1AllBlocks[i].level = 1
        level1BlockX = level1BlockX + 160  -- 水平间距160像素
        
        -- 建立上下层关系：上层块压住下层块
        table.insert(level1AllBlocks[i].L, level1AllBlocks[i + 9])
        
        -- 每3个块换行
        if i % 3 == 0 then
            level1BlockX = 70
            level1BlockY = level1BlockY + 100  -- 垂直间距100像素
        end
    end
    
    -- 设置下层9个块的位置和层级关系
    level1BlockX = 70
    level1BlockY = 16  -- 下层Y坐标更小，形成层叠效果
    for i = 10, 18 do
        level1AllBlocks[i].x = level1BlockX
        level1AllBlocks[i].y = level1BlockY
        level1AllBlocks[i].level = 1
        level1BlockX = level1BlockX + 160
        
        -- 建立下上层关系：下层块被上层块压住
        table.insert(level1AllBlocks[i].H, level1AllBlocks[i - 9])
        
        if i % 3 == 0 then
            level1BlockX = 70
            level1BlockY = level1BlockY + 100
        end
    end
    
    self.levelBlocksVallevel1 = level1AllBlocks  -- 保存第一关块数据
    self.randomBlocksVal = {}                    -- 随机块数据（高级关卡使用）
    
    -- 初始化槽位数组
    self.slotAreaVal = {}
    for i = 1, self.gameConfig.slotNum do
        self.slotAreaVal[i] = nil  -- 7个槽位初始为空
    end
    
    -- 将块添加到UI界面显示
    -- ... existing code ...
end

游戏流程图

flowchart TD
    A[游戏开始] --> B[初始化UI界面]
    B --> C[创建第一关数据]
    C --> D[生成18个块对象]
    D --> E[随机打乱块顺序]
    E --> F[设置块的位置和层级关系]
    F --> G[初始化7个槽位]
    G --> H[将块添加到界面显示]
    H --> I[开始游戏时间统计]
    I --> J[等待玩家操作]
    
    J --> K{玩家点击块}
    K -->|块被其他块压住| L[无法选中，提示玩家]
    K -->|块可以选中| M[块移动到槽位]
    
    M --> N{检查槽位}
    N -->|槽位未满| O[块放入槽位]
    N -->|槽位已满7个| P[游戏失败]
    
    O --> Q{检查是否有3个相同类型}
    Q -->|有3个相同| R[消除这3个块]
    Q -->|没有3个相同| S[继续游戏]
    
    R --> T{检查是否清除所有块}
    T -->|是| U[游戏胜利]
    T -->|否| S
    
    S --> J
    L --> J
    
    J --> V{玩家使用辅助功能}
    V -->|移出功能| W[从槽位移出3个块]
    V -->|打乱功能| X[重新排列所有块]
    V -->|撤回功能| Y[撤销上一次操作]
    
    W --> S
    X --> S
    Y --> S
    
    P --> Z[显示失败界面]
    U --> AA[显示胜利界面]
    Z --> BB[重新开始或退出]
    AA --> CC[进入下一关或退出]

数据结构说明

块对象结构

block = {
    id = 0,           -- 块的唯一标识符
    status = 0,       -- 块的状态（0=正常，1=已选中等）
    level = 1,        -- 块所在的层级
    type = 1,         -- 块的类型（1-12）
    x = 70,           -- 块在界面上的X坐标
    y = 50,           -- 块在界面上的Y坐标
    H = {},           -- 压在此块上方的块列表
    L = {}            -- 此块压住的下方块列表
}

游戏状态管理

gameStatus: 0=未开始，1=进行中，2=失败，3=胜利
currSlotNum: 当前槽位中的块数量
clearBlockNum: 已消除的块数量
slotAreaVal: 7个槽位的状态数组

核心游戏机制

层叠系统：块分为上下两层，上层块压住下层块，只有最上层的块才能被点击
三消机制：当槽位中有3个相同类型的块时自动消除
胜利条件：清除所有块
失败条件：槽位被填满（7个槽位都有块）
辅助功能：
- 移出：从槽位移出3个块（每局限用一次）
- 打乱：重新排列所有块（消耗20万元宝）
- 撤回：撤销上一次操作（每局限用一次）

这个游戏是双节活动中的一个小游戏，结合了策略性和运气成分，玩家需要合理规划点击顺序来避免槽位被填满。