Path of Building：流放之路深度构筑计算引擎技术解析

架构设计

Path of Building（PoB）采用模块化的Lua架构设计，核心计算引擎通过模块化组件实现高效的角色属性模拟。系统架构主要分为数据层、计算层和表示层三个主要部分。

核心模块结构：

-- 模块加载机制示例
local calcs = { }
calcs.targetVersion = targetVersion
calcs.breakdownModule = "Modules/CalcBreakdown"
LoadModule("Modules/CalcSetup", calcs)
LoadModule("Modules/CalcPerform", calcs)
LoadModule("Modules/CalcActiveSkill", calcs)

数据层通过版本化数据模块管理游戏数据，支持多版本游戏数据的并行处理：

for _, targetVersion in ipairs(targetVersionList) do
    local verData = setmetatable({ }, { __index = data })
    data[targetVersion] = verData
end

核心算法

修饰符计算引擎

PoB的核心计算引擎基于修饰符数据库（ModDB）系统，实现复杂的属性计算逻辑：

function modLib.createMod(modName, modType, modVal, ...)
    local flags = 0
    local keywordFlags = 0
    local tagStart = 1
    local source
    if select('#', ...) >= 1 and type(select(1, ...)) == "string" then
        source = select(1, ...)
        tagStart = 2
    end
    return {
        name = modName,
        type = modType,
        value = modVal,
        flags = flags,
        keywordFlags = keywordFlags,
        source = source,
        select(tagStart, ...)
    }
end

环境计算系统

计算环境初始化与性能优化：

function calcs.buildOutput(build, mode)
    local env = calcs.initEnv(build, mode)
    calcs.perform(env)
    local output = env.player.output
    
    if mode == "MAIN" then
        output.ExtraPoints = env.modDB:Sum("BASE", nil, "ExtraPoints")
        -- 详细属性计算逻辑
    end
    return env
end

扩展开发

技能系统扩展

技能数据采用结构化存储和元表优化：

verData.skillStatMapMeta = {
    __index = function(t, key)
        local map = verData.skillStatMap[key]
        if map then
            t[key] = copyTable(map, true)
            for _, mod in ipairs(map) do
                processMod(t._grantedEffect, mod)
            end
            return map
        end
    end
}

物品系统接口

物品基础数据与稀有模板系统：

verData.itemBaseLists = { }
for name, base in pairs(verData.itemBases) do
    if not base.hidden then
        local type = base.type
        if base.subType then
            type = type .. ": " .. base.subType
        end
        verData.itemBaseLists[type] = verData.itemBaseLists[type] or { }
        table.insert(verData.itemBaseLists[type], { 
            label = name:gsub(" %(.+%)",""), 
            name = name, 
            base = base 
        })
    end
end

性能优化

计算缓存机制

PoB实现了高效的计算缓存系统，避免重复计算：

function calcs.getNodeCalculator(build)
    return getCalculator(build, true, function(env, nodeList)
        env.modDB:AddList(calcs.buildModListForNodeList(env, nodeList))
    end)
end

修饰符快速匹配

优化修饰符比较算法提升性能：

function modLib.compareModParams(modA, modB)
    if modA.name ~= modB.name or modA.type ~= modB.type 
       or modA.flags ~= modB.flags or #modA ~= #modB then
        return false
    end
    for i, tag in ipairs(modA) do
        if tag.type ~= modB[i].type then
            return false
        end
        if modLib.formatTag(tag) ~= modLib.formatTag(modB[i]) then
            return false
        end
    end
    return true
end

开发者指南

环境搭建

开发环境配置要求：

1. 克隆开发分支：git clone -b dev https://gitcode.com/gh_mirrors/pat/PathOfBuilding
2. 复制TreeData文件夹到仓库目录
3. 创建开发模式启动快捷方式

调试功能

开发模式提供丰富的调试工具：

• F5 热重载程序
• Ctrl + ~ 切换控制台
• Alt 键显示详细调试信息
• 条件选项显示依赖修饰符列表

天赋树界面显示已分配和可分配节点

死灵法师职业图标资源

开源贡献

代码贡献规范

项目采用严格的分支管理策略：

• 所有Pull Request必须针对dev分支
• 修改必须经过充分测试
• 遵循现有的代码风格和架构模式

数据处理流程

游戏数据导出系统位于Export目录：

-- 数据导出脚本示例
local function exportSkillData()
    -- 从Content.ggpk提取技能数据
    -- 生成Lua模块文件
end

技术展望

Path of Building作为流放之路社区的核心工具，持续在以下方向进行技术演进：

• 多版本游戏数据并行支持
• 计算引擎性能优化
• 模组系统扩展性增强
• 社区数据贡献流程简化

项目通过模块化架构和清晰的接口设计，为开发者提供了强大的扩展能力，持续推动流放之路构筑理论的发展。

军团珠宝插槽激活状态视觉效果