Documentation
Bien démarrer

Installation

Installez InglisCore, terminez l'assistant d'installation dans votre navigateur et gardez le plugin à jour.

L'installation d'InglisCore prend quelques minutes. Rien n'est à configurer à la main : le plugin démarre avec une base de données intégrée et vous guide pour le reste dans votre navigateur.

Installer le plugin

  1. Arrêtez votre serveur.
  2. Déposez le jar d'InglisCore dans le dossier plugins.
  3. Démarrez le serveur.

Au premier démarrage, InglisCore utilise une base de données SQLite intégrée. Aucun serveur de base de données ni aucune installation ne sont nécessaires : chaque module est prêt immédiatement, avec des réglages par défaut adaptés.

Le lien d'installation

Une fois le serveur démarré, la console affiche un message de bienvenue avec un lien d'installation privé :

================================================================
 Welcome to InglisCore!
 Finish the setup from your browser:
   http://your.server.ip:25565/auth?token=...
================================================================

Ouvrez ce lien dans votre navigateur pour lancer l'assistant d'installation. Par défaut, l'éditeur web répond sur votre port Minecraft, vous n'avez donc aucun port supplémentaire à ouvrir.

  • Le lien d'installation reste valable 24 heures, ou jusqu'à la fin de l'installation.
  • Vous l'avez perdu ? Tapez /inglis setup dans la console pour en obtenir un nouveau.
  • L'adresse du lien est incorrecte (une IP locale, par exemple) ? Indiquez la bonne depuis la console avec /inglis setup url http://ip:port, puis relancez /inglis setup.
Attention

Toute personne qui possède le lien d'installation peut configurer votre serveur. Gardez-le pour vous.

L'assistant d'installation

L'assistant compte quatre étapes rapides. Tous vos choix pourront être modifiés plus tard depuis l'éditeur.

  1. Langue du serveur. La langue des messages envoyés aux joueurs. Les joueurs peuvent malgré tout recevoir les messages dans la langue de leur client.
  2. Identifiant du serveur. Un nom court et unique pour ce serveur, comme lobby, survival-1 ou factions. Il identifie le serveur sur votre réseau et dans les réglages propres à chaque serveur. Utilisez des lettres minuscules, des chiffres, - et _.
  3. Stockage des données. Gardez SQLite pour un serveur seul, ou choisissez MySQL / MariaDB pour partager les données entre plusieurs serveurs. Pour MySQL, renseignez l'hôte, le port, la base de données, l'utilisateur et le mot de passe, cochez SSL si votre base l'exige, puis cliquez sur Tester. Vous ne pouvez continuer qu'une fois la connexion réussie.
  4. Point de départ. Choisissez un modèle prêt à l'emploi (Survie conviviale, Faction / PvP ou Minimaliste) ou gardez les réglages par défaut. Les modèles peuvent aussi être appliqués plus tard depuis la page Modèles. Pour partir d'une configuration de serveur complète exportée ailleurs, voir modèles.

Cliquez sur Terminer, puis sur Ouvrir l'éditeur. Désormais, vous pouvez ouvrir l'éditeur à tout moment avec /inglis web. Voir éditeur web.

Utiliser MySQL ou MariaDB

Si vous avez choisi MySQL dans l'assistant, vos réglages et vos messages sont copiés automatiquement dans la nouvelle base. Redémarrez le serveur pour basculer dessus.

MySQL est indispensable pour relier plusieurs serveurs entre eux. Les autres serveurs de votre réseau rejoignent ensuite le réseau avec un code d'invitation, sans passer par l'assistant. Voir réseau.

Remarque

Si la base MySQL est injoignable au démarrage du serveur, InglisCore démarre en mode secours : les modules sont désactivés et seuls les opérateurs peuvent se connecter, pour que personne ne joue sur des données vides. Il retente la connexion toutes les 30 secondes et quitte le mode secours tout seul dès que la base est de retour.

Changer le port web

Par défaut, l'éditeur web partage votre port Minecraft. Certains hébergeurs ne le permettent pas, ou vous préférez peut-être un port séparé. Vous pouvez le changer dans l'éditeur, sous Système, ou depuis la console :

Commande Effet
/inglis setup port <port> Sert aussi l'éditeur sur un port dédié. Utilisez off pour le retirer.
/inglis setup share <on|off> Active ou désactive le partage du port Minecraft.
/inglis setup url <http://ip:port> Définit l'adresse publique utilisée dans les liens d'accès. Utilisez reset pour revenir à la détection automatique. Console uniquement.

Tout changement de port nécessite un redémarrage du serveur. Si le partage du port Minecraft échoue, la console vous le signale et vous suggère de définir un port dédié. Pensez à ouvrir ce port dans le pare-feu de votre hébergeur.

/inglis info affiche la version du plugin, la plateforme, le stockage, l'identifiant du serveur, les modules activés et l'adresse où l'éditeur web est accessible.

Mettre à jour InglisCore

  1. Téléchargez la nouvelle version.
  2. Arrêtez le serveur et remplacez l'ancien jar dans plugins par le nouveau.
  3. Démarrez le serveur.

Vos réglages, vos messages et les données des joueurs sont stockés dans la base de données et sont conservés. Sur un réseau, mettez à jour tous les serveurs pour qu'ils tournent tous sur la même version.

Passer de l'édition gratuite à l'édition complète se fait de la même façon : remplacez le jar, et tout ce que vous avez configuré est conservé. Voir éditions.

Commandes et permissions

Commande Permission Description
/inglis web inglis.web Vous donne un lien personnel vers l'éditeur web.
/inglis web revoke inglis.web Ferme toutes les sessions ouvertes de l'éditeur web.
/inglis info inglis.admin Affiche l'état du plugin.
/inglis setup inglis.web Réglages de secours : port, partage du port et adresse publique.
/inglis join <code> <pin> Console uniquement Rattache ce serveur à un réseau. Voir réseau.

Toutes les commandes /inglis nécessitent aussi inglis.admin. Les deux permissions sont données aux opérateurs par défaut. /inglis fonctionne aussi sous la forme /ingliscore et /ic.