Installation instructions

2011-04-26T21:16:59Z

143.50.153.50: /* Windows */

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

<code>/promote YourUserName DesiredClassName</code>

to promote yourself.}}

That's not just the best answer. It's the beesstt answer!

=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