BN Realpauser

// ============================================================
//            #####  ##   ##
//   ### ###  ##     ##   ##    ### ###
// ### ###    ####   #######  ### ###
//            ##     ##   ##
//            ##     ##   ##
//        ~FH~ UT-Clan  CreatioN
//    ______________________________
//
// Makers: KalestA / byNeutral
// e-mail: [email protected]
// icq: 61334814
// IRC: #fh.it    @    QuakeNet
//
// No one is authorized to modify this code or publish
//  this MOD without an asked authorization to the creators.
// ============================================================

----------------------
WHAT IS IT???
----------------------
----------------------
INSTALLATION
----------------------
To install this mutator, open the file UT2003.INI or the configuration file of the server and
 add the following line in the [Engine.GameEngine] section...

ServerPackages=bN_RealPauser_v1

...then copy all files you can find in this package in the SYSTEM folder of the server.


----------------------
HOW TO USE
----------------------
The mutator, when installed, do not need of any other configuration.
Its operation is based on variable "Max Players" of the server, that is... if the number of
 players in the server drop over this value, the game will be automatically paused. The
 pause do not take action until the flag (in a CTF game) or the ball (in a BR game) are in play.

>>> this mutator work only if the "Tournament mode" is active on the server!!!

It's possible to activate this mutator by the MUTATOR section in the WebAdmin.

In the case we want to modify the functionality of the mutator during a game and without
 restart the server, are available the following console commands...

MUTATE RPON
...enable the mutator.

MUTATE RPOFF
...disable the mutator.

MUTATE STOPALWAYS
...enable/disable the control over the flag (CTF) and over the ball (BR).

MUTATE COUNTDOWN X
...modify the number of countdown seconds before deactivate the pause. X is the num of seconds

MUTATE MAXPLAYERS X
...modify the number of players using for disconnection check. X is the number of players.
(this modification is valid until server restart)

MUTATE BLOCKTIMER
...enable/disable the stop of the time when the pause are active.
WARNING... bots are not paused if this feature are disabled.

MUTATE READYTOSTART
...enable/disable the "start when all players are ready" feature. (Click=Ready)

MUTATE AUTORESTART
...enable/disable the automatic unpause when all players are come back in the server.

MUTATE CLIENTTIMER
...enable/disable the timer that keep the pause elapsed time on all clients.

MUTATE AUTOSETMAXPLAYERS
...enable/disable the automatic set of the MaxPlayers parameter when a new players
 enter in the game.


MUTATE RPSTATES
...show, in console, the states of the mutator. This command is available to ALL players.

MUTATE PAUSE
...manually enable/disable the pause during the game. If the game is in a disconnection pause,
 and we want to manually restart the game, the value of MAXPLAYERS will be automatically
 reset to the current number of players in the server to prevent a new automatic pause after
 restart.

>>> All commands, except RPSTATES, are only available to players logged in the server as ADMIN.
>>> All the features of this mutator are active only if the game is begun and only when the
     game is not ended.
>>> The PAUSE command work only when the game is begun and is not ended.

The values of COUNTDOWN, MAXPLAYERS, BLOCKTIMER and the enable/disable state of the mutator
 can also be changed using the bN_RealPauser.ini file in the SYSTEM folder of the server.


----------------------
OTHER THINGS
----------------------
Any questions, suggestions, proposals, etc... can be send to one of the addresses listed in
 the header of this document.

Anyone is encouraged to send eventual reports on bug to the addresses listed in the header
 of this document.


ENJOY!


// =======================================
// Official internet sites:
//   http://www.fh-clan.it
//
// byNeutral®
// =======================================







// ============================================================
//            #####  ##   ##
//   ### ###  ##     ##   ##    ### ###
// ### ###    ####   #######  ### ###
//            ##     ##   ##
//            ##     ##   ##
//        ~FH~ UT-Clan  CreatioN
//    ______________________________
//
// Creatore: KalestA / byNeutral
// e-mail: [email protected]
// icq: 61334814
// IRC: #fh.it    @    QuakeNet
//
// No one is authorized to modify this code or publish
//  this MOD without an asked authorization to the creators.
// ============================================================

----------------------
DI COSA SI TRATTA???
----------------------
Real Pauser per UT2003 è un remake del mutator RealPauser per UT ma, per ora, con meno opzioni
 del predecessore. Cosa fa questo mutator? Semplice, gestisce le famose pause da disconnessione.
Questo significa che, se durante una ClanWar qualche giocatore si disconnette, il mutator ferma
 il gioco automaticamente. Questo significa che tutto viene fermato e, a differenza della pausa
 normale in UT, viene fermato anche lo scorrere del tempo. Eventuali spettatori all'interno
 del server potranno però muoversi sempre liberamente.
Quando il numero di giocatori diventa di nuovo ottimale il gioco viene, dopo un countdown,
 automaticamente fatto ripartire.

----------------------
INSTALLAZIONE
----------------------
Per installare il mutator, aprire il file UT2003.INI o il file di configurazione del server e
 aggiungere la seguente riga nella sezione [Engine.GameEngine]...

ServerPackages=bN_RealPauser_v1

In più copiare tutti i files contenuti in questo pack all'interno della cartella SYSTEM del
 server.


----------------------
UTILIZZO
----------------------
Il mutator, una volta installato funziona già senza ulteriori configurazioni.
Il suo funzionamento si basa sull'impostazione "Max Players" del server e cioè... se il numero
 di giocatori presenti nel server scende sotto tale numero, il gioco viene automaticamente
 messo in pausa. La pausa non viene applicata finchè la bandiera (in CTF) o la palla (in BR)
 sono in gioco (presa o comunque non in base).
>>> Il mutator funziona solamente se il "Tournament mode" è attivo nel server!!!

Il mutator è attivabile dalla sezione MUTATOR della WebAdmin.

In caso si volesse modificare il funzionamento del mutator durante una partita e senza
 dover riavviare il server sono disponibili i seguenti comandi per console...

MUTATE RPON
...abilita il mutator.

MUTATE RPOFF
...disabilita il mutator.

MUTATE STOPALWAYS
...attiva/disattiva il controllo sulle bandiere (in CTF) e sulla palla (in BR).

MUTATE COUNTDOWN X
...modifica i secondi di countdown alla disattivazione della pausa. X è il num di secondi.

MUTATE MAXPLAYERS X
...modifica il num di giocatori ideale che il mutator controllerà. X è il num. di giocatori.
(modifica valida fino a riavvio server)

MUTATE BLOCKTIMER
...attiva/disattiva il blocco dello scorrere del tempo quando la pausa è attiva.
ATTENZIONE... eventuali bot in gioco non verranno fermati se tale opzione sarà disattivata.

MUTATE READYTOSTART
...attiva/disattiva la possibilità di togliere la pausa quando tutti i giocatori sono pronti.
(Click=Ready)

MUTATE AUTORESTART
...attiva/disattiva l'automatismo che toglie automaticamente la pausa quando tutti i giocatori
 sono rientrati nel server.

MUTATE CLIENTTIMER
...attiva/disattiva il timer del tempo trascorso in pausa, sui vari clients.

MUTATE AUTOSETMAXPLAYERS
...attiva/disattiva la reimpostazione automatica del parametro MaxPlayers quando un nuovo
 giocatore entra in partita.


MUTATE RPSTATES
...visualizza in console lo stato del mutator. Disponibile a TUTTI i giocatori.

MUTATE PAUSE
...attiva/disattiva manualmente la pausa durante il gioco. Se il gioco è già in pausa a causa
 di una disconnessione, il valore di MAXPLAYERS verrà reimpostato al numero attuale di
 giocatori nel server per evitare che il gioco venga rifermato subito.

>>> Tutti i comandi, eccetto RPSTATES, funzionano solamente se si è loggati come ADMIN nel server.
>>> Tutte le funzionalità del mutator sono attive solamente quando il gioco è iniziato e il
     gioco non è finito.
>>> Il comando PAUSE funziona solamente quando il gioco è iniziato e non è finito.

I valori impostabili usando i comandi COUNTDOWN e MAXPLAYERS sono configurabili anche tramite
 il file bN_RealPauser.ini contenuto nella cartella SYSTEM del server.


----------------------
CONCLUSIONI
----------------------
Il mutator è mantenuto ancora in fase di beta testing pur avendo superato tutti gli ultimi
 test effettuati.
 
Chiunque avesse domande, suggerimenti, proposte ecc... può utilizzare uno dei metodi di
 comunicazione sopra elencati.

Si incoraggia chiunque a inviare resoconti su eventuali bug agli indirizzi sopra elencati.


// =======================================
// Official internet sites:
//   http://www.fh-clan.it
//
// byNeutral®
// =======================================

Read More