查看“︁Lua接口/服务端/CityChangeAttr”︁的源代码

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/帮会城市|帮会城市]] · [[Lua接口/服务端调用约定|调用约定]]

<div class="lua-lead lua-rule">增减城市或帮会属性，帮贡修改返回 1、-1 或无返回值。</div>

== Lua 调用 ==
<pre>CityChangeAttr(sceneId, selfId, attrType, attrChangedValue)</pre>

服务端脚本中共出现 43 处调用，实参个数出现过：4 个（43 处）。

实现位于 <code>LuaFnTbl_City.h</code> 第 832 行，注册表第 996 行。

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w11" | 序号
! scope="col" class="lua-w36" | 参数 / 类型
! scope="col" | 说明
|-
| 1
| <code>sceneId</code><br /><span class="lua-muted"><code>number</code></span>
| 当前调用所在的场景 ID。<br /><span class="lua-muted">脚本中的实参：<code>sceneId</code>（43 处）</span>
|-
| 2
| <code>selfId</code><br /><span class="lua-muted"><code>number</code></span>
| 当前场景内的对象 ID。玩家接口需传入有效玩家对象；不是角色 GUID。<br /><span class="lua-muted">脚本中的实参：<code>selfId</code>（43 处）</span>
|-
| 3
| <code>attrType</code><br /><span class="lua-muted"><code>number</code></span>
| 属性类型编号。<br /><span class="lua-muted">脚本中的实参：<code>GUILD_CONTRIB_POINT</code>（15 处）、<code>GUILD_MONEY</code>（11 处）、<code>6</code>（5 处）</span>
|-
| 4
| <code>attrChangedValue</code><br /><span class="lua-muted"><code>number</code></span>
| 属性变化量。<br /><span class="lua-muted">脚本中的实参：<code>ContribBonus</code>（8 处）、<code>SpecBonus</code>（6 处）、<code>(-1)*goldGet</code>（3 处）</span>
|}

== 返回值 ==
根据执行分支，返回数量可能为 0、1 个（0 个表示无返回值）。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>-1</code>；<code>1</code>。

== 脚本中的调用 ==
以下是服务端脚本里的真实调用点，按实参形态去重后列出 8 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。
<pre>-- city0_building5.lua
CityChangeAttr(sceneId, selfId, GUILD_MONEY, (-1)*goldGet)

-- city0_building5.lua
CityChangeAttr(sceneId, selfId, GUILD_CONTRIB_POINT, (-1)*minusContri)

-- city0_building5.lua
CityChangeAttr(sceneId, selfId, GUILD_MONEY, (-1)*curMoney)

-- city0_building5.lua
CityChangeAttr(sceneId, selfId, GUILD_MONEY, TicketMoney * x805012_g_GuildRate*merchandiseDay)

-- city0_building5.lua
CityChangeAttr(sceneId, selfId, GUILD_CONTRIB_POINT, contripoint)

-- city0_building5.lua
CityChangeAttr(sceneId, selfId, GUILD_MONEY, TicketMoney)

-- city0_building5.lua
CityChangeAttr(sceneId, selfId, GUILD_MONEY, addmoney)

-- event/city/ecity_0100engineering.lua
CityChangeAttr(sceneId, selfId, GUILD_CONTRIB_POINT, ContribBonus)</pre>

== 注意事项 ==
* 调用对象必须是当前场景中的有效玩家。
* 调用前要求玩家处于可执行逻辑的状态（实现体断言 <code>pHuman-&gt;IsCanLogic()</code>）；不满足时会记录断言，应先确认玩家当前状态。

</div>