内容仅用于留档：
common=client+server

/**
 * 实体被枪械击中前事件
 * 事件类型：common
 * 对应Forge原生事件: EntityHurtByGunEvent.Pre
 * 描述: 实体被枪械击中伤害判定前触发，可修改伤害、爆头判定、攻击者等属性
 * 可以取消，可以修改数值
 */
TimelessGunEvents.entityHurtByGunPre(event=>{})

/**
 * 实体被枪械击中后事件
 * 事件类型：common
 * 对应Forge原生事件: EntityHurtByGunEvent.Post
 * 描述: 实体被枪械击中伤害判定完成（未死亡）后触发，仅监听不可修改核心属性
 * 不可取消，仅监听
 */
TimelessGunEvents.entityHurtByGunPost(event=>{})

/**
 * 实体被枪械击杀事件
 * 事件类型：common
 * 对应Forge原生事件: EntityKillByGunEvent
 * 描述: 实体被枪械子弹击杀时触发，可监听击杀信息（伤害、是否爆头、枪械ID等）
 * 不可取消，仅监听
 */
TimelessGunEvents.entityKillByGun(event=>{})

/**
 * 掏出枪械事件
 * 事件类型：common
 * 对应Forge原生事件: GunDrawEvent
 * 描述: 生物掏出枪械时触发，可修改掏枪动画、禁止掏枪
 * 可以取消，可修改相关行为
 */
TimelessGunEvents.gunDraw(event=>{})

/**
 * 换弹完成事件
 * 事件类型：common
 * 对应Forge原生事件: GunFinishReloadEvent
 * 描述: 生物完成枪械换弹动作时触发，可修改换弹结果、重置弹药数
 * 可以取消，可以修改数值
 */
TimelessGunEvents.gunFinishReload(event=>{})

/**
 * 枪械击发事件
 * 事件类型：common
 * 对应Forge原生事件: GunFireEvent
 * 描述: 枪械扣动扳机击发时触发（连发/点射模式下一次扳机可能多次触发），可取消开火、修改弹道
 * 可以取消，可以修改数值
 */
TimelessGunEvents.gunFire(event=>{})

/**
 * 切换开火模式事件
 * 事件类型：common
 * 对应Forge原生事件: GunFireSelectEvent
 * 描述: 生物切换枪械开火模式（单发/连发/点射）时触发，可修改开火模式
 * 可以取消，可以修改数值
 */
TimelessGunEvents.gunFireSelect(event=>{})

/**
 * 枪械近战事件
 * 事件类型：common
 * 对应Forge原生事件: GunMeleeEvent
 * 描述: 生物使用枪械进行近战攻击时触发，可修改近战伤害、取消近战
 * 可以取消，可以修改数值
 */
TimelessGunEvents.gunMelee(event=>{})

/**
 * 开始换弹事件
 * 事件类型：common
 * 对应Forge原生事件: GunReloadEvent
 * 描述: 生物开始更换枪械弹药时触发，可取消换弹、修改换弹速度
 * 可以取消，可以修改数值
 */
TimelessGunEvents.gunReload(event=>{})

/**
 * 射出子弹事件
 * 事件类型：common
 * 对应Forge原生事件: GunShootEvent
 * 描述: 枪械射出子弹瞬间触发（一次扳机仅触发一次，区别于GunFireEvent），可修改子弹属性、新增特效
 * 可以取消，可以修改数值
 */
TimelessGunEvents.gunShoot(event=>{})

/**
 * 子弹击中方块事件
 * 事件类型：server
 * 对应Forge原生事件: AmmoHitBlockEvent
 * 描述: 子弹击中方块时触发（仅服务端），可修改子弹轨迹、新增爆炸/特效
 * 可以取消，可以修改数值
 */
TimelessGunEvents.ammoHitBlock(event=>{})

/**
 * 手部渲染前事件
 * 事件类型：client
 * 对应Forge原生事件: BeforeRenderHandEvent
 * 描述: 枪械手部模型渲染前触发（仅客户端），可修改持枪姿势、隐藏手部模型
 * 可以取消，可修改渲染相关属性
 */
TimelessGunEvents.beforeRenderHand(event=>{})

/**
 * 受伤时手部抖动事件
 * 事件类型：client
 * 对应Forge原生事件: RenderItemInHandBobEvent.BobHurt
 * 描述: 玩家受伤时枪械手部模型抖动渲染触发（仅客户端），可修改抖动幅度
 * 可以取消，可以修改抖动数值
 */
TimelessGunEvents.renderItemInHandBobHurt(event=>{})

/**
 * 视角移动手部抖动事件
 * 事件类型：client
 * 对应Forge原生事件: RenderItemInHandBobEvent.BobView
 * 描述: 玩家视角移动时枪械手部模型抖动渲染触发（仅客户端），可修改抖动幅度
 * 可以取消，可以修改抖动数值
 */
TimelessGunEvents.renderItemInHandBobView(event=>{})

/**
 * 受伤时场景抖动事件
 * 事件类型：client
 * 对应Forge原生事件: RenderLevelBobEvent.BobHurt
 * 描述: 玩家受伤时场景抖动渲染触发（仅客户端），可修改场景抖动幅度
 * 可以取消，可以修改抖动数值
 */
TimelessGunEvents.renderLevelBobHurt(event=>{})

/**
 * 视角移动场景抖动事件
 * 事件类型：client
 * 对应Forge原生事件: RenderLevelBobEvent.BobView
 * 描述: 玩家视角移动时场景抖动渲染触发（仅客户端），可修改场景抖动幅度
 * 可以取消，可以修改抖动数值
 */
TimelessGunEvents.renderLevelBobView(event=>{})

/**
 * 切换主副手持枪事件
 * 事件类型：client
 * 对应Forge原生事件: SwapItemWithOffHand
 * 描述: 玩家切换主副手持枪时触发（仅客户端），可禁止切换、修改切换动画
 * 可以取消，可修改切换相关行为
 */
TimelessGunEvents.swapItemWithOffHand(event=>{})