XS脚本指南 + 4则实用函数（2021.4.27大更新）

newtonerdai · 发表于 2020-12-26 23:33:58

目录
第〇部分 - 导语
第一部分 - 要素说明
   1、[xs文件夹]
   2、[xs脚本文件]
   3、[地图] 选项卡 - [脚本文件名] 输入栏
   4、[条件-脚本调用]
   5、[效果-脚本调用]
第二部分 - XS脚本语法
   1、决定版内部XS函数表
   2、XS脚本通用语法
第三部分 - 实用XS函数四则
   1、实用XS函数四则
   2、使用例

>>第〇部分 - 导语<<

决定版 Build 42848~43210 的编辑器更新了一个全新的模块：XS脚本。
（XS 或许代表 eXternal Subroutine，外部子程序）

你会发现游戏目录里多了点东西：

[个人数据文件夹]：C:\Users\<用户名>\Games\Age of Empires 2 DE\<长串数字>\resources\_common\xs\default0.xs
[游戏根目录]：C:\Program Files\Steam\steamapps\common\AoE2DE\resources\_common\xs\Constants.xs

编辑器里也多了这些东西：

[地图] 选项卡：[脚本文件名] 输入栏
[触发器] 选项卡：[条件-脚本调用]、[效果-脚本调用]

它们的作用和使用方法是：

>>第一部分 - 要素说明<<

1、[xs文件夹]：
正如上面所示，你可以在两个xs文件夹中放置.xs文件，编辑器读取.xs文件时会去这两个文件夹里找。

其中 [个人数据文件夹] 下的xs文件夹，如果你切换游戏账号就不能用了。
而 [游戏根目录] 下的，则是所有账号共用的。

2、[xs脚本文件]：
存放在上述任意 [xs文件夹] 下的.xs文件。
你可以在其中编写一些函数，供触发条件效果调用。函数编写指南见下文。
官方的 [xs脚本文件] 有两个，它们的作用分别是：

default0.xs：临时储存xs函数/语句的文件。当你在 [条件-脚本调用] 里编写函数文本，在点击任意触发/条件/效果后，编辑器会检查语法错误，无误则会写入到default0.xs中。所以，不要在这里编写内容，否则会被实时覆盖掉的。
Constants.xs：官方定义的通用常数文件。这里定义了整个游戏都能用的常数。目前只囊括了大部分资源编号。可能之后会添加别的常数进来。你可以在任意xs脚本里调用这些常数。

注意事项：

xs脚本文件最好是 UTF-8 编码。否则，xsChatData指令(后面会讲) 将无法正常发送文字。
xs脚本文件中，除了注释内容外的正文代码中，必须 全程使用ASCII字符 （即英文字母、英文标点符号、空格等），不能用全角、汉字等非ASCII字符，即使是用英文双引号括起的字符串。

函数语法规则 见第二部分。

3、[地图] 选项卡 - [脚本文件名] 输入栏：
   在这里写上你要调用的.xs文件名（不需要包括拓展名“.xs”）。
   输入栏最多容纳21个字符（中文/英文字符都只算1个字符）。
   写上内容后，需要到 [触发器] 选项卡里点选任意触发/条件/效果，编辑器才会尝试去 [xs文件夹] 中读取对应的文件，并检查语法错误。
   我们不妨把这里指定的xs脚本文件称为 [场景xs脚本]。

4、[条件-脚本调用]：
你可以在它的输入框中编写自定义函数，就像在 [xs脚本文件] 中一样。
在点击任意触发/条件/效果后，会检查语法错误，无误则写入到 [default0.xs] 中。而且！即使触发是关闭的，也能正常写入。
条件特性：

这个条件是恒成立的。
这个条件会在触发处于开启状态时 (注意不是激活状态)，不断自行调用其中的函数。
即使触发关闭，这个条件也能正常定义函数，并写入到 [default0.xs] 中。

这个条件可以用于：

①先调用函数做一次修改，再让其他条件检测资源量或变量（要注意条件执行顺序的先后哦）。
②见下图。默默定义一些函数，供效果调用（最好把它放在一个永久关闭的触发里，避免自行调用）。

输入框规范 见 [效果-脚本调用] ↓↓↓。
函数语法 见 [第二部分] ↓↓↓。

5、[效果-脚本调用]：
你可以在这里写上一个自定义函数名来调用运行该函数，也可以直接自己定义一个函数并自行调用。
这个效果会尝试去调用 [场景xs脚本] 或 [default0.xs] 或其自身输入框中的函数。
脚本输入框内容的规范——

[1] 调用已有函数：
- 假设我们已经在别处定义好了一个函数名为“chatFood()"，那么你在这个效果的输入框里写“chatFood” 或 “chatFood()” 都可以调用它。
[2] 定义函数并自行调用：
- 你也可以在其中定义函数，比如：
  void chatStone()
  {
  int stone = xsPlayerAttribute(1,2);
  xsChatData("P1's Stone = %d", stone);
  }
  这样这个函数会写入到 [default0.xs] 中，而且效果也会自行调用该函数。
[3] 允许注释：
- chatFood()//这是一句注释。
- void chatStone()
  {
  int stone = xsPlayerAttribute(1,2);
  }
  // 这是一句注释（只能放在函数本体后面，不能在函数前或函数中插入注释）。
[4] 不允许：
- chatFood() //这是一句注释。
- chatFood()//这是一句注释。
- chatFood()
  //这是一句注释。
- chatFood() （←注：末尾有个空格）
（换而言之，如果你只想调用一个函数，那输入框内绝对不要出现空格或换行符（字符串内的除外）！否则内容会被视为自定义函数并分析语法错误。）
[5] 允许在框内调用多个函数，但只有后一行生效，前一行会被忽略（建议分开放到多个效果里）：
- chatFood()
  chatStone()

注意！不要尝试在 [效果-脚本调用] 中调用一个带参数的函数，比如用getAB调用函数getAB(int a=1, int b=0){}。否则，有概率发生：①游戏崩溃。②该效果执行一次后，本局任何XS函数都将无法工作。你可以用一个无参数的函数来调用getAB函数。
注意！不要在第一次进入编辑器时在 [效果-脚本调用] 输入栏中连续写入超过6个字符，否则会导致游戏闪退（截至2021年4月27日）。可以尝试先进入场景测试一次后返回编辑器，再开始编辑 [效果-脚本调用]。

>>第二部分 - XS脚本语法<<

1、决定版内部XS函数：
函数说明与教程整理自：
（决定版遗朝制作组官方网站上的XS脚本简短指南与函数对照表）
（帝国时代3 ESOC论坛 XS脚本详细指南）
（divy1211的Github 的 AoE2DE_UGC_Guide - XS部分）

“勉强够用级别”的符号说明：
   float xsPlayerAttribute(int playerNumber, int resourceID)
         float 表示 xsPlayerAttribute函数会返回一个浮点数，
         int playerNumber 表示参数playerNumber 应该为一个整数。
      （void 表示空，即没有返回内容或数据没有类型）
      （string 表示 字符串）
   以上只是小部分，更多XS符号及语法请看［2、XS脚本通用语法］。

## 普通函数
// 获取指定玩家的指定资源ID的资源量（浮点数）
float xsPlayerAttribute(int playerNumber, int resourceID)

// 设置指定玩家的指定资源ID的资源量
void xsSetPlayerAttribute(int playerNumber, int resourceID, float value)

// 示例：
// 获取玩家1的食物储量(资源#0)，乘以2倍后添加到玩家1的木材储量(资源#1)上。
// cAttributeFood = 0，cAttributeWood = 1（来自官方常数Constants.xs）
void food_x2_add_to_wood(){
float food_amount = xsPlayerAttribute(1, cAttributeFood);
float wood_amount = xsPlayerAttribute(1, cAttributeWood);
wood_amount = wood_amount + food_amount * 2;
xsSetPlayerAttribute(1, cAttributeWood, wood_amount);
}

// 获取触发变量 ID 的值
int xsTriggerVariable(int variableID)

// 设置触发变量 ID 的值
void xsSetTriggerVariable(int variableID, int value)

// 示例：
// 获取触发变量#9的值，然后复制给触发变量#10。
void copy_variable(){
int var_value = xsTriggerVariable(9);
int var_value_new = var_value;
xsSetTriggerVariable(10, var_value_new);
}

// 返回游戏中的玩家数量（不包括盖亚女神）
int xsGetNumPlayers()

// 在游戏左上角的聊天框中显示一条消息，类似于 [效果-发送聊天]，不过此函数的消息可被全体玩家接收。
// 这通常用于验证xs脚本是否正常运作、输出运行结果，对测试很有帮助。
// 你可以在字符串中用 %d 引用 value。如 xsChatData("A = %d.", 5) 会显示为“A = 5”。
// 当然，你也可以直接将字符串与常数或变量相连。如 xsChatData("A = " + num_a + ".")，
// 这样你可以传入多个数值，而且也支持浮点数等其他数据类型。
// 注意，当前xs脚本的字符串只能使用 ASCII 字符（英文字母、数字、英文符号等）
// value 是可选参数，可以不填。
void xsChatData(string message, int value)

// 发送玩家1的食物量到聊天。
void chatFood()
{
int food = xsPlayerAttribute(1,0);
xsChatData("Player 1's food = %d", food);
xsChatData("Player 1's food = " + food);
}

// 返回当前游戏时间(以秒为单位)
int xsGetTime()

// 修改指定单位或科技的指定属性为指定值
// 对于特定的玩家，effectID 为要使用的效果id
// 这基本相当于 [修改属性] 效果
// 更多相关信息，请参考 [UserPatchup-effect 触发效果拾遗（附使用例）]
//    effectID=科技类型，unitOrTechnologyID=科技对象，attributeOrOperation=科技属性，
//    value=科技数值，playerNumber=游戏者编号（设为-1作用于全体）
//    至于up-effect的最后一位“格式”，或许可以借助XS的浮点数实现其对应的百分比功能。
void xsEffectAmount(int effectID, int unitOrTechnologyID, int attributeOrOperation, int value, int playerNumber)

// 示例：
void upgrade()
{
// 升级(3) 单位83(男村民)    为单位4(步弓手) 数值0(参数忽略) 作用于玩家1
xsEffectAmount(3,83,4,0,1);
// 升级(3) 单位280(轻型投石车)  为单位8(长弓兵) 数值0(参数忽略) 作用于全体玩家-1
xsEffectAmount(3,280,8,0,-1);
}

## 数组处理
// 创建一个给定大小(项数)的、指定数据类型的数组
// 所有值都会被初始化为 defaultValue（默认值）
// 返回一个唯一地标识这个数组的 arrayID。请务必储存到一个变量中，因为对数组进行各种操作都得借助 arrayID。
// 数组名(uniqueName)无实际意义，但必须是唯一的，不能与其他数组冲突
int xsArrayCreateInt(int size, int defaultValue, string uniqueName)
int xsArrayCreateFloat(int size, float defaultValue, string uniqueName)
int xsArrayCreateBool(int size, bool defaultValue, string uniqueName)
int xsArrayCreateString(int size, string defaultValue, string uniqueName)
int xsArrayCreateVector(int size, vector defaultValue, string uniqueName)

// 设置给定数组中指定索引处的值
// index 是数组中元素的索引。它从0开始，这意味着数组的第一个元素为索引0，第二个元素为索引1，以此类推。
// 例如，一个数组为 [66, 77, 88, 99]，那么 xsArraySetInt(arrayID, 2, 100) 后，数组将变为 [66, 77, 100, 99]
// 返回 1
int xsArraySetInt(int arrayID, int index, int value)
int xsArraySetFloat(int arrayID, int index, float value)
int xsArraySetBool(int arrayID, int index, bool value)
int xsArraySetString(int arrayID, int index, string value)
int xsArraySetVector(int arrayID, int index, vector value)

// 获取给定数组中指定索引处的值
// 返回获取到的值
// 如果你试图访问不存在的数组(无效的arrayID)或不存在的索引(负索引或超过数组长度的索引)中的值，则返回数据类型的默认值：
//    int defaultInt = -1
//    float defaultFloat = -1.0
//    bool defaultBool = false
//    string defaultString = ""
//    vector defaultVector = vector(0, 0, 0)
int xsArrayGetInt(int arrayID, int index)
float xsArrayGetFloat(int arrayID, int index)
bool xsArrayGetBool(int arrayID, int index)
string xsArrayGetString(int arrayID, int index)
vector xsArrayGetVector(int arrayID, int index)

// 调整指定数组的大小
// 返回 1
int xsArrayResizeInt(int arrayID, int newSize)
int xsArrayResizeFloat(int arrayID, int newSize)
int xsArrayResizeBool(int arrayID, int newSize)
int xsArrayResizeString(int arrayID, int newSize)
int xsArrayResizeVector(int arrayID, int newSize)

// 获取指定数组的大小
int xsArrayGetSize(int arrayID)

2、XS脚本通用语法：

/*
XS代表外部子程序（eXternal Subroutine）。
在帝国时代3中，XS是c++的一个极其简化的版本，用于编写AI脚本、随机地图脚本、触发器、UI和modding中使用的某些命令。
在帝国时代2决定版中，XS脚本的功能应该与帝国时代3的类似，具体有待探索。
本文大部分来自于 https://eso-community.net/viewtopic.php?p=436182
*/

复制代码

// 行注释：从左边双斜杠开始，直到本行末，都是注释。
/* 块注释。
首尾标志之间的都是注释内容。
*/

复制代码

———— 变量 ————
  语法：
<数据类型> <变量名称> = <值>;
  例如：
int c_Variable_1 = 100;
// 定义整数变量“c_Variable_1”值为100

float c_Percent_random = 0.33;
// 定义浮点数变量“c_Percent_random”值为0.33

  格式要求：
1、变量名称必须是唯一的，只能使用 A~Z、a~z、0~9、下划线(_)组合而成，且首个字符不能是数字。
2、xs语言区分大小写，所以 Resource 和 ReSourCe 和 resource 可以标识不同的变量。
3、变量名称不能跟xs语言的保留字相冲突（比如int是保留字，所以我们不能定义一个叫“int”的变量）
4、值必须符合数据类型的格式要求（比如我们不能给整数变量设一个浮点数值：int c_Variable_1 = 5.2）
5、末尾必须带一个英文分号，作为一句代码的结尾标识（会有无需分号的特例，但暂时不考虑）

  特殊说明：
1、为了方便管理，浮点数值为0.0时，将被视为一个正数
2、由于xs语言是用分号作为分隔，因此我们可以在同一行内塞下多条语句（如：int A = 1;  int B = 2; ）
3、等号(=)是赋值标志，表示把右侧的值赋值给左侧的变量

  数据类型一览：
整数(int)：
   int c_Variable_1 = 100;
   int zeroCelcius = 0;
浮点数(float)：
   float AbsoluteZero = -273.15;
   float PI = 3.141592;
   float c_Percent_random = 0.33;
字符串(string)：
   string myUnit = "Archer";
   string chat_text = "这是一段文字";
   string descript = "字符串内使用双引号，要用反斜杠转义：\"Hello\"。";
   // 【\"Hello\"】若打印，则会显示为【"Hello"】
   string descript = "字符串内使用反斜杠，要用反斜杠转义：\\Yes/。";
   // 【\\Yes/】若打印，则会显示为【\Yes/】
布尔值(bool)：
   bool aBoolVariable = true;
   bool anotherBoolVariable = false;
向量(vector)：
   暂无示例，在帝国时代3的xs脚本中用于储存XYZ三轴坐标。
更多类型：
   待补充。

  数据类型之间的转换：
并不能将原有的变量本身转为另一种类型，只能通过新定义一个变量、赋值来转换类型。
比如：
   浮点数→整数：
      float a = 23.945;
      int b = a;       // 结果是 b = 23（不舍入，只保留整数部分）
   整数→浮点数：
      int a = 23;
      float b = a;    // 结果是 b = 23.0
   布尔值→整数：
      bool a = true;
      int b = a;       // 结果是 b = 1（true→1，false→0）
   任何类型→字符串：
      bool a = true;
      string b = ""+a; // 结果是 b = "true"（必须如此连接才行）
   任何类型→布尔值：
      int a = 0;
      bool b = a;    // 结果是 b = flase（0→flase，非0→true）

———— 函数 ————
  一个函数可包括以下部分：
1、返回值的类型：类似于变量的定义。除 int,float,string,bool 等之外，还可以用 void 表示 <没有任何返回内容>。
2、自定义函数名：类似于变量的定义。名称必须唯一，只能使用 A~Z、a~z、0~9、下划线(_)，且首个字符不能是数字。
3、0个或若干个参数：类似于变量的定义。(类型名称=默认值)。在调用函数时，输入不同的值可以改变参数的值。
   参数只能在函数内部使用，函数执行结束就会被销毁。
4、一些语句：函数被调用时执行。这些语句可以使用参数作为变量。语句内也可以调用其他函数。
5、return 语句：可选。可让函数立即结束执行，并使函数返回一个值。如果不写 return 语句，则默认返回 void。

  语法（方括号内是可选内容）：
返回值的类型自定义函数名( [参数1类型参数1名称=参数1默认值  ,参数2, 参数3... ] )
{
   各语句;
   [return (返回值);]
}
  示例：
1、无参数、无实质语句、无返回值的函数：
   void doNothing()
   {
      return (void);
   }
2、给传入的两个整数相加，并返回：
   int addTwoNumber(int a=0, int b=0)
   {
      return (a + b);
   }
3、给传入的整数取绝对值，并返回：
   int abs(int a=0)
   {
      if (a < 0)
      {
      return (0 - a);
      }
      return (a);
   }
  调用函数：
1、使用函数名() 即可调用。
2、如果函数有返回值，则可以变量=函数名(参数)，把返回值赋值给变量。需注意，数据类型最好相匹配
3、如果函数的返回值为 void ，则不能赋值给变量。
4、传参数时，只能按顺序写: addTwoNumber(5,3)。不能像 addTwoNumber(b=3,a=5) 这样指定传给某个参数。

———— 规则（Rule） ————
  规则是会以特定间隔周期性地被自动调用的的void函数（无返回值）。
  规则应该在函数以外的地方定义和初始化。

  语法：
rule 规则名 // 规则的唯一性名称。遵循与变量相同的命名规则。而且不能与其他函数名重复。

   active/inactive // 设置规则的初始状态。active表示初始开启，inactive表示初始关闭。
            // 这与触发器的“初始开启/初始关闭”工作方式类似。
            // 开启的规则会被定期调用，可以被禁用而停止循环。
            // 关闭的规则会被游戏忽略，可以被启用而开始循环。
            // 无论是开启的还是关闭的，规则都可以像void函数一样被调用。

   // 以下附加参数都可省略。

   minInterval <int> // 倒计时模式。在代码块再次执行之前必须经过的最小间隔（游戏秒）
   maxInterval <int> // 倒计时模式。在代码块再次执行之前可能经过的最大间隔（游戏秒）（该参数可忽略）
   highFrequency // 高频模式（所有规则的默认模式）。
            // 每现实秒循环17~60次规则（这与游戏速度无关，但受性能影响）
            //  [ highFrequency ] 和 [ minInterval 与 maxInterval ] 冲突。
            // 上述两种模式不能同时使用。拥有高频标志时，间隔标志将强制无效。

   runImmediately  // 具有这个标志时，规则一旦开启则立即执行一次，随后周期性计时器开始运转。
            // 若没有这个标志，则倒计时模式开始，倒计时到 0 时规则被调用执行，循环往复。

   group 规则组名  // 该规则所属的组。且不需要用双引号括起。遵循与变量相同的命名规则。
            // 可以将多个规则分配给一个组，如此就可以通过简单地启用/禁用整个组来同时操作它们。

   priority <int>  // 规则会按照优先级高低依次执行
{
   // 要执行的代码块
}

  示例：
// 每隔 5 游戏秒执行一次对静态变量+1的简单规则。
rule Rule_Every5second
active
minInterval 5
{
   static int static_var = 0;
   static_var++;
   xsChatData("Static Variable = " + static_var);
}

  规则的启用与禁用：
// 可以在其他地方操作规则的开关。
void main()
{
   xsDisableRule("Rule_Every5second"); // 禁用规则
   xsEnableRule("Rule_Every5second"); // 启用规则
}

  可以使用xsDisableSelf来让规则只执行一次就禁用掉自身：
// 这个“激活器”规则会在第10秒时激活Rule_Every5second，随后自我禁用。
rule activatorOnlyOnce
active
minInterval 10
{
   xsEnableRule("Rule_Every5second");
   xsDisableSelf();
}

  规则组（group）：
// 在定义规则时，可以借助 [group 规则组名] 来创建一个组。
// 把多条规则划分给同一个规则组，就可以借助下面两个函数来统一启用/禁用了。
rule rule1
inactive
minInterval 3
group timingRules
{
}
rule rule2
inactive
minInterval 5
group timingRules
{
}
void main()
{
   xsEnableRuleGroup("timingRules"); // 启用规则组中所有规则
   xsDisableRuleGroup("timingRules"); // 禁用规则组中所有规则
}

>>第三部分 - 实用XS函数四则<<

1、实用XS函数四则（使用例在下文）

/*【newtonerdai设计的XS函数 · 根据资源修改变量】
以 [玩家X] 的 [资源Y] 修改 [变量Z]。有5种模式：
      mode = "=" —— 变量Z 设为资源Y
      mode = "+" —— 变量Z 加上资源Y
      mode = "-" —— 变量Z 减去资源Y
      mode = "*" —— 变量Z 乘以资源Y
      mode = "/" —— 变量Z 除以资源Y（向下取整）
各参数的含义：
      variable_id —— 触发变量ID，范围0~255，默认为0
      mode       —— 修改模式，默认为 =（即设置）
      player_id —— 玩家ID，范围1~8，默认为1（即玩家1）
      resource_id —— 资源ID，范围0~250，默认为0（即食物）
*/
void modify_Variable_by_Resource(int variable_id=0, string mode="=", int player_id=1, int resource_id=0)
{
      float resource_amount = xsPlayerAttribute(player_id, resource_id); // 获取玩家的资源值
      int var_value = xsTriggerVariable(variable_id);    // 获取触发变量数值
      if (mode == "=")
      {
         var_value = resource_amount;
         xsSetTriggerVariable(variable_id, var_value);
      }
      if (mode == "+")
      {
         var_value = var_value + resource_amount;
         xsSetTriggerVariable(variable_id, var_value);
      }
      if (mode == "-")
      {
         var_value = var_value - resource_amount;
         xsSetTriggerVariable(variable_id, var_value);
      }
      if (mode == "*")
      {
         var_value = var_value * resource_amount;
         xsSetTriggerVariable(variable_id, var_value);
      }
      if (mode == "/")
      {
         var_value = var_value / resource_amount;
         xsSetTriggerVariable(variable_id, var_value);
      }
}

/*【newtonerdai设计的XS函数 · 根据资源修改资源】
以[玩家A] 的 [资源A] 修改 [玩家B] 的 [资源B]。有5种模式：
      mode = "=" —— 资源B 设为资源A
      mode = "+" —— 资源B 加上资源A
      mode = "-" —— 资源B 减去资源A
      mode = "*" —— 资源B 乘以资源A
      mode = "/" —— 资源B 除以资源A
      （以上所有操作都保留小数，不取整。不过游戏里显示时只显示整数部分）
各参数的含义：
      p_B_id    —— 玩家B ID，范围1~8，默认为1（即玩家1）
      rsc_B_id —— 资源B ID，范围0~250，默认为0（即食物）
      mode    —— 修改模式，默认为 =（即设置）
      p_A_id    —— 玩家A ID，范围1~8，默认为1（即玩家1）
      rsc_A_id —— 资源A ID，范围0~250，默认为0（即食物）
*/
void modify_Resource_by_Resource(int p_B_id=1, int rsc_B_id=0, string mode="=", int p_A_id=1, int rsc_A_id=0)
{
      float rsc_A_amount = xsPlayerAttribute(p_A_id, rsc_A_id); // 获取玩家A 的资源值
      float rsc_B_amount = xsPlayerAttribute(p_B_id, rsc_B_id); // 获取玩家B 的资源值
      if (mode == "=")
      {
         xsSetPlayerAttribute(p_B_id, rsc_B_id, rsc_A_amount);
      }
      if (mode == "+")
      {
         rsc_B_amount = rsc_B_amount + rsc_A_amount;
         xsSetPlayerAttribute(p_B_id, rsc_B_id, rsc_B_amount);
      }
      if (mode == "-")
      {
         rsc_B_amount = rsc_B_amount - rsc_A_amount;
         xsSetPlayerAttribute(p_B_id, rsc_B_id, rsc_B_amount);
      }
      if (mode == "*")
      {
         rsc_B_amount = rsc_B_amount * rsc_A_amount;
         xsSetPlayerAttribute(p_B_id, rsc_B_id, rsc_B_amount);
      }
      if (mode == "/")
      {
         rsc_B_amount = rsc_B_amount / rsc_A_amount;
         xsSetPlayerAttribute(p_B_id, rsc_B_id, rsc_B_amount);
      }
}

/*【newtonerdai设计的XS函数 · 根据变量修改资源】
以 [变量A] 修改 [玩家X] 的 [资源Y]。有5种模式：
      mode = "=" —— 资源Y 设为变量A
      mode = "+" —— 资源Y 加上变量A
      mode = "-" —— 资源Y 减去变量A
      mode = "*" —— 资源Y 乘以变量A
      mode = "/" —— 资源Y 除以变量A
      （以上所有操作都保留小数，不取整。不过游戏里显示时只显示整数部分）
各参数的含义：
      player_id —— 玩家ID，范围1~8，默认为1（即玩家1）
      resource_id —— 资源ID，范围0~250，默认为0（即食物）
      mode       —— 修改模式，默认为 =（即设置）
      variable_id —— 触发变量ID，范围0~255，默认为0
*/
void modify_Resource_by_Variable(int player_id=1, int resource_id=0, string mode="=", int variable_id=0)
{
      float resource_amount = xsPlayerAttribute(player_id, resource_id); // 获取玩家的资源值
      int var_value = xsTriggerVariable(variable_id);    // 获取触发变量数值
      if (mode == "=")
      {
         resource_amount = var_value;
         xsSetPlayerAttribute(player_id, resource_id, resource_amount);
      }
      if (mode == "+")
      {
         resource_amount = resource_amount + var_value;
         xsSetPlayerAttribute(player_id, resource_id, resource_amount);
      }
      if (mode == "-")
      {
         resource_amount = resource_amount - var_value;
         xsSetPlayerAttribute(player_id, resource_id, resource_amount);
      }
      if (mode == "*")
      {
         resource_amount = resource_amount * var_value;
         xsSetPlayerAttribute(player_id, resource_id, resource_amount);
      }
      if (mode == "/")
      {
         resource_amount = resource_amount / var_value;
         xsSetPlayerAttribute(player_id, resource_id, resource_amount);
      }
}

2、使用例

首先把上面四则函数，放到你的 [xs脚本文件] 里，存为UTF-8编码，然后到编辑器 [地图]-[脚本文件名] 里指定xs脚本文件。
接着去 [触发器] 选项卡里，新建一个触发，创建一个 [效果-脚本调用]，在下面的使用例里任选一个函数来调用。至于怎么调用，上面已经说得很清楚了，在此不再赘述。
顺带一提，你可以修改相关变量值、资源量来测试，还可以按这个帖子的方法，在右上角简短任务栏里显示变量值、资源量。比如：

触发1 || 初始开启不循环
简短介绍 || 显示在屏幕上 = 是，内容为：
变量0 = <Variable 0>
变量100 = <Variable 100>
资源198 = <Unused Resource 198>
条件0 || 机会/随机百分比 = 0

复制代码

/*根据 P1资源修改变量#0*/

/*根据 P1资源修改 P1资源#198*/

/*根据变量#100 修改变量#0*/

/*根据变量#0 修改 P1资源#198*/

拓展阅读：
编辑器Build 43210新功能、半年来新发现大汇总！
[UP1.5] 用于AI-触发联动的 [资源法] 现已全面升级！
决定版精品贴大索引
决定版资源对照表（包含ID 英文中文扩充中文预设值作用）

春田一九零三 · 发表于 2020-12-27 19:39:32

又是一种新的途径

xiaogaoyagn · 发表于 2021-2-25 08:14:50

看了论坛那么多帖子，就觉得你特别专业，求教这个单位驻扎在单位内怎么做的，我用AOK驻扎半天，两个都没了，还有这个技能效果是不是只能AI设置，有缓冲时间的，能否一起赐教下

newtonerdai · 发表于 2021-4-27 21:24:52

（2021.4.27大更新）
1、大幅扩充帝国2DE官方函数库
2、[效果-脚本调用] 的注释方式+2、闪退BUG记录+1
3、XS脚本通用语法增加变量作用域、静态变量、数组、规则&规则组、模块化编程。

【重磅消息】
借助官方 xsEffectAmount 函数（第二部分→1、决定版内部XS函数→普通函数），我们可以在DE编辑器里实现 up-effect 语句了！

比如强制升级物件：

// 示例：
void upgrade()
{
// 升级(3) 单位83(男村民) 为单位4(步弓手) 数值0(参数忽略) 作用于玩家1
xsEffectAmount(3,83,4,0,1);
// 升级(3) 单位280(轻型投石车) 为单位8(长弓兵) 数值0(参数忽略) 作用于全体玩家-1
xsEffectAmount(3,280,8,0,-1);
}

复制代码

我是谁004 · 发表于 2021-4-28 15:53:37

太好了

终于有显性的效果了

cly806 · 发表于 2021-4-29 12:08:01

newtonerdai 发表于 2021-4-27 21:24
（2021.4.27大更新）
1、大幅扩充帝国2DE官方函数库
2、[效果-脚本调用] 的注释方式+2、闪退BUG记录+1

c里面的几个比如冒泡排序，比如虚类、指针能否运行，交给new2了，指针跟数组是c里面的两大组成部分哦

tutulovebee · 发表于 2021-7-29 23:05:48

條件的腳本應該是條件函數必定執行
條件回傳值是true時才會執行效果
條件回傳值是false時不會執行效果

大川 · 发表于 2023-11-30 13:20:11

秋一个xs 文件我想实现我的模组中，一个触发
当城堡兵杀死一个敌军事单位就变成英雄状态

		自动登录	找回密码
密码			注册翔鹰会员(昵称)

[战役制作] XS脚本指南 + 4则实用函数（2021.4.27大更新）

本帖子中包含更多资源

评分

本帖子中包含更多资源

点评

翔鹰建站十周年纪念章

二级翔鹰勋章

第八届火箭筒杯最佳战役

第八届火箭筒杯最佳新人

特级嘉禾勋章

三级帝国勋章

十字军勋章