[QBCore&ESX]支持扩展榜单的财富榜

[QBCore&ESX]支持扩展榜单的财富榜

$50.00

Add to Basket

财富榜插件 (LiuWan_caifu)

一款功能强大、界面美观的FiveM财富排行榜插件，支持ESX Legacy和QBCore双框架。

✨ 特性

  • 🎮 双框架支持：自动检测并支持ESX Legacy和QBCore框架

  • 📊 多榜单系统：现金榜、银行榜、总财富榜，可扩展自定义财富类型

  • 🎨 美观UI设计：浅色系主题 + 左侧竖向侧边栏导航，榜单再多也不挤

  • 🏆 领奖台展示：前三名以领奖台形式突出呈现，其余排名列表跟随其下

  • ⚡ 全自动更新：服务端定时刷新缓存，无需手动操作

  • 🌐 多语言支持：内置中文和英文

  • 🔧 高度可配置：丰富的配置选项，轻松自定义

📦 安装

  1. 下载插件并解压到服务器的 resources 目录

  2. 确保你已安装以下依赖：

   - oxmysql

   - es_extended (如果使用ESX) 或 qb-core (如果使用QBCore)

  1. 在 server.cfg 中添加：

ensure oxmysql

ensure es_extended  # 或 ensure qb-core

ensure LiuWan_caifu

🎮 使用方法

玩家命令

  • /caifu - 打开财富排行榜界面

操作说明

  • 点击左侧边栏导航切换不同榜单

  • 前三名以领奖台形式展示，其余排名在下方列表滚动查看

  • 榜单数据由系统定时自动更新，无需手动操作

  • 按 ESC 键或点击右上角 ✕ 关闭界面

⚙️ 配置

基础配置

编辑 config.lua 文件：


Config.Command = 'caifu' -- 打开财富榜的指令

Config.Framework = 'auto' -- 框架：'esx', 'qbcore', 或 'auto'(自动检测)

Config.DisplayLimit = 20 -- 每个榜单显示的玩家数量

Config.RefreshInterval = 300000 -- 数据刷新间隔（毫秒）

Config.Locale = 'zh' -- 语言：'zh' 中文, 'en' 英文

榜单配置

启用或禁用特定榜单：


Config.Leaderboards = {

    cash = {

        enabled = true, -- 启用现金榜

        name = '现金榜',

        icon = 'wallet',

        description = '根据玩家身上携带的现金排名'

    },

    bank = {

        enabled = true, -- 启用银行榜

        name = '银行榜',

        icon = 'landmark',

        description = '根据玩家银行存款排名'

    },

    total = {

        enabled = true, -- 启用总财富榜

        name = '总财富榜',

        icon = 'crown',

        description = '根据玩家总财富排名'

    }

}

图标说明：icon 字段填图标名称，界面会渲染成统一的线性描边矢量图标。

可用图标：crown 皇冠、wallet 钱包、landmark 银行、truck 卡车、coins 硬币、banknote 钞票、gem/diamond 宝石、star 星星、trophy 奖杯、briefcase 公文包、gift 礼物、car 汽车、home 房产、chart 图表。

若填写的名称不存在，会自动回退到 chart 图标。

自定义财富类型

在 Config.CustomWealth 中添加自定义财富榜单：

示例1：ESX黑钱榜


Config.CustomWealth = {

    ['black_money'] = {

        enabled = true,

        name = '黑钱榜',

        icon = 'banknote',

        description = '根据玩家黑钱数量排名',

        esx = {

            table = 'user_accounts',

            moneyColumn = 'money',

            identifierColumn = 'identifier',

            whereClause = "name = 'black_money'"

        },

        qbcore = {

            table = 'players',

            customQuery = [[

                SELECT citizenid as identifier,

                       CAST(JSON_EXTRACT(money, '$.black_money') AS UNSIGNED) as amount

                FROM players

                ORDER BY amount DESC

                LIMIT ?

            ]]

        }

    }

}

示例2：自定义积分系统


Config.CustomWealth = {

    ['points'] = {

        enabled = true,

        name = '积分榜',

        icon = 'star',

        description = '根据玩家积分排名',

        esx = {

            table = 'user_data',

            moneyColumn = 'points',

            identifierColumn = 'identifier'

        },

        qbcore = {

            table = 'player_data',

            moneyColumn = 'points',

            identifierColumn = 'citizenid'

        }

    }

}

🔌 API 导出

服务端导出

获取指定榜单数据


-- 获取榜单数据

-- leaderboardType: 'cash', 'bank', 'total', 或自定义类型名称

local data = exports['LiuWan_caifu']:getLeaderboard('total')




-- 返回格式：

-- {

--     {rank = 1, identifier = 'xxx', name = '玩家名', amount = 1000000},

--     {rank = 2, identifier = 'yyy', name = '玩家名', amount = 500000},

--     ...

-- }

手动更新榜单


-- 强制更新所有榜单数据

exports['LiuWan_caifu']:updateLeaderboards()

📁 文件结构


LiuWan_caifu/

├── fxmanifest.lua       # 资源清单

├── config.lua           # 配置文件

├── README.md            # 说明文档

├── client/

│   └── main.lua        # 客户端脚本

├── server/

│   └── main.lua        # 服务端脚本

└── html/

    ├── index.html      # UI界面

    ├── style.css       # 样式文件

    └── script.js       # 前端逻辑

🗄️ 数据库兼容性

ESX Legacy

  • 玩家数据表：users

  • 账户表：user_accounts

  • 标识符：identifier

QBCore

  • 玩家数据表：players

  • 标识符：citizenid

  • 数据格式：JSON字段 (money, charinfo)

🐛 故障排除

问题1：界面无法打开

  • 检查控制台是否有错误信息

  • 确认框架是否正确加载

  • 验证 oxmysql 是否已启动

问题2：数据不显示

  • 检查数据库连接是否正常

  • 确认数据库表结构是否正确

  • 查看服务端控制台的错误日志

问题3：框架检测失败

  • 在 config.lua 中手动指定框架：

Config.Framework = 'esx'  -- 或 'qbcore'

问题4：自定义财富榜不显示

  • 检查自定义配置中的表名和字段名是否正确

  • 确认 enabled 设置为 true

  • 验证数据库查询语句是否正确

📝 更新日志

v1.1.0 (2026-07-24)

  • 🎨 全新界面：左侧竖向导航侧边栏，榜单增多也能从容扩展

  • 🏆 前三名领奖台展示，其余名次以卡片列表呈现

  • ⚡ 数据完全自动更新，移除手动刷新按钮与相关流程

  • 💫 升级浅色视觉：玩家头像占位、悬浮动效、自动更新脉冲指示

v1.0.0 (2026-06-14)

  • ✨ 初始版本发布

  • 🎮 支持ESX Legacy和QBCore双框架

  • 📊 实现现金榜、银行榜、总财富榜

  • 🎨 美观的浅色系UI设计

  • 🔧 可扩展的自定义财富类型

  • 🌐 中英文双语支持

💡 技术支持

如遇到问题或有建议，请联系开发者。

开发者: 六万  

版本: 1.1.0  

最后更新: 2026-07-24