Αυτός ο οδηγός καλύπτει τον τρόπο εγκατάστασης του modding framework Oxide/uMod ή Carbon στον Rust server σας, την προσθήκη plugins της κοινότητας και τη διαχείρισή τους μέσω της κονσόλας. Για γενική διαμόρφωση του server και μεταβλητές εκκίνησης, δείτε τον Οδηγό Διαμόρφωσης Rust Server.

Εγκατάσταση Oxide/uMod ή Carbon

Το Oxide (που πλέον συντηρείται ως uMod) και το Carbon είναι modding frameworks για το Rust που σας επιτρέπουν να εγκαθιστάτε plugins φτιαγμένα από την κοινότητα. Αυτά τα frameworks προσθέτουν λειτουργίες όπως συστήματα οικονομίας, προσαρμοσμένα kits, vote rewards, ζώνες προστασίας PvE και πολλά άλλα.

Δεν χρειάζεται να ανεβάσετε κανένα αρχείο χειροκίνητα. Το modding framework εγκαθίσταται αυτόματα με τον ορισμό μίας μόνο μεταβλητής εκκίνησης:

1. Σταματήστε τον server σας από την καρτέλα Console του GPanel.
2. Συνδεθείτε στο GPanel και μεταβείτε στην καρτέλα Startup.
3. Βρείτε τη μεταβλητή FRAMEWORK και ορίστε την σε:
   • oxide — για Oxide/uMod (το πιο ευρέως χρησιμοποιούμενο framework, με τη μεγαλύτερη βιβλιοθήκη plugins)
   • carbon — για το framework Carbon (μια εναλλακτική με το δικό της οικοσύστημα plugins)
   • vanilla — για εκτέλεση χωρίς κανένα modding framework
4. Εκκινήστε τον server. Τα αρχεία του framework κατεβαίνουν και εφαρμόζονται αυτόματα. Στην πρώτη εκκίνηση με το Oxide, δημιουργείται η δομή καταλόγων oxide/.
5. Ελέγξτε το log της κονσόλας για μια γραμμή όπως Loaded plugin Oxide.Core για να επιβεβαιώσετε ότι το Oxide είναι ενεργό.

Εγκατάσταση Plugins

Τα plugins διανέμονται ως αρχεία .cs (πηγαίος κώδικας C#). Το Oxide τα μεταγλωττίζει στον server κατά την εκτέλεση — δεν απαιτείται προμεταγλώττιση.

1. Κατεβάστε το αρχείο .cs του plugin από το umod.org ή άλλη αξιόπιστη πηγή.
2. Ανεβάστε το αρχείο .cs στον κατάλογο oxide/plugins/ του server σας χρησιμοποιώντας SFTP ή τον file manager του GPanel. Για βοήθεια με το SFTP, δείτε Πώς να Ανεβάσετε Αρχεία μέσω SFTP.
3. Εάν ο server εκτελείται, το plugin θα εντοπιστεί και θα μεταγλωττιστεί αυτόματα μέσα σε λίγα δευτερόλεπτα. Θα δείτε στην κονσόλα μια έξοδο που επιβεβαιώνει ότι φορτώθηκε, π.χ. Loaded plugin MyPlugin v1.2.3 by Author.
4. Εάν ο server δεν εκτελείται, το plugin θα φορτωθεί στην επόμενη εκκίνηση.

Δομή Καταλόγων Oxide

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

Διαμόρφωση Plugins

Τα περισσότερα plugins δημιουργούν ένα αρχείο διαμόρφωσης JSON στο oxide/config/ την πρώτη φορά που φορτώνονται. Για να προσαρμόσετε ένα plugin:

1. Αφήστε το plugin να φορτωθεί τουλάχιστον μία φορά ώστε να δημιουργήσει το προεπιλεγμένο αρχείο διαμόρφωσής του.
2. Σταματήστε τον server σας (ή σημειώστε ότι ορισμένα plugins υποστηρίζουν ζωντανή επαναφόρτωση διαμόρφωσης).
3. Ανοίξτε το αρχείο διαμόρφωσης του plugin στο oxide/config/PluginName.json χρησιμοποιώντας τον file manager του GPanel ή SFTP.
4. Επεξεργαστείτε τις ρυθμίσεις και αποθηκεύστε το αρχείο.
5. Επαναφορτώστε το plugin με oxide.reload PluginName ή επανεκκινήστε τον server.

Διαχείριση Plugins μέσω Κονσόλας

Αυτές οι εντολές μπορούν να εκτελεστούν από την κονσόλα του GPanel ή μέσω ενός RCON client. Για ρύθμιση του RCON, δείτε Πρόσβαση RCON Rust και Εντολές Admin.

Ενημέρωση Plugins

Για να ενημερώσετε ένα plugin σε νεότερη έκδοση:

1. Κατεβάστε το ενημερωμένο αρχείο .cs από τη σελίδα του plugin στο umod.org.
2. Ανεβάστε το νέο αρχείο στο oxide/plugins/, αντικαθιστώντας το υπάρχον αρχείο.
3. Εάν ο server εκτελείται, το Oxide εντοπίζει την αλλαγή του αρχείου και επαναμεταγλωττίζει και επαναφορτώνει αυτόματα το plugin. Εναλλακτικά, εκτελέστε oxide.reload PluginName.
4. Ελέγξτε την κονσόλα για τυχόν σφάλματα. Ορισμένες ενημερώσεις plugins ενδέχεται να απαιτούν αλλαγές στο αρχείο διαμόρφωσης στο oxide/config/.

Αφαίρεση Plugins

Για να αφαιρέσετε εντελώς ένα plugin:

1. Εκτελέστε oxide.unload PluginName για να αποφορτώσετε το plugin ενώ ο server εκτελείται.
2. Διαγράψτε το αρχείο .cs από το oxide/plugins/.
3. Προαιρετικά διαγράψτε το αρχείο διαμόρφωσης του plugin από το oxide/config/ και τα αρχεία δεδομένων από το oxide/data/ εάν δεν τα χρειάζεστε πλέον.

Δημοφιλή Plugins

Αντιμετώπιση Προβλημάτων με Plugins

Εάν τα plugins σας δεν φορτώνονται, ελέγξτε τα εξής:

• Επιβεβαιώστε ότι το Oxide είναι εγκατεστημένο και ενεργό. Στην καρτέλα Startup του GPanel, η μεταβλητή FRAMEWORK πρέπει να είναι ορισμένη σε oxide. Το log της κονσόλας θα πρέπει να εμφανίζει Loaded plugin Oxide.Core κατά την εκκίνηση.
• Τα αρχεία plugin πρέπει να τοποθετούνται απευθείας στο oxide/plugins/ με την ακριβή επέκταση .cs. Αρχεία σε υποκαταλόγους ή με λανθασμένες επεκτάσεις αγνοούνται.
• Ελέγξτε την κονσόλα και το oxide/logs/ για σφάλματα μεταγλώττισης. Ένα plugin με συντακτικό σφάλμα δεν θα φορτωθεί και το μήνυμα σφάλματος θα περιγράφει το πρόβλημα.
• Ορισμένα plugins έχουν εξαρτήσεις από άλλα plugins (π.χ. πολλά plugins shop απαιτούν το Economics). Εγκαταστήστε πρώτα όλες τις απαιτούμενες εξαρτήσεις.

Για άλλα συνηθισμένα προβλήματα του server, δείτε Αντιμετώπιση Προβλημάτων Rust Server.

Χρειάζεστε Βοήθεια;

Εάν αντιμετωπίσετε ένα πρόβλημα που δεν καλύπτεται σε αυτόν τον οδηγό, η ομάδα υποστήριξής μας είναι διαθέσιμη για βοήθεια. Υποβάλετε ένα ticket υποστήριξης και συμπεριλάβετε το ID του server σας, μια περιγραφή του προβλήματος και οποιαδήποτε σχετική έξοδο της κονσόλας.