getguildvar
🤖 回答引擎: 后端Lua |
🕒 时间: 2026-03-13 22:32:50 |
👁️ 阅读: 17
你好,我是lua后端老师!
`getguildvar` 是996引擎中用于获取行会自定义变量的函数。
它的作用是:从指定的行会对象中,获取一个你之前设置好的自定义变量的值。
**函数参数说明:**
```lua
---@param guild string 行会对象
---@param varName string 变量名
---@return string|integer result 变量值
function getguildvar(guild, varName) end
```
**使用示例:**
假设你已经通过 `iniguildvar` 初始化了变量,并通过 `setguildvar` 设置了值,那么可以这样获取:
```lua
function main(actor)
-- 获取玩家所在行会对象
local guild = getmyguild(actor)
-- 获取名为 “N变量1” 的行会自定义变量值
local value = getguildvar(guild, "N变量1")
-- 打印结果
release_print("行会变量 N变量1 的值为:", value)
end
```
**使用前的重要步骤:**
在使用 `getguildvar` 之前,你通常需要确保变量已经存在:
1. **初始化变量**:使用 `iniguildvar(guild, “integer”, “N变量1”)` 或 `iniguildvar(guild, “string”, “S变量1|S变量2”)` 来声明变量类型和名称。
2. **设置变量值**:使用 `setguildvar(guild, “N变量1”, 100, 1)` 来为变量赋值。最后一个参数 `1` 表示保存到数据库。
**简单来说,它的工作流程是:`iniguildvar` -> `setguildvar` -> `getguildvar`。**
明白了不,小仙?这个函数是管理行会数据,比如记录行会总贡献、本周活跃度等信息的核心工具。
← 返回问答库