X3D DeveloperX3D Developer
ติดต่อ Discord
24/09/2026

ESX Legacy (es_extended) คืออะไร ติดตั้งและอัปเดตยังไง คู่มือไทย 2026

ESX Legacy (es_extended) คือเฟรมเวิร์ก RP ที่เซิฟ FiveM ไทยใช้มากที่สุด บทความนี้อธิบายโครงสร้าง es_extended ตารางฐานข้อมูล ลำดับ ensure ใน server.cfg การอัปเดตโดยไม่พังสคริปต์เดิม ปัญหาที่พบบ่อยของ 1.13.x และทางเลือก ESX Legacy Core X3D Build ที่วางทับได้ฟรี

ESX Legacy คือเฟรมเวิร์ก roleplay สำหรับ FiveM ที่พัฒนาต่อจาก ESX ดั้งเดิม ตัว core ชื่อ es_extended เป็น resource ที่ทุกสคริปต์ RP บนเซิฟ ESX เรียกใช้ ทั้งข้อมูลผู้เล่น เงิน ไอเทม อาชีพ อาวุธ และ callback ระหว่าง client กับ server เซิฟไทยส่วนใหญ่รัน ESX Legacy 1.x เพราะสคริปต์ไทยและสคริปต์ขายส่วนใหญ่รองรับ ESX ก่อน

สคริปต์ที่เกี่ยวข้อง

โครงสร้างที่ต้องรู้

ส่วน ทำอะไร
es_extended core: xPlayer, เงิน 3 บัญชี (money / bank / black_money), inventory, loadout, jobs, callbacks, การเซฟ
esx_* addons ตำรวจ พยาบาล ช่าง ร้านค้า โรงรถ ฯลฯ แต่ละตัวเรียก ESX. ผ่าน @es_extended/imports.lua
oxmysql ตัวเชื่อม MySQL/MariaDB ที่ ESX Legacy ใช้
ตาราง users ข้อมูลผู้เล่น: identifier, accounts (JSON), inventory (JSON), loadout (JSON), job, position, skin
items, jobs, job_grades, owned_vehicles ตารางมาตรฐานที่ addons ส่วนใหญ่คาดหวัง

ติดตั้งครั้งแรก

  1. ลง FXServer (artifact ล่าสุดที่ recommended) และ MySQL/MariaDB
  2. วาง oxmysql และ es_extended ใน resources/ รัน es_extended.sql ในฐานข้อมูลใหม่
  3. ตั้ง set mysql_connection_string ใน server.cfg
  4. ลำดับ ensure สำคัญมาก:
ensure oxmysql
ensure es_extended
# หลังจากนี้ค่อย ensure สคริปต์ที่ใช้ @es_extended/imports.lua
ensure x3d_notify
ensure x3d_progressbar
ensure esx_ambulancejob
  1. เข้าเซิฟครั้งแรก ตัวละครถูกสร้างใน users อัตโนมัติ ตั้ง admin ด้วย add_principal identifier.license:xxx group.admin

อัปเดต ESX โดยไม่พังสคริปต์เดิม

  • สำรอง โฟลเดอร์ es_extended และ dump ฐานข้อมูลก่อนทุกครั้ง
  • อ่าน changelog ของเวอร์ชันใหม่ว่ามี migration SQL ไหม (เช่น 1.10 → 1.11 เปลี่ยน identifier เป็น license)
  • อย่าแก้ไฟล์ใน es_extended โดยตรง ถ้าต้องแก้ ใช้ fork ที่เก็บรายการแก้ไว้ (ดูหัวข้อถัดไป) ไม่งั้นอัปเดตครั้งหน้าทับหาย
  • สคริปต์ที่ใช้ ESX.GetPlayerFromId / xPlayer.getInventoryItem / TriggerServerCallback ทำงานต่อได้ทุกเวอร์ชัน 1.x ตราบที่ชื่อ resource ยังเป็น es_extended

ปัญหาของ 1.13.x ที่เซิฟจริงเจอ

  • เซฟตอนออกเท่านั้น เซิฟล่ม = ทุกคนย้อนกลับไปตอนล็อกอิน
  • พิกัดเพี้ยนตอนหลุด ร่างถูก cull ก่อนเซฟ พิกัด (0,0,0) เลือด 0 เขียนทับฐานข้อมูล ครั้งหน้าเกิดกลางแมพหรือตาย
  • callback ค้าง ESX.TriggerServerCallback ที่ไม่มีคนตอบอยู่ในหน่วยความจำจนรีสตาร์ท
  • ตารางไอเทมว่างทั้งเซสชัน ถ้า MySQL พร้อมช้ากว่า es_extended ตอนบูต
  • ไม่มีอะไรกันดูปช่วงก่อนรีสตาร์ท และไม่มี audit log ว่าเงิน/ไอเทมเปลี่ยนจากสคริปต์ไหน
  • ค้นหาเงิน/ไอเทม/อาวุธไล่ทีละตัว ทุกครั้ง ยิ่งคนเยอะยิ่งช้า

รายละเอียดแต่ละข้ออยู่ในทำไมเซิฟ ESX ควรเปลี่ยน core

ทางเลือก: ESX Legacy Core — X3D Build

ESX Legacy Core — X3D Build คือ es_extended ฟอร์กจาก 1.13.4 ที่แก้ทุกข้อด้านบน ชื่อ resource ยังเป็น es_extended วางทับตัวเดิมได้เลย ทุก @es_extended/imports.lua และ dependencies { 'es_extended' } ทำงานต่อ ไม่ต้องแก้สคริปต์สักบรรทัด ฟรี GPL v3 เหมือนต้นฉบับ รายการแก้ทั้งหมดอยู่ใน README ตาม GPL §5a

สิ่งที่เพิ่ม: เซฟทุกคนทุก 10 นาที · ตรวจพิกัด/เลือดก่อนเซฟ · รอพื้นโหลดก่อน spawn · ค้นหา O(1) · callback มี timeout · ล็อกเศรษฐกิจ 10 นาทีก่อนรีสตาร์ท · audit log + Discord webhook · clamp กระสุน · ตัวกรองคำ · Config.Tables ตั้งชื่อตารางเอง · ตรวจ nc_inventory/ox_inventory อัตโนมัติ

ติดตั้ง: สำรอง es_extended เดิม วางโฟลเดอร์ใหม่แทน เปิดเซิฟ ไม่ต้องรัน SQL ถ้ามีฐานข้อมูล ESX อยู่แล้ว คู่มือฉบับเต็ม

UI มาตรฐาน ESX ที่ควรเปลี่ยนพร้อมกัน

esx_notify, esx_progressbar, esx_loadingscreen มาจากปี 2022 ฟอนต์ไทยขึ้นเป็นกล่อง ยกเลิกแถบไม่ได้ หน้าโหลดจอขาว X3D มีตัวแทนฟรีทั้งสาม พร้อมตัวส่งต่อ exports ชื่อเดิม อ่านที่ แทน esx_notify / esx_progressbar / esx_loadingscreen

คำถามที่พบบ่อย

ESX กับ ESX Legacy ต่างกันไหม — "ESX Legacy" คือชื่อชุดพัฒนาต่อของ ESX ตั้งแต่ 2021 (esx-framework/esx_core) เวอร์ชัน 1.x ทั้งหมดคือ ESX Legacy คำว่า ESX เฉย ๆ ในปัจจุบันหมายถึงตัวนี้

ใช้ ox_inventory กับ ESX Legacy ได้ไหม — ได้ และเป็นที่นิยม ox_inventory แทนระบบ inventory ในตัวของ ESX X3D Build ตรวจเจอและชี้ไอคอนให้เอง

QBCore หรือ ESX — ถ้าสคริปต์ที่อยากใช้ส่วนใหญ่รองรับ ESX (สคริปต์ไทยเกือบทั้งหมด) เลือก ESX Legacy อ่านเทียบเต็มที่ QBCore vs ESX Legacy vs Qbox

สคริปต์ฟรีสำหรับ ESX มีอะไรบ้าง — X3D แจกฟรี 16 ตัว ใช้กับ ESX Legacy ทั้งหมด ดูบทความแจกสคริป FiveM ฟรี

สคริปต์ที่เกี่ยวข้อง