Minecraft Server - Revision history

Voklen: Add syntax highlighting to code examples

2026-01-26T11:27:49Z

Add syntax highlighting to code examples

← Older revision		Revision as of 11:27, 26 January 2026
Line 81:		Line 81:
	For example:		For example:

	<~~code~~>services.minecraft-server.package = pkgs.minecraftServers.vanilla-1-12;</~~code~~>		<syntaxhighlight lang="nix">
			services.minecraft-server.package = pkgs.minecraftServers.vanilla-1-12;
			</syntaxhighlight>

	or		or

	<~~code~~>services.minecraft-server.package = pkgs.papermc;</~~code~~>		<syntaxhighlight lang="nix">
			services.minecraft-server.package = pkgs.papermc;
			</syntaxhighlight>

	=== Prefer IPv4 ===		=== Prefer IPv4 ===

Holacomotalevu at 17:34, 25 January 2026

2026-01-25T17:34:48Z

← Older revision		Revision as of 17:34, 25 January 2026
Line 42:		Line 42:
	You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].		You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].

	See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option. ~~This~~ primarily ~~depends~~ on your Java version.		See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option. These primarily depend on your [[Java]] version.
	== Tips and tricks ==		== Tips and tricks ==

Holacomotalevu: Undo revision 29562 by Holacomotalevu (talk)

2026-01-25T17:33:52Z

Undo revision 29562 by Holacomotalevu (talk)

← Older revision		Revision as of 17:33, 25 January 2026
Line 42:		Line 42:
	You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].		You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].

	See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option. ~~These~~ primarily depends on your Java version.		See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option. This primarily depends on your Java version.
	== Tips and tricks ==		== Tips and tricks ==

Holacomotalevu at 17:33, 25 January 2026

2026-01-25T17:33:25Z

← Older revision		Revision as of 17:33, 25 January 2026
Line 42:		Line 42:
	You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].		You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].

	See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option. ~~This~~ primarily depends on your Java version.		See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option. These primarily depends on your Java version.
	== Tips and tricks ==		== Tips and tricks ==

Holacomotalevu at 17:32, 25 January 2026

2026-01-25T17:32:53Z

← Older revision		Revision as of 17:32, 25 January 2026
Line 42:		Line 42:
	You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].		You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].

	See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option.		See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option. This primarily depends on your Java version.
	== Tips and tricks ==		== Tips and tricks ==

Holacomotalevu: clarified flags --> jvm flags

2026-01-24T17:04:38Z

clarified flags --> jvm flags

← Older revision		Revision as of 17:04, 24 January 2026
Line 37:		Line 37:
	allow-cheats = true;		allow-cheats = true;
	};		};
	jvmOpts = "-Xms2048M -Xmx2048M";		jvmOpts = "-Xms2048M -Xmx2048M";
	};		};
	</nowiki>}}		</nowiki>}}
	You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].		You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].

	See [[#See also]] for recommended flags for the <code>jvmOpts</code> option.		See [[#See also]] for recommended JVM flags for the <code>jvmOpts</code> option.
	== Tips and tricks ==		== Tips and tricks ==

Line 94:		Line 94:

	* [https://github.com/Infinidoge/nix-minecraft nix-minecraft], a [[flake]] based attempt to better support Minecraft related content for the Nix ecosystem. It can be used for more complex server setups, including mods and plugins.		* [https://github.com/Infinidoge/nix-minecraft nix-minecraft], a [[flake]] based attempt to better support Minecraft related content for the Nix ecosystem. It can be used for more complex server setups, including mods and plugins.
	* https://exa.y2k.diy/garden/jvm-args for setting additional JVM ~~options~~ in the <code>jvmOpts</code> option. Some server-related software—like the Velocity proxy—have their own recommended flags list.		* https://exa.y2k.diy/garden/jvm-args for setting additional JVM flags in the <code>jvmOpts</code> option. Some server-related software—like the Velocity proxy—have their own recommended JVM flags list.
	* https://mcuuid.net to get a player's UUID from their current username or vice versa.		* https://mcuuid.net to get a player's UUID from their current username or vice versa.
	[[Category: Applications]]		[[Category: Applications]]
	[[Category: Gaming]]		[[Category: Gaming]]

Holacomotalevu at 15:54, 24 January 2026

2026-01-24T15:54:05Z

← Older revision		Revision as of 15:54, 24 January 2026
Line 42:		Line 42:
	You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].		You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].

	See [[#~~jvm-flags\|~~See also]] for recommended flags for the <code>jvmOpts</code> option.		See [[#See also]] for recommended flags for the <code>jvmOpts</code> option.
	== Tips and tricks ==		== Tips and tricks ==

Line 94:		Line 94:

	* [https://github.com/Infinidoge/nix-minecraft nix-minecraft], a [[flake]] based attempt to better support Minecraft related content for the Nix ecosystem. It can be used for more complex server setups, including mods and plugins.		* [https://github.com/Infinidoge/nix-minecraft nix-minecraft], a [[flake]] based attempt to better support Minecraft related content for the Nix ecosystem. It can be used for more complex server setups, including mods and plugins.
	~~<span id="jvm-flags"></span>~~
	* https://exa.y2k.diy/garden/jvm-args for setting additional JVM options in the <code>jvmOpts</code> option. Some server-related software—like the Velocity proxy—have their own recommended flags list.		* https://exa.y2k.diy/garden/jvm-args for setting additional JVM options in the <code>jvmOpts</code> option. Some server-related software—like the Velocity proxy—have their own recommended flags list.
	* https://mcuuid.net to get a player's UUID from their current username or vice versa.		* https://mcuuid.net to get a player's UUID from their current username or vice versa.
	[[Category: Applications]]		[[Category: Applications]]
	[[Category: Gaming]]		[[Category: Gaming]]

Holacomotalevu: removed an unnecessary space

2026-01-24T15:52:35Z

removed an unnecessary space

← Older revision		Revision as of 15:52, 24 January 2026
Line 95:		Line 95:
	* [https://github.com/Infinidoge/nix-minecraft nix-minecraft], a [[flake]] based attempt to better support Minecraft related content for the Nix ecosystem. It can be used for more complex server setups, including mods and plugins.		* [https://github.com/Infinidoge/nix-minecraft nix-minecraft], a [[flake]] based attempt to better support Minecraft related content for the Nix ecosystem. It can be used for more complex server setups, including mods and plugins.
	<span id="jvm-flags"></span>		<span id="jvm-flags"></span>
	* https://exa.y2k.diy/garden/jvm-args for setting additional JVM options in the <code>jvmOpts</code> option. Some server-related ~~software —like~~ the Velocity proxy—have their own recommended flags list.		* https://exa.y2k.diy/garden/jvm-args for setting additional JVM options in the <code>jvmOpts</code> option. Some server-related software—like the Velocity proxy—have their own recommended flags list.
	* https://mcuuid.net to get a player's UUID from their current username or vice versa.		* https://mcuuid.net to get a player's UUID from their current username or vice versa.
	[[Category: Applications]]		[[Category: Applications]]
	[[Category: Gaming]]		[[Category: Gaming]]

Holacomotalevu: updated flags and some other reordering/rewriting

2026-01-24T15:51:27Z

updated flags and some other reordering/rewriting

← Older revision		Revision as of 15:51, 24 January 2026
Line 2:		Line 2:
	{{tip/unfree}}		{{tip/unfree}}

	[https://minecraft.wiki/w/Server Minecraft Server] is a server for the ~~blocky~~ sandbox game [[Minecraft]]. Currently only servers for the [https://www.minecraft.net/en-us/article/java-or-bedrock-edition Java Edition] of ~~the game~~ are supported.		[https://minecraft.wiki/w/Server Minecraft Server] is a server for the sandbox game [[Minecraft]]. Currently, only servers for the [https://www.minecraft.net/en-us/article/java-or-bedrock-edition Java Edition] of Minecraft are supported.

	== Setup ==		== Setup ==
Line 24:		Line 24:
	declarative = true;		declarative = true;
	whitelist = {		whitelist = {
	# This is a mapping ~~from~~ Minecraft usernames to UUIDs~~. You can use https://mcuuid.net/ to get a Minecraft UUID for a username~~		# This is a mapping of Minecraft usernames to to the players' UUIDs
	username1 = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";		username1 = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
	username2 = "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy";		username2 = "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy";
Line 37:		Line 37:
	allow-cheats = true;		allow-cheats = true;
	};		};
	jvmOpts = "-Xms2048M -~~Xmx4096M~~";		jvmOpts = "-Xms2048M -Xmx2048M";
	};		};
	</nowiki>}}		</nowiki>}}
	You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].		You might want to view the [https://minecraft.wiki/w/Server.properties#Keys list of all available server properties for the vanilla server].

			See [[#jvm-flags\|See also]] for recommended flags for the <code>jvmOpts</code> option.
	== Tips and tricks ==		== Tips and tricks ==

	~~=== Use a different server version/package ===~~

	To use a specific server version, or another Minecraft server—such as [https://papermc.io/ PaperMC]—change <code>services.minecraft-server.package</code> to a nix package that represents your desired server.

	~~For example:~~

	~~<code>services.minecraft-server.package = pkgs.minecraftServers.vanilla-1-12;</code>~~

	or

	~~<code>services.minecraft-server.package = pkgs.papermc;</code>~~

	=== Accessing the Minecraft server console ===		=== Accessing the Minecraft server console ===

	The Minecraft server console allows you to view server logs and issue [https://minecraft.wiki/w/Commands commands] to the server interactively. The Minecraft server console is <strong>not</strong> directly accessible on NixOS—unlike on ~~imperative~~ systems, where running the server through a shell command provides the interactive console to the current terminal ~~session~~.		The Minecraft server console allows you to view server logs and issue [https://minecraft.wiki/w/Commands commands] to the server interactively. The Minecraft server console is <strong>not</strong> directly accessible on NixOS—unlike on non-declarative systems, where running the server through a shell command provides the interactive console to the current terminal.

	==== Accessing logs ====		==== Accessing logs ====
Line 85:		Line 74:
	};		};
	</nowiki>}}		</nowiki>}}

			=== Use a different server ===

			To use a specific server version, or another Minecraft server—such as [https://papermc.io/ PaperMC]—change <code>services.minecraft-server.package</code> to a nix package that represents your desired server.

			For example:

			<code>services.minecraft-server.package = pkgs.minecraftServers.vanilla-1-12;</code>

			or

			<code>services.minecraft-server.package = pkgs.papermc;</code>

	=== Prefer IPv4 ===		=== Prefer IPv4 ===
Line 93:		Line 94:

	* [https://github.com/Infinidoge/nix-minecraft nix-minecraft], a [[flake]] based attempt to better support Minecraft related content for the Nix ecosystem. It can be used for more complex server setups, including mods and plugins.		* [https://github.com/Infinidoge/nix-minecraft nix-minecraft], a [[flake]] based attempt to better support Minecraft related content for the Nix ecosystem. It can be used for more complex server setups, including mods and plugins.
	* [https://docs.papermc.io/paper/aikars-flags/ ~~Aikar's flags] or the [~~https://~~github~~.~~com~~/~~Mukul1127~~/~~Minecraft~~-~~Java-Flags Minecraft performance flags benchmark]~~ for setting additional JVM options in the <code>jvmOpts</code> option.		<span id="jvm-flags"></span>
			* https://exa.y2k.diy/garden/jvm-args for setting additional JVM options in the <code>jvmOpts</code> option. Some server-related software —like the Velocity proxy—have their own recommended flags list.
			* https://mcuuid.net to get a player's UUID from their current username or vice versa.
	[[Category: Applications]]		[[Category: Applications]]
	[[Category: Gaming]]		[[Category: Gaming]]

Holacomotalevu: /* Tips and tricks */

2025-08-29T15:53:08Z

Tips and tricks

← Older revision		Revision as of 15:53, 29 August 2025
Line 65:		Line 65:

	<code>journalctl -eu minecraft-server.service</code>		<code>journalctl -eu minecraft-server.service</code>

			The logs are also available in the <code>logs</code> subdirectory of the server's data directory, which is configured via <code>services.minecraft-server.dataDir</code>. The default value for this option is <code>/var/lib/minecraft</code>.

	==== Issuing commands ====		==== Issuing commands ====