996传奇三端引擎–实战-14-副本玩法创建刷怪动态属性监听结束

一、副本系统架构设计

1.1 副本核心架构

1.2 副本类型与特征

副本类型	核心玩法	技术特征	适用场景
爬塔副本	逐层挑战	多层镜像地图	单人挑战
团队副本	多人协作	队伍共享地图	公会活动
秘境副本	随机生成	动态地图配置	探险玩法
挑战副本	限时通关	倒计时机制	竞技活动

二、镜像地图创建与管理

2.1 镜像地图创建流程

function CreateDungeonMap(player, templateMapId)
    -- 验证原图ID有效性
    if not IsValidTemplateMap(templateMapId) then
        return nil, "无效的地图模板ID"
    end
    
    -- 创建镜像地图
    local dungeonMapId = CreateMirrorMap(templateMapId)
    if not dungeonMapId then
        return nil, "地图创建失败"
    end
    
    -- 设置副本属性
    SetMapProperty(dungeonMapId, {
            
        owner = player:GetID(),
        createTime = os.time(),
        status = "ACTIVE"
    })
    
    -- 延迟传送玩家
    Schedule(500, function()  -- 500ms延迟避免黑屏
        TeleportPlayer(player, dungeonMapId, GetStartPosition())
    end)
    
    return dungeonMapId
end

2.2 关键配置规范

// 正确的地图配置示例
{
            
  "map_id": 1001,
  "mirror_config": {
            
    "allow_mirror": true,
    "max_players": 6,
    "time_limit": 1800, // 30分钟
    "monster_respawn": false
  },
  "start_position": [120, 240]
}

三、动态怪物控制系统

3.1 怪物属性动态调整

function SetupDungeonMonsters(mapId, difficulty)
    local monsters = GetMapMonsters(mapId)
    local playerLevel = GetMapOwnerLevel(mapId)
    
    for _, monster in ipairs(monsters) do
        -- 基础属性调整
        local baseHp = monster:GetBaseHP()
        local scaledHp = baseHp * GetHpScaleFactor(playerLevel, difficulty)
        monster:SetMaxHP(scaledHp)
        monster:SetHP(scaledHp)
        
        -- 添加副本专属Buff
        if difficulty > 2 then
            monster:AddBuff(DUNGEON_BUFFS[difficulty])
        end
        
        -- 设置副本怪物标记
        monster:SetVar("is_dungeon", true)
    end
end

-- 难度系数计算
function GetHpScaleFactor(playerLevel, difficulty)
    local baseFactor = 1.0 + (playerLevel - 1) * 0.05
    local difficultyFactor = 1.0 + (difficulty - 1) * 0.3
    return baseFactor * difficultyFactor
end

3.2 怪物AI优化方案

-- 解决怪物不攻击问题
function FixMonsterAI(monster)
    -- 1. 重置目标选择
    monster:ResetTarget()
    
    -- 2. 清除异常状态
    monster:ClearAbnormalStates()
    
    -- 3. 路径检测
    if monster:IsPathBlocked() then
        monster:FindAlternativePath()
    end
    
    -- 4. 仇恨系统重置
    monster:ResetThreatTable()
end

四、副本完成检测机制

4.1 多模式完成检测

4.2 定时扫描实现

function StartDungeonCheck(mapId)
    -- 创建定时器（每10秒检测一次）
    local timerId = CreateTimer(10, true, function()
        -- 检查超时
        if CheckTimeLimit(mapId) then
            EndDungeon(mapId, "timeout")
            return
        end
        
        -- 检查怪物数量
        if CheckMonsterClear(mapId) then
            EndDungeon(mapId, "success")
            return
        end
        
        -- 检查玩家在线状态
        if not HasPlayersInMap(mapId) then
            EndDungeon(mapId, "abandoned")
        end
    end)
    
    -- 存储定时器ID
    SetMapProperty(mapId, "check_timer", timerId)
end

function CheckMonsterClear(mapId)
    local monsterCount = 0
    local monsters = GetMapMonsters(mapId)
    
    for _, monster in ipairs(monsters) do
        -- 只统计副本生成的怪物
        if monster:GetVar("is_dungeon") then
            monsterCount = monsterCount + 1
        end
    end
    
    return monsterCount == 0
end

五、副本奖励与资源管理

5.1 奖励发放系统

function GrantDungeonRewards(mapId, result)
    local players = GetPlayersInMap(mapId)
    local baseRewards = DUNGEON_REWARDS[GetDungeonType(mapId)]
    
    for _, player in ipairs(players) do
        -- 基础奖励
        for _, reward in ipairs(baseRewards) do
            player:AddItem(reward.id, reward.count)
        end
        
        -- 结果加成
        if result == "success" then
            local bonus = GetSuccessBonus(mapId)
            player:AddItem(bonus.id, bonus.count)
            
            -- 首通奖励
            if IsFirstClear(player) then
                player:AddItem(FIRST_CLEAR_REWARD.id, FIRST_CLEAR_REWARD.count)
            end
        end
        
        -- 评分奖励
        local score = CalculateDungeonScore(player)
        GrantScoreRewards(player, score)
    end
end

5.2 资源清理策略

function CleanupDungeon(mapId)
    -- 1. 停止检测定时器
    local timerId = GetMapProperty(mapId, "check_timer")
    if timerId then
        CancelTimer(timerId)
    end
    
    -- 2. 清理副本怪物
    local monsters = GetMapMonsters(mapId)
    for _, monster in ipairs(monsters) do
        if monster:GetVar("is_dungeon") then
            DespawnMonster(monster:GetID())
        end
    end
    
    -- 3. 传送玩家回城
    local players = GetPlayersInMap(mapId)
    for _, player in ipairs(players) do
        TeleportToMainCity(player)
    end
    
    -- 4. 销毁镜像地图
    DestroyMirrorMap(mapId)
    
    LogSystem.Info("副本已清理: "..mapId)
end

六、高级技巧与优化方案

6.1 延迟回调最佳实践

-- 框架延迟回调接口
function ScheduleDelayedAction(delay, action, ...)
    if USE_FRAMEWORK_API then
        -- 框架接口（支持复杂参数）
        Framework.Schedule(delay, action, ...)
    else
        -- 原生接口（简单参数）
        CreateTimer(delay, false, function()
            action(...)
        end)
    end
end

-- 副本创建后延迟传送
function EnterDungeon(player, dungeonId)
    local mapId = CreateDungeonMap(player, dungeonId)
    if not mapId then return end
    
    ScheduleDelayedAction(500, function(p, m)
        TeleportPlayer(p, m, GetStartPosition())
        SendSystemMsg(p, "副本已开启，祝你好运！")
    end, player, mapId)
end

6.2 动态属性监听器

-- 怪物属性变更监听
function MonitorMonsterAttributes(monster)
    -- 监听血量变化
    monster:AddListener("HP_CHANGE", function(oldHp, newHp)
        if newHp < oldHp then
            -- 受伤处理
            OnMonsterDamaged(monster, oldHp - newHp)
        end
        
        -- Boss血量阶段检测
        if IsBoss(monster) then
            CheckBossPhase(monster, newHp)
        end
    end)
    
    -- 监听状态变化
    monster:AddListener("STATE_CHANGE", function(oldState, newState)
        if newState == "DEAD" then
            OnMonsterDeath(monster)
        end
    end)
end

-- Boss阶段检测
function CheckBossPhase(monster, currentHp)
    local maxHp = monster:GetMaxHP()
    local phase = 0
    
    if currentHp < maxHp * 0.3 then
        phase = 3
    elseif currentHp < maxHp * 0.6 then
        phase = 2
    elseif currentHp < maxHp * 0.9 then
        phase = 1
    end
    
    if phase > 0 and phase ~= monster:GetVar("phase")) then
        monster:SetVar("phase", phase)
        ActivateBossPhase(monster, phase)
    end
end

七、常见问题解决方案

7.1 副本问题排查表

问题现象	可能原因	解决方案
黑屏无法进入	立即传送未延迟	添加500ms延迟传送
怪物不攻击玩家	地图仇恨系统未启用	检查地图配置enable_hatred
副本无法完成	怪物计数错误	添加副本怪物标记is_dungeon
奖励重复发放	完成条件多次触发	添加状态锁is_rewarded
内存泄漏	未正确销毁副本	完善CleanupDungeon流程

7.2 副本超时处理强化

function CheckTimeLimit(mapId)
    local createTime = GetMapProperty(mapId, "createTime")
    local timeLimit = GetMapProperty(mapId, "timeLimit") or 1800 -- 默认30分钟
    local elapsed = os.time() - createTime
    
    -- 剩余时间提示
    if elapsed % 60 == 0 then  -- 每分钟提示
        local remain = timeLimit - elapsed
        local minutes = math.floor(remain / 60)
        BroadcastToMap(mapId, 
            string.format("剩余时间: %d分%d秒", minutes, remain % 60))
    end
    
    -- 超时判定
    if elapsed >= timeLimit then
        return true
    end
    
    return false
end

八、实战案例：爬塔副本实现

8.1 爬塔副本配置

TowerConfig = {
            
    max_floors = 100,
    floor_rewards = {
            
        [5] = {
            {
            id=1001, count=5}},
        [10] = {
            {
            id=1002, count=3}},
        [20] = {
            {
            id=1003, count=1}}
    },
    monster_scaling = {
            
        hp_factor = 1.1,  -- 每层血量增加10%
        damage_factor = 1.05
    }
}

8.2 爬塔核心逻辑

function EnterTower(player, startFloor)
    local currentFloor = startFloor or 1
    
    -- 创建塔层地图
    local mapId = CreateDungeonMap(player, TOWER_MAP_ID)
    SetMapProperty(mapId, "tower_floor", currentFloor)
    
    -- 生成本层怪物
    GenerateFloorMonsters(mapId, currentFloor)
    
    -- 启动楼层检测
    StartFloorCheck(mapId)
end

function GenerateFloorMonsters(mapId, floor)
    local baseMonster = GetBaseMonsterForFloor(1)
    local count = math.min(10, 3 + floor)  -- 最多10只怪
    
    for i = 1, count do
        local monster = SpawnMonster(baseMonster)
        
        -- 层级强化
        local scale = math.pow(TowerConfig.monster_scaling.hp_factor, floor-1)
        monster:SetMaxHP(monster:GetMaxHP() * scale)
        monster:SetDamage(monster:GetDamage() * scale)
    end
end

function OnFloorCleared(mapId)
    local floor = GetMapProperty(mapId, "tower_floor")
    
    -- 发放楼层奖励
    if TowerConfig.floor_rewards[floor] then
        GrantRewards(mapId, TowerConfig.floor_rewards[floor])
    end
    
    if floor >= TowerConfig.max_floors then
        -- 通关
        EndDungeon(mapId, "tower_complete")
    else
        -- 进入下一层
        ScheduleDelayedAction(3000, function()
            GenerateFloorMonsters(mapId, floor + 1)
            SetMapProperty(mapId, "tower_floor", floor + 1)
            BroadcastToMap(mapId, string.format("进入第%d层！", floor + 1))
        end)
    end
end