noloose 0.2 plugin README
-------------------------

noloose is a Palace server plugin that allows the server operator
to specify if, and where, loose props are permitted on the server.
Unlike the server flag NOLOOSEPROPS, the noloose plugin permits
operators or owners to drop props in a room.



Installation
------------

The following installation instructions assume that the Palace server
has been installed in /usr/local/palace.

noloose is a standard Palace server plugin. It is installed by placing
the plugin file, noloose.so, in the Palace binary folder,
/usr/local/palace/bin, and adding the following line to the plugin
configuration file, /usr/local/palace/<palace-name>/psdata/plugin.conf:

../bin/noloose.so <switch setting>

The optional control switches below may be set using the <switch setting>
parameter.

all [on|off] = "on" disables loose props anywhere
command [on|off] = toggles use of the `noloose command
member [on|off] = "on" disables loose props in member-created rooms
private [on|off] = "on" disables loose props in rooms where the Private
		   flag is enabled
public [on|off] = "on" disables loose props in any room, except rooms
		  marked Private or those created by members

For example:

../bin/noloose.so command off public on

will disable use of the `noloose command and not permit members or guests
to drop props in public rooms.

Note: You can use multiple switch settings. For instance, you could not
permit members or guests to drop props in public rooms or member-created
rooms, but still permit loose props in rooms that are marked Private.

Observe:

../bin/noloose.so command off member on public on



Command
-------

You can type `help `noloose for assistance controlling loose props directly
by the Palace client. This is a God command. Note though, if you change
a setting using the command, it will be reset to what is specified in the
plugin.conf file when the server is rebooted.