Installation instructions

2011-07-23T10:11:13Z

Johncarter:

{{alert|When first starting fCraft, type this in the console of your running server:

<code>/promote YourUserName DesiredClassName</code>

to promote yourself.}}

=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].
# 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).
# Run <code>ConfigTool.exe</code> before starting the server and carefully configure the options. Your configuration will be stored in <code>config.xml</code>.
# 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.

=Linux, Unix, MacOS X (Mono)=
# Download a current copy of fCraft here: {{LatestVersion}}. Use <code>gunzip</code> to extract it.
# 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>).
#: To be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need GDI+ library (libgdiplus).
# 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:
#: Mono 2.6.4: <code>mono SomeFile.exe</code>
#: Mono 2.8+: <code>mono -gc=sgen 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.
#: 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]].

=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 [http://www.mycaal.com loan modification] 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===
'''fCraft is not officially supported on CentOS due to numerous reported problems.''' If you still want to continue, try these solutions:
* [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.
* 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

fCraft Wiki - User contributions [en]

Installation instructions