คู่มือนี้ครอบคลุมทุกสิ่งที่คุณต้องการเพื่อให้เซิร์ฟเวอร์ alt:V ของคุณทำงานบน Legion Hosting ตั้งแต่การเริ่มต้นครั้งแรกและการกำหนดค่า server.toml ไปจนถึง gamemode resource การตั้งค่า CDN, voice chat และวิธีที่ผู้เล่นเชื่อมต่อผ่าน alt:V launcher สำหรับการพัฒนา resource การตั้งค่าฐานข้อมูล และการจัดการแอดมิน ดูที่ การตั้งค่าแอดมินและ Resource ของ alt:V

alt:V คืออะไร?

alt:V เป็นม็อด multiplayer แบบฟรีและโอเพนซอร์สสำหรับ Grand Theft Auto V ที่ช่วยให้ผู้เล่นเชื่อมต่อกับเซิร์ฟเวอร์แบบกำหนดเองที่ทำ gamemode ที่ไม่ซ้ำใคร เช่น roleplay (RP), deathmatch, racing, freeroam และอื่นๆ เซิร์ฟเวอร์ทำ resource แบบกำหนดเองที่เขียนด้วย JavaScript, TypeScript หรือ C# ให้เจ้าของเซิร์ฟเวอร์ควบคุมตรรกะการเล่นเกมได้อย่างเต็มที่ ผู้เล่นเชื่อมต่อผ่าน alt:V launcher ซึ่งปรับเปลี่ยน GTA V ให้รองรับการเชื่อมต่อ multiplayer

การเริ่มต้นครั้งแรก

เมื่อคุณได้รับเซิร์ฟเวอร์ alt:V ครั้งแรก ให้ทำตามขั้นตอนเหล่านี้เพื่อให้มันออนไลน์:

1. เข้าสู่ระบบ GPanel และเลือกเซิร์ฟเวอร์ alt:V ของคุณ
2. ไปที่แท็บ Startup และกำหนดค่าชื่อเซิร์ฟเวอร์ จำนวนผู้เล่นสูงสุด และตัวแปร startup อื่นๆ
3. ไปที่แท็บ Console และคลิก Start
4. เซิร์ฟเวอร์จะดาวน์โหลดไฟล์เซิร์ฟเวอร์ alt:V เมื่อบูตครั้งแรก ซึ่งอาจใช้เวลาสักครู่
5. เมื่อ console แสดงว่าเซิร์ฟเวอร์กำลังรับฟังและพร้อมสำหรับการเชื่อมต่อ เซิร์ฟเวอร์ของคุณก็ออนไลน์แล้ว
6. โดยค่าเริ่มต้น เซิร์ฟเวอร์จะเริ่มต้นโดยไม่มี gamemode resource คุณจะต้องเพิ่ม resource เพื่อสร้างการเล่นเกม ดูที่ การตั้งค่าแอดมินและ Resource ของ alt:V สำหรับรายละเอียด

ตัวแปร Startup ของ GPanel

alt:V เปิดเผยตัวเลือกการกำหนดค่าหลายอย่างเป็นตัวแปร startup ใน GPanel ไปที่แท็บ Startup เพื่อแก้ไขสิ่งเหล่านี้ การเปลี่ยนแปลงต้องรีสตาร์ทเซิร์ฟเวอร์

การกำหนดค่าเซิร์ฟเวอร์ (server.toml)

ไฟล์การกำหนดค่าหลักสำหรับเซิร์ฟเวอร์ alt:V คือ server.toml ซึ่งอยู่ในไดเรกทอรีรากของเซิร์ฟเวอร์ คุณสามารถแก้ไขไฟล์นี้ผ่านแท็บ Files ใน GPanel หรือผ่าน SFTP

ตัวอย่าง server.toml

name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]

การตั้งค่าหลัก: name (ชื่อที่แสดงใน browser), host (คงไว้ที่ 0.0.0.0), port (ต้องตรงกับ GPanel), players (จำนวนสูงสุด), password (ว่างไว้สำหรับสาธารณะ), announce (true เพื่อปรากฏใน browser), token (announce token จากเว็บไซต์ alt:V จำเป็นสำหรับการแสดงใน browser), gamemode (ป้ายกำกับใน browser เช่น "Roleplay"), modules (โมดูลสคริปต์: js-module หรือ csharp-module), resources (อาร์เรย์ของโฟลเดอร์ resource ที่จะโหลด) และ tags (แท็กตัวกรองใน browser)

Announce Token

เพื่อให้เซิร์ฟเวอร์ของคุณปรากฏใน alt:V server browser คุณต้องมี announce token จาก master server ของ alt:V:

1. เยี่ยมชมเว็บไซต์ alt:Vและเข้าสู่ระบบหรือสร้างบัญชี
2. ไปที่ส่วนการจัดการเซิร์ฟเวอร์และสร้าง server token ใหม่
3. คัดลอก token และวางลงในฟิลด์ token ใน server.toml ของคุณ
4. ตรวจสอบให้แน่ใจว่า announce = true ในการกำหนดค่าของคุณ
5. รีสตาร์ทเซิร์ฟเวอร์ ตอนนี้มันควรจะปรากฏใน browser สาธารณะ

Gamemode Resource

เซิร์ฟเวอร์ alt:V ขับเคลื่อนด้วย resource — สคริปต์ที่กำหนดตรรกะการเล่นเกมทั้งหมด หากไม่มี resource เซิร์ฟเวอร์จะไม่มีฟังก์ชันการทำงานแบบกำหนดเอง Resource ถูกวางไว้ในไดเรกทอรี resources/

โครงสร้างของ Resource

resources/
  myresource/
    resource.toml       <-- Resource configuration
    server/
      index.js          <-- Server-side script
    client/
      index.js          <-- Client-side script (runs on the player's GTA V)

การโหลด Resource

เพิ่มชื่อ resource ลงในอาร์เรย์ resources ใน server.toml เพื่อโหลดเมื่อเริ่มทำงาน:

resources = ["chat", "freeroam", "spawn"]

แต่ละ resource ต้องมีไฟล์ resource.toml ในไดเรกทอรีของมันที่กำหนดชนิด dependency และ entry point ของสคริปต์ สำหรับรายละเอียดเกี่ยวกับการสร้างและจัดการ resource ดูที่ การตั้งค่าแอดมินและ Resource ของ alt:V

การตั้งค่า CDN

alt:V ใช้กลไก CDN เพื่อให้บริการไฟล์ฝั่งไคลเอนต์ (model, texture, สคริปต์) แก่ผู้เล่นที่เชื่อมต่อ CDN ในตัว ให้บริการไฟล์โดยตรงจากเซิร์ฟเวอร์โดยไม่ต้องกำหนดค่าเพิ่มเติม — นี่คือค่าเริ่มต้นและทำงานได้ดีสำหรับเซิร์ฟเวอร์ส่วนใหญ่ สำหรับเซิร์ฟเวอร์ขนาดใหญ่ที่มี asset แบบกำหนดเองจำนวนมาก คุณสามารถกำหนดค่า CDN ภายนอก เพิ่มเติมได้โดยอัปโหลดไฟล์ไคลเอนต์ไปยังเว็บเซิร์ฟเวอร์และตั้งค่า URL ของ CDN ในการกำหนดค่า resource ของคุณ ซึ่งช่วยลดการใช้แบนด์วิดท์ของเซิร์ฟเวอร์เกม

Voice Chat

alt:V มีระบบ voice chat ในตัวที่ช่วยให้สามารถสื่อสารด้วยเสียงแบบ positional (3D) ระหว่างผู้เล่นได้ Voice chat ถูกเปิดใช้งานและกำหนดค่าใน server.toml

การกำหนดค่า Voice

[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0

bitrate ควบคุมคุณภาพเสียง (64000 เป็นค่ามาตรฐาน) ฟิลด์ external* กำหนดค่าเซิร์ฟเวอร์ voice ภายนอก — เว้นว่างไว้/เป็นศูนย์เพื่อใช้เซิร์ฟเวอร์ voice ในตัว ซึ่งแนะนำสำหรับการตั้งค่าส่วนใหญ่ ตัวเลือกเซิร์ฟเวอร์ voice ภายนอกจำเป็นเฉพาะสำหรับการกำหนดค่าขั้นสูงที่การประมวลผลเสียงถูกโอนไปยังเครื่องแยกต่างหาก

วิธีที่ผู้เล่นเชื่อมต่อ

ผู้เล่นเชื่อมต่อกับเซิร์ฟเวอร์ alt:V ผ่าน alt:V launcher ไม่ใช่ผ่าน GTA V โดยตรง

ผ่าน Server Browser

1. ดาวน์โหลดและติดตั้ง alt:V launcher จาก altvmp.com
2. เปิด alt:V launcher มันจะตรวจจับและยืนยันการติดตั้ง GTA V
3. จาก launcher เรียกดู Server Browser
4. ค้นหาเซิร์ฟเวอร์ของคุณตามชื่อหรือใช้ตัวกรอง (gamemode, tag, จำนวนผู้เล่น)
5. คลิกที่เซิร์ฟเวอร์ของคุณและเลือก Connect
6. หากเซิร์ฟเวอร์มีรหัสผ่าน ผู้เล่นจะถูกขอให้ป้อนรหัสผ่าน
7. GTA V จะเปิดพร้อมม็อด multiplayer ของ alt:V และเชื่อมต่อกับเซิร์ฟเวอร์ของคุณ

ผ่านการเชื่อมต่อโดยตรง

1. ใน alt:V launcher เลือก Direct Connect
2. ป้อนที่อยู่ IP และ port ของเซิร์ฟเวอร์ของคุณในรูปแบบ IP:PORT (เช่น 192.168.1.1:7788)
3. คลิก Connect

หากต้องการค้นหาที่อยู่ IP และ port ของเซิร์ฟเวอร์ของคุณ ดูที่ วิธีค้นหา IP และ Port ของเซิร์ฟเวอร์

จำนวนผู้เล่นสูงสุดและประสิทธิภาพ

เซิร์ฟเวอร์ alt:V สามารถรองรับจำนวนผู้เล่นที่สูงได้ แต่ประสิทธิภาพขึ้นอยู่กับ resource และแพ็กเกจเซิร์ฟเวอร์ของคุณเป็นอย่างมาก:

• ผู้เล่น 32–128 คน: ช่วงที่พบบ่อยสำหรับเซิร์ฟเวอร์ส่วนใหญ่ gamemode ที่เรียบง่ายทำงานได้อย่างราบรื่นที่จำนวนผู้เล่นสูง
• ผู้เล่น 128–512+ คน: เป็นไปได้สำหรับเซิร์ฟเวอร์ที่ปรับแต่งแล้วด้วย resource ที่มีประสิทธิภาพ ต้องการ CPU และ RAM มากขึ้น
• ประสิทธิภาพของ resource: สคริปต์ที่ปรับแต่งได้ไม่ดีเป็นสาเหตุหลักของปัญหาด้านประสิทธิภาพ สคริปต์ฝั่งเซิร์ฟเวอร์ที่ทำการดำเนินการหนักทุก tick หรือเก็บโครงสร้างข้อมูลขนาดใหญ่ไว้ในหน่วยความจำสามารถเป็นคอขวดของเซิร์ฟเวอร์ได้
• การ query ฐานข้อมูล: gamemode ที่ใช้ฐานข้อมูล (MySQL, MongoDB) ควรใช้ query แบบ async เพื่อหลีกเลี่ยงการบล็อก main thread

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

• การตั้งค่าแอดมินและ Resource ของ alt:V — การพัฒนา resource การตั้งค่าฐานข้อมูล เครื่องมือแอดมิน และการแก้ไขปัญหา
• วิธีค้นหา IP และ Port ของเซิร์ฟเวอร์
• วิธีอัปโหลดไฟล์ผ่าน SFTP
• คู่มือการเริ่มต้นเซิร์ฟเวอร์ — คู่มือทั่วไปสำหรับการเริ่มต้นเซิร์ฟเวอร์เกมใดก็ได้บน Legion Hosting

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

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