QSanguosha-For-Hegemony项目LUA扩展开发入门指南

扩展开发基础概念

QSanguosha-For-Hegemony是一款基于三国杀规则的扩展游戏框架，它允许开发者通过LUA脚本语言创建自定义的游戏内容。本文将详细介绍如何在该框架下进行基础扩展开发。

扩展文件基本结构

每个扩展包都是一个独立的LUA文件，文件需要返回一个包含Package对象的表。以下是基本结构：

-- 创建Package对象
extension = sgs.Package("package_name", sgs.Package_GeneralPack)

-- 定义武将和技能
-- ...

-- 添加翻译
sgs.LoadTranslationTable{
    -- 翻译内容
}

-- 返回Package表
return {extension}

Package对象详解

Package对象是扩展包的核心容器，它包含武将、卡牌等游戏元素。创建时需要指定两个参数：

extension = sgs.Package("moligaloo", sgs.Package_GeneralPack)

• 第一个参数：扩展包名称（英文标识符）
• 第二个参数：扩展包类型：
  • sgs.Package_GeneralPack：武将包（默认）
  • sgs.Package_CardPack：卡牌包

武将创建方法

创建武将使用sgs.General函数：

shiqian = sgs.General(extension, "shiqian", "qun")

参数说明：

1. 所属Package对象
2. 武将ID（英文标识符）
3. 势力归属（"wei"魏、"shu"蜀、"wu"吴、"qun"群）

技能开发基础

技能是游戏逻辑的核心，下面以"神偷"技能为例说明基本技能开发：

shentou = sgs.CreateOneCardViewAsSkill{ 
    name = "shentou",
    filter_pattern = ".|club|.|hand",
    view_as = function(self, card)
        local new_card = sgs.Sanguosha:cloneCard("snatch", sgs.Card_SuitToBeDecided, -1)
        new_card:addSubcard(card:getId())
        new_card:setSkillName(self:objectName())
        new_card:setShowSkill(self:objectName())
        return new_card
    end
}

这是一个OneCardViewAsSkill类型的技能，特点如下：

• filter_pattern：指定可用的牌（这里是任意梅花手牌）
• view_as函数：将选中的牌转换为目标牌（这里是"顺手牵羊"）

本地化翻译

为了让扩展内容显示为中文，需要添加翻译表：

sgs.LoadTranslationTable{
    ["moligaloo"] = "太阳神上",
    ["shentou"] = "神偷",
    [":shentou"] = "你可以将一张梅花手牌当做【顺手牵羊】使用。",
}

翻译内容包括：

• 扩展包名称
• 技能名称
• 技能描述（以冒号开头）

技能与武将关联

最后需要将技能赋予武将：

shiqian:addSkill(shentou)

扩展包部署

完成脚本编写后：

1. 将文件保存为extension目录下的.lua文件（如moligaloo.lua）
2. 启动游戏时扩展包会自动加载

进阶开发准备

完整的扩展包开发还需要：

1. 武将头像图片（特定格式和路径）
2. 技能音效（特定格式和路径）
3. 更复杂的技能逻辑实现

这些内容将在后续的进阶教程中详细介绍。

总结

本文介绍了QSanguosha-For-Hegemony项目LUA扩展开发的基础知识，包括：

• 扩展包基本结构
• Package对象创建
• 武将定义方法
• 基础技能实现
• 本地化翻译
• 扩展部署方法

掌握这些基础知识后，开发者可以开始创建简单的自定义武将和技能。