<?php

namespace App\Module\Pet\Events;

use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

/**
 * 宠物技能使用事件
 * 
 * 当用户使用宠物技能时触发此事件，允许其他系统响应宠物技能的使用。
 * 此事件可用于记录技能使用日志、更新技能冷却时间、处理技能效果等。
 */
class PetSkillUsedEvent
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    /**
     * 用户ID
     *
     * @var int
     */
    public int $userId;

    /**
     * 宠物ID
     *
     * @var int
     */
    public int $petId;

    /**
     * 技能ID
     *
     * @var int
     */
    public int $skillId;

    /**
     * 技能参数
     *
     * @var array
     */
    public array $params;

    /**
     * 创建一个新的事件实例
     *
     * @param int $userId 用户ID
     * @param int $petId 宠物ID
     * @param int $skillId 技能ID
     * @param array $params 技能参数
     * @return void
     */
    public function __construct(int $userId, int $petId, int $skillId, array $params = [])
    {
        $this->userId = $userId;
        $this->petId = $petId;
        $this->skillId = $skillId;
        $this->params = $params;
    }
}