Installation instructions
| When first starting fCraft, type this in the console of your running server:
to promote yourself. |
Windows
- fCraft requires Microsoft .NET Framework 3.5. Your system may already have it installed, and you can download it from microsoft.com.
- Download a current copy of fCraft here: 0.644
- Extract the zip file into the directory where you wish to keep all the server data (maps, logs, config, etc).
- Run
ConfigTool.exebefore starting the server and carefully configure the options. Your configuration will be stored inconfig.xml. - After configuring the server, you can run either
fCraftUI.exe(GUI version) ORfCraftConsole.exe(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: 0.644. Use
gunzipto extract it. - 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
yumorapt-get).- 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:
mono SomeFile.exe - Mono 2.8+:
mono -gc=sgen SomeFile.exe
- Mono 2.6.4:
- From here on out is roughly the same as on Windows. You can run
ConfigTool.exeto configure your server, and then eitherfCraftUI.exeORfCraftConsole.exeto 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.xmlmanually with your favorite text editor. Detailed information about config.xml keys can be found here.
- 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
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:
- 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/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