这是自制创意工坊Mod的官方指南。

1. 在steam workshop订阅你想要使用的Mod
   
2. 在steam启动游戏，并选择选项“玩 With Mod"
   
3. 在游戏中选择你想要使用的Mod
   
4. 玩游戏

制作《枪与香蕉》的Mod，不需要你会任何关于编程的技能和工具。
只需要你制作美术图和编辑Excel文件。

编辑Excel文件，你可以使用Microsoft Office Excel。
制作美术图，你可以使用Photoshop或者其他软件。

自制Mod文件夹要放在路径：
Steam\steamapps\common\Pirates Outlaws\PiratesOutlaws_PC\Mod

注意：steam workshop会把第一层文件夹名替换成特殊的workshop ID，所以你自制Mod文件夹必须放在第二层，且要都同名。


打开路径：Steam\steamapps\common\Pirates Outlaws\PiratesOutlaws_PC\lib
双击启动lib.exe。

选择自制Mod的文件夹后会基于Excel文件创建出Txt文件。
(游戏程序是读取Txt文件而不是读取Excel文件)
你自制Mod的Excel文件越大，这时转换所需时间就越长。请耐心等待下。
想要节省转换时间，可以自己手动把Excel里的内容复制粘贴到Txt文件中。
(打开Excel文件，使用快捷键Ctrl+A可以选中表中所有内容)

从Steam中启动游戏，选择“玩With Mod”，开始测试你的自制Mod。

名字带后缀(local)表示是本地Mod。从steam创意工坊订阅的Mod是不会有这个后缀的。

在steam库中勾选工具，找到枪蕉modding kit后点击“安装“。

编辑Excel文件“ModInfo“中自制Mod的信息，把Mod的图标放在文件夹”Image“中。
点击ModUploader中的“Add“按钮，添加你自制Mod的第一层文件夹路径和展示在steam workshop的Mod展示图。
填写自制Mod的名称和描述。
确认填写无误后，勾选Visibility。可以先设置“private“然后进行自测。
测试没问题后，设置成“Public“。

更新Mod：在列表中选择你想要更新的Mod，再点击“Edit“。
在你点击“Publish“前，检查所有信息。

我们建议你创建新的Mod，而不是修改游戏本体已有的内容。这样可以避免与游戏本体产生冲突和BUG。

Skins(皮肤) 难度：简单。可以添加新皮肤。
Cards(卡牌) 难度：普通。 可以添加新卡牌。
Relics(遗物) 难度：普通。 可以添加新遗物。
Packages(拓展包) 难度：普通。可以添加新拓展包。
Upgrades(升级) 难度：普通。可以添加新的升级。
Heroes(英雄/角色) 难度：难。可以添加新角色。
UI. 难度：简单。不能添加新UI，但可以去修改当前的UI。
Backgrounds(背景) 难度：简单。不能添加新的背景，但可以去修改当前的背景。
Enemy skins(敌人皮肤) 难度：简单。 可以修改当前敌人皮肤。

我们已给你准备了一些官方Mod，涉及了几乎所有你可以创Mod的范围。

例如你想要自制一个新英雄Mod，可以先订阅我们提供的Mod，找到这个Mod的路径和对应文件夹，复制粘贴，重命名这个副本。查看文件夹里的内容，就能轻松知道所有必须包含的美术图和Excel文件了。这时跟着教程去替换或者编辑这些图和Excel文件就能创建你的英雄。

重命名和替换文件夹“Image“里的所有图片。
编辑所有在文件夹“Table” 和 “Localization”里的所有Excel文件。

https://gtm.steamproxy.vip/sharedfiles/filedetails/?id=2329460962
订阅这个“Official assets”, 在电脑中找到这个Mod的文件夹，可查看里面的Excel文件去看我们的游戏策划是如何设计卡牌、遗物、英雄等游戏内容。

在你开始编辑Excel文件去创建Mod时，可以先在Mod “Official assets”的文件夹的Excel文件中搜索下相似的内容，把相似的内容复制到你的Excel中，然后改变excel里的ID和其他必须有的单元格。

你所订阅的所有Mod都可以在这个路径中找到：
Steam\steamapps\workshop\content\1046300

在Excel文件中，你可以看到，每个游戏内容，都有自己的ID。
你需要根据ID规则去编辑ID，并且在所有Excel中调用的地方填写相同的ID。

在Mod “Official assets” 中，ID是数字。
但在 Official sample Mod中，ID都是字符串，例如“ModCharacterID(1)”。

每个Excel文件都有自己的ID格式和ID规则。
每个ID的规则列表如图：

在本节中，我们将介绍《枪与香蕉》的一些基本机制和结构。 这是非常重要的，如果你要修改视觉以外的内容，就必须了解这一部分。 我们建议你在阅读本节时，在Mod “Official assets”对应的文件夹中打开Excel文件“ HighAction”和“ Card”。

首先，战斗中的所有效果和功能都是通过“BaseAction”来实现。 例如，“TH_AddAmmo”表示填装弹药，“TB_AddHealth”表示回复生命值。“BaseAction”是该游戏中最基本的单位，你无法创建新的“BaseAction”或更改现有的“BaseAction”功能。你可以做的是创建一个新的“HighAction”，去使用现有的“BaseAction”，赋予不同的值，或组合不同的“BaseAction”以构建更复杂的“HighAction”。然后在Excel文件“Cards”，“Relics”或其他Excel文件中执行这些“HighAction”。

你可以在Mod “Official assets”中的Excel文件“Reference”中找到“BaseAction”列表。
要执行HighAction，你需要将其ID与一些参数结合起来。
例如，这是Excel “Card”中的一个单元格：

该单元格的功能是执行带有某些参数的HighAction “1002”。关于HighAction “1002”，你可以在Mod “Official assets”中的Excel文件“HighAction”中找到它。
你可以查看Mod “Official assets”中的Excel文件“Card”，“Relics”和“HighAction”，以了解所有卡牌和遗物的完整运行流程。

格式和参数
从图中可以看到，执行HighAction的完整格式由8个部分组成。
“1002,0,1,211,6,null,null,Melee/Melee_Kick”

• 第1部分：HighAction的ID
  
• 第2部分：持续性HighAction的层数
  游戏中有两种不同类型的HighAction：瞬发型和持续型。对于瞬发型的HighAction，这一项填0。对于持续型的HighAction，这一项至少要填1。所有持续型的HighAction都有一个消耗时机，你需要在“HighAction”表中配置。持续型HighAction的层数会在这个消耗时机-1，并且当层数变为0时，该持续型的HighAction会被移除。
  
• 第3部分：执行次数
  
• 第4部分：作用目标
  对于瞬发型的HighAction，这一项是该HighAction的作用对象。对于持续型的HighAction，这一项是持续型的HighAction被触发时，效果的作用对象。
  
• 第5部分：效果1
  在Excel表“HighAction”中，有一项“Determine”(判定条件)。你可以在这一项中填写一些判定条件，如果判定通过，则执行BaseAction1即此第5部分；如果判定不通过，则执行BaseAction2，即第6部分。如果没有填写判定条件，默认执行BaseAction1。
  
  Excel表“HighAction”的BaseAction1中可能有多个BaseAction，会按顺序执行，但是玩家在调用的时候只能修改第一个BaseAction的参数值，后面的BaseAction会使用“HighAction”表中填写的参数值。如果第一个BaseAction有多个参数，调用时每个参数之间用感叹号!隔开(注意所有表中的符号都需要用英文字符，不能用中文字符)。
  
• 第6部分：效果2
  BaseAction2的第一个BaseAction的参数，如果填写“null”，会使用“HighAction”表中填写的参数。
  
• 第7部分：持续型HighAction的施加目标
  一个持续型的HighAction需要一个拥有者(就像角色身上的状态)。这一项是持续型HighAction的施加对象。对于瞬发型的HighAction，这一项填“null”。
  
• 第8部分：当执行HighAction的时候播放的特效名字
  在Excel表“HighAction”中，每个HighAction有一个默认的特效，如果这一项填null，会播放表中的默认特效。

以下是两个示例，可帮助你理解本节。
示例1：“1002,0,1,211,6,null,null,Melee/Melee_Kick”
这是卡牌“挥拳”的功能：“近战，造成6点伤害。”

第1部分：1002。在Excel表“HighAction”中你可以找到ID “1002”是“MeleeAttack”。
第2部分：0。这表示这是一个瞬发型的HighAction。
第3部分：1。这表示这个HighAction会执行1次，“造成6点伤害(1次)”。
第4部分：211。这表示目标是距离最近的敌人。关于目标参数的含义，你可以查看Mod“Official Assets”里的Excel表 “Reference”。
第5部分：6。这个HighAction没有判定条件，会执行BaseAction1。6是这个BaseAction “TB_Damage_Melee”的参数。
第6部分：null。这个HighAction没有判定条件，没有BaseAction2，填“null”。
第7部分：null。这是一个瞬发型的HighAction。所以这一项填“null”。
第8部分：Melee/Melee_Kick。在Excel表“HighAction”中，你可以找到“1002”使用的特效是“Melee/Melee_Straight”。 这里卡牌“挥拳”需要使用不同的特效，所以将要使用的特效名称填在这一项。

示例 2：“3004,3,1,0,null,null,321”
这是卡牌“肌肉”的功能：“技能，施加3层愤怒。”

第1部分：3004。在Excel表“HighAction”中你可以找到ID “3004”是“buff_Rage”。
第2部分：3。“愤怒”是一个持续型的HighAction。而且消耗时机是“SelfTurnEnd”(自己的回合结束)，所以“3”表示这个HighAction会持续3个回合。
第3部分：1。当这个HighAction的拥有者攻击时，会自动触发1次来增加攻击伤害。
第4部分：0。在大多数情况下，目标“0”表示行为的来源，目标“1”表示行为的对象。当愤怒的拥有者攻击时，增加攻击伤害的目标是攻击者，即愤怒的拥有者，所以这一项填 “0”。
第5部分：null。“愤怒”是一个游戏中的通用状态，效果是固定的，所以游戏策划将所有的参数都填写在了Excel表“HighAction”中，玩家调用这个HighAction的时候，不需要填写效果值。其他通用的状态“虚弱”，“致盲”等等也是一样，调用时这一项都填写“null”来使用默认值。
第6部分：和第5部分一样。
第7部分：321。这表示任何你选择的目标。这张卡可以对你自己或者任何敌人使用，注意这一项不代表卡可用的目标，卡的可用目标在“Card”表中单独配置，这一项是这一个HighAction的目标。
第8部分：null。这个示例中没有第8部分。只有当某个项和其后所有项都是“null”时，可以省略该项和其后所有项， 注意这里第5和第6部分是“null”第7部分不是“null”，所以第5和第6部分不能省略。

关于Excel文件“ HighAction”更加具体的结构，可以在Excel的第一和第三行查看每一列的名称，结合Mod “Official assets”中的Excel文件，就能知道每一列的功能 。有很多列对于你自制Mod是没有用的，不要去变动就行了。

打开Mod “Official assets”中的Excel文件“Reference”可查看BaseAction列表和更多详细信息。

EventAction是可以在战斗之外执行的功能。使用EventAction，可以使一些遗物在战斗外执行效果。

例如，遗物“面包”：“+8最大生命值”。当你得到此遗物时，它将执行2个EventAction：
{"name":"ChangeHealthMax","values":["8"]},{"name":"ChangeHealth","values":["8"]}
并且当你失去此遗物时，它将执行一个EventAction：
{"name":"ChangeHealthMax","values":["-8"]}

打开Mod “Official assets”中的Excel文件“Reference”可查看EventAction列表和更多详细信息。

图片
你需要将4张图片(如果英雄有特殊姿势则为5张图片)放入“Image”文件夹中。
1个皮肤图(1个特殊姿势)，1个皮肤卡牌图用于在英雄面板中进行选择，2个用于UI的头像。
你需要重命名它们，2个具有相同名称的图的Mod会产生冲突。



Excel文件
需要在“Table”文件夹中编辑3个Excel文件。
你可以通过编辑Excel文件“ ExtraAssetsPivot”来调整皮肤图片的坐标。
你还可以修改初始牌组，或者添加一些初始遗物。你可以使用此功能来快速测试你制作的卡牌和遗物。

图片
将新卡的所有图像放在“Image”文件夹中即可。

Excel文件
需要在“Table”和“Localization”文件夹中编辑4个Excel文件。


关于卡牌ID
卡牌ID的范围必须在ModCardID(1)和ModCardID(1000)之间，并且你还需要在Excel中编辑卡牌的升级版本。 升级版本的ID必须为升级前ID+10000，因此介于ModCardID(10001)和ModCardID(11000)之间。

图片
需要将遗物图像放在文件夹“Image”中。

Excel文件
需要在“Table”和“Localization”文件夹中编辑3个Excel文件。

关于遗物ID
通用遗物ID必须在ModRelicID(1)和ModRelicID(1000)之间。
隐藏遗物ID必须在ModRelicID(10001)和ModRelicID(11000)之间。

隐藏遗物
游戏中有许多功能是通过“隐藏遗物”来实现的。 例如，大多数英雄的能力是通过获取一个或多个隐藏遗物来实现的。 它们对于玩家是不可见的。

拓展包是一些卡牌和遗物的组合，因此，除了创建几张卡片和遗物之外，你只需要为拓展包添加2张UI图片，然后再编辑1个Excel文件使其在“储藏室”中显示。

对于拓展包中的所有卡牌和遗物，你需要在Excel文件“ CardsFall”和“ Reclis”中将“ UnlockState”设置为0。并且拓展包中的卡牌和遗物的最大数量为6。

本质上，升级是在每次游戏开始时都会添加给你的英雄的隐藏遗物。 因此，你只需要创建一个隐藏的遗物来实现该功能，然后为升级UI添加1张图片，然后再编辑1个Excel文件使其在“储藏室”中显示。

图片
英雄需要一个皮肤所需要的所有图片，几张英雄卡牌图片和一个英雄能力图标。 如果英雄有起始遗物(例如占卜师)，则还需要1张遗物图片。

Excel文件
需要在“Table”和“Localization”文件夹中编辑9个Excel文件。

你只需要在“Image”文件夹中替换要修改的UI和背景图。 你使用的新图片必须与现有图片有相同的名称，格式和尺寸。

替换文件夹“Image”中的图像，并与现有图片保持相同的图片名称。
编辑文件夹“Table”中的Excel文件“ ExtraAssetsPivot”来调整敌人图片的位置。
你可以使用海盗港湾的第一次战斗出现的敌人来测试你的敌人皮肤，然后将图片名称更改为你要替换的敌人图片名称。

游戏中有很多变量，创建新内容时可能需要获取它们的值。格式为<VariableName>。
如果变量具有参数，则将参数放在变量名称之后，之间用符号“:”分隔，例如<VariableName:1:2>。

以下是一些常见变量，例如<Ammo>，<Coins>。
有两种特殊类型的变量，它们由玩家定义：FightData和AdventureData。你可以保存任何值并对其进行一些计算，然后在需要时获取其值。每次战斗后，FightData将重置为0。每局游戏结束后，AdventureData将重置为0。

例如，卡牌“进化射击”和“进化打击”可以增加所有进化卡的伤害，此功能是通过创建战斗变量FightData “Evolution”来实现的，用来储存进化卡的额外伤害。每次使用进化卡时，提高FightData “Evolution”的值。

打开Mod “Official assets”中的Excel文件“Reference”可查看变量列表和更多详细信息。

Excel文件中有很多参数，当你看到一些数字但不理解含义时，可以在Mod “Official assets”中查看Excel文件“Reference”。

持续型的HighAction具有两个时机：
触发时机
持续型HighAction的功能将在此HighAction的触发时机生效。
消耗时机
持续型HighAction的层数将在消耗时机减少1。

打开Mod “Official assets”中的Excel文件“Reference”可查看时机列表和更多详细信息。

Keyword（关键词）是附加在卡牌，遗物或HighAction上的字符串，赋予它们一些共同的功能。 在Excel文件“Card”，“Relics”和“ HighAction”中，有一个Keyword列。

例如，如果HighAction的关键词为“AK_Crit“，则表示来自此HighAction的攻击(只有用于攻击的HighAction会使用此关键字)会造成暴击。

打开Mod “Official assets”中的Excel文件“Reference”可查看Keyword列表和更多详细信息。

游戏中的所有文本都在本地化Excel文件中。 对于每种语言，都有一个Excel文件，只需要编辑你语言的excel文件，然后删除不需要的语言的excel文件即可。
官方Mod使用的是英文版本。