魂元逻辑

魂元相关玩法的API集合 更多...

函数
int	ChargeSoul (FxCreature *pActor, unsigned long nValue)
	角色pActor向魂元石充电，充电。 更多...
int	DischargeSoul (FxCreature *pActor, unsigned long nValue, unsigned long nMaxValue=0)
	魂元石向角色pActor输入魂元，即放电。 更多...
int	GetSoul (FxCreature *pActor)
	查询角色pActor的魂元数值。 更多...
int	GetSoulChargable (FxCreature *pActor, unsigned long nInput)
	查询角色pActor的魂元数值是否够存储在魂元石。 更多...
int	GetSoulDischargable (FxCreature *pActor, unsigned long nInput)
	查询角色pActor的魂元数值是否够存储在魂元石，就是查询角色的魂元值剩余空间是否够接受一次放电 更多...

详细描述

魂元相关玩法的API集合

函数说明

ChargeSoul()

int ChargeSoul	(	FxCreature *	pActor,
		unsigned long	nValue
	)

角色pActor向魂元石充电，充电。

参数

pActor	[角色] 角色对象。
nValue	[整数] 操作的魂元数值。

返回

[整数] 充电的结果

返回值

0	失败，这个逻辑中，只会因为pActor不是玩家而失败
1	充电成功

DischargeSoul()

int DischargeSoul	(	FxCreature *	pActor,
		unsigned long	nValue,
		unsigned long	nMaxValue = 0
	)

魂元石向角色pActor输入魂元，即放电。

参数

pActor	[角色] 角色对象。
nValue	[整数] 操作的魂元数值，默认0
nMaxValue	[整数] 操作的最大数值，默认0

返回

[整数] 放电的结果

返回值

0	失败，这个逻辑中，只会因为pActor不是玩家而失败
1	放电成功

注解

nMaxValue比nValue大的时候，会随机一个数值。否则严格按照nValue进行魂元输入。

GetSoul()

int GetSoul

(

FxCreature *

pActor

)

查询角色pActor的魂元数值。

参数

pActor

[角色] 角色对象。

返回

[整数] 角色的魂元值

GetSoulChargable()

int GetSoulChargable	(	FxCreature *	pActor,
		unsigned long	nInput
	)

查询角色pActor的魂元数值是否够存储在魂元石。

参数

pActor	[角色] 角色对象。
nInput	[整数] 输入的数值。

返回

[整数] 角色的魂元值

注解

魂元石存储的操作要求玩家的当前魂元值大于魂元值的容量，即魂元石必须充满魂元。即不存在：4点魂元存储在容量10的魂元石中这样的逻辑。

GetSoulDischargable()

int GetSoulDischargable	(	FxCreature *	pActor,
		unsigned long	nInput
	)

查询角色pActor的魂元数值是否够存储在魂元石，就是查询角色的魂元值剩余空间是否够接受一次放电

参数

pActor	[角色] 角色对象。
nInput	[整数] 输入的数值。

返回

[整数] 角色的魂元值

注解

玩家还剩余的魂元空间必须能够完全接受某个容量的魂元石的输入。即不存在：容量10的魂元石，这次像玩家放4点，魂元石剩余6点这种逻辑。