SH-Logger — FiveM 服务器全能日志与管理插件

## 📋 插件简介

SH-Logger 是一款专为 FiveM ESX 服务器设计的高级日志管理系统，提供全方位的游戏行为记录、实时监控和远程管理功能。融合 Resources 日志系统的优点，支持游戏内面板、网页后台和 KOOK 机器人三重管理方式。

## ✨ 核心功能

### 1️⃣ 全面的日志记录

日志类型 记录内容 截图支持 物品日志 拾取、丢弃、给予、存取仓库/车辆/柜子等详细动作 ✅ 金钱日志 转账、存款、取款、交易等资金变动 ✅ 连接日志 玩家进服、退服、掉线等连接事件 ❌ 死亡日志 玩家死亡原因、位置、凶手信息 ✅ 聊天日志 全局聊天、私聊、指令使用记录 ✅ 管理员日志 管理员操作记录，支持与普通日志分离 ✅

特色功能：

– 🏷️ 详细的物品动作追踪 – 自动识别丢弃、拾取、给予、放入柜子/车辆等动作

– 🏦 银行日志细分 – 存款、取款、转账分类记录

– ⚠️ 金钱异常检测 – 单次大额变动自动触发异常警告

– 📝 物品白名单 – 支持通配符，过滤不需要记录的常规物品

### 2️⃣ 三重管理面板 🎮 游戏内面板

– 快捷键支持 – F6 一键开启（可选双重令牌验证）

– 指令开启 – /logs 命令

– 权限控制 – 基于 ESX 权限组

– 现代化 UI – 卡片/表格双视图，支持图片预览

– 实时筛选 – 按类型、玩家、时间快速筛选

– 日志清理 – 自动/手动清理历史日志 🌐 网页管理面板

– 多用户登录 – 支持配置多个管理员账号

– 登录审计 – 记录登录 IP 地址和时间

– 响应式设计 – 完美适配手机和电脑

– 视图切换 – 卡片/表格样式自由切换 🤖 KOOK 机器人

– 实时推送 – 日志实时推送到指定频道

– 精美卡片 – 两列布局的彩色卡片消息

– 截图预览 – 自动上传并嵌入截图

– 分类频道 – 不同类型日志推送到不同频道

### 3️⃣ 智能截图系统

– 📸 自动截图 – 关键事件自动捕获游戏画面

– ☁️ 云端存储 – 使用 imgbb 图床，支持自定义过期时间

– 🖼️ 类型开关 – 独立控制各类型日志是否截图

– 🔗 外链访问 – 截图 URL 可在面板和 KOOK 中直接查看

### 4️⃣ KOOK 控制台（远程管理）

管理员可在 KOOK 频道发送指令，直接管理服务器：

“`

/restart [资源名]     – 重启资源

/start [资源名]       – 启动资源

/stop [资源名]        – 停止资源

/kick [ID] [原因]     – 踢出玩家

/ban [ID] [小时] [原因] – 封禁玩家

/say [消息]           – 发送公告

“`

安全特性：

– 仅指定 KOOK 用户可执行命令

– 命令执行结果实时反馈到频道

– 支持自定义轮询间隔

### 5️⃣ KOOK 白名单系统

自动化白名单流程：

1. 新玩家连接 → txAdmin 自动踢出并生成识别码

2. 玩家在 KOOK 频道发送识别码申请

3. 管理员打 ✅ 批准（或自动批准）

4. 玩家重新连接即可进服

功能亮点：

– 支持 auto 自动模式和 reaction 人工审核模式

– 申请消息自动清理

– 批准通知卡片自动删除

– 与 txAdmin 深度集成

### 6️⃣ 扩展集成 🔌 sh-lib 支持（可选）

– UseSHLib = true – 使用 sh-lib 的通知、UI 组件

– UseSHLib = false – 使用 ESX 原生通知，保持独立运行 🔧 txAdmin 集成

– 自动批准白名单

– 玩家踢出/封禁联动

– 服务器状态同步

## 🎯 技术优势

### 1. 高性能架构

– 异步数据库操作 – 使用 MySQL.Async，不阻塞主线程

– 智能缓存 – 统计数据缓存，减少数据库查询

– 分页加载 – 大量日志分页显示，流畅不卡顿

### 2. 安全可靠

– 权限分级 – 多层级权限控制

– 令牌验证 – F6 按键支持双重验证

– 登录审计 – 完整记录管理员登录行为

– SQL 注入防护 – 参数化查询，安全可靠

### 3. 灵活配置

– 模块化开关 – 各功能独立启用/禁用

– 自定义样式 – 支持自定义 KOOK 卡片颜色和图标

– 多语言支持 – 易于本地化扩展

### 4. 易于维护

– 自动清理 – 支持按时间自动清理旧日志

– 日志分类 – 管理员日志与普通日志分离

– 详细注释 – 代码注释清晰，易于二次开发

## 📊 适用场景

场景 功能应用 反作弊 金钱异常检测 + 截图证据 纠纷处理 物品/金钱日志追溯 管理审计 管理员操作全记录 玩家服务 白名单自动化处理 远程管理 KOOK 控制台 + 网页面板 证据留存 截图 + 详细日志卡片

## 🚀 快速对比

功能 SH-Logger 普通日志插件 游戏内面板 ✅ 现代化 UI ❌ 简陋或没有 网页后台 ✅ 完整功能 ❌ 多数没有 KOOK 推送 ✅ 精美卡片 ❌ 纯文本或没有 截图系统 ✅ 自动上传 ❌ 手动或无 白名单系统 ✅ KOOK 集成 ❌ 需单独插件 远程控制台 ✅ KOOK 执行 ❌ 不支持 物品动作细分 ✅ 8+ 种动作 ❌ 简单记录 视图切换 ✅ 卡片/表格 ❌ 单一视图

## 💡 为什么选择 SH-Logger？

1. 一体化解决方案 – 日志记录、管理面板、远程控制、白名单系统全部集成

2. 现代化体验 – 精美的 UI 设计，流畅的交互体验

3. 实时监控 – KOOK 推送让管理无处不在

4. 证据链完整 – 日志 + 截图，处理纠纷有据可依

5. 持续更新 – 融合 Resources 等优秀插件的优点，不断改进

SH-Logger – 让服务器管理更智能、更高效！