Skip to content

Commit

Permalink
Adding readme to stop this page from looking so naked
Browse files Browse the repository at this point in the history
  • Loading branch information
Jonty800 committed Apr 11, 2012
1 parent 883fe5d commit 73b80f9
Show file tree
Hide file tree
Showing 2 changed files with 293 additions and 0 deletions.
243 changes: 243 additions & 0 deletions README
Original file line number Diff line number Diff line change
@@ -0,0 +1,243 @@
Thank you for downloading 800Craft, a custom Minecraft server based on fCraft.

If you like 800Craft, feel free to buy me and GlennMR a drink by donating to:
http://donate.800craft.net

Special thanks to fragmer, what a bro!


=== Installation (Windows) ====================================================

80Craft requires Microsoft .NET Framework 4.0. Your system may already have it
installed, and you can download it from microsoft.com

=== Installation (Linux, Unix, MacOS X) =======================================

800Craft requires 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 800Craft components (ServerGUI and ConfigGUI) you
will also need GDI+ library (libgdiplus). Before starting 800Craft, make sure
that it has read/write permissions in the 800Craft 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"

=== Initial Setup =============================================================

Before starting the server for the first time, run ConfigGUI.exe to choose
your server's name and settings.

You may need to add firewall exceptions for 800Craft 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. Open ConfigGUI, set Visibility: [Public]
(or set <IsPublic> to true in config.xml).

"Could not connect to server: it's probably down":
Make sure that you added firewall exception for 800Craft (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 800Craft 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, 800Craft has several special
options that can only be set via command-line switches:

--path=<path> Working path (directory) that 800Craft 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, 800Craft 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, 800Craft 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://800Craft.net/wiki

To request features, report bugs, or receive support, please visit:
http://forums.800Craft.net



=== Licensing =================================================================

800Craft is open-source and free for all uses. However, fCraft code and binaries are
licensed and distributed under the permissive MIT License, reproduced here:

----
Copyright 2009, 2010, 2011 Matvei Stefarov <[email protected]>

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" Petersson of Mojang, and is
not affiliated with fCraft in any way. fCraft does not use any code, assets,
or any other files from Minecraft... neither does 800Craft.



=== Credits ===================================================================

800Craft was developed by Jonty800 and GlennMR.

Thanks again to fragmer, what a bro.

Thanks to 800Craft code contributers:
Rebelliousdude, boblol0909 and Maicke98 for trying.

Thanks to fCraft code contributors and modders:
Asiekierka, Dag10, Destroyer, FontPeg, M1_Abrams, Optical-Lza,
Redshift, SystemX17, TkTech, Wootalyzer

Thanks to people who supported fCraft development through donations:
800Craft.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 800Craft:
Au70 Galaxy, Project Vanilla.

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~, 800Craft 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 800Craft!
50 changes: 50 additions & 0 deletions readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
## About 800craft
800craft is a modified version of the popular Minecraft server software called fCraft. It was created by Jonty800 and is now maintained by GlennMR and Jonty800.

800Craft is currently working on a big update, which will include Physics and many more new features and commands.
Something to get real excited for is the MineManager that is coming very soon. You'll be able to access your console and monitor month by month server statistics anywhere in the world from 800Craft.net. And best of all, it's going to be 100% free!
Download it now, 800Craft is extremely stable and very high on performance and when we release our next version, we'll send you an automatic update :).
## Features

On top of all the amazing features fCraft already has, we have implemented:

* Custom kick and ban commands such as: /Basscanon, /Gtfo, /Tempban, /Banx, /Warn
* Custom chat commands such as: /High5, /Away, /Poke, /Troll, /Review
* As well as the addition of Admin Chat, you also get the option to create your own chat channel
* Fun commands such as: /Slap, /Kill, /Possess
* Additional building commands
* Fly around the server with /Fly
* Voting with /Vote
* Make a server-wide vote for if a player should be kicked with /Vote kick
* Set your rank requirements with /Requirements (/Reqs)
* Change your server's blocks with /Env terrain
* Let your server's environment change according to the local time with /Env realistic
* Wipe your guest world easily with /Guestwipe
* Create dummy skins on a given world
* Minecraft making you mad? /Ragequit
* Doors
* Portals
* Realms (Personal worlds for players)
* Hide ranks with /Rhide
* Teleport to zones with /Tpzone
* Control your Realm with /Realm create activate kick ban unban like invite join flush
* Fun modes like: /Bromode
* Flying
* Anti-Caps detector
* Profanity detector
* Grass Physics (More physics coming soon)

* Customize your server by writing your own .NET DLL's and using them to modify existing functions or add features.

## HeartbeatSaver

* When you shutdown your server, or the server crashes, the Heartbeat Saver automatically opens, keeping your uptime on minecraft.net the same as it was before shutdown.
Nobody likes suddenly dropping to the bottom of a list containing 1000+ servers.

This feature can only found in 800Craft.

## Release
800Craft has been released and is currently at version 0.103. You can download it here: https://github.com/GlennMR/800craft/downloads
For support, visit our forum here: http://www.au70galaxy.com/314/upload/index.php?/forum/32-au70-server-software/

Thanks for using 800Craft, enjoy!

0 comments on commit 73b80f9

Please sign in to comment.