แถบความคืบหน้าใช้ได้ทุกเฟรมเวิร์ก ธีมพีช ยกเลิกด้วย ESC รองรับภาษาไทย ไฟล์เล็ก ไม่ต้อง build

---

ฟีเจอร์

• [+] ผู้เล่นกด ESC ยกเลิกได้เอง มี onCancel ให้สคริปต์รับต่อ
• [+] โชว์เวลาที่เหลือเป็นตัวเลข นับถอยหลังได้
• [+] ล็อกปุ่มลัดระหว่างแถบเดินอัตโนมัติ ผ่าน state bag และ event
• [+] ธีมพีช / เจด สลับตามธีมผู้เล่นตอนรัน
• [+] ฟอนต์ไทยฝังมาในตัว ข้อความไม่กลายเป็นกล่องสี่เหลี่ยม
• [+] ไฟล์เล็ก ไม่ต้อง build ลงแล้วใช้ได้เลย
• [+] สคริปต์เก่าที่เรียก esx_progressbar ใช้ต่อได้ ไม่ต้องแก้สักตัว
• [+] ไม่พึ่ง ESX.PlayerData จึงไม่ error ตอนเซิร์ฟเวอร์เพิ่งบูต
• [+] ใช้ได้กับ ESX, standalone หรือเฟรมเวิร์กอื่น

---

ลงยังไง

ensure x3d_progressbar

เอา esx_progressbar ตัวเดิมออกก่อน — สองตัวเปิด NUI ซ้อนกัน

มีสคริปต์เก่าเรียก exports['esx_progressbar'] อยู่? ย้าย optional/esx_progressbar/ ออกมาไว้ใน resources/ แล้ว ensure ต่อจาก x3d_progressbar เป็นตัวส่งต่อ 12 บรรทัด ไม่ต้องแก้สคริปต์เก่าสักตัว

ensure x3d_progressbar
ensure esx_progressbar      # เฉพาะเมื่อมีสคริปต์เก่าเรียกชื่อนี้

ใช้ยังไง

exports['x3d_progressbar']:Progressbar('กำลังซ่อมรถ...', 15000, {
    FreezePlayer  = true,
    animation     = { type = 'anim', dict = 'mini@repair', lib = 'fixing_a_ped' },
    onFinish      = function() print('เสร็จ') end,
    onCancel      = function() print('ยกเลิก') end,
    showCountdown = true,
})

exports['x3d_progressbar']:CancelProgressbar()

ผู้เล่นกด ESC ยกเลิกได้เอง onCancel จะถูกเรียก

รู้ว่ามีแถบกำลังทำงานอยู่

ระหว่างแถบเดิน ตัวนี้ตั้ง state bag ไว้ให้ อ่านจากที่ไหนก็ได้

if LocalPlayer.state.minigame then return end   -- กันเปิดกระเป๋าระหว่างทำอย่างอื่น

และยิง event ให้ด้วย ถ้าอยากผูกกับ HUD หรือ inventory ของตัวเอง

AddEventHandler('x3d_progressbar:active', function(active) ... end)

ที่มาและใบอนุญาต

ต่อยอดจาก esx_progressbar ของโปรเจกต์ ESX Legacy Copyright (C) 2022-2024 ESX-Framework · สัญญาอนุญาต GNU GPL v3

Modifications Copyright (C) 2026 X3D-Developer

แจกจ่ายต่อได้ภายใต้ GPL v3 เท่านั้น — ต้องเปิดซอร์ส เก็บประกาศลิขสิทธิ์เดิมไว้ และระบุว่าแก้อะไรไปบ้าง ไฟล์ LICENSE อยู่ในโฟลเดอร์นี้

แก้อะไรไปบ้าง (GPL-3.0 §5a)

Modified 2026 by X3D-Developer, based on esx_progressbar 1.13.4.

• ยกเลิกด้วย ESC — ของเดิมยกเลิกเองไม่ได้ ต้องรอจนครบเวลา
• onCancel เรียกเมื่อถูกยกเลิก (ของเดิมมีแค่ onFinish)
• showCountdown โชว์เวลาที่เหลือเป็นตัวเลข
• ล็อกปุ่มลัดระหว่างทำงาน ผ่าน state bag minigame + event x3d_progressbar:active
• ธีมพีช/เจด สลับตามธีมผู้เล่นตอนรันไทม์
• ฟอนต์ไทยฝังมาในตัว (Noto Sans Thai) ข้อความไม่กลายเป็นกล่องสี่เหลี่ยม
• กัน ESX.PlayerData.ped เป็น nil ตอนยังโหลดไม่เสร็จ (ของเดิม error ตอนบูต)
• fx_version จาก adamant เป็น cerulean