Installation instructions - Revision history

F: /* Linux, Unix, MacOS X (Mono) */

2013-08-02T21:25:20Z

Linux, Unix, MacOS X (Mono)

← Older revision		Revision as of 21:25, 2 August 2013
Line 12:		Line 12:
	*MacOS X 10.6		*MacOS X 10.6
	If you are using a different distribution, use at your own risk.}}		If you are using a different distribution, use at your own risk.}}
	# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.		# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it. Read the README file.
	## Putting the PlayerDB.txt ~~on an~~ <code>NTFS~~</code>~~ partition can reduce chance of corruption on unsafe shutdown/power loss.		## Putting the <code>PlayerDB.txt</code> on an NTFS partition can reduce chance of corruption on unsafe shutdown/power loss.
	# fCraft requires Mono 2.8+ (minimum) or Mono 3.0+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).		# fCraft requires Mono 2.8+ (minimum) or Mono 3.0+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).
	# If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done by running <code>mozroots --import --ask-remove</code> as the fCraft user on your system.		# If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done by running <code>mozroots --import --ask-remove</code> as the fCraft user on your system.

F: /* Linux, Unix, MacOS X (Mono) */

2013-08-02T21:22:21Z

Linux, Unix, MacOS X (Mono)

← Older revision		Revision as of 21:22, 2 August 2013
Line 13:		Line 13:
	If you are using a different distribution, use at your own risk.}}		If you are using a different distribution, use at your own risk.}}
	# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.		# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.
	## Putting the PlayerDB.txt on an NTFS partition can ~~greatly~~ reduce chance of corruption on unsafe shutdown/power loss.		## Putting the PlayerDB.txt on an <code>NTFS</code> partition can reduce chance of corruption on unsafe shutdown/power loss.
	# fCraft requires Mono 2.~~6.4~~ (minimum) or Mono 2.10+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).		# fCraft requires Mono 2.8+ (minimum) or Mono 3.0+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).
	# If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done by running <~~CODE~~>mozroots --import --ask-remove</~~CODE~~> as the fCraft user on your system.		# If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done by running <code>mozroots --import --ask-remove</code> as the fCraft user on your system.
	# Before starting fCraft, make sure that it has read/write permissions in the fCraft directory. I do not recommend running fCraft as root - it is always safer to run servers under their own limited user accounts.		# Before starting fCraft, make sure that it has read/write permissions in the fCraft directory. I do not recommend running fCraft as root - it is always safer to run servers under their own limited user accounts.
	# To run ".exe" files with Mono, use the following syntax:		# To run ".exe" files with Mono, use the following syntax:
	#: Mono 2.~~6.4~~: <code>mono SomeFile.exe</code>		#: Mono 2.8+: <code>mono --gc=sgen SomeFile.exe</code>
	#: Mono 2.8+: <code>mono ~~--gc=sgen~~ SomeFile.exe</code>		#: Mono 3.0+: <code>mono SomeFile.exe</code>
	{{notice\|'''Consider using [[fcraftd]] script, made by Hellenion, to manage your *nix server!}}		{{notice\|'''Consider using [[fcraftd]] script, made by Hellenion, to manage your *nix server!}}
	# From here on out is roughly the same as on Windows. You can run <code>ConfigGUI.exe</code> to configure your server, and then either <code>ServerGUI.exe</code> OR <code>ServerCLI.exe</code> to start the server.		# From here on out is roughly the same as on Windows. You can run <code>ConfigGUI.exe</code> to configure your server, and then either <code>ServerGUI.exe</code> OR <code>ServerCLI.exe</code> to start the server.

Hellenion: /* Linux, Unix, MacOS X (Mono) */ NTFS recommendation

2013-06-01T14:09:03Z

Linux, Unix, MacOS X (Mono): NTFS recommendation

← Older revision		Revision as of 14:09, 1 June 2013
Line 13:		Line 13:
	If you are using a different distribution, use at your own risk.}}		If you are using a different distribution, use at your own risk.}}
	# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.		# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.
			## Putting the PlayerDB.txt on an NTFS partition can greatly reduce chance of corruption on unsafe shutdown/power loss.
	# fCraft requires Mono 2.6.4 (minimum) or Mono 2.10+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).		# fCraft requires Mono 2.6.4 (minimum) or Mono 2.10+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).
	# If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done by running <CODE>mozroots --import --ask-remove</CODE> as the fCraft user on your system.		# If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done by running <CODE>mozroots --import --ask-remove</CODE> as the fCraft user on your system.

F: /* Linux, Unix, MacOS X (Mono) */

2013-05-31T01:58:00Z

Linux, Unix, MacOS X (Mono)

← Older revision		Revision as of 01:58, 31 May 2013
Line 19:		Line 19:
	#: Mono 2.6.4: <code>mono SomeFile.exe</code>		#: Mono 2.6.4: <code>mono SomeFile.exe</code>
	#: Mono 2.8+: <code>mono --gc=sgen SomeFile.exe</code>		#: Mono 2.8+: <code>mono --gc=sgen SomeFile.exe</code>
			{{notice\|'''Consider using [[fcraftd]] script, made by Hellenion, to manage your *nix server!}}
	# From here on out is roughly the same as on Windows. You can run <code>ConfigGUI.exe</code> to configure your server, and then either <code>ServerGUI.exe</code> OR <code>ServerCLI.exe</code> to start the server.		# From here on out is roughly the same as on Windows. You can run <code>ConfigGUI.exe</code> to configure your server, and then either <code>ServerGUI.exe</code> OR <code>ServerCLI.exe</code> to start the server.
	#: If you want to run console-only on a headless server, the ConfigGUI probably won't work for you to configure things. You can run ConfigGUI on your local machine and upload edited config.xml and worlds.xml files. Alternatively, edit <code>config.xml</code> manually with your favorite text editor. Detailed information about config.xml keys can be found [[List of config keys\|here]].		#: If you want to run console-only on a headless server, the ConfigGUI probably won't work for you to configure things. You can run ConfigGUI on your local machine and upload edited config.xml and worlds.xml files. Alternatively, edit <code>config.xml</code> manually with your favorite text editor. Detailed information about config.xml keys can be found [[List of config keys\|here]].
	~~{{notice\|'''Consider using [[fcraftd]] script, made by Hellenion, to manage your *nix server!}}~~

	=[[Troubleshooting]]=		=[[Troubleshooting]]=
	==Autentication/Decription failed for heartbeats==		==Autentication/Decription failed for heartbeats==
	This recently surfaced when mollstam introduced https for minecraft.net, causing some trust issues with fCraft's heartbeats, especially under mono, since mono trusts no certificates by default. To fix this one must import certificates, with <CODE>mozroots --import --ask-remove</CODE> Mozillas certificates are imported into mono. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.)		This recently surfaced when mollstam introduced https for minecraft.net, causing some trust issues with fCraft's heartbeats, especially under mono, since mono trusts no certificates by default. To fix this one must import certificates, with <CODE>mozroots --import --ask-remove</CODE> Mozillas certificates are imported into mono. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.)

F: /* Linux, Unix, MacOS X (Mono) */

2013-05-31T01:57:38Z

Linux, Unix, MacOS X (Mono)

← Older revision		Revision as of 01:57, 31 May 2013
Line 21:		Line 21:
	# From here on out is roughly the same as on Windows. You can run <code>ConfigGUI.exe</code> to configure your server, and then either <code>ServerGUI.exe</code> OR <code>ServerCLI.exe</code> to start the server.		# From here on out is roughly the same as on Windows. You can run <code>ConfigGUI.exe</code> to configure your server, and then either <code>ServerGUI.exe</code> OR <code>ServerCLI.exe</code> to start the server.
	#: If you want to run console-only on a headless server, the ConfigGUI probably won't work for you to configure things. You can run ConfigGUI on your local machine and upload edited config.xml and worlds.xml files. Alternatively, edit <code>config.xml</code> manually with your favorite text editor. Detailed information about config.xml keys can be found [[List of config keys\|here]].		#: If you want to run console-only on a headless server, the ConfigGUI probably won't work for you to configure things. You can run ConfigGUI on your local machine and upload edited config.xml and worlds.xml files. Alternatively, edit <code>config.xml</code> manually with your favorite text editor. Detailed information about config.xml keys can be found [[List of config keys\|here]].
	#'''Consider using [[fcraftd]] script, made by Hellenion, to manage your *nix server!~~'''~~		{{notice\|'''Consider using [[fcraftd]] script, made by Hellenion, to manage your *nix server!}}

	=[[Troubleshooting]]=		=[[Troubleshooting]]=
	==Autentication/Decription failed for heartbeats==		==Autentication/Decription failed for heartbeats==
	This recently surfaced when mollstam introduced https for minecraft.net, causing some trust issues with fCraft's heartbeats, especially under mono, since mono trusts no certificates by default. To fix this one must import certificates, with <CODE>mozroots --import --ask-remove</CODE> Mozillas certificates are imported into mono. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.)		This recently surfaced when mollstam introduced https for minecraft.net, causing some trust issues with fCraft's heartbeats, especially under mono, since mono trusts no certificates by default. To fix this one must import certificates, with <CODE>mozroots --import --ask-remove</CODE> Mozillas certificates are imported into mono. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.)

F: /* Linux, Unix, MacOS X (Mono) */

2013-05-31T01:57:20Z

Linux, Unix, MacOS X (Mono)

← Older revision		Revision as of 01:57, 31 May 2013
Line 8:		Line 8:
	=Linux, Unix, MacOS X (Mono)=		=Linux, Unix, MacOS X (Mono)=
	{{notice\|fCraft has only been officially tested on		{{notice\|fCraft has only been officially tested on
	*Ubuntu 10		*Ubuntu 10/12
	*Debian 6		*Debian 6
	*MacOS X 10.6		*MacOS X 10.6
Line 21:		Line 21:
	# From here on out is roughly the same as on Windows. You can run <code>ConfigGUI.exe</code> to configure your server, and then either <code>ServerGUI.exe</code> OR <code>ServerCLI.exe</code> to start the server.		# From here on out is roughly the same as on Windows. You can run <code>ConfigGUI.exe</code> to configure your server, and then either <code>ServerGUI.exe</code> OR <code>ServerCLI.exe</code> to start the server.
	#: If you want to run console-only on a headless server, the ConfigGUI probably won't work for you to configure things. You can run ConfigGUI on your local machine and upload edited config.xml and worlds.xml files. Alternatively, edit <code>config.xml</code> manually with your favorite text editor. Detailed information about config.xml keys can be found [[List of config keys\|here]].		#: If you want to run console-only on a headless server, the ConfigGUI probably won't work for you to configure things. You can run ConfigGUI on your local machine and upload edited config.xml and worlds.xml files. Alternatively, edit <code>config.xml</code> manually with your favorite text editor. Detailed information about config.xml keys can be found [[List of config keys\|here]].
			#'''Consider using [[fcraftd]] script, made by Hellenion, to manage your *nix server!'''

	=[[Troubleshooting]]=		=[[Troubleshooting]]=
	==Autentication/Decription failed for heartbeats==		==Autentication/Decription failed for heartbeats==
	This recently surfaced when mollstam introduced https for minecraft.net, causing some trust issues with fCraft's heartbeats, especially under mono, since mono trusts no certificates by default. To fix this one must import certificates, with <CODE>mozroots --import --ask-remove</CODE> Mozillas certificates are imported into mono. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.)		This recently surfaced when mollstam introduced https for minecraft.net, causing some trust issues with fCraft's heartbeats, especially under mono, since mono trusts no certificates by default. To fix this one must import certificates, with <CODE>mozroots --import --ask-remove</CODE> Mozillas certificates are imported into mono. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.)

Hellenion: /* Linux, Unix, MacOS X (Mono) */ indenting

2012-10-01T17:43:30Z

Linux, Unix, MacOS X (Mono): indenting

← Older revision		Revision as of 17:43, 1 October 2012
Line 14:		Line 14:
	# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.		# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.
	# fCraft requires Mono 2.6.4 (minimum) or Mono 2.10+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).		# fCraft requires Mono 2.6.4 (minimum) or Mono 2.10+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).
	#: If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done ~~with~~ <CODE>mozroots --import --ask-remove</CODE> as the fCraft user on your system.		# If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done by running <CODE>mozroots --import --ask-remove</CODE> as the fCraft user on your system.
	# Before starting fCraft, make sure that it has read/write permissions in the fCraft directory. I do not recommend running fCraft as root - it is always safer to run servers under their own limited user accounts.		# Before starting fCraft, make sure that it has read/write permissions in the fCraft directory. I do not recommend running fCraft as root - it is always safer to run servers under their own limited user accounts.
	# To run ".exe" files with Mono, use the following syntax:		# To run ".exe" files with Mono, use the following syntax:

Hellenion: /* Linux, Unix, MacOS X (Mono) */ importing certificates is required for public servers.

2012-10-01T17:42:26Z

Linux, Unix, MacOS X (Mono): importing certificates is required for public servers.

← Older revision		Revision as of 17:42, 1 October 2012
Line 14:		Line 14:
	# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.		# Download a current copy of fCraft here: {{LatestVersion}}. Use ''gunzip'' to extract it.
	# fCraft requires Mono 2.6.4 (minimum) or Mono 2.10+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).		# fCraft requires Mono 2.6.4 (minimum) or Mono 2.10+ (recommended) runtime. You can [http://www.go-mono.com/mono-downloads/download.html download from www.mono-project.org], or (on some Linux distributions) install it through your package manager (like ''yum'' or ''apt-get''). If the latest version of Mono is not available for your platform, you can [[Building Mono\|build your own copy of Mono]]. Note that to be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need ''libgdiplus'' (GDI+ library).
			#: If you're intending to run a public server that appears on minecraft.net's server list, you need to import https certificates to tell mono you trust them, this can be done with <CODE>mozroots --import --ask-remove</CODE> as the fCraft user on your system.
	# Before starting fCraft, make sure that it has read/write permissions in the fCraft directory. I do not recommend running fCraft as root - it is always safer to run servers under their own limited user accounts.		# Before starting fCraft, make sure that it has read/write permissions in the fCraft directory. I do not recommend running fCraft as root - it is always safer to run servers under their own limited user accounts.
	# To run ".exe" files with Mono, use the following syntax:		# To run ".exe" files with Mono, use the following syntax:

Hellenion: /* Autentication/Decription failed for heartbeats */ improved rationale

2012-10-01T17:37:31Z

Autentication/Decription failed for heartbeats: improved rationale

← Older revision		Revision as of 17:37, 1 October 2012
Line 23:		Line 23:
	=[[Troubleshooting]]=		=[[Troubleshooting]]=
	==Autentication/Decription failed for heartbeats==		==Autentication/Decription failed for heartbeats==
	This recently surfaced when mollstam ~~moved www.minecraft.net in favour of~~ minecraft.net, causing some trust issues with fCraft's heartbeats. To fix this one must import ~~the latest~~ certificates with <CODE>mozroots --import --ask-remove</CODE>. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.		This recently surfaced when mollstam introduced https for minecraft.net, causing some trust issues with fCraft's heartbeats, especially under mono, since mono trusts no certificates by default. To fix this one must import certificates, with <CODE>mozroots --import --ask-remove</CODE> Mozillas certificates are imported into mono. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.)

Hellenion: /* Troubleshooting */ Added a piece aboot the Auth errors that surfaced recently.

2012-09-25T22:54:39Z

Troubleshooting: Added a piece aboot the Auth errors that surfaced recently.

← Older revision		Revision as of 22:54, 25 September 2012
Line 22:		Line 22:

	=[[Troubleshooting]]=		=[[Troubleshooting]]=
			==Autentication/Decription failed for heartbeats==
			This recently surfaced when mollstam moved www.minecraft.net in favour of minecraft.net, causing some trust issues with fCraft's heartbeats. To fix this one must import the latest certificates with <CODE>mozroots --import --ask-remove</CODE>. This must be done on the user-account that will run the server, importing it as root does not apply it system-wide. (it can be made system wide with <CODE>--machine</CODE> but this is not the default for a reason.