• Introduzione
• Che cos'è PunkBuster
• Guida di partenza rapida
• I fondamenti
  • Integrazione nel gioco
  • La cartella PB e i file che contiene
  • L'interfaccia di PunkBuster
• Attivare e disattivare PunkBuster
• Aggiornamento di PunkBuster
• Comandi e impostazioni
  • Comandi
  • Impostazioni
• Controllo dei nomi dei giocatori
• Controllo delle variabili del gioco
• Controllo avanzato delle cvar
• Cattura di schermate
• Registrazione su sistema remoto
• Domande frequenti

Questa pubblicazione è destinata agli amministratori di server di gioco in linea a cui interessa utilizzare il sistema anti-trucchi PunkBuster, o che vogliono saperne di più sull'argomento. Attualmente, l'unico gioco che offre supporto diretto per PunkBuster è Return to Castle Wolfenstein, di id Software, Inc.

Abbiamo fatto il possibile perché questa pubblicazione sia utile a tutti i nuovi utenti di PunkBuster, ma anche a quelli avanzati. Saremo lieti di ricevere commenti o suggerimenti per posta elettronica all'indirizzo pubs@evenbalance.com.

Essendo questo manuale destinato agli amministratori di server, presuppone una certa familiarità con la console del gioco, con le procedure di inserimento dei comandi e con l'uso dei file di configurazione.

Se vuoi saperne di più su come usare il client PunkBuster per giocare, consulta la nostra pubblicazione "PunkBuster per i giocatori".

Noi siamo un gruppo di appassionati di giochi in linea. Nel settembre 2000 abbiamo iniziato a occuparci dell'aumento degli imbrogli durante le partite multigiocatore in linea, e abbiamo deciso di fare qualcosa per rimediare. In passato erano già stati fatti dei tentativi, perfino dagli stessi programmatori dei giochi, ma in generale si erano rivelati dei fallimenti. Così, abbiamo elaborato un nuovo modo per affrontare il problema e deciso di sviluppare un software sperimentale per vedere se funzionava. Eravamo dell'idea che, una volta creato un prodotto aperto a tutti, il responso delle comunità in linea ci avrebbe fatto capire se l'esperimento era riuscito oppure no. Dopo diversi mesi di sviluppo, molto duro lavoro, e grazie anche al testing e al supporto di migliaia di utenti, crediamo di aver trovato una soluzione pratica al problema degli imbrogli nei giochi multigiocatore in linea: PunkBuster.

PunkBuster è un sistema software anti-trucchi ad aggiornamento automatico con architettura client/server. In altre parole, i giocatori utilizzano il client PunkBuster quando giocano in linea, mentre il server PunkBuster è in esecuzione sul server a cui ci si collega per giocare. Il sistema PunkBuster è stato pensato per controllare tutti i partecipanti, analizzando i loro computer alla ricerca di trucchi, exploit e altre forme di imbroglio, servendosi di tecniche simili a quelle usate dai programmi antivirus per cercare i virus. PunkBuster non modifica alcun file o impostazione dei computer, anche se rileva qualche forma di violazione. Si limita a segnalare ciò che scopre e, in certi casi, a estromettere i giocatori disonesti dalla partita. PunkBuster è opzionale. Un amministratore di server di giochi che decidesse di utilizzarlo, limiterà la partecipazione ai giocatori che hanno attivato PunkBuster sui propri computer. Se non ti piace l'idea che un software del genere sia in funzione nel tuo sistema, puoi disattivare PunkBuster, che peraltro non è "spyware" e non è neppure un troiano: è stato progettato per aiutare dei gruppi di persone oneste ad allontanare i giocatori che non vogliono utilizzare sui loro sistemi un software neutrale sviluppato da terze parti e capace di analizzarli obiettivamente durante il gioco. Le attività svolte da PunkBuster sono descritte nel nostro sito Web, dove si trova anche una dichiarazione relativa alla privacy. Noi consideriamo molto importante la privacy e la sicurezza dei nostri utenti e dei loro computer: nel nostro software non esiste alcun supporto, documentato o non documentato, che permetta a chicchessia di ottenere il controllo del tuo computer dall'esterno, oppure accedere o modificare informazioni private, apertamente o di nascosto. Inoltre, PunkBuster non trasmette i tuoi file privati a nessun altro computer, né gestisce alcun tipo di database centrale che archivia informazioni relative ai tuoi file personali. PunkBuster essenzialmente si limita a cercare trucchi noti per i videogiochi durante una partita in cui è stato abilitato. L'obiettivo è autenticare le installazioni per garantire una partita onesta a tutti partecipanti.

A metà del 2001 abbiamo creato Even Balance, Inc., una corporazione con capitale privato dedicata a gestire l'applicazione commerciale del sistema PunkBuster. Abbiamo in programma di offrire diversi tipi di prodotti e servizi per le comunità di giocatori in linea che utilizzano i giochi da noi supportati. Siamo interessati a stringere nuovi rapporti con sviluppatori di videogiochi che desiderano affidarci la realizzazione di un supporto anti-trucchi per i loro giochi multigiocatore in linea.

La licenza per uso personale, non commerciale, del software PunkBuster è gratuita. Prima dell'installazione, è necessario accettare il nostro accordo di licenza, visibile su schermo. Per utilizzare PunkBuster in ambienti commerciali di qualsiasi tipo, oppure in collegamento a qualunque evento commerciale, è necessario chiedere a Even Balance, Inc. una specifica licenza commerciale. Per saperne di più sull'argomento, scrivi per posta elettronica a license@evenbalance.com.

Troverai altre informazioni su Even Balance, Inc. e sul sistema PunkBuster visitando il nostro sito Web: evenbalance.com.

Se vuoi creare un server di gioco usando l'elenco dei server nel gioco, assicurati prima che l'impostazione PunkBuster sia 'Yes' (sì). Se vuoi utilizzare il server esclusivamente in modalità console, prima di procedere usa il comando PB_SV_ENABLE per assicurarti che il server PunkBuster sia attivato. Quando PunkBuster viene attivato per la prima volta, utilizza la configurazione predefinita, che è stata pensata per funzionare con tutti i tipi di server di gioco. Modificando le impostazioni di PunkBuster descritte in questa pubblicazione, è possibile ottimizzare il server per adattarlo alla velocità di connessione, al carico di utenti e alle preferenze dell'amministratore. Più avanti vengono elencate alcune opzioni che aumentano notevolmente il livello di protezione dagli imbrogli offerto dal server, con una curva di apprendimento relativamente semplice.

Quando PunkBuster è operativo, puoi attivare la funzione di cattura automatica delle schermate impostando PB_SV_AUTOSS a 1. Per rendere permanente questa e altre modifiche ai parametri di PunkBuster, inserisci il comando PB_SV_WRITECFG, che salva quasi tutte le impostazioni di PunkBuster sul file di configurazione "pbsv.cfg" (caricato da PunkBuster a ogni avvio). Quando la funzione di cattura automatica delle schermate è attivata, il server inizierà a catturare periodicamente le schermate di tutti i giocatori connessi, memorizzandole nella cartella "svss". Il limite predefinito al numero di schermate catturate è 100 e può essere cambiato grazie al comando PB_SV_SSCEILING. Una volta raggiunto il limite, il server PunkBuster inizia a sovrascrivere i file già esistenti, ricominciando dal numero sequenziale più basso, in un ciclo infinito.

Gli amministratori di server che desiderano registrare durante il gioco importanti informazioni sulle cvar dei giocatori connessi, possono modificare nella console del gioco le quattro impostazioni citate di seguito, con l'avvertenza che la mole dei dati raccolti sarà ingente. Ogni 15 minuti tutte le cvar create dall'utente e non predefinite dei giocatori verranno archiviate in speciali file di registro con estensione .var nella cartella "svlogs".

• PB_SV_CvarLogging 2
• PB_SV_CvarWalk 4
• PB_SV_CvarUserPulse 15
• PB_SV_CvarChangedPulse 15

Anche se il gioco deve contenere del codice che permette una stretta integrazione con PunkBuster, i due software sono completamente separati. PunkBuster si trova in una cartella privata "pb" dentro la cartella in cui è installato il gioco. Per esempio, se il gioco è installato in "c:\giochi\rtcw", i file di PunkBuster si troveranno in "c:\giochi\rtcw\pb". Per rimuovere o disinstallare PunkBuster dal tuo sistema, è sufficiente eliminare la cartella "pb" usando la Gestione risorse. PunkBuster non modifica il registro di sistema e non nasconde alcun file o informazione in nessun altro punto del computer.

Quando PunkBuster è stato appena installato, la cartella "pb" contiene solo pochi file. Quando il gioco viene avviato per la prima volta dopo l'installazione di PunkBuster, quest'ultimo aggiunge nuovi file e cartelle che serviranno in seguito.

La cartella "pb" contiene di norma i seguenti tipi di file:

• File con estensione "dll" o "so" (esempio: pbcl.dll): sono file di sistema di PunkBuster. Eliminandoli, si rischia di compromettere il funzionamento di PunkBuster. Modificare anche uno solo di questi file è una violazione dell'accordo di licenza e provoca il suo termine immediato e permanente, assieme alla possibilità di usare legalmente il nostro software.
• File con estensione "db": sono file del database di PunkBuster. Vengono creati e aggiornati automaticamente. Se cancelli uno o più di questi file, PunkBuster li rigenera e li riempie nuovamente con le informazioni raccolte dai server principali PunkBuster, se possibile. Modificare questi file può provocare comportamenti imprevedibili di PunkBuster.
• File con estensione "dat": sono file di dati di PunkBuster. Non dovrebbero essere né cancellati né modificati. Il sistema PunkBuster li gestisce automaticamente.
• File con estensione "log": sono file in cui PunkBuster registra varie informazioni durante l'utilizzo. Di norma, il client PunkBuster registra soltanto le informazioni relative agli errori più gravi. Il server PunkBuster registra automaticamente in questi file le attività importanti.
• File con estensione "htm": sono file speciali di registro, formattati per essere visualizzati con un browser Web come Internet Explorer o Netscape.
• File con estensione "cfg": sono file di configurazione, contenenti i comandi e le impostazioni di PunkBuster. Puoi creare e modificare i tuoi file di configurazione e caricarli automaticamente o manualmente. Più avanti in questa pubblicazione troverai informazioni dettagliate sui comandi e le impostazioni di PunkBuster. Due specifici file "cfg" (pbcl.cfg e pbcllog.cfg) possono essere utilizzati e sovrascritti dal sistema PunkBuster in certe circostanze. All'avvio, PunkBuster carica automaticamente il file di configurazione pbcl.cfg.

PunkBuster crea anche delle sottocartelle all'interno della cartella "pb", per organizzare le proprie informazioni. Ecco un elenco di queste cartelle e relativo contenuto:

• La cartella "htm" contiene file htm utilizzati durante l'aggiornamento automatico del sistema PunkBuster. Dopo un certo tempo di utilizzo e numerosi aggiornamenti, questa cartella può contenere vecchi file che si possono cancellare per recuperare spazio.
• La cartella "dll" contiene diversi file di sistema di PunkBuster, ricavati durante l'aggiornamento automatico da installazioni precedenti di PunkBuster. Come i file htm citati prima, è possibile cancellare i vecchi file di questa cartella per recuperare spazio.
• La cartella "svlogs" contiene i registri del server PunkBuster. I relativi file hanno nomi composti da numeri sequenziali da 8 cifre e dall'estensione ".log".
• La cartella "svss" contiene le schermate (file PNG) catturate dai giocatori connessi al server. Il file pbsvss.htm in questa cartella è un indice sequenziale che può essere utilizzato per visualizzare velocemente e agilmente le schermate catturate.

Esistono due modi per attivare o disattivare il software PunkBuster: scrivendo dei comandi nella console del gioco, oppure utilizzando l'interfaccia del gioco. In seguito si parlerà solo del primo; il secondo è descritto nella nostra pubblicazione "PunkBuster per i giocatori". In ogni caso, quando è disattivato PunkBuster ignora i cambiamenti delle impostazioni e tutti i comandi, tranne quello che lo attiva.

Per attivare il server PunkBuster dalla console, scrivi "PB_SV_ENABLE", senza le virgolette. Per disattivare PunkBuster, scrivi "PB_SV_DISABLE".

NOTA: PunkBuster non può essere disattivato immediatamente durante una partita. Disattivandolo, lo farai entrare in modalità disattivazione, ma si disattiverà realmente solo all'inizio della partita successiva. Né i giocatori né gli amministratori dei server possono attivare o disattivare PunkBuster nel corso di una partita. Una volta attivati per una sessione di gioco, i client e i server PunkBuster restano in funzione, indipendentemente da quante volte si selezioni la modalità attivazione o disattivazione. Solo quando si esce dalla partita viene salvato lo stato attuale di PunkBuster. Nella partita seguente, PunkBuster entrerà nell'ultima modalità selezionata durante la sessione di gioco precedente.

Uno degli aspetti principali del sistema PunkBuster è la sua funzione di aggiornamento automatico. Man mano che vengono pubblicate nuove versioni dei file sui nostri server principali, il software PunkBuster in esecuzione sul computer dei giocatori e degli amministratori cerca di prelevarli e di eseguire un aggiornamento automatico senza interrompere il gioco. Nella maggior parte dei casi, questo processo è automatico e trasparente. Dato che i server PunkBuster richiedono che tutti i giocatori connessi abbiano una versione identica di tutti i file di PunkBuster per autenticarli, la funzione di aggiornamento automatico è un'importante componente del sistema. PunkBuster conserverà le vecchie versioni nel caso che sia necessario collegarsi a un server che utilizza del software PunkBuster non aggiornato.

Tutti i file di aggiornamento di PunkBuster vengono memorizzati in speciali file HTML compressi e possono essere aperti con qualunque browser Web. Abbiamo progettato e realizzato un metodo affidabile per inviare in modo sicuro gli aggiornamenti dai nostri server principali a quelli normali, quindi ai computer su cui è attivo PunkBuster. Abbiamo dedicato ogni cura a sviluppare questo sistema in modo che accetti e utilizzi solo i file autentici di PunkBuster durante l'aggiornamento automatico.

A volte, però, può essere necessario aggiornare manualmente un sistema PunkBuster. Per esempio, l'accesso a Internet può non essere disponibile e c'è una partita multigiocatore in corso su rete locale, oppure si è verificato qualche problema temporaneo di instradamento, che impedisce ai client PunkBuster di trovare i server principali per procurarsi gli aggiornamenti. Oppure ancora, può capitare che la squadra di sviluppo di PunkBuster pubblichi delle versioni beta del software PunkBuster, da scaricare manualmente e da collaudare prima della distribuzione ufficiale. Qualunque sia la ragione che renda necessario un aggiornamento manuale, abbiamo preparato una sezione separata della pagina Download sul nostro sito Web (Even Balance), chiamata 'Manual Updates' (aggiornamenti manuali). Dato che tutti gli aggiornamenti di PunkBuster vengono memorizzati in file HTML (compatibili con i browser Web), non bisogna scaricare alcun file compresso oppure avviare programmi di installazione per effettuare l'aggiornamento. Tutto ciò che serve è aprire i nostri file di aggiornamento con un browser Web e quindi utilizzare il comando "Salva con nome" del menu "File" del browser. Nella pagina di download sono pubblicate anche le istruzioni per salvare i file HTML sul disco rigido locale. Esistono gruppi separati di file per ciascun sistema operativo supportato (ovvero Windows, Linux e Macintosh). Dopo aver usato il comando "Salva con nome", PunkBuster sa come aggiornarsi utilizzando i file salvati. Per completare nel modo giusto certi aggiornamenti manuali, può essere necessario uscire dal gioco e rientrare attivando PunkBuster.

Il modo più semplice per controllare che il tuo server PunkBuster sia correttamente installato, attivato e operativo è scrivere "PB_SV_VER" nella console del gioco. Se tutto è a posto, vedrai apparire il numero di versione del software PunkBuster attualmente installato. Se non c'è risposta,  PunkBuster non è installato correttamente, oppure è danneggiato e deve essere reinstallato.

Alcuni comandi non richiedono parametri aggiuntivi, altri sì. Per esempio, il comando "PB_SV_VER" non prevede alcun parametro: scrivendo "PB_SV_VER" chiedi a PunkBuster di indicarti il numero di versione del software attivo. Il comando "PB_SV_LOAD" accetta invece come parametro il nome di un file. Dunque, scrivendo "PB_SV_LOAD ABC.CFG" chiedi a PunkBuster di caricare il file di configurazione chiamato "ABC.CFG".

Molti amministratori preferiscono controllare da remoto i loro server usando la funzione rcon integrata nel gioco. Quasi tutti i comandi di PunkBuster funzionano nello stesso modo se vengono inseriti nella console o inviati da remoto. Alcuni comandi citati di seguito inviano delle richieste ai client e le risposte non vengono comunicate all'utente quando provengono da remoto attraverso rcon. Questi comandi sono indicati dalla dicitura {solo rcon} dopo il nome, nell'elenco seguente.

Molti amministratori non usano il comando PB_SV_LOAD e preferiscono servirsi del comando exec specifico del gioco, per caricare file di configurazione contenenti i comandi e le impostazioni del gioco e di PunkBuster. Invece, i file di configurazione caricati dal comando PB_SV_LOAD possono contenere soltanto i comandi e le impostazioni di PunkBuster.

Le impostazioni di PunkBuster, a volte chiamate anche variabili, contengono informazioni numeriche o testuali usate dal software durante il funzionamento. Modificandole, puoi influenzare il funzionamento di PunkBuster. Tutte le impostazioni di PunkBuster hanno all'inizio dei valori predefiniti, adatti alla maggior parte degli utenti. Se vuoi sapere il valore attuale di un'impostazione, ti basta scriverne il nome, senza aggiungere altro. Per esempio, scrivendo "PB_SV_AUTOSS" chiedi a PunkBuster di visualizzare il valore attuale di questa impostazione, nonché i valori ammessi. Questa particolare impostazione può essere 1 oppure 0; per impostarla a 1, scrivi "PB_SV_AUTOSS 1": PunkBuster ti risponderà visualizzando il nome dell'impostazione e il nuovo valore. Se cerchi di usare un valore non consentito, PunkBuster sceglie quello ammissibile più vicino.

Qui di seguito troverai un elenco alfabetico dei comandi e delle impostazioni di PunkBuster, una loro descrizione generica e, quando è necessario, le istruzioni d'uso.

PB_SV_BadName [secondi consentiti per cambiare] [parola offensiva]
Aggiunge un nome proibito nel relativo elenco del server, per respingere i giocatori con nomi potenzialmente offensivi.

PB_SV_BadNameDel [posizione]
Elimina un nome proibito nel relativo elenco dei server.

PB_SV_BadNameList
Visualizza l'attuale elenco dei nomi proibiti sul server (consulta la sezione Controllo dei nomi dei giocatori).

PB_SV_Ban [posizione] [ragione indicata] | [ragione privata opzionale]
Elimina un giocatore dalla partita e lo bandisce permanentemente dal server facendo riferimento al suo guid (che dipende dalla chiave di installazione). Il bando viene registrato, e anche scritto nel file pbbans.dat della cartella pb.

PB_SV_BanList [testo opzionale da cercare]
Visualizza nella console l'elenco dei giocatori banditi, inclusi quelli temporaneamente espulsi. Se inserisci il parametro [testo opzionale da cercare], appaiono soltanto i bandi e le espulsioni contenenti il testo specificato (è utile quando devi cercare un nome o un guid ben preciso).

PB_SV_BindSrch [testo da cercare] [nome o posizione del giocatore ] {solo rcon}
Chiede a tutti i giocatori collegati un rapporto sulle associazioni di tasti locali contenenti il [testo da cercare] indicato. Per specificare il nome di un giocatore o una sotto-stringa (invece del numero di posizione), racchiudi il testo fra virgolette.

PB_SV_Cvar [nome della cvar] [IN/OUT/INCLUDE/EXCLUDE] [parametro 1] [parametro 2 opzionale]
Aggiunge una cvar all'elenco delle cvar che il server controlla automaticamente durante il gioco.

PB_SV_CvarChanged [nome o posizione del giocatore ] {solo rcon}
Chiede a tutti i giocatori collegati un elenco delle cvar locali che sono state cambiate rispetto al valore originale predefinito. Per specificare il nome di un giocatore o una sotto-stringa (invece del numero di posizione), racchiudi il testo fra virgolette.

PB_SV_CvarList
Elenca la gamma dei valori ammessi per tutte le cvar che il server controlla (consulta la sezione Controllo delle variabili del gioco).

PB_SV_CvarSrch [testo da cercare] [nome o posizione del giocatore ] {solo rcon}
Chiede a tutti i giocatori collegati un elenco delle cvar locali contenenti il [testo da cercare] indicato. Per specificare il nome di un giocatore o una sotto-stringa (invece del numero di posizione), racchiudi il testo fra virgolette.

PB_SV_CvarUser [nome o posizione del giocatore ] {solo rcon}
Chiede a tutti i giocatori collegati un elenco delle cvar locali da loro create, ovvero non appartenenti al gioco. Per specificare il nome di un giocatore o una sotto-stringa (invece del numero di posizione), racchiudi il testo fra virgolette.

PB_SV_CvarVal [nome variabile] [nome o posizione del giocatore ] {solo rcon}
Chiede a tutti i giocatori collegati il valore della cvar locale indicata. Per specificare il nome di un giocatore o una sotto-stringa (invece del numero di posizione), racchiudi il testo fra virgolette.

PB_SV_Disable
Disattiva il server PunkBuster. Questo comando ha effetto soltanto quando si esce dal server e lo si riavvia.

PB_SV_Enable
Attiva il server PunkBuster.

PB_SV_GetSs [nome o posizione del giocatore ]
Chiede a uno o più giocatori collegati una schermata, che verrà catturata e inviata al server. Per specificare il nome di un giocatore o una sotto-stringa (invece del numero di posizione), racchiudi il testo fra virgolette.

PB_SV_Kick [posizione] [minuti] [ragione indicata] | [ragione privata opzionale]
Esclude un giocatore dalla partita e non gli permette di rientrare prima che sia passato il numero di minuti specificato, o prima che il server venga riavviato, a seconda di quale evento si verifica prima. Le espulsioni temporanee non vengono scritte nel file pbbans.dat, ma sono registrate e appaiono nel rapporto generato dal comando pb_sv_banlist.

PB_SV_Load [nome file]
Carica il file di configurazione di PunkBuster specificato, che può contenere comandi e/o modifiche alle impostazioni del software.

PB_SV_PList
Visualizza un elenco dei giocatori, specificando il loro stato attuale.

PB_SV_Ver
Mostra la versione del server PunkBuster attualmente in esecuzione.

PB_SV_WriteCfg
Scrive i valori attuali delle impostazioni del server PunkBuster sul disco rigido locale, creando o sovrascrivendo il file pbsv.cfg, in modo che vengano caricate automaticamente al prossimo avvio di PunkBuster. Gli amministratori di server che desiderano gestire diversi file di configurazione per varie situazioni, di solito non usano questo comando.

Alcuni amministratori di sistema desiderano limitare il linguaggio blasfemo oppure offensivo sui loro server. È una questione di preferenze personali: chi desidera impedire che i giocatori inseriscano parole considerate offensive nei loro nomi, può sfruttare la funzione di controllo dei nomi di PunkBuster.

Di norma, PunkBuster non controlla i nomi offensivi (detti anche nomi proibiti). Se vuoi creare un elenco di parole offensive che PunkBuster non permetterà ai giocatori di inserire nei propri nomi, usa il comando BadName. Il formato di questo comando è:

PB_SV_BADNAME [secondi consentiti per cambiare] [parola offensiva]

Se desideri, puoi creare un file di configurazione contenente solo comandi di questo tipo, quindi inviare il comando PB_SV_LOAD manualmente oppure sfruttare il file pbsv.cfg per attivare il filtraggio di tutte le parole inserite. Se preferisci, puoi specificare i termini offensivi nella console e usare il comando PB_SV_WRITECFG per generare un file pbsv.cfg contenente l'elenco di questi termini e le altre impostazioni attuali di PB. Il file pbsv.cfg verrà caricato automaticamente da PunkBuster all'avvio.

Se PunkBuster scopre che un giocatore usa un nome contenente una qualunque [parola offensiva] presente nel suo elenco, indipendentemente dal maiuscolo e dal minuscolo, gli invia un messaggio, notificandogli che quel nome non è ammesso sul server e deve essere cambiato. Se il nome non viene regolarizzato entro l'intervallo di tempo specificato in [secondi consentiti per cambiare] per la parola offensiva in questione, il giocatore viene escluso dalla partita. Impostando [secondi consentiti per cambiare] a 0 si ottiene di espellere immediatamente il giocatore, senza visualizzare alcun messaggio di avvertimento.

PB elimina i codici dei colori dai nomi prima di cercare [parola offensiva].

PunkBuster fornisce agli amministratori di server la possibilità di controllare se le cvar dei giocatori sono impostate in una gamma accettabile di valori durante la partita. Quando un giocatore si collega a un server di gioco compatibile con PunkBuster, il client PB scarica dal server l'elenco dei valori accettabili per le cvar e controlla che siano tutte in regola. Il giocatore verrà avvertito di qualunque cvar considerata inaccettabile dal server e avrà alcuni secondi per apportare le necessarie correzioni, prima che il server inizi l'analisi finale. Se il valore di qualche cvar risulta inaccettabile, il giocatore viene immediatamente escluso dalla partita.

Per aggiungere un controllo di cvar al tuo server PB, usa il comando PB_SV_CVAR. È possibile effettuare quattro diversi tipi di controllo sulle cvar: IN, OUT, INCLUDE e EXCLUDE. Ciascuno di essi è spiegato più avanti, con degli esempi che riportano anche il formato del comando PB_SV_CVAR da utilizzare per aggiungere correttamente il relativo controllo all'elenco del server. Come avviene per qualsiasi comando o impostazione di PunkBuster, i controlli delle cvar possono essere memorizzati nei file di configurazione e caricati automaticamente all'avvio, oppure manualmente durante il gioco. Comunque, ti consigliamo di aggiungere i nuovi controlli delle cvar in modo che abbiano effetto al prossimo riavvio del server, piuttosto che durante la partita.

Ricorda che dopo aver raggiunto un controllo di cvar, non lo puoi rimuovere o modificare senza riavviare il server PB. Aggiungendo un nuovo controllo su una stessa cvar, quello già esistente non viene modificato. Ricorda inoltre che i controlli sulle cvar inesistenti restituiscono sempre valori nulli o vuoti (corrispondenti a 0).

PB_SV_CVAR [nome della cvar] IN [valore iniziale] [valore finale opzionale]
Se vuoi che una data cvar abbia sempre un valore prefissato, oppure che sia compresa in una certa fascia di valori, usa il controllo "IN".  Per esempio, "PB_SV_CVAR handicap IN 10" significa che la cvar handicap di ogni giocatore che gioca col tuo server deve sempre essere uguale a 10.  Il comando "PB_SV_CVAR handicap IN 5 15" significa invece che handicap deve sempre avere un valore compreso fra 5 e 15 (inclusi).

PB_SV_CVAR [nome della cvar] OUT [valore iniziale] [valore finale opzionale]
Se vuoi che una data cvar non abbia mai un valore prefissato, oppure che non entri mai in una certa fascia di valori, usa il controllo "OUT".  Per esempio, "PB_SV_CVAR handicap OUT 0" significa che la cvar handicap di ogni giocatore che gioca col tuo server non deve mai essere uguale a 0.  Il comando "PB_SV_CVAR handicap OUT 11 99" significa invece che handicap non deve mai avere valori compresi fra 11 e 99 (inclusi).

PB_SV_CVAR [nome della cvar] INCLUDE [testo]
Se vuoi che una data cvar contenga sempre il [testo] specificato, usa il controllo "INCLUDE". Per esempio, "PB_SV_CVAR r_drawbuffer INCLUDE gl_back" significa che in qualche punto della cvar r_drawbuffer di ciascun giocatore deve sempre essere presente il testo "gl_back".

PB_SV_CVAR [nome della cvar] EXCLUDE [testo]
Se vuoi che una data cvar non contenga mai il [testo] specificato, usa il controllo "EXCLUDE".  Per esempio, "PB_SV_CVAR name EXCLUDE ^" significa che la cvar name di ciascun giocatore non deve mai contenere il testo "^" in alcun punto (nota: il simbolo ^ viene usato per cambiare il colore del testo, dunque l'esempio precedente impedisce di usare nomi colorati sul tuo server senza essere espulso dopo essere stato rilevato da PunkBuster).

Oltre al controllo delle variabili del gioco, descritto nella sezione precedente, PunkBuster comprende anche degli strumenti avanzati che gli amministratori possono usare quando desiderano. Cinque comandi del genere sono PB_SV_BINDSRCH, PB_SV_CVARSRCH, PB_SV_CVARVAL, PB_SV_CVARUSER e PB_SV_CVARCHANGED. i primi tre richiedono due parametri ([testo] [giocatore]) mentre agli altri ne basta uno: [giocatore].  Se [giocatore] non viene specificato per nessuno di questi comandi, l'effetto riguarda tutti i giocatori attualmente connessi. Esistono due modi per specificare i giocatori: usando il numero di posizione o una sotto-stringa del nome. Per scoprire il numero di posizione di un giocatore, usa il comando PB_SV_PLIST e controlla nella prima colonna del tabulato che apparirà. Se vuoi specificare una sotto-stringa del nome, ricordati di racchiuderla fra virgolette. Per esempio, PB_SV_CVARVAL handicap "wolf" preleva il valore della cvar handicap da tutti i giocatori il cui nome contiene la parola "wolf".

Il comando PB_SV_BINDSRCH cerca il [testo] specificato fra le associazioni dei tasti di tutti i giocatori, e segnala i tasti trovati e le funzioni associate, in forma integrale. Può servire per scoprire se qualche giocatore sta cercando di aggirare il controllo delle cvar associando a un tasto il comando che imposta qualche cvar a valori non ammessi dal server e le ripristina prima del controllo successivo. Per esempio, "PB_SV_BINDSRCH back" richiede ai giocatori collegati un elenco di tutti i tasti le cui associazioni contengono "back".

Il comando PB_SV_CVARSRCH è simile a BINDSRCH, descritto prima, con la differenza che cerca all'interno dei valori di tutte le cvar presenti nel sistema del giocatore, comprese quelle da lui definite. Dato che le cvar possono essere usate per eseguire dei comandi, questa ricerca permette di scoprire se qualcuno ha impostato una cvar come alias da eseguire per impostare altre cvar fuori dai valori ammissibili. Quando si invia questo comando, appare l'elenco completo delle cvar del giocatore contenenti il testo specificato. Il valore delle cvar può essere richiamato o registrato manualmente, con il comando PB_SV_CVARVAL, oppure automaticamente, usando l'impostazione PB_SV_CVARWALK.

Il comando PB_SV_CVARVAL si può utilizzare per controllare in qualsiasi momento il valore di una cvar. Per esempio, "PB_SV_CVARVAL cg_drawallweaps" visualizza il valore della cvar cg_drawallweaps di tutti i giocatori collegati. "PB_SV_CVARVAL cg_drawallweaps 1" ha lo stesso effetto, ma solo per il giocatore in posizione 1.

Il comando PB_SV_CVARUSER preleva l'elenco delle cvar create dall'utente.

Il comando PB_SV_CVARCHANGED preleva l'elenco delle cvar che non sono attualmente impostate al loro valore predefinito.

Esistono anche delle impostazioni avanzate per automatizzare la registrazione periodica delle informazioni sulle cvar generate dai comandi citati prima.

L'impostazione PB_SV_CVARLOGGING determina come e dove vengono visualizzate o registrate in un file le informazioni sulle cvar dei giocatori. Un server ad alto traffico con molti giocatori può generare in tempo relativamente breve una grande quantità di informazioni sulle cvar, se il suo amministratore decide di sfruttare le funzioni citate prima. Lasciando l'impostazione PB_SV_CVARLOGGING al suo valore predefinito, ossia 1, tutte le informazioni relative alle cvar vengono gestite come eventi normali, dunque visualizzate sulla console del server e registrate nell'attuale file di registro di PunkBuster. Per inviare le informazioni relative alle cvar a un file separato (.var), imposta PB_SV_CVARLOGGING a 2. In questo caso, PunkBuster compilerà due file di registro separati per ciascuna mappa: uno con estensione .log (registro normale) e uno con estensione .var (registro delle cvar). i due file avranno lo stesso nome, corrispondente al loro numero sequenziale, ma con estensione diversa (per esempio, 00000001.log e 00000001.var).  Impostando PB_SV_CVARLOGGING a 3 si ottiene di registrare le informazioni relative alle cvar usando entrambi i metodi relativi ai valori 1 e 2.

I comandi PB_SV_CVARUSER e PB_SV_CVARCHANGED citati prima servono per smascherare i giocatori che hanno scoperto come aggirare le regole del gioco usando impostazioni ancora sconosciute. Se un amministratore sospetta che un dato giocatore stia facendo delle cose normalmente non consentite dal gioco, può esaminare le sue cvar alla ricerca di combinazioni insolite che rivelino l'imbroglio. Gli amministratori o le associazioni di giocatori possono registrare periodicamente e automaticamente le informazioni relative a tutti i partecipanti, per poi analizzarle in un secondo tempo, invece di effettuare controlli in tempo reale. Per automatizzare l'invio dei comandi PB_SV_CVARUSER e PB_SV_CVARCHANGED a tutti i giocatori, usa le impostazioni PB_SV_CVARUSERPULSE e PB_SV_CVARCHANGEDPULSE. Ad esempio, imposta PB_SV_CVARUSERPULSE a 15 se vuoi che il server PunkBuster invii automaticamente un comando PB_SV_CVARUSER a ciascun giocatore una volta ogni 15 minuti, con distribuzione casuale. Il valore predefinito delle impostazioni PULSE è 99, ovvero la relativa funzione è disattivata. Scegliendo valori inferiori a 98 si attivano queste funzioni automatiche.

Un'altra impostazione avanzata pensata per l'utilizzo assieme alle PULSE, discusse prima, è PB_SV_CVARWALK. Il suo valore predefinito è 0, ovvero la funzione è disattivata. Selezionando un valore non nullo, PunkBuster scorre automaticamente tutte le cvar che appaiono in un elenco, generato per esempio dal comando PB_SV_CVARUSER, e ne richiede il valore effettivo.

Le impostazioni citate di seguito chiedono al server PunkBuster di registrare ogni 15 minuti di gioco tutte le cvar create e modificate da tutti i giocatori, assieme ai relativi valori, in un file di registro separato con estensione .var:

PB_SV_CvarLogging 2
PB_SV_CvarWalk 4
PB_SV_CvarUserPulse 15
PB_SV_CvarChangedPulse 15


PunkBuster permette agli amministratori di sistema di catturare immagini dello schermo di qualsiasi giocatore connesso al server. È molto semplice chiedere una schermata a uno o più giocatori, nonché attivare la cattura automatica. Gli amministratori che vogliono ottimizzare il loro server possono contare su parecchie funzioni avanzate. I valori predefiniti sono adatti alla maggior parte dei casi e sono un buon punto di partenza per capire come funziona la cattura di schermate.

Esistono due modi per catturare schermate: manualmente e automaticamente. Possono anche essere usati assieme. Per catturare manualmente un'immagine dello schermo di tutti i giocatori, è sufficiente scrivere "PB_SV_GETSS" nella console del gioco. Dopo alcuni secondi, appariranno dei messaggi che indicano in quale punto del disco rigido sono state salvate le schermate, e che nome hanno. Il nome contiene un numero sequenziale e le immagini sono tutte in formato PNG, che assomiglia al GIF e al JPG offrendo il meglio di entrambi. Oltre a salvare le schermate in un file PNG, PunkBuster genera anche un file HTML di supporto che ha il loro stesso nome, per consentirti di visualizzarle facilmente con un browser, come Netscape o IE. Inoltre, tutte le schermate catturate vengono registrate in uno specifico file HTML chiamato pbsvss.htm, che funge da indice generale delle immagini.

Per catturare manualmente la schermata di uno o più giocatori, puoi specificare direttamente il loro numero di posizione oppure usare una sotto-stringa di testo che li identifichi tutti. PB preleverà le schermate dei giocatori corrispondenti ai criteri specificati. Per scoprire il numero di posizione di un giocatore, usa il comando PB_SV_PLIST e controlla nella prima colonna del tabulato che apparirà. Per catturare una schermata di tutti i giocatori il cui nome contiene le lettere "ABC", scrivi PB_SV_GETSS "ABC" (le virgolette sono necessarie quando si utilizzano le sotto-stringhe per specificare dei nomi).

Per attivare la cattura automatica delle schermate, imposta PB_SV_AUTOSS a 1 (il valore predefinito è 0). Fatto ciò, puoi modificare i valori delle impostazioni PB_SV_AUTOSSFROM e PB_SV_AUTOSSTO per specificare con quale frequenza PunkBuster richiederà le schermate a ciascun giocatore collegato. Entrambe le impostazioni usano i secondi come unità di misura del tempo, e i loro valori predefiniti sono rispettivamente 60 e 1200. Dunque, il server PunkBuster Server catturerà una nuova schermata per ogni giocatore in un momento scelto a caso, da 1 a 20 minuti dopo la cattura precedente.

Nota: indipendentemente da quale combinazione di cattura manuale o automatica si utilizzi, il sistema PunkBuster limita le richieste in due modi. Innanzitutto, le dimensioni massime di ogni schermata sono limitate a 82.000 pixel, per occupare meno spazio e meno banda passante. Se imposti i parametri (descritti di seguito) per catturare immagini contenenti più di 82.000 pixel, PunkBuster ne ridurrà automaticamente le dimensioni per adattarle a questo limite. Inoltre, PunkBuster non permette di catturare più di 3 schermate ogni 10 minuti per ciascun giocatore, né accetta nuove richieste di cattura prima che siano passati almeno 30 secondi. Il comando PB_SV_PLIST, che visualizza informazioni sui giocatori collegati, mostra una colonna "RecentSS", che indica il numero di richieste inviate a ciascun giocatore negli ultimi 10 minuti.

Gli amministratori dovrebbero ricordare pure che PunkBuster non cattura le schermate quando il gioco locale è stato ridotto a icona, oppure quando è attiva qualche altra applicazione. In questi casi, viene generata una schermata nera, contenente nella parte inferiore il motivo della mancata cattura. Attualmente è impossibile catturare le schermate con certe configurazioni video, che peraltro non consentono neppure al gioco di farlo usando la relativa funzione integrata (esterna a PunkBuster).

Puoi personalizzare la cattura di schermate cambiando questa impostazioni:

PB_SV_SSWIDTH e PB_SV_SSHEIGHT specificano le dimensioni dell'immagine in pixel. Le dimensioni predefinite sono 320 x 240. Se si supera la risoluzione effettiva del video sul sistema locale del giocatore, PB riduce automaticamente i parametri corrispondenti. Per esempio, se chiedi una schermata con risoluzione 800 x 600 a un giocatore che sta usando la risoluzione 640 x 480, PB cattura automaticamente in formato 640 x 480.

PB_SV_XPCT e PB_SV_YPCT specificano su quale punto dello schermo del gioco è centrata la porzione di immagine da catturare. I valori predefiniti sono 50 e 50, corrispondenti al centro dello schermo. Valori inferiori spostano l'area catturata verso sinistra (nel caso di XPCT) e verso l'alto (nel caso di YPCT), mentre valori superiori la spostano rispettivamente verso destra e verso il basso. Impostando XPCT e/o YPCT a -1, viene scelto a caso un valore percentuale compreso fra 0 e 100 per quella specifica richiesta. Dunque, a ogni richiesta vengono catturate in modo casuale porzioni diverse dello schermo.

PB_SV_SSSRATE imposta la frequenza di campionamento della cattura. Per catturare vaste porzioni dello schermo ottenendo ugualmente un'immagine compatta, vengono saltati dei pixel. Sono disponibili le frequenze di campionamento 1, 2 e 4. Scegliendo 2, le dimensioni dell'immagine sono circa un quarto del normale (corrispondente al valore 1), mentre usando 4 scendono a circa un sedicesimo. Questa riduzione delle dimensioni avviene a scapito della qualità. La cosa migliore è usare la frequenza di campionamento 1, tranne quando devi catturare grandi porzioni dello schermo e la perdita di nitidezza non è un problema. Anche rispettando il limite di 82.000 pixel, la frequenza di campionamento 4 ti permette di catturare immagini in formato 1280x1024, per i pochi giocatori che usano risoluzioni così alte.

PB_SV_SSDELAY fa attendere al client PB un numero casuale di secondi (fino a 60) prima di eseguire una richiesta di cattura.

PB_SV_SSPATH può specificare una locazione alternativa dove salvare le schermate catturate. Può trattarsi anche di una cartella di rete condivisa. Il valore predefinito è una stringa vuota, ovvero si usa la cartella pb/svss per memorizzare le schermate catturate e i relativi file di supporto.

PB_SV_SSFLOOR, PB_SV_SSCEILING e PB_SV_SSNEXT stabiliscono le convenzioni usate dal server PB per i nomi delle schermate catturate. L'impostazione PB_SV_SSNEXT contiene il numero sequenziale che PB userà per la prossima immagine: per esempio, se PB_SV_SSNEXT è 250, la prossima immagine si chiamerà su disco pb000250.png, mentre il suo file di supporto sarà pb000250.htm. L'impostazione PB_SV_SSNEXT viene incrementata e gestita automaticamente dal sistema PB, ma può anche essere impostata manualmente. Le impostazioni FLOOR e CEILING stabiliscono l'intervallo della numerazione sequenziale per i nomi delle immagini catturate. Usando il comando PB_SV_SSPATH citato prima, gli amministratori che gestiscono più server possono fare in modo che tutti inviino le schermate a un archivio centrale. Per assicurare che non ci siano conflitti di nomi, si può assegnare a ciascun server una propria gamma di numeri con le impostazioni FLOOR e CEILING.

PB_SV_SSCMD conserva il nome di un file di script locale (batch) eseguito automaticamente da PB dopo aver prelevato con successo ogni schermata. Il valore predefinito è una stringa vuota, dunque non viene eseguito alcuno script locale. PunkBuster passa come parametro a eventuali script il nome completo dell'immagine, con il relativo percorso. Questo accorgimento permette agli amministratori esperti di automatizzare l'elaborazione, l'archiviazione e/o la pubblicazione delle schermate (per esempio su un server Web).

Even Balance, Inc. offrirà presto un servizio speciale facoltativo a pagamento per gli amministratori di server che vogliono registrare in tempo reale su un sistema remoto le firme digitali delle schermate, in modo che vengano pubblicate automaticamente su un sito Web pubblico. Offriremo anche un servizio simile per i giocatori. Ogni abbonato avrà la propria pagina, e le attività di ciascun giorno verranno organizzate in sotto-pagine. Quando questo servizio sarà disponibile, potrai trovare ulteriori informazioni sul nostro sito Web: evenbalance.com.