example
example

资源 [免费]🔥𝗬𝗮𝗻𝘁𝗼🔥 头像系统 | 集中管理你的 FiveM 玩家头像插件 ESX | QBCore

YANTO

新用户
高级用户
认证用户
黄金
0.00 黄金

🔥𝗬𝗮𝗻𝘁𝗼🔥 头像系统​


GITHUB: Github 下载链接

预览链接为[LuxuAvatars]:预览

致敬原作者​

本插件基于 LuxuAvatars 开发。在此向原作者表示诚挚的感谢!

关于多版本兼容​

在中文 FiveM 社区中,许多创作者基于 LuxuAvatars 开发了自己的插件,但修改了资源名称和数据库表结构。这导致服务器所有者在购买和使用这些修改后的插件时,难以同步和管理之前的头像数据。

为解决这个问题,本插件特别设计了多资源名称和多数据库表兼容功能,支持:

  • 多种资源名称:Yanto_Avatars、Moonlight_Avatars、LuxuAvatars
  • 多种数据库表:yanto_avatars、moonlight_avatars、luxu_avatars
这样,无论您使用哪个版本的头像插件,都可以无缝切换和同步数据。

数据同步功能​

本插件支持在启动时自动同步所有配置的数据库表中的数据。您可以在配置文件中选择需要同步的数据表,并设置同步方向:

  • newest:使用所有表中最新的数据
  • primary:以主表为准
如果您需要同步其他插件的数据表,只需在配置文件中添加相应的表名即可。如果您使用的插件数据表不在预设列表中,您可以:

  1. 联系作者更新插件
  2. 自己学习代码结构并添加自定义数据表(本插件是开源的)

交流讨论​

欢迎加入 QQ 群 1045292696 一起讨论交流!

这是什么 🤔?​

这个FiveM资源使开发者能够将所有玩家头像插件集中在一个脚本统一内管理的插件。

为什么需要这个 🤨?​

越来越多的资源包含玩家个人资料图片,并以独特的方式存储它们,这可能会给访问它们用于其他资源带来挑战。

它是如何工作的 🦊?​

这个资源通过提供一个专用脚本来解决这个问题,该脚本允许玩家更改他们的个人资料图片。这种更改将与所有利用这些导出功能的其他资源同步,使管理玩家头像变得更加简单和高效。

多插件兼容性​

本插件支持多种资源名称,以兼容不同的插件:

  • Yanto_Avatars(主资源)
  • Moonlight_Avatars(桥接资源)
  • LuxuAvatars(桥接资源)
您可以使用任何一个资源名称来调用相同的导出函数,这使得您的插件可以与依赖不同资源名称的其他插件无缝兼容。

此外,本插件还支持将头像数据同步保存到多个数据库表中,以兼容不同的插件:

  • yanto_avatars
  • moonlight_avatars
  • luxu_avatars
您可以在配置文件中选择需要同步的数据库表。

1746191533555.png

贡献并使其更好 🌐

这将只会像社区希望的那样好。 考虑在github上贡献代码。

[依赖项]​

[安装]​

  1. 创建以下文件夹:
    • Yanto_Avatars(主资源)
    • Moonlight_Avatars(桥接资源)
    • LuxuAvatars(桥接资源)
  2. 将主资源的所有内容放入 Yanto_Avatars 文件夹中。
  3. 将桥接资源的文件放入相应的文件夹中:
    • Moonlight_Avatars/fxmanifest.lua
    • Moonlight_Avatars/client.lua
    • Moonlight_Avatars/server.lua
    • LuxuAvatars/fxmanifest.lua
    • LuxuAvatars/client.lua
    • LuxuAvatars/server.lua
  4. 将所有文件夹复制到您的 resources 文件夹中。
  5. 在 server.cfg 中添加以下内容: ``` ensure Yanto_Avatars ensure Moonlight_Avatars ensure LuxuAvatars ```

[导出]​

您可以使用以下任何一个资源名称来调用导出函数:

  • Yanto_Avatars
  • Moonlight_Avatars
  • LuxuAvatars
客户端

Lua:
 -- 获取玩家头像 | 返回字符串或nil exports.Yanto_Avatars:GetCurrentPlayerAvatar() -- 或者 exports.Moonlight_Avatars:GetCurrentPlayerAvatar() -- 或者 exports.LuxuAvatars:GetCurrentPlayerAvatar()

-- 获取所有玩家头像 | 返回表或nil exports.Yanto_Avatars:GetAllPlayersAvatars() -- 或者 exports.Moonlight_Avatars:GetAllPlayersAvatars() -- 或者 exports.LuxuAvatars:GetAllPlayersAvatars()

服务器端

Lua:
 -- 获取玩家头像 | 返回字符串或nil exports.Yanto_Avatars:GetPlayerAvatar(playerSRC) -- 或者 exports.Moonlight_Avatars:GetPlayerAvatar(playerSRC) -- 或者 exports.LuxuAvatars:GetPlayerAvatar(playerSRC)

-- 获取所有玩家头像 | 返回表或nil exports.Yanto_Avatars:GetAllPlayersAvatars() -- 或者 exports.Moonlight_Avatars:GetAllPlayersAvatars() -- 或者 exports.LuxuAvatars:GetAllPlayersAvatars()

-- 更新玩家头像 exports.Yanto_Avatars:UpdatePlayerAvatar(playerSRC,avatar) -- 或者 exports.Moonlight_Avatars:UpdatePlayerAvatar(playerSRC,avatar) -- 或者 exports.LuxuAvatars:UpdatePlayerAvatar(playerSRC,avatar)

[配置]​

Lua:
 Config.ProfileMenuCommand = "avatar" -- 打开个人资料菜单的命令,设置为false禁用

--[[ 默认图像路径 ]] Config.DefaultImg = { type = 'file', -- "file" - 文件路径, "url" - 网址链接 link = "/web/imgs/default.jpg" }

Config.UseMySQL = true -- 设置为true使用MySQL数据库,否则使用本地JSON文件

-- 数据库同步设置 Config.DatabaseSync = { -- 预设数据表 yanto_avatars = true, -- 同步到 yanto_avatars 表 moonlight_avatars = true, -- 同步到 moonlight_avatars 表 luxu_avatars = true, -- 同步到 luxu_avatars 表

-- 自定义数据表 (示例)<br>-- custom_avatars = true, -- 同步到 custom_avatars 表<br><br>-- 添加更多自定义数据表...<br>

}

-- 数据同步设置 Config.SyncOnStartup = true -- 在启动时自动同步所有数据表中的数据 Config.SyncDirection = "newest" -- 同步方向: "newest" - 使用最新的数据, "primary" - 以主表为准

-- 主数据表 (当 SyncDirection 为 "primary" 时使用) Config.PrimaryTable = "yanto_avatars"

--[[ 框架专属设置 ]] -- 这些选项仅在定义了Config.Framework时有效

Config.Framework = 'qb' -- "qb" - QBCore框架, "esx" - ESX框架, false - 不使用框架 Config.ESX_VERSION = "legacy" -- "legacy" - ESX Legacy版本, "old" - 旧版ESX

Config.CharacterExclusive = true -- 设置为true让每个玩家角色拥有自己的头像

[添加自定义数据表]​

如果您需要添加自定义数据表,请按照以下步骤操作:

  1. 创建数据库表(确保表结构与预设表相同): ```sql CREATE TABLE 自定义表名 ( key int(11) NOT NULL AUTO_INCREMENT, identifier varchar(100) NOT NULL, avatar varchar(255) NOT NULL, history LONGTEXT NOT NULL DEFAULT '{}', PRIMARY KEY (key) ) ENGINE=InnoDB DEFAULT CHARSET=UTF8; ```
  2. 在配置文件中添加自定义表: ```lua Config.DatabaseSync = { -- 预设数据表 yanto_avatars = true, moonlight_avatars = true, luxu_avatars = true,

    -- 自定义数据表 自定义表名 = true, } ```
  3. 重启资源,系统将自动检测并同步自定义表中的数据。

[可选SQL]​

您可以根据需要创建以下任何一个或多个数据库表:

SQL:
-- yanto_avatars 表 
CREATE TABLE yanto_avatars ( key int(11) NOT NULL AUTO_INCREMENT, identifier varchar(100) NOT NULL, avatar varchar(255) NOT NULL, history LONGTEXT NOT NULL DEFAULT '{}', PRIMARY KEY (key) ) ENGINE=InnoDB DEFAULT CHARSET=UTF8;

-- moonlight_avatars 表 
CREATE TABLE moonlight_avatars ( key int(11) NOT NULL AUTO_INCREMENT, identifier varchar(100) NOT NULL, avatar varchar(255) NOT NULL, history LONGTEXT NOT NULL DEFAULT '{}', PRIMARY KEY (key) ) ENGINE=InnoDB DEFAULT CHARSET=UTF8;

-- luxu_avatars 表 
CREATE TABLE luxu_avatars ( key int(11) NOT NULL AUTO_INCREMENT, identifier varchar(100) NOT NULL, avatar varchar(255) NOT NULL, history LONGTEXT NOT NULL DEFAULT '{}', PRIMARY KEY (key) ) ENGINE=InnoDB DEFAULT CHARSET=UTF8;

链接 🔗

  • 🔥𝗬𝗮𝗻𝘁𝗼🔥 开发
  • QQ群: 1045292696
 
由版主最后编辑:
YANTO

还可以输入20字数。
领取红包用户
B FWL 4ak6 slook xieron S
感谢楼主的红包!

FWL领取了您的红包获得了0.10黄金
 
感谢楼主的红包!

4ak6领取了您的红包获得了0.53黄金
 
感谢楼主的红包!

slook领取了您的红包获得了0.57黄金
 
感谢楼主的红包!

xieron领取了您的红包获得了0.31黄金
 
后退
顶部