游戏脚本核心数据结构说明书

一、概述

本文档详细定义了游戏脚本开发中所使用的核心数据结构，包括类、枚举等，涵盖了游戏中角色、物品、地图、技能、触发器等关键模块的属性和关联关系。适用于游戏脚本开发人员、维护人员以及相关测试人员，作为脚本编写、功能扩展和问题排查的参考依据。

二、核心类定义

2.1 基础配置类

2.1.1 lualib 系统配置类

2.2 容器与引用类

2.2.1 Ref 引用类

空类，用于对象引用管理，可根据实际需求扩展属性。

2.2.2 Include 包含类

空类，用于模块包含关系定义，可根据实际需求扩展属性。

2.2.3 Point 坐标类

空类，用于表示游戏内的坐标点，可扩展 X、Y 等坐标属性。

2.2.4 MapObjects 地图对象集合

2.2.5 EntityObjects 实体对象集合

2.2.6 UserItems 用户物品集合

空类，用于存储用户拥有的物品列表，可通过索引访问具体的 UserItem 对象。

2.2.7 HeroInfos 英雄信息集合

2.3 角色相关类

2.3.1 HeroInfo 英雄对象信息类

2.3.2 GuildObject 行会对象类

2.3.3 MapObject 地图对象基类

2.3.4 NPCObject NPC 对象类

继承自 MapObject，扩展属性如下：

2.3.5 EntityObject 实体对象类

继承自 MapObject，涵盖玩家、怪物、英雄等可交互实体，属性如下：

2.3.6 PlayerObject 玩家对象类

继承自 EntityObject，扩展属性如下：

2.3.7 MonsterObject 野怪对象类

继承自 EntityObject，无额外扩展属性，可根据实际需求补充。

2.3.8 HeroObject 英雄实体类

继承自 EntityObject，无额外扩展属性，可根据实际需求补充。

2.3.9 HumanObject 人型对象类

继承自 EntityObject，无额外扩展属性，可根据实际需求补充。

2.3.10 EntityCopy 实体属性快照类

2.4 技能与伤害相关类

2.4.1 BaseData 基础数据类

2.4.2 SkillData 技能数据类

注：MPower 和 Power 的计算方式为 Random (Base, Bonus+Base)，即从基础值到基础值加额外值的范围内随机取值。

2.4.3 BuffData Buff 数据类

2.4.4 DamageData 伤害数据类

2.5 物品相关类

2.5.1 ItemObject 物品基类

空类，作为所有物品对象的父类，可根据实际需求扩展属性。

2.5.2 UserItem 用户物品类

2.5.3 ItemInfo 物品基础信息类

2.5.4 InfoType 物品类型详情类

2.5.5 ItemMaterial 物品素材类

2.6 地图类

2.6.1 Map 地图类

三、枚举定义

3.1 DamageSource 伤害来源枚举

3.2 TriggerType 触发器枚举