Quick Start Guide

Este é um passo a passo de referência de como criar um servidor Minecraft com Sponge versão 7 ou superior.

Nota

Are you migrating from a Bukkit or Canary based server? Please read Migrando ao Sponge as it explains the differences between these platforms and Sponge, and explains the migration process.

Aviso

If you’re running behind a server proxy such as BungeeCord, Waterfall or Velocity, there are additional steps you must follow once Sponge is installed, which are documented in Using Sponge with Server Proxies.

System Requirements

A versão do Java necessária depende da versão do Sponge (e consequentemente do Minecraft) que deseja executar:

Versão da SpongeAPI	Versão do Minecraft	Versão miníma do Java	Notas
7.x	1.12.2	Java 8	Requer pelo menos a atualização 20. Não funciona com Java 9 ou superior.
8.x	1.16.5	Java 8	Java 17 is recommended on Sponge Vanilla. Java 11 is recommended on Sponge Forge.
9.x	1.18	Java 17	No longer in development
10.x (unreleased)	1.19.4	Java 17	Still in development
11.x (unreleased)	1.20.1	Java 17	Minecraft version may change

Nós também recomendamos uma CPU com uma alto desempenho em um único núcleo e no minímo 2GB de RAM (maior se planeja utilizar mods). É altamente recomendado uma versão 64bit do Java.

See Instalando o Java for more help with how to install Java.

Aviso

Forge for 1.16.5 cannot run on Java 17 or newer, for this reason we recommend Java 11 as it is the latest Java that is long term supported.

SpongeForge or SpongeVanilla?

There are two official Sponge implementations on offer that integrate directly with the official Minecraft server jar:

• SpongeForge - a mod for Forge that allows you to use Sponge plugins with Forge mods;

• SpongeVanilla - a server jar that adds Sponge support directly into vanilla Minecraft.

When choosing, there are a few things to keep in mind:

• If you want to run Forge mods alongside Sponge, you must use SpongeForge.

• If you want to run Sponge in single player, you must use SpongeForge.

• If you want a vanilla server with Sponge support, you can use either SpongeForge or SpongeVanilla.

While this suggests that you should use SpongeForge in all cases, SpongeVanilla can actually be easier to update and setup than Minecraft Forge and SpongeForge.

Nota

Other implementations of the SpongeAPI exist that do not use Mojang’s Minecraft code, such as Lantern. This guide will only focus on the implementations that the Sponge Project provides.

SpongeForge

SpongeForge é um mod para Minecraft Forge e consequentemente requer um servidor Minecraft Forge. Configure seu servidor Minecraft Forge primeiro. Assim que seu servidor estiver configurado, você pode baixar o SpongeForge da nossa página de downloads e colocar no diretório “mods”, juntamente com os outros mods que deseja instalar. Você pode então iniciar seu servidor Forge e o Sponge será carregado.

Note that SpongeForge requires a compatible build of Minecraft Forge to be installed on your server. The version we build against is indicated on the downloads page, as well as the filename. Updating SpongeForge may also require an update to Minecraft Forge.

Aviso

Some mods may clash with SpongeForge’s changes causing errors to appear on the console. Before reporting this to Sponge, please refer to When Things Go Wrong, particularly Mod Compatibility. You can also ask us for help on our support channels.

For more information on how to create a Minecraft Forge server and install SpongeForge, see Instalar o SpongeForge.

SpongeVanilla

SpongeVanilla is a server wrapper for vanilla Minecraft that adds the Sponge code to Minecraft when run. Unlike SpongeForge, you do not need to have created a Minecraft server before running SpongeVanilla. It is therefore simpler to setup and update, making it a good option for those that simply want the Vanilla experience.

Você pode obter o SpongeVanilla da nossa página de downloads. Assim que baixado, execute o SpongeVanilla usando a linha de comando, pois o Sponge desabilita a interface gráfica do servidor para aumentar o desempenho. O SpongeVanilla irá baixar a versão apropriada do Minecraft e configurar a infraestrutura do servidor para você.

For more information on creating a SpongeVanilla server, see Instalando o SpongeVanilla.

Configurando o Sponge

Sponge is a highly configurable product. While the core is designed to provide the SpongeAPI for servers, Sponge also adds optional performance optimizations and exploit patches to the vanilla game, as well as fine tuning some of Sponge’s advanced systems. The configuration file can be found in the config/sponge directory.

For more information about how to configure Sponge, see Configurando o Sponge.

Instalar Plugins

O diretório onde os plugins são instalados depende da versão do Sponge que você estiver utilizando.

• For SpongeAPI 7 and earlier, plugins go in the /mods directory.

• For SpongeAPI 8 and later, plugins go in the /plugins directory.

Once you have added your plugins to the plugins directory, start (or restart) your server. Your plugins should then be available, which you can verify by running the /sponge plugins list command (On Sponge API 7 and earlier this command is /sponge plugins).

Nota

Sponge does not have an equivalent to Bukkit’s /reload command and so plugins cannot be unloaded and reloaded during the server lifetime. The server must be restarted to change plugins.

Once plugins are installed, they may generate configuration files. The Sponge convention is that these files are placed in the config directory, but this may vary. Read the plugin documentation for any specific guidance.

For more information about plugins, please see our page on installing plugins.

Nota

You can find community supplied Sponge plugins on our hosted plugin repository Ore.

Next Steps

Now you have created your server, we recommend you familiarize yourself with the following so that you can manage your server effectively:

• Gerir a Whitelist

• Gerir os Bans

• Gerir Permissões

• Instalar Plugins

• Correção de exploração de bugs

• Ajustes de Desempenho

• Comandos e Permissões

When Things Go Wrong

From time to time, incompatible mods or other strange behavior might cause problems on your server. Before reaching out for help, following the advice on these pages may help you fix your problems quickly:

• Mod Compatibility

• Resolução de Problemas

• Depuração

• Ficheiros de Registo