Quick Start Guide

This is a step by step reference on how to create a Minecraft server with Sponge version 7 and above.

참고

Bukkit이나 Canary 서버에서 전환하고 계신가요? 그렇다면 Sponge로 이전하기 문서를 확인해주세요. Sponge 서버와의 차이점과 Sponge 서버로 전환하는 방법에 대해 설명합니다.

경고

BungeeCord나 Waterfall, 또는 Velocity 같은 서버 프록시를 사용하고 계신다면 Sponge 서버 설치 후 추가로 하셔야 할 게 있습니다. 서버 프록시와 함께 Sponge 사용하기 문서에서 확인하실 수 있습니다.

시스템 요구 사항

The version of Java that you require depends on the version of Sponge (and therefore Minecraft) that you wish to run:

SpongeAPI version	Minecraft version	Minimum Java Version	Notes
7.x	1.12.2	Java 8	Requires at least update 20. Does not work with Java 9 or later.
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

We also recommend a CPU with a large single core speed and at least 2GB of RAM (higher if you plan to run with mods). We highly recommend using the 64bit Java runtime.

See Java 설치 for more help with how to install Java.

경고

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나 SpongeVanilla가 무엇인가요?

Sponge는 공식 마인크래프트 서버 jar 파일과 직접 통합하는 두 가지의 공식 Sponge 구현체를 제공합니다.

SpongeForge - Sponge 플러그인과 Forge 모드를 사용할 수 있는 모드 서버 프로그램입니다.
SpongeVanilla - 바닐라 마인크래프트 서버에서 Sponge 기능을 사용할 수 있는 서버 프로그램입니다.

서버를 선택하기 전 알아두어야 할 몇 가지가 있습니다:

Sponge와 Forge 모드를 함께 사용하시려면 SpongeForge**만 **사용할 수 있습니다.
Sponge를 싱글 플레이에 사용하신다면 SpongeForge**를 **사용하셔야 합니다.
Sponge 기능을 지원하는 바닐라 서버를 원하신다면 SpongeForge**나 **SpongeVanilla 중 하나를 선택하시면 됩니다.

따라서 모든 경우에 SpongeForge를 사용해야 하지만, SpongeVanilla는 마인크래프트 Forge와 SpongeForge보다 업데이트 및 설정이 쉬운 장점이 있습니다.

참고

모장의 마인크래프트 코드를 사용하지 않고 SpongeAPI를 구현한 Lantern 같은 서버 프로그램도 있지만 이 문서에서는 SpongePowered 팀이 제공하는 구현체에 대해서만 기술합니다.

SpongeForge

SpongeForge is a mod for Minecraft Forge and therefore requires a Minecraft Forge server. Set up your Minecraft Forge server first. Once you have your server set up, you can get SpongeForge from our downloads page and place it in the “mods” directory alongside any other mods you may wish to install. You can then start your Forge server and Sponge should be loaded.

SpongeForge는 호환되는 마인크래프트 포지 빌드가 필요하다는 걸 명심하세요. 이 빌드 번호는 다운로드 페이지에서 파일명에 빌드 번호를 같이 명시하였습니다. SpongeForge를 업데이트할 때 마인크래프트 Forge도 업데이트해야 할 수도 있습니다.

경고

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.

마인크래프트 포지 서버를 만들고고 SpongeForge를 설치하는 방법에 대한 더 자세한 정보는 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.

You can get SpongeVanilla from our downloads page. Once downloaded, ensure that you run SpongeVanilla using the command line, as Sponge disables the server console GUI to increase performance. SpongeVanilla will download the appropriate version of Minecraft and setup the server structure for you.

For more information on creating a SpongeVanilla server, see SpongeVanilla 설치하기.

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 Sponge 설정하기.

플러그인 설치하기

The directory where plugins are installed depends on the version of Sponge that you are using.

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).

참고

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.

참고

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:

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: