Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Thank you for downloading fCraft, the custom Minecraft server. If you like fCraft, support its development by donating! http://donate.fcraft.net === Installation (Windows) ==================================================== fCraft requires Microsoft .NET Framework 3.5. Your system may already have it installed, and you can download it from microsoft.com For more information, see http://www.fcraft.net/wiki/Installation_Instructions === Installation (Linux, Unix, MacOS X) ======================================= fCraft requires Mono 2.6.4 (minumum) or Mono 2.10 (recommended). You can download it from www.mono-project.org, or (on some Linux distributions) install it through your package manager. 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. 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" For more information, see http://www.fcraft.net/wiki/Installation_Instructions === Initial Setup ============================================================= Before starting the server for the first time, run ConfigGUI.exe to choose your server's name and settings. By default, fCraft servers are private. That means it will not be listed on minecraft.net, and only players who have the link will be able to join. To set your server to public, set Visibility: [Public] in ConfigGUI, (or set "IsPublic" key to "true" in config.xml). Remember that if the serveris running while you make configuration changes, you need to restart it or use "/Reload config" command. You may need to add firewall exceptions for fCraft applications (ConfigGUI, ServerGUI, or ServerCLI, or ServerWinService) to allow incoming TCP connections on the listening port. Default port is 25565. If your server is behind a router, you may also need to set up port forwarding on the same port. See www.port-forward.com for further guidance. When you are ready to start the server, run ONE of the available server front-ends (GUI, CLI, or WinService). === Troubleshooting =========================================================== Server does not show up on minecraft.net list: Make sure that server is public. See 2nd paragraph of "Initial Setup" section, above. "Could not connect to server: it's probably down": Make sure that you added firewall exception for fCraft (if applicable), and forwarded the port on your router. If you are connecting from same computer that the server is working on, try connecting to: http://www.minecraft.net/play.jsp?ip=127.0.0.1&port=____ (fill in the blank with your server's port number) "Could not verify player name": Verification problems occur when your fCraft server cannot verify identity of connecting players. Here are some things that may cause or fix verification problems: 1. If minecraft.net is offline or slow, wait for it to stabilize. 2. If minecraft.net is working but you still cant verify name, log out then log back in. 3. Try restarting your server. Wait a couple minutes before trying to connect to a newly-restarted server (to give your server time to synchronize with minecraft.net). 4. If you (or your players) are using WoM client's "Resume" function, which uses cached verification information, use the proper log-in procedure in WoM. The "Resume" function only works as long as your IP does not change and as long as the server does not restart. 5. If you are using WoM and connecting with a bookmark, make sure that the bookmarked address starts with "http://www.minecraft.net/..." and not "mc://...". Addresses in the form "mc://" are temporary, and will stop working whenever the server is restarted. Other players cannot connect from the same LAN/network as me: Minecraft client has a lot of trouble working on LAN. You probably will not be able to connect via the public URL. There is a workaround: 1. Check "Allow connections from LAN without verification" in ConfigGUI. (or set <AllowUnverifiedLAN> to true 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/play.jsp?ip=____&port=____ (fill in the blanks with your server's IP address and port number) === List of Files ============================================================= ConfigGUI.exe - Graphical interface for editing your server's settings, rank setup, and world list. Also includes a map coverter and terrain generator. If you alter configuration while the server is running, use /reloadconfig command to apply the changes. Note that some changes (like changes to the rank list and IRC configuration) require a full server restart. ConfigCLI.exe - A simple command-line configuration tool. fCraft.dll - Core of the server, used by all other applications. fCraftGUI.dll - Provides shared functionality for Config and Server GUI. ServerCLI.exe - Command-line interface for the server. ServerGUI.exe - Graphical interface for the server. === Command-line Options ====================================================== In addition to many settings stored in config.xml, fCraft has several special options that can only be set via command-line switches: --path=<path> Working path (directory) that fCraft should use. If the given path is relative, it's computed against the location of fCraft.dll --logpath=<path> Path (directory) where the log files should be placed. If the given path is relative, it's computed against the working path. --mappath=<path> Path (directory) where the map files should be loaded from/saved to. If the given path is relative, it's computed against the working path. --config=<file> Path (file) of the configuration file, including the filename (typically "config.xml"). If the given path is relative, it's computed against the working path. --norestart If this flag is present, fCraft will shutdown whenever it would normally restart (e.g. automatic updates or /restart command). This may be useful if you are using an auto-restart script or a process monitor. --exitoncrash If this flag is present, fCraft frontends will exit at once in the event of an unrecoverable crash, instead of showing a message and prompting for user input. --nolog If this flag is present, all logging is disabled. --nocolor If this flag is present, ServerCLI will not use any colors or formatting in its console output. === Help & Support ============================================================ When you first join the server, promote yourself by typing... /rank YourNameHere owner ...in the server's console. Replace "owner" if you renamed your highest rank. Type "/help" in-game or in server console to get started. Type "/commands" for a list of available commands. For detailed information, please visit: http://fcraft.net/wiki To request features, report bugs, or receive support, please visit: http://forums.fcraft.net For quick help/support, join #fCraft channel on Esper.net IRC: irc://irc.esper.net:5555/fCraft See CHANGELOG.txt or visit http://www.fcraft.net/wiki/Version_history for complete information about changes in this release compared to previous versions of fCraft. === Licensing ================================================================= fCraft is open-source and free for all uses. fCraft code and binaries are licensed and distributed under the permissive MIT License, reproduced here: ---- Copyright 2009, 2010, 2011 Matvei Stefarov <email@example.com> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ---- If you create fCraft plugins that do not include any substantial portions of fCraft's original code, they belong to you and you are free to do absolutely anything with them. However, if you would like to distribute whole modified copies of fCraft, please follow the MIT License terms. fCraft uses and bundles Devart dotConnect for MySQL, under free license. Full text of the Devart dotConnect for MySQL license should be included with your copy of fCraft in LICENSE.dotConnect.txt Original Minecraft was developed by Markus "Notch" Persson of Mojang, and is not affiliated with fCraft in any way. fCraft does not use any code, assets, or any other files from Minecraft. === Credits =================================================================== fCraft was developed by Matvei Stefarov (firstname.lastname@example.org) in 2009-2011 Thanks to fCraft code contributors and modders: Asiekierka, Dag10, Destroyer, FontPeg, Jonty800, M1_Abrams, Optical-Lza, Redshift, SystemX17, TkTech, Wootalyzer Thanks to people who supported fCraft development through donations: fCraft.net community, Astelyn, D3M0N, Destoned, DreamPhreak, Pandorum, Redshift, TkTech, ven000m, wtfmejt, Team9000 and SpecialAttack.net communities, and others who donated anonymously Thanks to people whose code has been ported to fCraft: Dudecon (Forester), Osici (Omen), vLK (MinerCPP), Tim Van Wassenhove, Paul Bourke Thanks to Minecraft servers that helped test and improve fCraft: TheOne's Zombie Survival, SpecialAttack.net Freebuild, Team9000 Freebuild, D3M0Ns FreeBuild, ~The Best Freebuild 24/7~, fCraft Freebuild Official Thanks to people who submitted bug reports and feature requests: Astelyn, Clhdrums87, Darklight, David00143, Dogwatch, Epiclolwut, Fehzor, Gamma-Metroid, Hellenion, Sunfall, maintrain97, Mavinstar, Unison, and all others. Special thanks for inspiration and suggestions: CO2, Descension, ElectricFuzzball, Exe, Hearty0, iKJames, LG_Legacy, PyroPyro, Revenant, Varriount, Voziv, Zaneo, #mcc on Esper.net, HyveBuild/iCraft team, MinerCPP team, OpenCraft team And thank You for using fCraft!