Jump to content

Installation instructions: Difference between revisions

From fCraft Wiki
← Older edit

F (talk | contribs)

2 user groups
2,040 edits
No edit summary
 
(27 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{alert|When first starting fCraft, type this in the console of your running server:
<code>/promote YourUserName DesiredClassName</code>
to promote yourself.}}
=Windows=
=Windows=
# fCraft requires Microsoft .NET Framework 3.5. Your system may already have it installed, and you can [http://www.microsoft.com/download/en/details.aspx?id=22 download it from microsoft.com].
# fCraft requires Microsoft .NET Framework 3.5. Your system may already have it installed, and you can [http://www.microsoft.com/download/en/details.aspx?id=22 download it from microsoft.com].
# Download a current copy of fCraft here: {{LatestVersion}}
# Download a current copy of fCraft here: {{LatestVersion}}
# Extract the zip file into the directory where you wish to keep all the server data (maps, logs, config, etc).
# Extract the zip file into the directory where you wish to keep all the server data (maps, logs, config, etc).
# Run <code>ConfigTool.exe</code> before starting the server and carefully configure the options. Your configuration will be stored in <code>config.xml</code>.
# Run <code>ConfigGUI.exe</code> before starting the server and carefully configure the options. Your configuration will be stored in ''config.xml''. You world list will be stored in ''worlds.xml''.
# After configuring the server, you can run either <code>fCraftUI.exe</code> (GUI version) OR <code>fCraftConsole.exe</code> (command-line version) to start the server. Do not run both at the same time.
# After configuring the server, you can run either <code>ServerGUI.exe</code> (GUI version) OR <code>ServerCLI.exe</code> (command-line version) to start the server. Do not run both at the same time.


=Linux, Unix, MacOS X (Mono)=
=Linux, Unix, MacOS X (Mono)=
# Download a current copy of fCraft here: {{LatestVersion}}. Use <code>gunzip</code> to extract it.
{{notice|fCraft has only been officially tested on
# fCraft requires Mono 2.6.4 (minumum) or Mono 2.10.2 (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 <code>yum</code> or <code>apt-get</code>).
*Ubuntu 10/12
#: To be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need GDI+ library (libgdiplus).
*Debian 6
*MacOS X 10.6
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. Read the README file.
## 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).
# 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>
# From here on out is roughly the same as on Windows. You can run <code>ConfigTool.exe</code> to configure your server, and then either <code>fCraftUI.exe</code> OR <code>fCraftConsole.exe</code> to start the server.
{{notice|'''Consider using [[fcraftd]] script, made by Hellenion, to manage your *nix server!}}
#: If you want to run console-only on a headless server, the ConfigTool GUI probably won't work for you to configure things. You can run ConfigTool on your local machine and upload edited config.xml/worlds.xml. Alternatively, edit <code>config.xml</code> manually with your favorite text editor. Detailed information about config.xml keys can be found [[Config|here]].
# 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.
# [http://www.mycaal.com loan modification]
#: 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]].
 
=Troubleshooting=
===Port Forwarding===
If you have a router, you will need to [http://portforward.com/ forward the port] to allow external players to connect. '''Default port is 25565'''. ConfigTool includes a little tool for checking whether the port is forwarded properly - click the [Check] button next to port number setting, on "General" tab.
 
===I made changed to the config/world list, but changes didn't apply===
* Make sure that fCraftConsole and fCraftUI are NOT running while you run ConfigTool. fCraft may overwrite your changes if it's still running.
* Changes are not saved until you hit "OK" or "Apply" in ConfigTool.
* Make sure that ConfigTool is in the same folder as the rest of the server files. If you compiled fCraft from source, copy binaries from separate project folders.
 
===Other players cannot connect from LAN===
Minecraft client has a lot of trouble working on LAN. You probably will not be able to connect via the public URL (http://www.minecraft.net/play.jsp?server=...). Fortunately, there is a workaround:
# Enable "Allow connections from LAN without verification" checkbox in ConfigTool (<[[AllowUnverifiedLAN]]> in config.xml).
# Find your local IP address.
#* In Windows XP+, go to Start -> type "cmd" to open a terminal -> type "ipconfig". The address you need is labeled "IPv4 Address" under "Local Area Connection".
#* In Unix/Linux, use "ifconfig" utility.
# Connect to [http://www.minecraft.net/play.jsp?ip=_____&port=_____ http://www.minecraft.net/play.jsp?ip=_____&port=_____] (fill in blanks with your server's IP address and port).
 
===How do I promote myself to the highest rank/class?===
Type the following in console (either fCraftConsole or fCraftUI): <code>/promote YourName DesiredClass</code>
 
===System.DllNotFoundException: libMonoPosixHelper.so===
Install <code>libmono-posix2.0-cil</code> package, if available.
This is also a known issue with compiling Mono from source on CentOS. Update to 2.10+ (recommended), or try [http://go-mono.com/forums/#nabble-td1537921 this workaround].
 
===Memory usage keeps going up under Mono===
If you are using Mono 2.6.x or earlier, you are out of luck. If you are running 2.8+, try running mono with "--gc=sgen" switch, like this: <code>mono -gc=sgen fCraftConsole.exe</code>.
If you've tried everything and cannot get Mono memory usage under control, try setting the [[RestartInterval]] config key to make the server restart itself every once in a while.


===CentOS problems===
=[[Troubleshooting]]=
'''fCraft is not officially supported on CentOS due to numerous reported problems.''' If you still want to continue, try these solutions:
==Autentication/Decription failed for heartbeats==
* [http://www.go-mono.com/mono-downloads/download.html Use the official package from the Mono website]. The version available via yum may be outdated.
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.)
* You may have to add mono directory (<code>/opt/novell/mono/</code>) to your paths. Adding something like this to your startup script should do it:
#echo export PKG_CONFIG_PATH=/opt/novell/mono/lib/pkgconfig:$PKG_CONFIG_PATH>>~/.bash_profile
#echo export PATH=/opt/novell/mono/bin:$PATH>>~/.bash_profile
#source ~/.bash_profile

Latest revision as of 21:25, 2 August 2013

Windows

  1. fCraft requires Microsoft .NET Framework 3.5. Your system may already have it installed, and you can download it from microsoft.com.
  2. Download a current copy of fCraft here: 0.644
  3. Extract the zip file into the directory where you wish to keep all the server data (maps, logs, config, etc).
  4. Run ConfigGUI.exe before starting the server and carefully configure the options. Your configuration will be stored in config.xml. You world list will be stored in worlds.xml.
  5. After configuring the server, you can run either ServerGUI.exe (GUI version) OR ServerCLI.exe (command-line version) to start the server. Do not run both at the same time.

Linux, Unix, MacOS X (Mono)

fCraft has only been officially tested on
  • Ubuntu 10/12
  • Debian 6
  • MacOS X 10.6

If you are using a different distribution, use at your own risk.

  1. Download a current copy of fCraft here: 0.644. Use gunzip to extract it. Read the README file.
    1. Putting the PlayerDB.txt on an NTFS partition can reduce chance of corruption on unsafe shutdown/power loss.
  2. fCraft requires Mono 2.8+ (minimum) or Mono 3.0+ (recommended) runtime. You can 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 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).
  3. 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 mozroots --import --ask-remove as the fCraft user on your system.
  4. 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.
  5. To run ".exe" files with Mono, use the following syntax:
    Mono 2.8+: mono --gc=sgen SomeFile.exe
    Mono 3.0+: mono SomeFile.exe
Consider using fcraftd script, made by Hellenion, to manage your *nix server!
  1. From here on out is roughly the same as on Windows. You can run ConfigGUI.exe to configure your server, and then either ServerGUI.exe OR ServerCLI.exe 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 config.xml manually with your favorite text editor. Detailed information about config.xml keys can be found here.

Troubleshooting

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 mozroots --import --ask-remove 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 --machine but this is not the default for a reason.)

Retrieved from "https://fcraft.net/w/index.php?title=Installation_instructions&oldid=2448"