QF 触发函数收到的 actor 是字符串（玩家名字），大量学员拿到就直接当对象用：调接口、拼字段、存进表里当键再去点属性，轻则接口静默无效，重则脚本报错中断，整段攻城战报逻辑停摆。典型错误写法：
local function onGuildWar(actor)
giveitem(actor, "裁决之杖", 1)
end
传进去的是字符串名字，后续一切对象级操作全部落空。
先判断类型，是字符串就用 getplayerbyname 转成玩家对象，再交给接口使用。下面是沙巴克战报的正确写法：拿下沙巴克时向全服发屏幕公告并记录功臣。示例代码如下：
local function onSabukWin(actor, guildName)
if type(actor) == "string" then
actor = getplayerbyname(actor)
end
giveitem(actor, "裁决之杖", 1)
sendcentermsg(actor, 255, 215, "【" .. guildName .. "】攻占沙巴克！功臣：" .. tostring(actor), 0, 10)
setsysvarex("SabukOwner", guildName, 1)
end
getplayerbyname 是引擎真名接口：入参玩家名字符串，返回玩家对象。转一次，处处可用。
三步验证：一，把脚本放进 QF 触发目录，M2 控制台执行重载脚本命令；二，用测试小号触发对应事件（这里可用 triggerchat 聊天触发临时改绑），观察控制台是否打印出对象而非字符串；三，故意删掉转换行再触发一次，复现报错，记住报错行号——以后线上见到同款报错，三秒内定位到没转对象。
离线玩家拿不到对象怎么办？getplayerbyname 只对在线玩家有效，按唯一 ID 找人要用 getplayerbyid，配合 sendmail 可以给离线玩家发奖励——邮件接口收 "#名字" 格式，离线也照发不误。示例代码如下：
local function rewardById(makeindex, name)
local target = getplayerbyid(makeindex)
if target ~= nil and target ~= "" then
giveitem(target, "金条", 2)
else
sendmail("#" .. name, 9001, "沙巴克军饷",
"攻城奖励已随邮件补发。", "金条#2#1")
end
end
全站技术干货持续更新：996 引擎 / Lua 实战帖，语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
设计初衷 行会系统的通病是"人多力量大"只体现在攻城：日常没有人人有份的参与结构，普通成员对行会缺少归属感与参与点。科技树把…
设计初衷 打怪掉装、强化失败、版本更替，都在往玩家背包里塞过渡装备，卖不掉、扔了心疼，压在包里发臭。回收系统的价值两条：给过…
底层原理 性能优化不靠猜，靠剖析。os.clock 返回脚本进程占用的 CPU 时间（秒，小数），两次取值之差就是中间代码的…
设计初衷 满级是长线游戏的分水岭：不转生，毕业玩家无事可做、数值通胀无处吸收；硬开新等级，老装备一夜贬值。转生系统的价值在于…
业务场景 石墓阵里 6 个精英点位驻着白野猪王，被清掉后要按周期补位。散装写法把地图、坐标、怪物名硬编码在脚本里，开新区要复…
底层原理 闭包是函数与其捕获环境的绑定：内层函数引用外层局部变量时，这份数据随函数体一起存活，外部既访问不到也改不掉。限频器…