Découvrez notre jeu  Défis Quiz !

Developpeur Web - Lua - Fivem

 GUEST-P02ZNSSOW2

🔹 引言 🔹



📢 欢迎体验 MultiChest 文档


MultiChest 是一个专为 FiveM 设计的脚本,旨在为玩家提供一个安全的保险箱系统。无论是将珍贵物品存储在银行中,还是自定义特定位置,这个工具通过直观且安全的管理方式,丰富了玩家的角色扮演体验。

MultiChest 通过 FiveM Escrow 保护,提供基于 config.lua 文件的高度详细配置。您可以自定义标记、通知、Webhook 等内容,同时确保源代码的安全性。🚀


⚙️ 前提条件


为确保 MultiChest 正常运行,请确保您的服务器已安装以下资源:

▪️ es_extended
▪️ ox_lib
▪️ ox_inventory
▪️ oxmysql


📚 数据库


                        
CREATE TABLE IF NOT EXISTS `user_chest` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `owner` varchar(50) NOT NULL,
  `name` varchar(50) NOT NULL,
  `name_chest` varchar(100) NOT NULL,
  `name_bank` varchar(100) NOT NULL,
  `weight` int(11) NOT NULL,
  `password` varchar(100) NOT NULL,
  PRIMARY KEY (`id`),
  INDEX `owner_index` (`owner`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
                        
                    

程序启动时,MultiChest 会自动创建所需的数据库。

ℹ️ 信息:

▪️ id:保险箱的标识符,每次新增时自动递增。
▪️ owner:保险箱所有者的标识符。
▪️ name:对应玩家选择的保险箱类型。
▪️ name_chest:玩家为保险箱自定义的名称。
▪️ name_bank:保险箱关联的银行名称。
▪️ weight:保险箱的承载容量。
▪️ password:玩家选择的密码。


🔹 原理 🔹


➡️ 预加载点位


该模块根据 Config.CoffreLocations 中定义的参数配置保险箱的交互点。它负责显示视觉标记和地图上的指示图标(blips),并处理玩家靠近时的交互。

🔧 详情:

▪️ 为 Config.CoffreLocations 中定义的每个位置添加可自定义的地图标记(图标、大小、颜色、标签)。
▪️ 根据 Config.Marker 的参数显示视觉标记(类型、颜色、大小、旋转等)。
▪️ 创建交互区域,检测玩家靠近并允许通过 [E] 键进行交互。

此配置为玩家提供沉浸式且流畅的体验,帮助他们定位并与保险箱交互。➡️


🔓 打开主菜单


该模块显示一个上下文菜单,允许玩家根据其与交互点的距离访问已有保险箱或租赁新保险箱。

🔧 详情:

▪️ 脚本通过比较玩家坐标与 Config.CoffreLocations 中的坐标,识别最近的银行。
▪️ 检查玩家是否已在该银行拥有保险箱。
     ▫️ 如果是,则提供访问保险箱的选项。
     ▫️ 如果否,则仅显示租赁选项。
▪️ 显示交互式上下文菜单,提供可用的操作选项。

此功能为玩家提供直观且根据位置适配的保险箱管理界面。🔓


🛒 打开购买保险箱菜单


该模块允许玩家通过输入界面选择并租赁当前银行可用的保险箱,定义名称和密码。

🔧 详情:

▪️ 从 Config.Coffres 中筛选出与玩家所在银行匹配的保险箱,显示名称、价格、税费(基于重量)、最大重量和槽位数。
▪️ 通过对话框收集保险箱的名称和密码。
▪️ 触发事件,将信息传递给服务器以完成租赁。
▪️ 如果没有可用保险箱,则在菜单中显示错误消息。

此清晰高效的界面满足每个银行的保险箱租赁需求。🛒


📦 打开玩家保险箱菜单


该模块显示玩家在对应银行租赁的所有保险箱列表,并提供打开、重命名、修改密码或删除保险箱的选项。

🔧 详情:

▪️ 如果玩家没有保险箱,则显示错误通知。
▪️ 根据玩家位置识别当前银行。
▪️ 上下文菜单列出每个保险箱的名称(未定义时使用默认名称)。
▪️ 为每个保险箱提供子菜单,包含选项:通过密码打开、更改密码、重命名或删除。

此功能提供全面且安全的界面,帮助玩家跟踪和管理其保险箱。📦


📋 打开库存菜单 (ox_inventory)


该模块基于 ox_inventory 打开特定保险箱的库存,显示并管理其中的物品。

🔧 详情:

▪️ 通过 ox_inventory 获取所选保险箱,玩家可直接访问其内容。

此功能确保保险箱库存管理的流畅性和集成性,优化用户体验。📋


🔹 配置文件 🔹


🎨 标记设置


                        
Config.Marker = {
    id_type = 27,
    size_x = 0.3,
    size_y = 0.3,
    size_z = 0.3,
    color_red = 0,
    color_green = 150,
    color_blue = 150,
    color_opacity = 100,
    rotate = true,
}
                        
                    

本节允许您自定义游戏中指示保险箱位置的视觉标记,这些标记是玩家的交互点。

🔧 可选参数:

▪️ id_type:标记类型(参考 FiveM 文档中的 ID)。
▪️ size_x, size_y, size_z:标记尺寸(长、宽、高)。
▪️ color_red, color_green, color_blue:RGB 颜色 (0-255)。
▪️ color_opacity:透明度 (0-255)。
▪️ rotate:启用/禁用旋转 (true/false)。

调整标记以完美融入您的服务器!🎯


📍 地图标记设置


                        
Config.Blips = {
    activ_blips = true,
    icon = 272,
    display = 4,
    scale = 0.7,
    color = 2,
    activ_text_on_blip_bank_name = false,
    txt_blip_intro_bank_name = "[保险箱]",
    txt_blip_intro_simple = "[保险箱]",
}
                        
                    

地图标记(blips)是地图上用于定位保险箱的图标。本节允许您根据需要进行配置。

🔧 可选参数:

▪️ activ_blips:启用/禁用地图标记 (true/false)。
▪️ icon:图标 ID(参考 FiveM 文档)。
▪️ display:显示类型 (4 = 地图 + 小地图)。
▪️ scale:标记大小。
▪️ color:颜色(参考 FiveM 文档)。
▪️ activ_text_on_blip_bank_name:显示银行名称。
▪️ txt_blip_intro_bank_name, txt_blip_intro_simple:标记文本。

自定义标记以有效引导玩家!🗺️


🔔 通知设置


                        
Config.Notifications = {
    position_error = "center-left",
    duration_error = 5000,
    position_success = "center-left",
    duration_success = 5000,
    position_warning = "center-left",
    duration_warning = 5000,
}
                        
                    

通知用于告知玩家与保险箱相关的操作或错误。调整其位置和持续时间以提升体验。

🔧 可选参数:

▪️ position_error, position_success, position_warning:屏幕位置。
▪️ duration_error, duration_success, duration_warning:持续时间(毫秒)。

确保消息清晰且位置恰当!📢


🌐 Webhook 设置


                        
Config.Webhook = {
    webhook_use_only_one_logo = false,
    webhook_logo_defaut = "https://www.heickotv.xyz/multichest/multichest.png",
    webhook_logo_fleeca_bank = "https://www.heickotv.xyz/multichest/fleeca_bank.png",
    webhook_logs_activation = true,
    webhook_link_log = "https://discord.com/api/webhooks/...",
    txt_log_title_for_buy = "保险箱租赁",
    txt_log_for_buy = "已租赁",
    color_code_for_buy = 65280,
}
                        
                    

Webhook 将保险箱相关操作(购买、修改、删除)的日志发送到 Discord。

🔧 可选参数:

▪️ webhook_use_only_one_logo:使用单一图标或按银行区分。
▪️ webhook_logo_defaut, webhook_logo_fleeca_bank 等:图标 URL。
▪️ webhook_logs_activation:启用日志。
▪️ webhook_link_log:Discord Webhook URL。
▪️ txt_log_title_for_buy 等:日志标题和文本。
▪️ color_code_for_buy 等:嵌入颜色。

通过 Discord 监控活动!🔗


✏️ 文本设置


                        
Config.Text = {
    txt_button = "[E] - 管理保险箱",
    txt_first_head_menu = "保险箱管理 -",
    txt_my_chest = "📦 我的保险箱 -",
    txt_access_chest = "📦 访问我的保险箱",
    -- (完整列表在 config.lua 中)
}
                        
                    

自定义界面和通知中显示的所有文本,以实现完全沉浸式体验。

🔧 可选参数:

▪️ txt_button:交互按钮文本。
▪️ txt_first_head_menu:菜单标题。
▪️ txt_my_chest:个人保险箱标签。

根据您的社区调整语言!📝


🔒 限制设置


                        
Config.Limit = {
    chest_limit_per_player = 15,
}
                        
                    

定义玩家可拥有的保险箱数量上限。

🔧 可选参数:

▪️ chest_limit_per_player:最大保险箱数量。

平衡经济和游戏性!⚖️


📌 位置设置


                        
Config.CoffreLocations = {
    { coords = vector3(251.24, 220.82, 106.35), 
      bank_type = "FleecaBank", 
      bank_name = "Pacific Bank - Vinewood Blvd." },
    -- (完整列表在 config.lua 中)
}
                        
                    

添加玩家可与保险箱交互的位置。

🔧 可选参数:

▪️ coords:坐标 (x, y, z)。
▪️ bank_type:银行类型 (FleecaBank, Mazebank 或 SavingBank)。
▪️ bank_name:银行名称。

将保险箱放置在您想要的位置!📍


📦 保险箱设置


                        
Config.Coffres = {
    { name = "小型保险箱", 
      weight = 50000, 
      price = 1000, 
      nb_slot = 10, 
      bank_name = "Pacific Bank - Vinewood Blvd." },
    -- (完整列表在 config.lua 中)
}
                        
                    

定义可供租赁的保险箱类型。

🔧 可选参数:

▪️ name:保险箱名称。
▪️ weight:容量(克)。
▪️ price:租赁价格。
▪️ nb_slot:槽位数量。
▪️ bank_name:关联银行。

为玩家提供多样化的保险箱选择!🎁


💰 税费设置


                        
Config.Taxes = {
    enable = true,
    percent = 2.0,
    nb_hour_between_two_samples = 6,
}
                        
                    

为租赁的保险箱添加税费系统。

🔧 可选参数:

▪️ enable:启用/禁用税费。
▪️ percent:税费百分比。
▪️ nb_hour_between_two_samples:两次收取间隔(小时)。

模拟真实的经济发展!💸

SUIVEZ-NOUS !
Discord Twitter Instagram Facebook

Classement
Règlement
 
 
 
Inscription
Connexion
 
 
 
Discord
X (Twitter)
Instagram
Facebook