Minecraft:Server.jar

Template:Infobox program Template:Pointer box server.jar is an executable

1. REDIRECT Template:Wikipedia

Template:Redr file containing the program and resources of the Java Edition server software. It is distributed by Mojang Studios and can be downloaded free of charge.

Code is shared between server.jar and Minecraft:client.jar, meaning they are identical in gameplay. The client.jar file provides an internal server used for playing singleplayer worlds, but server.jar does not provide a client.

Contents

The server.jar file can be opened with a

1. REDIRECT Template:Wikipedia

Template:Redr that supports ZIP files.

When ran, libraries from the contained META-INF directory are extracted into the working directory. This behavior can further be configured by a different main class available on the JAR file, see Template:Slink.

The archive also contains a version.json file, which provides version information.

Directory structure

Upon running the server.jar, the program generates the following files and directories:

• Template:File: The working directory of the server software process.
  • Template:File: contains external libraries and JAR files required by the server software.
  • Template:File: a versioned JAR file that contains the primary code and resources for the server (similar to Minecraft:client.jar, but without client-related files, e.g. rendering code).
  • Template:File: Contains logs.
    • Template:File: Rotated older log. There might be any number of these files depending on how many times the log was rotated. Same format as latest.log, but compressed with gzip.
    • Template:File: The most recent log. UTF-8 format, CRLF line endings on Windows, LF line endings on Linux and macOS.
  • Template:File: World data directory. Can have different name or location if the default value in server.properties is changed. Not generated until the EULA is accepted.
  • Template:File: Specifies IP addresses that are banned from the server. Not generated until the EULA is accepted.
  • Template:File: Specifies players that are banned from the server. Not generated until the EULA is accepted.
  • Template:File: Contains information about the EULA applying to the server software, as well as specifying whether the user has accepted it.
  • Template:File: Specifies operator status of players. Not generated until the EULA is accepted.
  • Template:File: Server icon that appears on the server list. Not generated automatically. Must be in PNG format and 64x64 pixels.
  • Template:File: Primary server software JAR file. Can be located elsewhere, but usually placed in the same directory as the rest of the server data.
  • Template:File: Preset configuration file used to configure most of the server's functionality.
  • Template:File: Specifies players that are whitelisted. Not generated until the EULA is accepted.

Files are generated on the first run if not mentioned otherwise.

eula.txt

If an eula.txt file does not exist on startup, it is generated with default content and the program exits. The default content is as follows:

<syntaxhighlight lang="properties">

1. By changing the setting below to TRUE you are indicating your agreement to our EULA (https://aka.ms/MinecraftEULA).
2. [Generation time]

eula=false </syntaxhighlight>

Much like server.properties, it follows the

1. REDIRECT Template:Wikipedia

Template:Redr syntax. eula has to be set to true for the server to start.

Interface

The server software has both a command-line interface and a basic

1. REDIRECT Template:Wikipedia

Template:Redr.

The command-line interface outputs logs to the

1. REDIRECT Template:Wikipedia

Template:Redr, and accepts newline delimited input from the

1. REDIRECT Template:Wikipedia

Template:Redr, which is executed by the server as Minecraft:commands (similar to being executed by command blocks, but with the highest privilege level). Running a command in the interface does not require / at the beginning of the line.

The GUI appears if the platform supports windowing and the --nogui or nogui option is not provided. It is written in

1. REDIRECT Template:Wikipedia

Template:Redr (AWT), and it features three sections:

• "Stats" which displays memory usage as a graph and as a value, and average tick time,
• "Players" which displays a player list, and
• "Log and chat" which displays logs and serves the same function as the command-line interface.

Command-line options

<section begin="command-line-options"/>

Option	Description
--bonusChest	Enable the bonus chest when generating a world for the first time.
--demo	Enable demo mode. Shows the players a demo pop-up, and players cannot break or place blocks after the 5 in-game days demo time has expired, even if they have purchased the game.
--eraseCache	Erase cached data like light levels and biome data, which must then be regenerated. Equivalent to the "Erase Cached Data" option of "Optimize World" in World Options on the client.
--forceUpgrade	Optimize the world by upgrading the level data to the latest format. Once the world is optimized, it is no longer compatible with older level formats. Equivalent to the "Optimize World" option in World Options on the client.
--help	Print available options without starting the server.
--initSettings	Initialize Minecraft:server.properties and eula.txt without starting the server. If either file is missing, it creates them with default values.
--jfrProfile	Initialize REDIRECT Template:Wikipedia Template:Redr profiler for the server. While the server is running, the profiler can be opened using an external tool or software, such as VisualVM. It enables monitoring of the server's CPU, memory, and threads usage. Additionally, it saves a jfr file on the debug folder of the server.jar, containing JVM and operating system events, and several Minecraft-related custom events. Further information on Template:Slink.
--nogui	Disable the GUI when launching the server.
nogui	Legacy alias of --nogui.
--pidFile <path>	Create a text file at path containing the REDIRECT Template:Wikipedia Template:Redr (PID) of the server process while it's running.
--port <port>	Specify the TCP port to use instead of the value in server.properties.
--recreateRegionFiles	Optimize the world similar to --forceUpgrade, but also rewrites all the chunks independently of whether they have been upgraded, creating fresh and defragmented region files.<ref>Template:Cite</ref> Using this option after changing region-file-compression in server.properties will recompress all region files in the new format.
--safeMode	Ensure the server only loads the vanilla data pack.
--serverId <id>	Specify the "Server Id" string used in the crash report details.
--universe <path>	Specify the path to the directory level-name in server.properties is relative to. If empty, it is relative to the working directory.
--world <name>	Specify the world name to use instead of the level-name value in server.properties.

<section end="command-line-options"/>

Bundler options

The server.jar introduces an extra layer of code (called the "bundler") for extracting runtime libraries. This allows the main class to be specified at startup using system properties.

The following system properties can change the startup behavior:<ref>Template:Cite</ref>

• bundlerMainClass: Specifies the main class to start. If not specified, the main class defined on META-INF/main-class file in the server.jar (usually net.minecraft.server.Main) is used instead. There are three available main classes:
  • net.minecraft.server.Main: Used for launching the Minecraft server.
  • net.minecraft.data.Main: Used as entry point for Template:Tpl.
  • net.minecraft.gametest.Main: Used as an entry point for the Minecraft:GameTest framework, which provides its own command-line options.<ref>Template:Cite</ref>
  • Unspecified: If no option is specified or an empty blank string ("") is entered, it results in Empty main class specified, exiting.

Before executing the main class, the JAR file automatically extracts

1. REDIRECT Template:Code

Template:Redr and

1. REDIRECT Template:Code

Template:Redr folders, even for unspecified option.

• bundlerRepoDir: Specifies the working directory for the resources extraction. If not specified, the current working directory is used instead.

System properties are specified like -D<property>, which property is the name defined above. They must be specified for the JVM program in the command-line, placed before -jar parameter (otherwise it will be specified for the server.jar file, which is invalid), e.g. java -DbundlerMainClass="net.minecraft.data.Main" -jar server.jar is a valid execution.

History

Template:Hatnote {{#vardefine:params|0 }}Template:Hatnote Template:HistoryTable

References

<references/>

See also

• Minecraft:Bedrock Dedicated Server, the server software used to host a Bedrock Edition server.
• Minecraft:client.jar, the program and resources for the Java Edition game.

Navigation

Concepts Template:BlockLink Template:EnvLink Template:EffectLink Template:Nbt Loot context Template:EntityLink Template:BlockLink Template:File Identifier Template:BlockLink Template:EnvLink Template:ItemLink Template:ItemLink Template:EnvLink Template:BlockLink General format Template:EnvLink Template:LegacyBlockLink Remake Template:EntityLink Template:BlockLink Template:EnvLink Template:BlockLink Template:EnvLink Template:ItemLink Template:Nbt NBT format Template:EffectLink Template:ItemLink § Formatting codes Template:FileLink Template:FileLink Template:BlockLink Template:EnvLink World Template:EnvLink Template:EnvLink Anomalous Template:EnvLink Legacy Template:EnvLink Level format Template:BlockLink Template:EnvLink Template:EntityLink Template:BlockLink Template:EntityLink Template:BlockLink Template:EnvLink Legacy Template:LegacyBlockLink Classic server protocol Template:EntityLink Template:EnvLink Template:LegacyItemLink Template:ItemLink Template:FileLink Template:EnvLink Template:EnvLink .minecraft Template:File client.jar Template:EnvLink Template:ItemLink Template:BlockLink Template:Blocklink Template:FileLink Template:EnvLink Template:ItemLink Template:FileLink Tools Template:Keys Debug screen hotkey renderer Template:FileLink Template:BlockLink Template:FileLink Template:BlockLink Sound Template:BlockLink Template:EnvLink Template:EnvLink Commands Brigadier Template:BlockLink All commands Launching Mojang API Template:FileLink Template:FileLink Legacy Legacy Minecraft authentication Yggdrasil Protocol Template:EnvLink Template:ItemLink Data types Template:BlockLink Server Template:File server.jar Template:BlockLink Template:BlockLink Template:BlockLink Operator list Protocols Query RCON Server Management Protocol Legacy al_version Template:EnvLink

Components Template:Mono Template:EnvLink Template:ItemLink Template:BlockLink Template:BlockLink Template:ItemLink Template:BlockLink Template:BlockLink Template:EffectLink Template:EnvLink Template:ItemLink Template:BlockLink Template:ItemLink Template:BlockLink Template:ItemLink Template:BlockLink Template:BlockLink Template:EntityLink Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:EntityLink Trade set World Clock Template:EntityLinkTemplate:Upcoming Tag Template:BlockLink Template:EnvLink Template:BlockLink Template:ItemLink Template:EnvLink Template:BlockLink Template:BiomeLink Template:EnvLink Template:EnvLink Template:EnvLink Template:BlockLink Template:ItemLink Template:BlockLink Template:ItemLink Template:Healthbar Damage type Template:ItemLink Template:ItemLink Template:ItemLink Template:ItemLink Template:EntityLink Template:FileLink GameTest Template:BlockLink Template:BlockLink World generation Dimension Template:EnvLink Template:EnvLink Template:EnvLink Template:EnvLink Template:FileLink Template:EnvLink Template:EnvLink Environment attribute Noise settings Template:EnvLink Template:EnvLink Noises Template:EnvLink Structures Template:EnvLink Template:BlockLink Template:BlockLink Template:EnvLink Removed Template:ItemLink Data packs Template:BlockLink Template:ItemLink Tutorials Template:EnvLink Template:FileLink Optimizing Template:BlockLink Repairing a world corrupted by a data pack Content Template:ItemLink Template:ItemLink Template:ItemLink World generation Template:EnvLink Template:EnvLink

Components Template:Mono Template:EnvLink Template:EnvLink Template:EntityLink Template:BlockLink Template:EnvLink Template:EnvLink (sounds.json) Shaders Template:EnvLink Template:ItemLink Aa Fonts Template:BlockLink Template:File Texts Template:FileLink regional_compliancies.json Template:ItemLink Debug Missing font character Template:BlockLink Template:BlockLink Tools Slicer Legacy Texture Ender Unstitcher Tutorials Template:FileLink Template:FileLink Template:EnvLink Template:EnvLink

de:server.jar fr:server.jar ja:Server.jar pt:Server.jar zh:服务端核心文件