####################################################################################################
##
##  Nexgen Warning Plugin
##  [NexgenWarn112N - For Nexgen 112N]
##
##  Version: 1.0
##  Release Date: April 2012
##  Author: Patrick "Sp0ngeb0b" Peltzer
##  Contact: spongebobut@yahoo.com  -  www.unrealriders.de
##
####################################################################################################
##   Table of Content
##
##   1. About
##   2. Server Install
##   3. Credits and thanks
##   4. Info for programmers
##
####################################################################################################


####################################################################################################
## 
##  1. About
##
####################################################################################################
NexgenWarn is a plugin for the NexgenServerController which implements a basic warning function in
the control panel. Original, the only way to force a player to read your message was a windowed PM.
However, I wasn't that happy with that feature. 1) It isn't located in the admin tabs, so it's kinda
annoying to find the function. 2) The warned player could easily close the message immediatly by
hitting the ESC button. 3) Windowed PMs dont always have to be understood as a warning, therefore
the signals weren't clear.

These are the issues I've adressed in this plugin, which will bring the following FEATURES to you:


- The warning function is located in Nexgen's Moderator tab

- The warned player has to click a checkbox on the warning dialog inorder to close it. If he doesn't
  the window will appear again.
  
- A warning signal will be send out which can be fetched by other plugins (e.g. NexgenPlayerLookup)



####################################################################################################
## 
##  2. Server Install
##
####################################################################################################
 1. Make sure your server has been shut down.

 2. Copy the NexgenWarn112N.u file to the system folder of your UT
    server.

 3. If your server is using redirect upload the NexgenWarn112N.u.uz file
    to the redirect server.

 4. Open your servers configuration file and add the following server package:

      ServerPackages=NexgenWarn112N

    Also add the following server actor:

      ServerActors=NexgenWarn112N.NexgenWarn

    Note that the actor should be added AFTER the Nexgen controller server actor
    (ServerActors=Nexgen112N.NexgenActor).


 5. Restart your server. If the installation was succesful, you will find he new warning feature in
    Nexgen's moderator tab (if you have the specific right).


####################################################################################################
## 
##  3. Credits and thanks
##
####################################################################################################

- Defrost for developing Nexgen.


####################################################################################################
##
##  4. Info for programmers
##
####################################################################################################
This mod is open source. You can view/and or use the source code of it partially or entirely without
my permission. You are also more then welcome to recompile this mod for another Nexgen version.
Nonetheless I would like you to follow these limitations:

- If you use parts of this code for your own projects, please give credits to me in your readme.
  (Patrick 'Sp0ngeb0b' Peltzer)
  
- If you recompile or edit this plugin, please leave the credits part of the readme intact.
  Also note that you have to pay attention to the naming of your version to avoid missmatches.
  The number in the name stands for the Nexgen version the plugin was compiled for, so if you want
  to recompile the plugin for e.g. 'Nexgen112K', name the plugin 'NexgenWarn112K'. Multiple versions
  of the plugin for one Nexgen release can be shown via '_X', where the X stands for your current
  version number (e.g. 'NexgenWarn112K_2').

- For the case you want to release your own version, contact me first. If you don't receive an
  answer in a week, see this as a 'Yes' ;)
  
NOTE: I use a special work-around inorder to implement my changes in Nexgen's core panels (which
      can not be changed directly). This can cause unwanted results if there's another plugin which
      modifies the Moderator tab. So mod authors, keep this in mind ;)




Bug reports / feedback can be send directly to me.



Sp0ngeb0b, April 2012

admin@unrealriders.de / spongebobut@yahoo.com
www.unrealriders.de
#unrealriders @ QuakeNet