Αυτός ο οδηγός καλύπτει πώς να εγκαταστήσετε πόρους (scripts) στον διακομιστή σας FiveM, να ρυθμίσετε μια βάση δεδομένων MySQL για frameworks όπως το ESX ή το QBCore και να κατανοήσετε τη σειρά φόρτωσης πόρων. Εάν δεν έχετε ακόμη ολοκληρώσει την αρχική ρύθμιση του διακομιστή, ξεκινήστε πρώτα με τον FiveM Server Setup Guide.

Εγκατάσταση Πόρων και Scripts

Οι διακομιστές FiveM επεκτείνονται με πόρους (που ονομάζονται επίσης scripts). Οι πόροι προσθέτουν λειτουργίες όπως αντιπροσωπείες αυτοκινήτων, επαγγέλματα, στοιχεία HUD, frameworks και άλλα.

Πώς να Εγκαταστήσετε έναν Πόρο

1. Κατεβάστε τον πόρο από την πηγή του (GitHub, φόρουμ Cfx.re, Tebex, κ.λπ.).
2. Εξάγετε τον φάκελο του πόρου από το ZIP/αρχείο εάν χρειάζεται.
3. Ανεβάστε τον φάκελο του πόρου στον κατάλογο resources/ του διακομιστή σας χρησιμοποιώντας την καρτέλα Files του GPanel ή μέσω SFTP.
4. Ανοίξτε το server.cfg και προσθέστε μια γραμμή ensure για τον πόρο:

# Add your custom resources
ensure my-new-resource

5. Επανεκκινήστε τον διακομιστή από το GPanel ή το TXAdmin για να φορτωθεί ο πόρος.

Manifests Πόρων

Κάθε έγκυρος πόρος πρέπει να περιέχει ένα αρχείο manifest. Οι σύγχρονοι πόροι χρησιμοποιούν το fxmanifest.lua, ενώ οι παλαιότεροι χρησιμοποιούν το __resource.lua. Εάν ένας κατεβασμένος φάκελος πόρου δεν περιέχει κανένα από αυτά τα αρχεία, ο πόρος δεν θα φορτωθεί. Ορισμένες λήψεις τοποθετούν τον πραγματικό φάκελο πόρου μέσα σε έναν εξωτερικό φάκελο — βεβαιωθείτε ότι ο φάκελος που τοποθετείτε στο resources/ είναι αυτός που περιέχει το manifest.

Σειρά Φόρτωσης Πόρων

Οι πόροι φορτώνονται με τη σειρά που εμφανίζονται στο server.cfg. Εάν ένας πόρος εξαρτάται από έναν άλλο (για παράδειγμα, ένα script επαγγέλματος που εξαρτάται από ένα framework όπως το ESX ή το QBCore), βεβαιωθείτε ότι η εξάρτηση παρατίθεται πριν από τον πόρο που τη χρειάζεται:

# 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

Οργάνωση Πόρων με Φακέλους Κατηγορίας

Μπορείτε να οργανώσετε τους πόρους σε υποφακέλους μέσα στον κατάλογο resources/. Χρησιμοποιήστε τη σημειογραφία αγκυλών στο server.cfg για να εξασφαλίσετε έναν ολόκληρο φάκελο κατηγορίας:

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

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

Αυτό φορτώνει κάθε πόρο εντός του ονομασμένου υποφακέλου. Είναι ένας βολικός τρόπος ομαδοποίησης σχετικών scripts χωρίς να παραθέτετε καθένα ξεχωριστά.

Hot-Loading Πόρων μέσω TXAdmin

Δεν χρειάζεστε πάντα μια πλήρη επανεκκίνηση του διακομιστή για να φορτώσετε έναν νέο πόρο. Το TXAdmin μπορεί να ξεκινήσει, να σταματήσει και να επανεκκινήσει μεμονωμένους πόρους από τη σελίδα Resources του. Αφού ανεβάσετε έναν νέο πόρο και προσθέσετε τη γραμμή ensure, μπορείτε να εκτελέσετε την ακόλουθη εντολή στη ζωντανή κονσόλα του TXAdmin:

refresh
ensure my-new-resource

Η εντολή refresh λέει στον διακομιστή να σαρώσει ξανά τον κατάλογο resources/ για νέες καταχωρήσεις.

Ρύθμιση Βάσης Δεδομένων (MySQL / MariaDB)

Πολλά frameworks και πόροι του FiveM (όπως το ESX, το QBCore ή το vRP) απαιτούν μια βάση δεδομένων MySQL ή MariaDB. Το Legion Hosting παρέχει διαπιστευτήρια βάσης δεδομένων με τον διακομιστή σας.

Εύρεση των Διαπιστευτηρίων Βάσης Δεδομένων σας

1. Στο GPanel, μεταβείτε στην καρτέλα Databases.
2. Εάν δεν υπάρχει ακόμη βάση δεδομένων, κάντε κλικ στο New Database για να δημιουργήσετε μία.
3. Σημειώστε τα ακόλουθα στοιχεία:
   • Database Host (διεύθυνση και θύρα)
   • Database Name
   • Username
   • Password (κάντε κλικ στο εικονίδιο ματιού για να τον αποκαλύψετε)

Διαμόρφωση της Σύνδεσης Βάσης Δεδομένων

Τα στοιχεία σύνδεσης της βάσης δεδομένων ορίζονται στο server.cfg χρησιμοποιώντας μια συμβολοσειρά σύνδεσης. Η ακριβής μορφή εξαρτάται από το ποιον πόρο MySQL χρησιμοποιείτε, αλλά η πιο συνηθισμένη μορφή είναι:

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

Αντικαταστήστε τα placeholders με τα πραγματικά σας διαπιστευτήρια από την καρτέλα Databases. Για παράδειγμα:

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

Επιλογή Πόρου MySQL

Όποιον πόρο MySQL κι αν χρησιμοποιείτε, πρέπει να εξασφαλιστεί στο server.cfg πριν από οποιουσδήποτε πόρους που εξαρτώνται από αυτόν:

# 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

Βασικά Στοιχεία Framework

Ένα framework παρέχει τα βασικά συστήματα παιχνιδιού πάνω στα οποία χτίζονται άλλοι πόροι — πράγματα όπως ταυτότητα παίκτη, χρήματα, απόθεμα, επαγγέλματα και οχήματα. Τα δύο πιο δημοφιλή frameworks του FiveM είναι:

Τα περισσότερα frameworks εγκαθίστανται μέσω του συστήματος recipe του TXAdmin κατά την αρχική ρύθμιση. Εάν επιλέξατε ένα recipe όπως "QBCore" ή "ESX" κατά τη ρύθμιση του TXAdmin, το framework και οι βασικές του εξαρτήσεις είναι ήδη εγκατεστημένα. Εάν χρειάζεται να εγκαταστήσετε ένα framework χειροκίνητα, ακολουθήστε την επίσημη τεκμηρίωσή του:

• ESX Documentation
• QBCore Documentation

Λήψη Βοήθειας

Εάν χρειάζεστε βοήθεια με την εγκατάσταση πόρων ή τη διαμόρφωση της βάσης δεδομένων:

1. Ελέγξτε την τεκμηρίωση του πόρου ή τη σελίδα του στο GitHub για οδηγίες εγκατάστασης και γνωστά προβλήματα.
2. Ελέγξτε την κονσόλα του GPanel ή τα logs του TXAdmin για μηνύματα σφάλματος.
3. Ανοίξτε ένα δελτίο υποστήριξης στο https://legionhosting.net/submitticket.php με τα μηνύματα σφάλματός σας και το όνομα του πόρου που προσπαθείτε να εγκαταστήσετε.

Σχετικά Άρθρα

• FiveM Server Setup Guide
• FiveM Troubleshooting
• How to Upload Files via SFTP
• How to Find Your Server IP and Port