This_Player

原版属性和方法仍在逐项核验。本页先列 GOW-Next 新增的玩家对象接口。

方法列表

方法	用途
GetEquipBaseValue	读取装备模板基础值
GetEquipDurability	读取装备当前耐久
SetEquipRareValue / GetEquipRareValue	读写六槽极品值
GiveItemWithRareValues	发放带六槽极品值的物品
宝宝控制	修改、击杀或召回当前宝宝

GetEquipBaseValue

用途： 读取人物或英雄指定装备的物品模板基础字段。

function GetEquipBaseValue(Slot: Integer; IsHero: Boolean;
  const FieldName: string; DefaultValue: Int64): Int64;

参数	说明
Slot	装备位置 0..15
IsHero	False 人物，True 英雄
FieldName	模板字段名，不区分大小写
DefaultValue	无装备、无英雄或字段无效时的返回值

常用位置：0 衣服、1 武器、3 项链、4 头盔、5..6 手镯、7..8 戒指、9 护身符、10 腰带、11 鞋子、12 宝石、13 斗笠、14 战鼓、15 马牌。

常用字段：std_mode、shape、weight、dura_max、need_level、need_job、ac、max_ac、mac、max_mac、dc、max_dc、mc、max_mc、sc、max_sc、price。

Value := This_Player.GetEquipBaseValue(1, False, 'max_dc', 0);

返回的是模板基础值，不含极品、强化、元素和人物最终加成。

SetEquipRareValue / GetEquipRareValue

用途： 读写人物当前装备的六槽极品值。

function SetEquipRareValue(EquipSlot, RareSlot: Integer;
  Value: Int64): Boolean;
function GetEquipRareValue(EquipSlot, RareSlot: Integer;
  DefaultValue: Int64): Int64;

参数	说明
EquipSlot	装备位置 0..15
RareSlot	极品槽 1..6
Value	Int32 模式为 0..255；Int64 模式为非负 Int64
DefaultValue	读取失败时返回

设置成功返回 True 并刷新装备与人物属性；Value=0 清除该槽。

This_Player.SetEquipRareValue(1, 5, 3);

GiveItemWithRareValues

用途： 发放一件带六槽极品值的物品。

function GiveItemWithRareValues(const ItemName: string;
  Value1, Value2, Value3, Value4, Value5, Value6: Int64): Boolean;

成功返回 True。物品不存在、数值越界、背包不足或入包失败时返回 False。

This_Player.GiveItemWithRareValues('木剑', 0, 1, 0, 0, 0, 2);

宝宝控制

function SetSlaveAbilityValue(SlaveIndex, AbilityId, Value: Integer;
  Additive: Boolean): Boolean;
function SetSlaveActionDelay(SlaveIndex, DelayKind, Value: Integer): Boolean;
function KillAllSlaveMonsters: Integer;
function RecallAllSlaves: Integer;

参数	说明
SlaveIndex	当前宝宝列表序号，从 1 开始
AbilityId	1/2 AC，3/4 MC，5/6 DC，13 HP，14 MaxHP
Additive	False 覆盖，True 增加
DelayKind	1 攻击间隔，2 移动间隔
Value	非负 Integer；动作间隔单位为毫秒

前两个方法成功返回 True。击杀和召回返回匹配到的有效宝宝数量；召回返回值不表示移动已经完成。