--------------------------------------------------------------------------

==========================================================================

							 The Stoneless FAQ
							  for version 1.00

Some answers to questions commonly asked of me. Scan though if you've
got a question.

				Questions:
				==========

1. What is Stoneless?
2. How much does Stoneless cost?
3. Stoneless reports that map has leaks, but no .pts file is generated!
4. Nothing shows up in the 3d view!
5. Entities aren't showing up in the 3d view!
6. Some key or shift-some key doesn't work in my part of the world.
7. I can't get Stoneless to work with Windows NT!
8. I'm getting this error when I run qbsp:
		************ ERROR ************
		CheckFace: point off plane
   And the map isn't being successfully compiled.
9. The 3d camera keeps rocking uncontrollably
10. I'm getting this error when I run qbsp:
	faces==MAX_FACES
   What should I do??

				Answers:
				========

1. What is Stoneless?

	Stoneless is a powerful Quake map builder. It allows everyone
to create levels for the registered version of Quake, just like
the ones included with the game.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

2. How much does Stoneless cost?

	Absolutely nothing. That's why it's called freeware. You'll need to
buy Quake, though.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

3. Stoneless reports that map has leaks, but no .pts file is generated!
	
	This is probably because you've forgotten to add an 
info_player_start entity to the map. Every map needs one.
	If this isn't the problem... Well qbsp has been known to make
mistakes - try a different compile. QBSP256 by Tom Grandgent (Woofer) is 
usually very good, abet slow. Get it from Walnut Creek (ftp.cdrom.com).
	Make sure there are no entities outside the map. It can be tempting
to place trigger_counters and other entities you can't see outside - but
will cause leaks.
	If all else fails, create a big cube surrounding the whole level.
It'll probably run very slowly, but at least you can vis it.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

4. Nothing shows up in the 3d view!

	In version 0.92 there is a new feature, adjustable back clipping
planes. This is extremely powerful (see the docs), as it cuts out
everything a certain distance away from the camera. Got to options and set
Back clip plane to 5000 or so, and move closer to the object you want to
see. Once you've got used to the idea, you might want to set it to 800 or
so.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

5. Entities aren't showing up in the 3d view!

	Another new feature in version 0.92 is the ability to turn off
point entities (see the docs for a definition). Go to tools/Render point 
entities to turn them on and off.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

6. Some key or shift-some key doesn't work in my part of the world.

	There are many different key combinations to change the grid and 
zoom in Stoneless.

Grid:
	'[' and ']',
	',' and '.',
	'a' and 'z'

Zoom:
	'+' and '-',
	's' and 'x'

	Choose which ever works best. If none of these work... Well, then
we're in trouble. You had better write to me and suggest what will.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

7. I can't get Stoneless to work with Windows NT!
	
	There are a few special instructions for installing on Windows NT.
Firstly, unless you have the service pack that supports DirectX3 and
Direct3D, the OpenGL-only version will work better under Windows NT.
Download it from the Stoneless Site.
	Secondly, there are two .dlls in the Stoneless directory only for
Windows95. These are opengl32.dll and glu32.dll. Delete them both.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

8. I'm getting this error when I run qbsp:
		************ ERROR ************
		CheckFace: point off plane
   And the map isn't being successfully compiled.

	This means that one of the faces is made up of 4 or more points, 
and at least one of those points is not co-planear with the others. That 
should all be lying on an infinitely flat plane, but for some reason, 
qbsp has generated a point that is not (actually to protect from floating
point errors, the plane does have a thickness, but that's not important).
	This error won't be reported by Tools/Check Map because Stoneless
doesn't save the points you see on the map, only the planes. Qbsp is
generating the invalid point, probably because of a bad brush.
        Some versions of qbsp are more strict than others in this area. It
might be worthwhile trying a few different qbsp's to try and find one with
a larger "ON_EPSILON" value. The error will still be there, but qbsp will
ignore it. If the error's very pronounced, one or two polygons may appear
distorted from some angles in Quake.
        Your last option is to move brushes a few at a time into an
invisible layer, and compile the level with "Save only visible." When the
errors disappear, you'll know that you've just moved the culprit (or 
culprits) into the invisible layer.
	If possible, delete this brush and make it again, try to or put a
pillar infront of the hole to cover it up.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

9. The 3d camera keeps rocking uncontrollably

	This is probably due to a joystick connected to your system. When
joystick support is on, moving the joystick will move the 3d camera, even
if it is not the focused windows. Some joysticks may rock slightly, even
if you are not touching it, so go to File/Options and the 3d options tab.
Disable the joystick or move the speed dragbar closer to unresponsive.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

10. I'm getting this error when I run qbsp:
	faces==MAX_FACES
   What should I do??

	To less memory usage and help performance, most qbsps have a maximum
number of faces per brush. So does Stoneless - currently, it can't handle
brushes with more than 32 faces. The standard qbsp compile (and the one the
comes with Stoneless) only support 16 faces. You can either get a new qbsp,
one that supports 32 faces. This will run slower and take more memory. Or you
can use the Check Map tool in Stoneless (in strict mode) to find all the brushes
if more than 16 faces and delete them.

""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

If your questions aren't answered here, don't hesitate to write to me at
jewsbury@netspace.net.au, and I'll attempt to answer them.

David Jewsbury (aka Gooz), author of Stoneless
jewsbury@netspace.net.au

                        ==-==-==-==-==-==-==-==-==-==-==-==-==-==-==-==
                                                              Stoneless
                  http://netspace.net.au/~jewsbury/stoneless/index.html

==========================================================================

--------------------------------------------------------------------------