Aller au contenu principal

Besoin d'un serveur performant pour vos projets ?

Découvrez nos offres

Installer des mods mod.io

Core Keeper dispose d'un support officiel des mods via mod.io, accessible depuis le jeu. Sur un serveur dédié, les mods s'installent en déposant leurs fichiers sur le serveur. Avant d'installer quoi que ce soit, il faut comprendre où chaque mod doit tourner.

Mods serveur, mods client : ce qu'il faut savoir​

Type de modExemplesSur le serveurChez les joueurs
Client uniquementInterface, affichage, confort visuel, minicarteNon : inutile, voire source d'erreursOui, chez ceux qui le veulent
Contenu partagéNouveaux objets, blocs, ennemis, recettesOuiOui, dans la même version
Serveur uniquementRéglages de gameplay appliqués par le serveurOuiNon, si l'auteur l'indique
Tous les mods ne fonctionnent pas sur un serveur dédié

Certains mods sont uniquement côté client et ne sont pas prévus pour un serveur dédié. Consultez la page mod.io de chaque mod avant de l'installer : l'auteur y précise en général s'il est compatible avec le serveur dédié, s'il doit être installé chez les joueurs, et de quelles dépendances il a besoin.

Dans le doute, retenez ceci : un mod qui ajoute du contenu (objets, blocs, créatures) doit presque toujours être présent à la fois sur le serveur et chez tous les joueurs, dans la même version.

Récupérer les fichiers d'un mod​

Deux possibilités, selon le mod :

  • Depuis la page mod.io du mod, quand un téléchargement manuel est proposé
  • Depuis votre PC, après vous être abonné au mod dans le jeu : les mods téléchargés par Core Keeper sont stockés dans un dossier mod.io sur votre PC (sous Windows, en général dans C:\Users\Public\mod.io\). Chaque mod y a son propre sous-dossier

Pensez aussi aux dépendances : de nombreux mods nécessitent une bibliothèque commune (par exemple CoreLib) qui doit être installée elle aussi, sur le serveur comme chez les joueurs.

Où installer les mods sur le serveur​

Les mods se placent dans le dossier Mods/ des données du serveur, en général :

CoreKeeperServer_Data/StreamingAssets/Mods/
├── MonMod/
│   └── ...
└── CoreLib/
    └── ...

Créez le dossier Mods/ s'il n'existe pas. Chaque mod a son propre sous-dossier. L'emplacement exact peut varier selon la version du jeu : suivez en priorité les instructions de l'auteur du mod.

Le piège du double dossier

Une archive extraite donne souvent Mods/MonMod/MonMod/.... Un dossier en trop et le mod peut être ignoré sans erreur visible. Vérifiez que les fichiers du mod se trouvent directement dans Mods/MonMod/.

Procédure d'installation​

  1. Vérifiez sur mod.io que le mod est compatible avec le serveur dédié et avec votre version de Core Keeper
  2. Connectez-vous à votre Panel Game : game.yorkhost.fr
  3. Sélectionnez votre serveur et arrêtez-le
  4. Faites une sauvegarde depuis l'onglet Backups (voir Sauvegardes)
  5. Dans l'onglet Files, ouvrez (ou créez) le dossier Mods/
  6. Envoyez le dossier du mod et de ses dépendances : uploadez l'archive .zip puis décompressez-la, ou transférez le dossier par SFTP (identifiants dans Paramètres → Détails SFTP, voir Extension SFTP pour VSCode)
  7. Démarrez le serveur et surveillez la Console
  8. Demandez à vos joueurs d'installer les mêmes mods, dans la même version (abonnement sur mod.io depuis le jeu)

Vérifier que le mod est chargé​

Au démarrage, le serveur indique en général dans la console les mods qu'il charge, ainsi que les éventuelles erreurs de chargement. Cherchez le nom de votre mod dans les lignes de démarrage. En cas d'erreur, notez le message exact : c'est l'information à donner à l'auteur du mod ou à notre support.

Vérifiez ensuite l'effet en jeu (nouvel objet, nouvelle recette…).

Désinstaller un mod​

  1. Arrêtez le serveur
  2. Supprimez le dossier du mod dans Mods/
  3. Démarrez le serveur
Retirer un mod de contenu en cours de partie

Retirer un mod qui ajoute des objets ou des blocs peut faire disparaître les éléments déjà posés ou stockés dans le monde, voire empêcher le chargement du monde. Sauvegardez avant, et en cas de gros changement, préférez repartir sur un nouveau monde.

Bonnes pratiques​

  • Ajoutez les mods un par un et démarrez le serveur entre chaque ajout : vous saurez immédiatement lequel pose problème.
  • Après une mise à jour du jeu, vérifiez la compatibilité de chaque mod avant de redémarrer : un mod pas encore mis à jour peut empêcher le démarrage.
  • Les mods augmentent la consommation de RAM : pour un serveur moddé, une offre Octarine ou Galaxite est recommandée (voir Premiers pas).

Voir aussi​