OS X Minecraft server setup: Difference between revisions

Latest revision as of 11:53, 8 November 2015

Preface.

This page will describe how i run my Minecraft servers. All scripts i use will soon be available at my BitBucket repo. I just need to finish up the last few details before releasing my first version ;-)
Some of my inspiration was found at electricmonk.nl and minecraft.gamepedia.com.

The guide to YAMS.

User with limited privileges.

This way of creating a new user for your Minecraft Server IS complicated... but necessary if you want to run your Minecraft Server as secure as possible.
~~The login to GUI, makes it possible to run scheduled tasks using OS X launchd / launchctl~~ <-- bug ??

Follow the guide here like this, until you reach "append Groups/_minecraft GroupMembership _minecraft"

Execute the dscl command passwd /Users/_minecraft "YourTemporaryPassword"

Continue following the guide, but ONLY until you reach "You might want something like this to prevent the user from showing up in the login dropdown:".

Log out of OS X

Log in as "_minecraft", using "YourTemporaryPassword" from step 2. Skip everything related to the first userlogin on the GUI.

Log out.

Log in as your normal user.

Continue the user creation from "You might want something like this to prevent the user from showing up in the login dropdown:"

STOP completely when you reach "Creating the user home". The rest is covered here after :-)

Finish up by deleting the following obsolete files and folders.

cd ../_minecraft/

sudo rm -R Desktop Documents Downloads Movies Music Pictures

YAMS...

Action Terminal command

Change to the new user : sudo su - _minecraft

Download the sourcecode like this : curl -kLOs https://bitbucket.org/fmjensen/yams

unzip the scripts : unzip yams-<version>.zip

Change to the directory containing the scripts : cd yams-<version>

"Update" your server : ./admin_update_server

READ the output from the script you just ran, and ACT upon the information ;-)

About the YAMS scripts and files.

This part contains a description of all files in the zip file you downloaded.

admin_accept_eula

This script

admin_chk_version

This script

admin_ejectramdisk

This script

admin_launch_on_ramdisk

This script

admin_quit_read_command-fifo

This script

admin_read_command-fifo

This script

admin_stop_on_ramdisk

This script will stop the server gracefully if the following conditions are met:

Server is running on RAM disk

admin_update_server

This script can update the server if the following requirements are met:

Server must not be running.

RAM disk must be ejected. See admin_eject_ramdisk

admin_wipe_everything

This script
=== backup_exclude_list
This file

backup_ramdisk

This script

cmd_list

This script

cmd_raw

This script

cmd_say

This script

cmd_showhelp

This script

cmd_whitelist-add

This script

cmd_whitelist-delete

This script

cmd_whitelist-list

This script

cmd_xp2player

This script
=== net.minecraft.ramdisk.server.backup
This file
=== server-icon.png
This file
=== server.properties
This file

Personalize your server.

TBD

@@ Line 1: / Line 1: @@
-== Preface. ==
+__NOTOC__== Preface. ==
+<blockquote>
-This page will describe how i run my Minecraft servers.
+This page will describe how i run my Minecraft servers. All scripts i use will soon be available at my [https://bitbucket.org/fmjensen/yams BitBucket repo]. I just need to finish up the last few details before releasing my first version ;-)
+Some of my inspiration was found at [http://www.electricmonk.nl/log/2011/07/22/minecraft-server-optimization/ electricmonk.nl] and [http://minecraft.gamepedia.com/Tutorials/Create_a_Mac_OS_X_startup_daemon minecraft.gamepedia.com].
+</blockquote>
 == The guide to YAMS. ==
 <blockquote>
-=== Install [http://www.macports.org Macports]. ===
+=== User with limited privileges. ===
+<div class="toccolours mw-collapsible mw-collapsed">
+This way of creating a new user for your Minecraft Server IS complicated... but necessary if you want to run your Minecraft Server as secure as possible.<br />
+<strike>The login to GUI, makes it possible to run scheduled tasks using OS X launchd / launchctl</strike> <-- bug ??
+<div class="mw-collapsible-content">
+# Follow the guide here [http://minecraft.gamepedia.com/Tutorials/Create_a_Mac_OS_X_startup_daemon#The_hard_.28and_correct.29_way like this], until you reach <code>"append Groups/_minecraft GroupMembership _minecraft"</code>
+# Execute the dscl command <code>&nbsp;passwd /Users/_minecraft "YourTemporaryPassword"</code>
+# Continue following the guide, but ONLY until you reach "''You might want something like this to prevent the user from showing up in the login dropdown:''".
+# Log out of OS X
+# Log in as "_minecraft", using "YourTemporaryPassword" from step 2. Skip everything related to the first userlogin on the GUI.
+# Log out.
+# Log in as your normal user.
+# Continue the user creation from "You might want something like this to prevent the user from showing up in the login dropdown:"
+# STOP completely when you reach "Creating the user home". The rest is covered here after :-)
+Finish up by deleting the following obsolete files and folders.
-Installation is neatly described at the [http://www.macports.org/install.php Macports install] page.
+# <code>cd ../_minecraft/</code >
+# <code>sudo rm -R Desktop Documents Downloads Movies Music Pictures</code ></div>
+</div>
-=== Install [http://tmux.github.io tmux]. ===
+=== YAMS... ===
-Use macPorts for the install process. It can be done like this at the time of writing they page.
+{| class="mw-collapsible mw-collapsed wikitable"
-* <code>&nbsp;sudo port install tmux&nbsp;</code>
+! Action || Terminal command
-* type in your password, and you should get something similar to this:
+|-
-<blockquote><pre>Password:
+| Change to the new user :  || <code> sudo su - _minecraft </code>
---->  Computing dependencies for tmux
+|-
---->  Dependencies to be installed: libevent
+| Download the sourcecode like this : || <code>curl -kLOs <nowiki>https://bitbucket.org/fmjensen/yams</nowiki></code>
---->  Fetching archive for libevent
+|-
---->  Attempting to fetch libevent-2.0.22_1.darwin_15.x86_64.tbz2 from http://lil.fr.packages.macports.org/libevent
+| unzip the scripts :  || <code>unzip yams-<version>.zip</code>
---->  Attempting to fetch libevent-2.0.22_1.darwin_15.x86_64.tbz2 from http://mse.uk.packages.macports.org/sites/packages.macports.org/libevent
+|-
---->  Attempting to fetch libevent-2.0.22_1.darwin_15.x86_64.tbz2 from http://nue.de.packages.macports.org/macports/packages/libevent
+| Change to the directory containing the scripts :  || <code>cd yams-<version></code>
---->  Fetching distfiles for libevent
+|-
---->  Attempting to fetch libevent-2.0.22-stable.tar.gz from http://skylink.dl.sourceforge.net/levent/libevent/libevent-2.0
+| "Update" your server :  || <code>./admin_update_server</code>
---->  Verifying checksums for libevent
+|-
---->  Extracting libevent
+| READ the output from the script you just ran,  || and ACT upon the information ;-)
---->  Applying patches to libevent
+|}
---->  Configuring libevent
---->  Building libevent
---->  Staging libevent into destroot
---->  Installing libevent @2.0.22_1
---->  Activating libevent @2.0.22_1
---->  Cleaning libevent
---->  Fetching archive for tmux
---->  Attempting to fetch tmux-2.1_0.darwin_15.x86_64.tbz2 from http://lil.fr.packages.macports.org/tmux
---->  Attempting to fetch tmux-2.1_0.darwin_15.x86_64.tbz2 from http://mse.uk.packages.macports.org/sites/packages.macports.org/tmux
---->  Attempting to fetch tmux-2.1_0.darwin_15.x86_64.tbz2 from http://nue.de.packages.macports.org/macports/packages/tmux
---->  Fetching distfiles for tmux
---->  Attempting to fetch tmux-2.1.tar.gz from http://lil.fr.distfiles.macports.org/tmux
---->  Verifying checksums for tmux
---->  Extracting tmux
---->  Configuring tmux
---->  Building tmux
---->  Staging tmux into destroot
---->  Installing tmux @2.1_0
---->  Activating tmux @2.1_0
-If you want integration with system pasteboard consider installing port tmux-pasteboard as well
---->  Cleaning tmux
---->  Updating database of binaries
---->  Scanning binaries for linking errors
---->  No broken files found.</pre>
 </blockquote>
-=== User with limited privileges. ===
+== About the YAMS scripts and files. ==
+<blockquote>
+<div class="toccolours mw-collapsible mw-collapsed">
+This part contains a description of all files in the zip file you downloaded.
+<div class="mw-collapsible-content">
+=== admin_accept_eula ===
+This script
+=== admin_chk_version ===
+This script
+=== admin_ejectramdisk ===
+This script
+=== admin_launch_on_ramdisk ===
+This script
+=== admin_quit_read_command-fifo ===
+This script
+=== admin_read_command-fifo ===
+This script
+=== admin_stop_on_ramdisk ===
+This script will stop the server gracefully if the following conditions are met:
+* Server is running on RAM disk
+=== admin_update_server ===
+This script can update the server if the following requirements are met:
+* Server must not be running.
+* RAM disk must be ejected. See admin_eject_ramdisk
+=== admin_wipe_everything ===
+This script
+=== backup_exclude_list
+This file
+=== backup_ramdisk ===
+This script
+=== cmd_list ===
+This script
+=== cmd_raw ===
+This script
+=== cmd_say ===
+This script
+=== cmd_showhelp ===
-Do it [http://minecraft.gamepedia.com/Tutorials/Create_a_Mac_OS_X_startup_daemon#The_hard_.28and_correct.29_way like this]... stop when you get to the headline "Moving the server files".
+This script
-=== BitBucket scripts for running a Minecraft server. ===
+=== cmd_whitelist-add ===
-# Change to the new user
+This script
-TBD
-=== About the server update script. ===
+=== cmd_whitelist-delete ===
-This script can update the server, IF it is not running... and since you have not downloaded any jar-files yet, i don't think it is running ;-)
+This script
-You will need to manually obtain the following files:
+=== cmd_whitelist-list ===
-* bin/blah... (link to file)
-* eula.txt  (command to create and populate it)
-# Make sure you are logged in as the ''_minecraft'' user, and you are in the correct folder.
+This script
+=== cmd_xp2player ===
-TBD
+This script
-=== Edit configuration files. ===
+=== net.minecraft.ramdisk.server.backup
-XXX
+This file
-=== Test if the server behaves and works as expected.. ===
+=== server-icon.png
-# Change to the new user
+This file
-TBD
-=== XXX. ===
+=== server.properties
-XXX
+This file
+</div>
+</div>
 </blockquote>
+== Personalize your server. ==
+TBD
 [[Category:Apple]]
 [[Category:Minecraft]]

Action	Terminal command
Change to the new user :	`sudo su - _minecraft`
Download the sourcecode like this :	`curl -kLOs https://bitbucket.org/fmjensen/yams`
unzip the scripts :	`unzip yams-<version>.zip`
Change to the directory containing the scripts :	`cd yams-<version>`
"Update" your server :	`./admin_update_server`
READ the output from the script you just ran,	and ACT upon the information ;-)