คู่มือนี้ครอบคลุมการตั้งค่าผู้ดูแล ทรัพยากรฝั่งเซิร์ฟเวอร์ แผนที่กำหนดเอง การจัดการยานพาหนะ และการแก้ไขปัญหาสำหรับเซิร์ฟเวอร์ BeamMP ของคุณบน Legion Hosting สำหรับการตั้งค่าเซิร์ฟเวอร์เริ่มต้น คีย์การยืนยันตัวตน และการกำหนดค่าพื้นฐาน โปรดดูที่ คู่มือการตั้งค่าเซิร์ฟเวอร์ BeamMP

---

การตั้งค่าผู้ดูแล

BeamMP ไม่มีระบบล็อกอินหรือรหัสผ่านผู้ดูแลแบบดั้งเดิม แทนที่จะเป็นเช่นนั้น คำสั่งผู้ดูแลจะถูกดำเนินการผ่านคอนโซลเซิร์ฟเวอร์หรือผ่านปลั๊กอิน Lua ฝั่งเซิร์ฟเวอร์ที่ตรวจสอบตัวระบุผู้เล่น

คำสั่งคอนโซล

คอนโซลเซิร์ฟเวอร์ใน GPanel ให้การเข้าถึงโดยตรงไปยังคำสั่งเซิร์ฟเวอร์ในตัว พิมพ์คำสั่งลงในช่องป้อนข้อมูลคอนโซลโดยตรง:

---

โครงสร้างโฟลเดอร์ Resources

BeamMP ใช้โฟลเดอร์ Resources เพื่อจัดระเบียบเนื้อหาฝั่งเซิร์ฟเวอร์ โฟลเดอร์นี้ประกอบด้วยไดเรกทอรีย่อยสองรายการที่มีวัตถุประสงค์แตกต่างกัน:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

ทรัพยากรฝั่งไคลเอนต์ (Client Resources)

ไฟล์ที่วางไว้ใน Resources/Client/ จะถูกดาวน์โหลดโดยผู้เล่นโดยอัตโนมัติเมื่อพวกเขาเชื่อมต่อ ซึ่งใช้สำหรับ:

• แผนที่กำหนดเอง — ไฟล์ม็อดแผนที่ .zip ที่ผู้เล่นต้องการเพื่อโหลดแผนที่ของเซิร์ฟเวอร์
• ยานพาหนะกำหนดเอง — ไฟล์ม็อดยานพาหนะ .zip ที่เพิ่มรถใหม่หรือปรับแต่งรถที่มีอยู่
• ม็อดไคลเอนต์อื่น ๆ — ม็อด BeamNG.drive ใด ๆ ที่ต้องมีอยู่บนไคลเอนต์

ทรัพยากรฝั่งเซิร์ฟเวอร์ (ปลั๊กอิน Lua)

ไดเรกทอรี Resources/Server/ ประกอบด้วยปลั๊กอิน Lua ฝั่งเซิร์ฟเวอร์ ปลั๊กอินเหล่านี้ทำงานบนเซิร์ฟเวอร์เท่านั้นและจะไม่ถูกส่งไปยังผู้เล่น ปลั๊กอินแต่ละตัวอยู่ในโฟลเดอร์ย่อยของตัวเองพร้อมไฟล์ main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

ปลั๊กอินฝั่งเซิร์ฟเวอร์สามารถ:

• ตอบสนองต่อเหตุการณ์ของผู้เล่น (การเข้าร่วม การออก ข้อความแชท การเกิดยานพาหนะ)
• ใช้คำสั่งกำหนดเองที่เรียกใช้ผ่านแชท (เช่น /tp, /give)
• จัดการสิทธิ์และขีดจำกัดของยานพาหนะ
• เพิ่มระบบเศรษฐกิจ การเทเลพอร์ต หรือคุณสมบัติการเล่นเกมกำหนดเองอื่น ๆ
• บันทึกกิจกรรมของผู้เล่นและบังคับใช้กฎ

---

การเพิ่มแผนที่กำหนดเอง

หากต้องการเรียกใช้แผนที่กำหนดเอง (ที่ไม่ใช่ค่าเริ่มต้น) บนเซิร์ฟเวอร์ BeamMP ของคุณ:

1. ดาวน์โหลดม็อดแผนที่เป็นไฟล์ .zip จากแหล่งม็อด BeamNG.drive (เช่น คลังเก็บม็อด BeamNG.drive)
2. หยุดเซิร์ฟเวอร์ของคุณใน GPanel
3. อัปโหลดไฟล์ .zip ไปยัง Resources/Client/ ผ่านแท็บ Files หรือ SFTP อย่าแตกไฟล์ zip
4. อัปเดตตัวแปรเริ่มต้น MAP (หรือ Map ใน ServerConfig.toml) ให้เป็นเส้นทางแผนที่ที่ถูกต้องสำหรับแผนที่กำหนดเอง เส้นทางนี้มักอยู่ในรูปแบบ /levels/map_name/info.json — ตรวจสอบเอกสารของม็อดสำหรับเส้นทางที่แน่นอน
5. เริ่มเซิร์ฟเวอร์

---

การจัดการยานพาหนะ

การจัดการยานพาหนะบนเซิร์ฟเวอร์ BeamMP ถูกควบคุมผ่านการตั้งค่า MaxCars และอาจผ่านปลั๊กอิน Lua ฝั่งเซิร์ฟเวอร์

การตั้งค่า MaxCars

การตั้งค่า MaxCars ใน ServerConfig.toml (หรือตัวแปรเริ่มต้น MAX_CARS) ควบคุมจำนวนยานพาหนะที่ผู้เล่นแต่ละคนสามารถสร้างพร้อมกันได้:

• 1 — ผู้เล่นแต่ละคนสามารถมียานพาหนะหนึ่งคันในแต่ละครั้ง (แนะนำสำหรับเซิร์ฟเวอร์ขนาดใหญ่)
• 2–3 — อนุญาตให้ผู้เล่นมียานพาหนะสองสามคัน มีประโยชน์สำหรับเซิร์ฟเวอร์ขนาดเล็กหรือการรวมตัวของรถ
• ค่าที่สูงขึ้นจะเพิ่มภาระเซิร์ฟเวอร์ตามสัดส่วน

ม็อดยานพาหนะกำหนดเอง

หากต้องการเพิ่มยานพาหนะกำหนดเองไปยังเซิร์ฟเวอร์ของคุณ:

1. ดาวน์โหลดม็อดยานพาหนะเป็นไฟล์ .zip
2. วางไว้ใน Resources/Client/
3. รีสตาร์ทเซิร์ฟเวอร์ ผู้เล่นจะดาวน์โหลดม็อดยานพาหนะโดยอัตโนมัติเมื่อเชื่อมต่อ

การจำกัดยานพาหนะผ่านปลั๊กอิน

สำหรับการควบคุมที่ละเอียดยิ่งขึ้น (เช่น การแบนยานพาหนะเฉพาะ การจำกัดประเภทยานพาหนะ) คุณจะต้องมีปลั๊กอิน Lua ฝั่งเซิร์ฟเวอร์ ปลั๊กอินเหล่านี้สามารถดักจับเหตุการณ์การเกิดยานพาหนะและอนุญาตหรือปฏิเสธตามกฎกำหนดเอง ตรวจสอบฟอรัม BeamMP สำหรับปลั๊กอินการจัดการยานพาหนะ

---

การติดตั้งและการจัดการปลั๊กอิน

ปลั๊กอิน Lua ฝั่งเซิร์ฟเวอร์ขยายฟังก์ชันการทำงานของเซิร์ฟเวอร์ของคุณ นี่คือวิธีการติดตั้งและจัดการ:

การติดตั้งปลั๊กอิน

1. ดาวน์โหลดไฟล์ปลั๊กอิน (โดยทั่วไปคือโฟลเดอร์ที่มี main.lua และอาจมีไฟล์อื่น ๆ)
2. หยุดเซิร์ฟเวอร์ของคุณ
3. อัปโหลดโฟลเดอร์ปลั๊กอินไปยัง Resources/Server/ ผ่านแท็บ Files หรือ SFTP
4. ตรวจสอบให้แน่ใจว่าโครงสร้างโฟลเดอร์ถูกต้อง: Resources/Server/PluginName/main.lua
5. เริ่มเซิร์ฟเวอร์ คอนโซลจะแสดงข้อความเมื่อปลั๊กอินโหลด

การลบปลั๊กอิน

1. หยุดเซิร์ฟเวอร์ของคุณ
2. ลบโฟลเดอร์ปลั๊กอินจาก Resources/Server/
3. เริ่มเซิร์ฟเวอร์

---

การแก้ไขปัญหา

ข้อผิดพลาดของคีย์การยืนยันตัวตน

• ตรวจสอบว่าคีย์ถูกวางอย่างถูกต้องในตัวแปรเริ่มต้น AUTH_KEY — ไม่มีช่องว่างหรือการขึ้นบรรทัดใหม่เพิ่มเติม
• ตรวจสอบให้แน่ใจว่าคีย์ไม่ถูกเพิกถอนหรือหมดอายุบน BeamMP Keymaster
• แต่ละคีย์สามารถใช้ได้บนเซิร์ฟเวอร์เดียวเท่านั้นในแต่ละครั้ง หากคุณกำลังใช้คีย์เดียวกันที่อื่น มันจะล้มเหลว
• คอนโซลจะแสดงข้อผิดพลาดการยืนยันตัวตนเมื่อเริ่มต้นหากคีย์ไม่ถูกต้อง

ผู้เล่นไม่สามารถเชื่อมต่อได้

• ยืนยันว่าเซิร์ฟเวอร์เริ่มต้นเต็มที่และแสดงว่าออนไลน์ใน GPanel
• ตรวจสอบว่าผู้เล่นกำลังใช้ ตัวเปิด BeamMP ไม่ใช่ตัวเปิด BeamNG.drive มาตรฐาน
• หากเซิร์ฟเวอร์ถูกตั้งค่าเป็น Private = true ผู้เล่นต้องใช้การเชื่อมต่อโดยตรงด้วย IP และพอร์ตที่ถูกต้อง โปรดดู วิธีค้นหา IP และพอร์ตของเซิร์ฟเวอร์ของคุณ
• ตรวจสอบให้แน่ใจว่าเวอร์ชันตัวเปิด BeamMP ของผู้เล่นเข้ากันได้กับเวอร์ชันเซิร์ฟเวอร์ ตัวเปิดที่ล้าสมัยอาจไม่สามารถเชื่อมต่อได้
• หากเซิร์ฟเวอร์เต็ม (ถึง MaxPlayers) ผู้เล่นเพิ่มเติมไม่สามารถเข้าร่วมได้จนกว่าจะมีคนออกไป

ปัญหาการซิงค์ม็อด

• หากผู้เล่นติดอยู่ในการดาวน์โหลดหรือได้รับข้อผิดพลาดเกี่ยวกับม็อดที่ขาดหายไป ตรวจสอบว่าไฟล์ม็อด .zip ใน Resources/Client/ ไม่เสียหาย
• ดาวน์โหลดใหม่และอัปโหลดไฟล์ม็อดใหม่หาก .zip เสียหาย
• ไฟล์ม็อดขนาดใหญ่มากอาจทำให้เกิดการหมดเวลาสำหรับผู้เล่นที่มีการเชื่อมต่อช้า พิจารณาลบม็อดขนาดใหญ่ที่ไม่จำเป็นออก
• ตรวจสอบให้แน่ใจว่าไฟล์ม็อด .zip ไม่ซ้อนกัน (เช่น .zip ภายในโฟลเดอร์ภายใน .zip อีกตัว)

ปัญหาประสิทธิภาพกับผู้เล่น/ยานพาหนะจำนวนมาก

• ลด MaxCars เป็น 1 ต่อผู้เล่น
• ลด MaxPlayers หากเซิร์ฟเวอร์กำลังประสบกับความล่าช้าอย่างต่อเนื่อง
• เปลี่ยนไปใช้แผนที่ที่ง่ายกว่า (Grid Map หรือ Industrial) เพื่อประสิทธิภาพที่ดีขึ้นกับจำนวนผู้เล่นที่สูง
• ลบม็อดไคลเอนต์ที่ไม่จำเป็นออกจาก Resources/Client/ เพื่อลดเวลาในการดาวน์โหลดและการใช้หน่วยความจำ
• ตรวจสอบกราฟการใช้ทรัพยากรของ GPanel — หาก CPU หรือ RAM อยู่ที่ขีดจำกัดอย่างต่อเนื่อง พิจารณาอัปเกรดแผนเซิร์ฟเวอร์ของคุณ เปิดตั๋วสนับสนุน เพื่อหารือเกี่ยวกับตัวเลือก

เซิร์ฟเวอร์ไม่ปรากฏในเบราว์เซอร์

• ตรวจสอบให้แน่ใจว่า Private ถูกตั้งค่าเป็น false ในการกำหนดค่าของคุณ
• ตรวจสอบว่าคีย์การยืนยันตัวตนถูกต้องและไม่ได้ถูกใช้งานโดยเซิร์ฟเวอร์อื่น
• รอ 1–2 นาทีหลังจากเริ่มต้นเพื่อให้เซิร์ฟเวอร์ลงทะเบียนกับแบ็กเอนด์ของ BeamMP
• ตรวจสอบคอนโซลสำหรับข้อผิดพลาดใด ๆ ที่เกี่ยวข้องกับการเชื่อมต่อเซิร์ฟเวอร์หลัก

---

บทความที่เกี่ยวข้อง

• คู่มือการตั้งค่าเซิร์ฟเวอร์ BeamMP — การตั้งค่าเริ่มต้น คีย์การยืนยันตัวตน การกำหนดค่า และคำแนะนำการเชื่อมต่อ
• วิธีค้นหา IP และพอร์ตของเซิร์ฟเวอร์ของคุณ
• วิธีอัปโหลดไฟล์ผ่าน SFTP
• คู่มือการเริ่มต้นเซิร์ฟเวอร์ — คู่มือทั่วไปสำหรับการเริ่มต้นเซิร์ฟเวอร์เกมใด ๆ บน Legion Hosting

---

ต้องการความช่วยเหลือเพิ่มเติม?

หากคุณกำลังประสบปัญหาที่ไม่ได้ครอบคลุมในคู่มือนี้ ทีมสนับสนุนของเราพร้อมให้ความช่วยเหลือ เปิดตั๋วที่ legionhosting.net/submitticket.php พร้อมรายละเอียดเซิร์ฟเวอร์ของคุณ คำอธิบายปัญหา และข้อความข้อผิดพลาดที่เกี่ยวข้องจากคอนโซล GPanel