Installation instructions

When first starting fCraft, type this in the console of your running server: /promote YourUserName DesiredClassName to promote yourself.

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 ConfigTool.exe before starting the server and carefully configure the options. Your configuration will be stored in config.xml.
5. After configuring the server, you can run either fCraftUI.exe (GUI version) OR fCraftConsole.exe (command-line version) to start the server. Do not run both at the same time.

Linux, Unix, MacOS X (Mono)

1. Download a current copy of fCraft here: 0.644. Use gunzip to extract it.
2. fCraft requires Mono 2.6.4 (minumum) or Mono 2.10.2 (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).

   To be able to use graphical fCraft components (ServerGUI and ConfigGUI) you will also need GDI+ library (libgdiplus).

3. 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.
4. To run ".exe" files with Mono, use the following syntax:

   Mono 2.6.4: mono SomeFile.exe

   Mono 2.8+: mono -gc=sgen SomeFile.exe

5. From here on out is roughly the same as on Windows. You can run ConfigTool.exe to configure your server, and then either fCraftUI.exe OR fCraftConsole.exe 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 config.xml manually with your favorite text editor. Detailed information about config.xml keys can be found here.

Troubleshooting

Port Forwarding

If you have a router, you will need to 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

• fCraft can read most changes on the fly using /Reload command. However, some things require a full restart:
  • Ranks
  • Worlds
  • IRC settings
  • Enabling/disabling BlockDB
• Make sure that ServerCLI and ServerGUI are NOT running while you run ConfigGUI. fCraft may overwrite your changes if it's still running.
• Changes are not saved until you hit "OK" or "Apply" in ConfigGUI.
• Make sure that ConfigGUI is in the same folder as the rest of the server files.

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. Fortunately, there is a workaround:

1. Enable "Allow connections from LAN without verification" checkbox in ConfigTool (<AllowUnverifiedLAN> in config.xml).
2. 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.
3. Connect to http://www.minecraft.net/classic/play?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): /promote YourName DesiredClass

System.DllNotFoundException: libMonoPosixHelper.so

Install libmono-posix2.0-cil package, if available. This is also a known issue with compiling Mono from source on CentOS. Update to 2.10+ (recommended), or try 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: mono --gc=sgen ServerGUI.exe. 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:

• Use the official package from the Mono website. The version available via yum may be outdated.
• You may have to add mono directory (/opt/novell/mono/) 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