Hướng dẫn này trình bày cách cài đặt tài nguyên (script) trên máy chủ FiveM của bạn, thiết lập cơ sở dữ liệu MySQL cho các framework như ESX hoặc QBCore, và hiểu về thứ tự tải tài nguyên. Nếu bạn chưa hoàn thành thiết lập máy chủ ban đầu, hãy bắt đầu với Hướng Dẫn Thiết Lập Máy Chủ FiveM trước.

Cài Đặt Tài Nguyên và Script

Máy chủ FiveM được mở rộng bằng tài nguyên (còn gọi là script). Tài nguyên bổ sung các tính năng như đại lý ô tô, nghề nghiệp, các thành phần HUD, framework và nhiều hơn nữa.

Cách Cài Đặt Một Tài Nguyên

1. Tải tài nguyên từ nguồn của nó (GitHub, diễn đàn Cfx.re, Tebex, v.v.).
2. Giải nén thư mục tài nguyên từ tệp ZIP/archive nếu cần.
3. Tải thư mục tài nguyên lên thư mục resources/ của máy chủ bằng tab Files của GPanel hoặc qua SFTP.
4. Mở server.cfg và thêm một dòng ensure cho tài nguyên:

# Add your custom resources
ensure my-new-resource

5. Khởi động lại máy chủ từ GPanel hoặc TXAdmin để tài nguyên được tải.

Manifest Tài Nguyên

Mọi tài nguyên hợp lệ phải chứa một tệp manifest. Các tài nguyên hiện đại dùng fxmanifest.lua, trong khi các tài nguyên cũ hơn dùng __resource.lua. Nếu một thư mục tài nguyên đã tải không chứa một trong các tệp này, tài nguyên sẽ không tải được. Một số bản tải lồng thư mục tài nguyên thực sự bên trong một thư mục bao ngoài — hãy đảm bảo thư mục bạn đặt vào resources/ là thư mục chứa manifest.

Thứ Tự Tải Tài Nguyên

Tài nguyên được tải theo thứ tự chúng xuất hiện trong server.cfg. Nếu một tài nguyên phụ thuộc vào một tài nguyên khác (ví dụ, một script nghề nghiệp phụ thuộc vào một framework như ESX hoặc QBCore), hãy đảm bảo phần phụ thuộc được liệt kê trước tài nguyên cần đến nó:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Sắp Xếp Tài Nguyên với Thư Mục Danh Mục

Bạn có thể sắp xếp tài nguyên thành các thư mục con bên trong thư mục resources/. Dùng ký hiệu dấu ngoặc vuông trong server.cfg để ensure toàn bộ một thư mục danh mục:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Điều này tải mọi tài nguyên trong thư mục con được đặt tên. Đây là một cách tiện lợi để nhóm các script liên quan mà không phải liệt kê từng cái một.

Tải Nóng (Hot-Loading) Tài Nguyên qua TXAdmin

Bạn không phải lúc nào cũng cần khởi động lại toàn bộ máy chủ để tải một tài nguyên mới. TXAdmin có thể khởi động, dừng và khởi động lại từng tài nguyên riêng lẻ từ trang Resources của nó. Sau khi tải lên một tài nguyên mới và thêm dòng ensure của nó, bạn có thể chạy lệnh sau trong console trực tiếp của TXAdmin:

refresh
ensure my-new-resource

Lệnh refresh báo cho máy chủ quét lại thư mục resources/ để tìm các mục mới.

Thiết Lập Cơ Sở Dữ Liệu (MySQL / MariaDB)

Nhiều framework và tài nguyên FiveM (chẳng hạn như ESX, QBCore, hoặc vRP) yêu cầu một cơ sở dữ liệu MySQL hoặc MariaDB. Legion Hosting cung cấp thông tin đăng nhập cơ sở dữ liệu cùng với máy chủ của bạn.

Tìm Thông Tin Đăng Nhập Cơ Sở Dữ Liệu Của Bạn

1. Trong GPanel, vào tab Databases.
2. Nếu chưa có cơ sở dữ liệu nào, nhấp New Database để tạo một cái.
3. Ghi lại các chi tiết sau:
   • Database Host (địa chỉ và cổng)
   • Database Name
   • Username
   • Password (nhấp vào biểu tượng con mắt để hiển thị)

Cấu Hình Kết Nối Cơ Sở Dữ Liệu

Chi tiết kết nối cơ sở dữ liệu được đặt trong server.cfg bằng một chuỗi kết nối. Định dạng chính xác phụ thuộc vào tài nguyên MySQL mà bạn đang dùng, nhưng định dạng phổ biến nhất là:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Thay các chỗ giữ chỗ bằng thông tin đăng nhập thực tế của bạn từ tab Databases. Ví dụ:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Lựa Chọn Một Tài Nguyên MySQL

Dù bạn dùng tài nguyên MySQL nào, nó cũng phải được ensure trong server.cfg trước bất kỳ tài nguyên nào phụ thuộc vào nó:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Kiến Thức Cơ Bản Về Framework

Một framework cung cấp các hệ thống chơi cốt lõi mà các tài nguyên khác xây dựng dựa trên — những thứ như danh tính người chơi, tiền, kho đồ, nghề nghiệp và phương tiện. Hai framework FiveM phổ biến nhất là:

Hầu hết các framework được cài đặt qua hệ thống recipe của TXAdmin trong quá trình thiết lập ban đầu. Nếu bạn đã chọn một recipe như "QBCore" hoặc "ESX" trong khi thiết lập TXAdmin, framework và các phần phụ thuộc cốt lõi của nó đã được cài đặt. Nếu bạn cần cài đặt một framework theo cách thủ công, hãy làm theo tài liệu chính thức của nó:

• Tài Liệu ESX
• Tài Liệu QBCore

Nhận Trợ Giúp

Nếu bạn cần hỗ trợ về cài đặt tài nguyên hoặc cấu hình cơ sở dữ liệu:

1. Kiểm tra tài liệu hoặc trang GitHub của tài nguyên để biết hướng dẫn cài đặt và các vấn đề đã biết.
2. Xem lại console GPanel hoặc nhật ký TXAdmin để tìm các thông báo lỗi.
3. Mở một ticket hỗ trợ tại https://legionhosting.net/submitticket.php kèm theo các thông báo lỗi của bạn và tên tài nguyên bạn đang cố cài đặt.

Bài Viết Liên Quan

• Hướng Dẫn Thiết Lập Máy Chủ FiveM
• Khắc Phục Sự Cố FiveM
• Cách Tải Tệp Lên qua SFTP
• Cách Tìm IP và Cổng Máy Chủ Của Bạn