เอกสาร

X3D Vault (ตู้เซฟแก๊ง)

ตู้เซฟ ESX ใช้หน้าจอกระเป๋า x3d_inventory ตู้ส่วนตัวมีเลเวล แชร์ให้เพื่อน ตู้หน่วยงานตามอาชีพ ฟรี

ซื้อ / รับฟรีตั้งค่า config

การติดตั้ง

  1. วางโฟลเดอร์ x3d_vault ใน resources/
  2. รัน install.sql (สร้างตาราง x3d_vault, x3d_vault_storage และไอเทม card_safe)
  3. ใน server.cfg ให้ ensure x3d_inventory ก่อน แล้วค่อย ensure x3d_vault
  4. ตั้งตำแหน่งตู้ใน config/VAULT/config.group.lua (ตู้ส่วนตัว) และ config/VAULT/config.society.lua (ตู้หน่วยงาน)

ต้องมี

ต้องมี หมายเหตุ
ESX Legacy (es_extended) ใช้ @es_extended/imports.lua
oxmysql
x3d_inventory คลังตู้เซฟใช้หน้าจอของกระเป๋านี้ (ฟรีในร้าน X3D)

ตั้งค่าหลัก (config/config.general.lua)

ค่า ใช้ทำอะไร
Config.Locale 'th' หรือ 'en'
Config.VaultNameTagLength ความยาวรหัสตู้ (3–6)
Config.CloseEvents อีเวนต์ฝั่ง client ของสคริปต์อื่นที่ให้ปิดตู้ทันที

Vault types

ตู้แต่ละแบบเป็นหนึ่งก้อนใน Config.GroupVault (ส่วนตัว) หรือ Config.SocietyVault (หน่วยงาน)

ช่อง ใช้ทำอะไร
name ชื่อประเภทตู้ที่ผู้เล่นเห็น
max_level / exp_per_lvl เลเวลสูงสุด และ EXP ต่อเลเวล (ตู้ส่วนตัว)
lvl_permission[level] slot, weight, total_*_limit (-1 = ไม่จำกัด), allow_accounts/items/weapons, shareable
allowed_list accounts/items/weapons แต่ละอัน type = 'whitelist' | 'blacklist' + list
upgrade_items ของที่ใช้เพิ่ม EXP เช่น { type = 'item', name = 'card_safe', exp = 1000 }
open_vault_option / create_vault_option ของที่ต้องมีเพื่อเปิด/สร้างตู้ (เว้นว่าง = ไม่ต้องใช้)
allowed_jobs อาชีพที่เปิดตู้หน่วยงานได้
zone.blip / zone.text blip บนแผนที่ และป้ายเหนือตู้
zone.locations ตำแหน่งตู้: model, coords, heading, action_radius (ระยะกด E)
max_vault_per_player / can_remove จำนวนตู้ต่อคน และให้ลบตู้เองได้ไหม

ต่อกับระบบของคุณ

  • addons/hooks/client.lua → Hooks.OpenGuide(reopen, isOpen) เปิดคู่มือจากปุ่ม [?] (ปล่อย nil = ซ่อนปุ่ม)
  • addons/text3d/client.lua ป้ายเหนือตู้ (native + ฟอนต์ไทย) แทนที่ด้วยระบบป้ายของคุณเองได้

exports (server)

  • GetPlayerVaults(identifier) รายชื่อตู้ที่ผู้เล่นเป็นเจ้าของหรือได้รับแชร์
  • GetVaultData(group, nameTag, identifier) / CanAccessVault(vault, identifier)
  • DepositItems(identifier, group, nameTag, items) ฝากของเข้าตู้ คืนรายการที่ฝากไม่ได้
ดูหน้าสินค้า