kknongchang_2506/app/Module/GameItems/Models/Item.php

<?php

namespace App\Module\GameItems\Models;

use App\Module\GameItems\Enums\ITEM_TYPE;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Relations\HasOne;
use UCore\ModelCore;

/**
 * 物品基础信息
 *
 * field start 
 * @property  int  $id  物品ID，主键
 * @property  string  $name  物品名称
 * @property  string  $description  物品描述
 * @property  int  $category_id  物品分类ID，外键关联kku_item_categories表
 * @property  \App\Module\GameItems\Enums\ITEM_TYPE  $type  物品类型（1:可使用, 2:可装备, 3:可合成, 4:可交任务, 5:可开启...）
 * @property  bool  $is_unique  是否是单独属性物品（0:否，默认, 1:是）
 * @property  int  $max_stack  最大堆叠数量（0表示无限堆叠）
 * @property  int  $sell_price  出售价格
 * @property  bool  $tradable  是否可交易（0:不可交易, 1:可交易，默认）
 * @property  bool  $dismantlable  是否可分解（0:不可分解, 1:可分解，默认）
 * @property  int  $default_expire_seconds  玩家获取物品后的默认有效秒数（0表示永久有效）
 * @property  \App\Module\GameItems\Casts\DisplayAttributesCast  $display_attributes  展示属性，以JSON格式存储键值对，用于界面展示和描述的属性
 * @property  \App\Module\GameItems\Casts\NumericAttributesCast  $numeric_attributes  数值属性，以JSON格式存储键值对，用于计算和游戏逻辑的属性
 * @property  string  $global_expire_at  物品全局过期时间（可为空）
 * @property  int  $chest_consume_group_id  宝箱开启消耗组ID（仅宝箱类型物品使用）
 * @property  int  $chest_reward_group_id  宝箱开启奖励组ID（仅宝箱类型物品使用）
 * @property  \Carbon\Carbon  $created_at  创建时间
 * @property  \Carbon\Carbon  $updated_at  更新时间
 * field end
 */
class Item extends ModelCore
{

    /**
     * 与模型关联的表名
     *
     * @var string
     */
    protected $table = 'item_items';

    // attrlist start 
    protected $fillable = [
        'id',
        'name',
        'description',
        'category_id',
        'type',
        'is_unique',
        'max_stack',
        'sell_price',
        'tradable',
        'dismantlable',
        'default_expire_seconds',
        'display_attributes',
        'numeric_attributes',
        'global_expire_at',
        'chest_consume_group_id',
        'chest_reward_group_id',
    ];
    // attrlist end

    /**
     * 应该被转换为日期的属性
     *
     * @var array
     */
    protected $dates = [
        'global_expire_at',
        'created_at',
        'updated_at',
    ];

    /**
     * 应该被转换为原生类型的属性
     *
     * @var array
     */
    protected $casts = [
        'display_attributes' => \App\Module\GameItems\Casts\DisplayAttributesCast::class,
        'numeric_attributes' => \App\Module\GameItems\Casts\NumericAttributesCast::class,
        'type'               => ITEM_TYPE::class,
        'is_unique'          => 'boolean',
        'max_stack'          => 'integer',
        'sell_price'         => 'integer',
        'default_expire_seconds' => 'integer',
        'tradable'           => 'boolean',
        'dismantlable'       => 'boolean',
    ];

    /**
     * 获取物品所属分类
     *
     * @return BelongsTo
     */
    public function category(): BelongsTo
    {
        return $this->belongsTo(ItemCategory::class, 'category_id');
    }

    /**
     * 获取物品的所有实例
     *
     * @return HasMany
     */
    public function instances(): HasMany
    {
        return $this->hasMany(ItemInstance::class, 'item_id');
    }

    /**
     * 获取拥有该物品的用户
     *
     * @return HasMany
     */
    public function users(): HasMany
    {
        return $this->hasMany(ItemUser::class, 'item_id');
    }



    /**
     * 宝箱配置（新系统）
     *
     * @return HasMany
     */
    public function chestConfig(): HasOne
    {
        return $this->HasOne(\App\Module\GameItems\Models\ItemChestConfig::class, 'item_id', 'id');
    }

}