chatroom/app/Models/Autoact.php

<?php

/**
 * 文件功能：自动动作事件模型
 * 对应原版 ASP 聊天室的 autoact 表
 * 存储系统随机事件（好运/坏运/经验/金币奖惩）
 * 管理员可在后台管理这些事件
 *
 * @author  ChatRoom Laravel
 *
 * @version 1.0.0
 */

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Autoact extends Model
{
    /** @var string 表名 */
    protected $table = 'autoact';

    /** @var array 可批量赋值的字段 */
    protected $fillable = [
        'text_body',
        'event_type',
        'exp_change',
        'jjb_change',
        'enabled',
    ];

    /** @var array 类型转换 */
    protected $casts = [
        'exp_change' => 'integer',
        'jjb_change' => 'integer',
        'enabled' => 'boolean',
    ];

    /**
     * 随机获取一条已启用的事件
     */
    public static function randomEvent(): ?self
    {
        return static::where('enabled', true)->inRandomOrder()->first();
    }

    /**
     * 将事件文本中的变量替换为实际值
     *
     * @param  string  $username  当前用户名
     * @return string 替换后的文本
     */
    public function renderText(string $username): string
    {
        return str_replace('{username}', "【{$username}】", $this->text_body);
    }
}