Foire aux Questions

Avertissement

Cette documentation est faire pour une ancienne version de SpongeAPI et n’est plus maintenue. Même si les examples de code fonctionnent toujours pour cette version de l’API, les politiques, lignes de conduite, et quelques liens peuvent avoir changé. Veuillez vous rendre sur la dernière version de la documentation pour ces derniers.

Pour tous

Qu’est-ce que Sponge ?

Sponge est une nouvelle API Minecraft polyvalente. Elle a été créée pour enrichir votre expérience de Minecraft en autorisant les plugins à ajouter des fonctionnalités à Minecraft. Vous pouvez en savoir plus à propos de Sponge ici : Introduction et à propos de son histoire ici : L’histoire de Sponge

Qu’est-ce qui est requis pour lancer Sponge ?

Sponge (et Minecraft) nécessite Java Runtime Environment (JRE) pour fonctionner correctement. Bien évidemment, vous aurez également besoin d’un ordinateur sur lequel faire fonctionner le serveur, mais hormis cela rien n’est nécessaire. Apprenez-en plus sur comment choisir la version de Java appropriée ici : Installation de Java

Où puis-je obtenir Sponge ?

Les builds de développement bêta de SpongeForge et SpongeVanilla sont déjà disponibles : Téléchargements de Sponge

Quelles-sont les implémentations de Sponge disponibles ?

Le projet Sponge développe actuellement deux implémentations qui utilisent toutes les deux la SpongeAPI :

  1. SpongeForge, un coremod pour Minecraft Forge, est un modding framework Minecraft connu pour stimuler le modding Minecraft. Il manquait à Forge une API inter-version, c’est là où Sponge entre en jeu. Sponge permet aux administrateurs d’intégrer des plugins à leurs serveurs facilement, ce qui rend la gestion de ceux-ci plus simple. (SpongeForge était tout simplement nommé Sponge dans le passé, mais il a été renommé pour éviter toutes confusions).

  2. SpongeVanilla, est une implémentation indépendante de l’API Sponge, fonctionnant comme surcouche du serveur Minecraft vanilla. (SpongeVanilla était anciennement connu sous le nom de Granite, jusqu’à ce que les équipes de développement fusionnent).

Où puis-je obtenir des plugins pour Sponge ?

Sur notre dépôt de plugins officiel, appelé Ore. Son développement a déjà commencé sur GitHub. Mais les plugins sont temporairement hébergés sur les SpongeForums.

Qu’est-il arrivé à Bukkit ?

Le projet Bukkit a stoppé le développement de leur API ainsi que celle de leur serveur modifié. Peu après, un des contributeurs de Bukkit à envoyé un ordre de retrait via le DMCA afin d’arrêter la distribution de CraftBukkit. Il était dans ses droits. Les téléchargements, ainsi que le code source, de CraftBukkit et de ses dérivés (comme Spigot et Cauldron) ne sont plus disponibles publiquement. Si vous souhaitez savoir en quoi cela a affecté le développement de Sponge, jetez un œil à notre page histoire : L’histoire de Sponge

Puis-je utiliser des plugins Bukkit avec Sponge ?

Malheureusement non, pas de manière native. Sponge utilise sa propre API (Sponge API), alors que Bukkit utilise l’API Bukkit. Cependant, il est possible qu’un plugin pour Sponge implémente l’API Bukkit par dessus l’API de Sponge.

Pour les propriétaires de serveur

Je suis propriétaire d’un serveur ! Comment le passage à Sponge va t-il affecter mon serveur ?

Pour un serveur Forge existant, vous devrez télécharger Sponge et le placer dans le dossier mods. Le serveur peut alors être démarré comme n’importe quel autre serveur Forge.

Les serveurs n’utilisant pas Forge peuvent utiliser SpongeVanilla à la place, une implémentation qui n’est pas basée sur Forge. Il existe des guides pour migrer depuis Bukkit et/ou Canary sur SpongeDocs. Il est bon de noter que de nombreux développeurs de la communauté Bukkit supportent désormais Sponge et prévoient de rendre disponibles leurs plugins pour les serveurs utilisant Sponge.

Il sera possible d’utiliser des mondes existants avec Sponge. Il revient cependant aux développeurs de plugins de créer un processus de conversion permettant de conserver les données de leurs plugins, si c’est nécessaire. Certains développeurs ne le feront peut-être pas.

Par ailleurs, nous ne fournirons pas de support pour les plugins Bukkit sur Sponge. Cependant, il est possible pour un membre de la communauté de créer un moyen de faire fonctionner les plugins Bukkit sur Sponge.

Comment le passage à Sponge va-t-il affecter les joueurs de mon serveur ?

Le passage à Sponge ne devrait pas affecter les joueurs sur votre serveur. Si vous (en tant que propriétaire d’un serveur) organisez la migration correctement, les joueurs pourront se connecter sur votre serveur de la même façon qu’avant la migration vers Sponge. Ils n’auront pas besoin d’avoir Forge installé - à moins que votre serveur nécessite des mods Forge bien sûr.

Pour les développeurs

Qu’est-il possible de faire avec Sponge ?

Sponge fourni une API de Plugins. Cela signifie que vous pouvez créer du nouveau contenu et de nouveaux modes de jeu à la volée. Consultez nos pages concernant les plugins pour obtenir un aperçu rapide : Création d’un Plugin

Qu’est-ce que je ne peux pas faire avec Sponge ? / Quelles sont ses limitations ?

Sponge ne peut pas être utilisé pour créer de nouveaux blocs, textures ou mobs du côté client, de même que n’importe quel contenu qui nécessiterait une modification du client. Pour le moment, l’API Sponge ne supportera pas l’envoi de mods ou de plugins au client pour des raisons de sécurité. Cependant, vous pouvez utiliser la ForgeAPI pour les clients et créer des plugins Sponge du côté serveur. Il est même possible d’utiliser Sponge sur le client, mais pour plusieurs fonctionnalités des mods sont toujours requis.

Je suis un développeur de plugins Bukkit ! Pourquoi Sponge ne peut-il pas utiliser l’API Bukkit ?

L’API Bukkit contient des lignes de code sous la licence GPL. C’est une des principales raisons pour laquelle Bukkit a disparu en septembre. En créant une nouvelle API sous la licence MIT, nous pourrons éviter les problèmes de Bukkit, bien que cela ne nous libère pas du contrôle de Mojang, étant donné qu’ils sont propriétaires de leur code. Mais nous sommes convaincus que Mojang soutient le modding et continuera à le faire.

Serais-je capable d’accéder aux fonctions internes du serveur avec mes plugins ?

L’accès aux fonctions internes du serveur (connues sous le nom « NMS » ou « net.minecraft.server » dans CraftBukkit) peut se faire via MCP, qui possède un grand nombre de méthodes simplifiées. Cependant, sachez qu’accéder à ces fonctions augmente le risque de dysfonctionnement de votre plugin, c’est à vous de voir.

Voir Plugins dépendants des implémentations pour une introduction à l’utilisation de MCP dans vos plugins.