-
Notifications
You must be signed in to change notification settings - Fork 17
/
Copy pathREADME.txt
314 lines (228 loc) · 14.9 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
Thank you for downloading 800Craft, a custom Minecraft server based on fCraft.
Special thanks to fragmer, what a bro!
=== Installation (Windows) ====================================================
800Craft 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"
If you're intending to run a public server that appears on minecraft.net's server list,
you need to import https certificates to tell mono you trust them, this can be done by
running mozroots --import --ask-remove as the 800Craft user on your system.
=== 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:
https://minecraft.net/classic/play?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://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 https://minecraft.net/classic/play?ip=____&port=____
(fill in the blanks with your server's IP address and port number)
I get errors when my PlayerDB / Worlds / Config tries to save:
Possible causes of this are as follows:
1. Running 800Craft from a protected system directory (e.g. Windows
or ProgramFiles folder) while using a non-administrative user account.
In that case, 800Craft's data should go into AppData, ProgramData,
or some directory owned by your user account.
2. Accidentally running 800Craft from a temporary folder. If you downloaded
800Craft in a zip file, and tried to run it directly from the zip file,
it'll end up being extracted and launched from a temporary folder. Instead,
extract all files to a permanent location before running 800Craft.
3. Launching two copies of 800Craft. UnauthorizedAccessException can happen
when two processes try to write to the same file at the same time. In that
case, don't run two instances of 800Craft from the same directory.
4. Launching a sandboxed, freshly-downloaded copy of 800Craft. Open file
properties, and see if there is a "Security" note indicating that the file
came from the Internet, and an "Unblock" button next to it.
5. Trying to write to a read-only file. Make sure none of 800Craft's files are
marked as read-only (in files' properties).
6. Trying to write to a read-only drive. Make sure you're not running 800Craft
from a USB drive, CD/DVD, or a remote network share.
7. Trying to treat a directory as a file (e.g. saving a file with an exact name
as an existing directory). Unlikely as it is, make sure there's no directory named
"PlayerDB.txt" in 800Craft's folders.
8. If all else fails, try to run 800Craft as Administrator. UAC can sometimes get
in the way even if you do everything right.
=== 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.
HeartbeatSaver.exe - A console heartbeat sender, for use when the server is down
=== 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.
To request features, report bugs, or receive support, please visit:
http://au70.net
=== Licensing =================================================================
800Craft is open-source and available free of change for all uses. 800Craft code
and binaries are licensed and distributed under the 3-clause BSD license,
reproduced here:
----
Copyright (c) 2011-2013 Jon Baker, Glenn Marien and Lao Tszy <[email protected]>
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of 800Craft or the names of its
contributors may be used to endorse or promote products derived from this
software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
----
The 800Craft HeartBeatSaver is Copyright (C) <2011 - 2013> Jon Baker
and is ONLY to be distributed with copies of 800Craft.
fCraft code and binaries are
licensed and distributed under the permissive MIT License, reproduced here:
----
Copyright 2009 - 2013 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 800Craft plugins that do not include any substantial portions of
fCraft's original code or 800Craft's 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 800Craft, please follow the MIT and the GPLv3 License terms.
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, GlennMR and LaoTszy.
Thanks again to fragmer, what a bro.
Thanks to 800Craft code contributers:
Rebelliousdude, boblol0909, WaterGod469 and Maicke98 for trying.
With testing from Pure2K12, LeChosenOne and Xanderortiz.
And suggestions from Project-Vanilla and the Au70 Community
Thanks to Minecraft servers that helped test and improve 800Craft:
Au70 Galaxy, Project Vanilla and [AWESOME+PROTECTED] Xander Ortiz
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 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!