Installation instructions

2011-04-26T09:58:31Z

188.138.101.244: /* How do I promote myself to the highest rank/class? */

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

<code>/promote YourUserName DesiredClassName</code>

to promote yourself.}}

=Windows=
* Make sure that you have [http://www.microsoft.com/downloads/details.aspx?familyid=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en Microsoft .NET Framework 3.5+] installed.
* [https://sourceforge.net/projects/fcraft/files/ Download fCraft binaries here.]
* Extract the zip file into the directory where you wish to keep all the server data (maps, logs, config, etc).
* Before starting the server you probably want to run <code>ConfigTool.exe</code>, and carefully configure the options you want your server to run (Config is 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.
** You will need to [http://portforward.com/ forward the port] on your router that you set the server to run on for people to be able to connect to you. '''Default port is 25565'''

=Linux, Unix, MacOS X (Mono)=
* fCraft has been tested/compiled on:
** ''Debian Squeeze w/ Mono 2.4.4'' - <code>deb http://debian.meebey.net/pkg-mono</code>
** ''Debian Lenny w/ Mono 2.4.2.3'' - <code>deb http://www.backports.org/debian lenny-backports main | mono-devel package</code> (Thanks to Fighter for testing)
** ''Mac OS X 10.6.4 w/ Mono 2.6.4'' (Thanks to Panda for testing)
** ''CentOS 4 w/ Mono 2.6.4'' (requires a [[#System.DllNotFoundException:_libMonoPosixHelper.so|workaround]], thanks to iKJames for testing)
* The first and most important step here is to ensure you have the [http://mono-project.com/Obtaining_Mono Mono runtime] installed.
* The next step is to download the [https://sourceforge.net/projects/fcraft/files/ latest binaries]
** fCraft can be compiled from source using Mono (using [http://monodevelop.com/ MonoDevelop IDE] is the easiest way) if you wish to keep up with the latest experimental versions on the [https://fcraft.svn.sourceforge.net/svnroot/fcraft SVN]. Visit #fCraft on [irc://irc.esper.net:5555 irc.esper.net] if you need more info.
* From here on out is roughly the same as on Windows. You can run <code>mono ConfigTool.exe</code> to configure your server, and then either <code>mono fCraftUI.exe</code> OR <code>mono 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 favourite text editor. Detailed information about config.xml keys can be found [[Config Keys|here]].

=Troubleshooting=
===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.

Soudns great to me BWTHDIK

===CentOS problems===
:There have been a lot of problems reported with getting Mono working on CentOS.
:* [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

====System.DllNotFoundException: libMonoPosixHelper.so====
:Install <code>libmono-posix2.0-cil</code> package.
:This is also a known issue with compiling Mono from source on CentOS. Update to 2.8+ (recommended), or try [http://go-mono.com/forums/#nabble-td1537921 this workaround].

===Memory usage keeps going up under Mono===
:Try running mono with "--gc=sgen" switch, like this: <code>mono -gc=sgen fCraftConsole.exe</code> (thanks to wootalyzer for discovering).

fCraft Wiki - User contributions [en]

Installation instructions