GameObject 常见类型详解 -- 按钮(BUTTON)

GAMEOBJECT_TYPE_BUTTON 是 TrinityCore 中用于创建按钮的 GameObject 类型

字段详细说明

字段索引 字段名称 数据类型 默认值 说明 可选值/范围
data0 startOpen enum false 按钮的初始状态 0 = 未按下, 1 = 已按下
data1 open uint32 0 按下按钮所需的锁类型ID 引用 Lock.db2,0表示无需钥匙
data2 autoClose uint32 3000 按钮自动恢复时间(毫秒) 0 - 2147483647
data3 linkedTrap uint32 0 关联的陷阱ID 引用 GameObjects.db2
data4 noDamageImmune enum false 按钮是否对伤害免疫 0 = 否, 1 = 是
data5 GiganticAOI enum false 是否具有巨大活动范围 0 = 否, 1 = 是
data6 openTextID uint32 0 按下按钮时显示的文本ID 引用 BroadcastText.db2
data7 closeTextID uint32 0 恢复按钮时显示的文本ID 引用 BroadcastText.db2
data8 requireLOS enum false 是否需要视线 0 = 否, 1 = 是
data9 conditionID1 uint32 0 按钮的使用条件ID 引用 PlayerCondition.db2
data10 InteractRadiusOverride uint32 0 交互半径覆盖值(码*100) 0 - 2147483647

状态控制字段

字段 说明
startOpen 定义按钮在游戏世界中的初始状态,按下状态的按钮会在一段时间后自动恢复(根据autoClose值)
autoClose 控制按钮按下后多长时间自动恢复,0表示永不自动恢复

访问控制字段

字段 说明
open 定义按下按钮所需的钥匙或条件,引用 Lock.db2 表中的记录
conditionID1 定义玩家使用按钮之前必须满足的条件,引用 PlayerCondition.db2 表

关联机制字段

字段 说明
linkedTrap 关联一个陷阱对象,当按钮被按下时会触发该陷阱

交互反馈字段

字段 说明
openTextID 按钮被按下时显示给玩家的文本消息ID
closeTextID 按钮恢复时显示给玩家的文本消息ID

游戏机制字段

字段 说明
noDamageImmune 控制按钮是否可以被攻击或法术影响
requireLOS 控制玩家是否需要与按钮保持视线接触才能交互
GiganticAOI 扩大按钮的活动范围,使远处玩家也能检测到

性能优化字段

字段 说明
InteractRadiusOverride 自定义按钮的交互距离,覆盖默认值

注意事项

  • 触发机制: 按钮主要用于触发事件

  • linkedTrap关联: 通过linkedTrap可以创建复杂的触发机制,按钮按下时会激活关联的陷阱

  • 视线要求: requireLOS字段可以增加游戏的交互真实感,玩家必须直视按钮才能按下

  • 性能考虑: GiganticAOI会影响服务器性能,应谨慎使用

  • 平衡性: autoClose时间过短或过长都可能影响游戏体验

使用示例

sql 复制代码
-- 一个基本的按钮,初始未按下,3秒后自动恢复
INSERT INTO `gameobject_template` 
(entry, [type](file://c:\TrinityCore\dep\protobuf\src\google\protobuf\descriptor.h#L797-L797), displayId, [name](file://c:\TrinityCore\dep\g3dlite\include\G3D\XML.h#L166-L168), data0, data1, data2) 
VALUES (223456, 1, 2234, '基本按钮', 0, 0, 3000);
sql 复制代码
-- 一个高级按钮,需要钥匙,关联陷阱,需要视线接触
INSERT INTO `gameobject_template` 
(entry, [type](file://c:\TrinityCore\dep\protobuf\src\google\protobuf\descriptor.h#L797-L797), displayId, [name](file://c:\TrinityCore\dep\g3dlite\include\G3D\XML.h#L166-L168), data0, data1, data2, data3, data8) 
VALUES (223457, 1, 2235, '高级按钮', 0, 100, 5000, 50001, 1);
相关推荐
Kagol7 小时前
🎉OpenTiny NEXT-SDK 重磅发布:四步把你的前端应用变成智能应用!
前端·开源·agent
冬奇Lab8 小时前
OpenClaw 源码精读(2):Channel & Routing——一条消息如何找到它的 Agent?
人工智能·开源·源码阅读
冬奇Lab8 小时前
一天一个开源项目(第38篇):Claude Code Telegram - 用 Telegram 远程用 Claude Code,随时随地聊项目
人工智能·开源·资讯
sunny86510 小时前
Claude Code 跨会话上下文恢复:从 8 次纠正到 0 次的工程实践
人工智能·开源·github
strayCat2325518 小时前
Clawdbot 源码解读 7: 扩展机制
人工智能·开源
Moment20 小时前
OpenClaw 从能聊到能干差的是这 50 个 Skills 😍😍😍
前端·后端·开源
草梅友仁21 小时前
墨梅博客 1.7.0 发布与 AI 开发实践 | 2026 年第 9 周草梅周报
开源·github·ai编程
ursazoo1 天前
写了一份 7000字指南,让 AI 帮我消化每天的信息流
人工智能·开源·github
冬奇Lab2 天前
一天一个开源项目(第37篇):awesome-selfhosted - 自托管软件资源集合
开源·自动化运维·资讯
冬奇Lab2 天前
一天一个开源项目(第36篇):EverMemOS - 跨 LLM 与平台的长时记忆 OS,让 Agent 会记忆更会推理
人工智能·开源·资讯