Editing Nagware

Jump to: navigation, search

Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.

The administrator who locked it offered this explanation: Server migration

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
#REDIRECT [[Plug-ins]]
+
The [[Nagware]] [[Plug-ins|plug-in]] sends a message to unregistered players every x minutes and optionally kicks them after y minutes. The plugin can be configured via a config file. The server owner can define what messages are sent and the duration between the messages. This plugin was made by menotume for the SilverCat server. This plugin was created to help increase player authentication and therefore reduce player and server abuse.
 +
 
 +
==Sample Configuration File==
 +
 
 +
The plugin is customizable with a plain-text configuration file. A sample that is distributed with the source code can be found below:
 +
 
 +
# Sample configuration file for the nagware plugin.
 +
#
 +
 +
# permission tag to use to grant "/nag" command permissions
 +
# defaults to "NAG" if not specified.
 +
permname = say
 +
 +
# Apply logic to observers ?  (yes/no)
 +
# default is no
 +
kickobs = yes
 +
 +
# minplayers: There must be this many players before anybody is
 +
#    kicked, but the warnings will still happen.
 +
# default is 1
 +
minplayers  = 2
 +
 +
# Include observers in minplayer count ?  (yes/no)
 +
# default is yes
 +
countobs = yes
 +
 +
# messagesuffix: Message to be added to the end of all other defined messages.
 +
messagesuffix = \nRegister at http://my.bzflag.org/bb/ and use your login in the bzflag connect screen.
 +
 +
# Message: Messages to be sent to players at specified times.
 +
#  Format is:  TIME,[REPEAT] MESSAGE
 +
#      *) Time and repeat are in minutes, whole numbers only (0 is allowed)
 +
#      *) If repeat is specified, the message will be repeated every [REPEAT] minutes until the next
 +
#          message is applied (if any), or the player is kicked.
 +
message = 1 This server requires global registration.
 +
message = 2 Dieser Server erfordert globale Registrierung.\nCe serveur exige l'enregistrement global\nEste camarero requiere matrícula global
 +
message = 3,1 You will be kicked from this server shortly, please register and come back!
 +
message = 6,2 You are now marked to be kicked randomly.
 +
 +
# Same format as above, except 'repeat' is not used.
 +
# If not defined, no players will be kicked.
 +
kickmessage = 7 You have been kicked because you are not registered.
 +
 
 +
==Plugin Setup==
 +
 
 +
Load the plugin in bzfs with the following configuration option:
 +
-loadplugin <path to plugin>,<path to config>
 +
 
 +
For example (on linux):
 +
-loadplugin /home/bzfs/lib/nagware.so,/home/bzfs/configs/nagware.cfg
 +
 
 +
If there is an error in the configuration file, the plugin will not
 +
load.  See the output of bzfs (or the log file) for details.
 +
 
 +
==Plugin Commands==
 +
 
 +
The following commands are available for privileged players (see the
 +
sample config file for how to set the permission name):
 +
 
 +
'''/nag on:''' Enables the plugin for sending messages and kicking players. The plugin is enabled by default.
 +
 
 +
'''/nag off:''' Stops the plugin from sending messages and kicking players. Reenable with '/nag on'.  NOTE that the plugin is automatically disabled during a match.
 +
 
 +
'''/nag config:''' Display the current configuration options.
 +
 
 +
'''/nag reload:''' Reload the configuration file. Any config file errors will be shown.
 +
 
 +
'''/nag list:''' Show all unverified players, and how long they have been connected.
 +
 
 +
[[Category:Plug-Ins]]

Please note that all contributions to BZFlagWiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see BZFlagWiki:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel | Editing help (opens in new window)