🇫🇷 🇬🇧 🇺🇸 🇨🇳 🇪🇦 🇮🇹 🇯🇵 🇹🇳 🇷🇺

Документация MultiChest

🔹 Введение 🔹

📢 Добро пожаловать в документацию MultiChest

MultiChest — это скрипт, разработанный для предоставления игрокам системы безопасных сундуков в FiveM. Будь то хранение ценных предметов в банке или настройка определённых местоположений, этот инструмент обогащает RP-опыт, позволяя интуитивно и безопасно управлять имуществом игроков.

Защищённый FiveM Escrow, MultiChest предлагает чрезвычайно детализированную настройку через файл config.lua. Вы можете настроить маркеры, уведомления, вебхуки и многое другое, сохраняя при этом безопасность нашего исходного кода. 🚀

⚙️ Предварительные требования

Чтобы обеспечить правильную работу 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. Он управляет отображением визуальных маркеров и индикаторов на карте (блипов), а также взаимодействием игрока при приближении.

🔧 Подробности:

▪️ Для каждой позиции, определённой в Config.CoffreLocations, добавляются настраиваемые блипы (иконка, размер, цвет, метка) на карту.
▪️ Визуальные маркеры отображаются в соответствии с параметрами, указанными в Config.Marker (тип, цвет, размер, вращение и т.д.).
▪️ Интерактивные зоны обнаруживают присутствие игрока и позволяют взаимодействовать с помощью клавиши [E].

Эта настройка обеспечивает immersive и плавный опыт для поиска и взаимодействия с сундуками в игре. ➡️

🔓 Открытие главного меню

Этот модуль отображает контекстное меню, позволяющее игроку получить доступ к существующим сундукам или арендовать новый, в зависимости от его близости к точке взаимодействия.

🔧 Подробности:

▪️ Скрипт определяет ближайший банк, сравнивая координаты игрока с координатами, заданными в 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 = "[Сундук]",
}

Блипы — это иконки, отображаемые на карте для указания местоположения сундуков. Этот раздел позволяет настроить их по вашему усмотрению.

🔧 Доступные опции:

▪️ 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: URL вебхука Discord.
▪️ 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: Интервал между сборами (в часах).

Симулируйте реалистичную экономику! 💸

Developpeur Web - Lua - Fivem

Документация MultiChest

🔹 Введение

🔹 Принципы

🔹 Файл конфигурации

🔹 Введение 🔹

📢 Добро пожаловать в документацию MultiChest

⚙️ Предварительные требования

📚 База данных

🔹 Принципы 🔹

➡️ Предварительная загрузка точек

🔓 Открытие главного меню

🛒 Открытие меню покупки сундуков

📦 Открытие меню сундуков игрока

📋 Открытие меню инвентаря (OX_Inventory)

🔹 Файл конфигурации 🔹

🎨 Настройка маркеров

📍 Настройка блипов

🔔 Настройка уведомлений

🌐 Настройка Webhook

✏️ Настройка текстов

🔒 Настройка ограничений

📌 Настройка местоположений

📦 Настройка сундуков

💰 Настройка налогов