LA WEBTOOL (HERRAMIENTA WEB)

La herramienta WebTool de PunkBuster proporciona los medios para administrar remotamente los servidores de juegos desde cualquier ordenador conectado, por  medio un navegador web (como Netscape Navigator o Internet Explorer de Microsoft).  A partir de la versión 0,987, el software PunkBuster Server incluye un mini servidor web que tiene una interface tipo web para introducir información, que traduce a comandos   de juego.  Este tipo de acceso es similar a usar los comandos desde la “rcon” (consola remota), excepto que se hace a través de una interfaz html y puedes manejarlo incluso desde los ordenadores que no tienen el juego o PunkBuster instalado.  Casi cualquier cosa que se puede hacer desde una consola remota del servidor a través de rcon puede lograrse fácilmente mediante el uso de la herramienta WebTool.  Por defecto,  WebTool está desactivado.  El resto de esta sección explica cómo activar y utilizar el WebTool.

Hay cinco variables de configuración de PunkBuster asociados a la WebTool: pb_sv_httpPort, pb_sv_httpAddr, pb_sv_httpKey, pb_sv_httpRefresh, y pb_sv_httpMaps.  El valor por defecto de pb_sv_httpPort es 0, lo que significa que la WebTools está desactivado.  Para activar el WebTools, debe establecerse un número de puerto entre 1 y 65535, que no esté ya en uso por otro programa en el equipo donde se ejecuta el servidor de juegos, en la variable pb_sv_httpPort. La mayoría de los servidores web utilizan el puerto 80.  Si decide no utilizar 80, entonces probablemente es mejor usar un número que sea, al menos, 1024 o superior para evitar conflictos con otro software.  Una vez que se establece la variable pb_sv_httpPort, PunkBuster responderá diciendo o bien que se está escuchando en el número de puerto especificado o que hubo algún problema al tratar de escuchar en el número de puerto especificado, lo que significa que debe especificarse un número de puerto.  Después de establecer la variable pb_sv_httpPort, debe probar la funcionalidad de WebTool, si es posible, mediante la ejecución de un navegador web en el mismo equipo que el servidor del juego y entrar en esta URL: http://127.0.0.1: Por ejemplo, si se eligió como número de puerto 8000, entonces usted debería introducir en el navegador la dirección web 127.0.0.1:8000.  En este punto, debería abrirse la página de acceso de WebTool.

Si usted desea utilizar la WebTool desde otro ordenador conectado al servidor de juegos por medio de una red (incluso a través de Internet si se desea), entonces la variable pb_sv_httpAddr debe estar configurada con la dirección IP enrutable del servidor de juegos.  Tenga en cuenta que la WebTool no utiliza un protocolo seguro (como https) por razones de rendimiento.  Esto significa que cualquier información que usted envíe desde su navegador web mediante a la WebTool se envía en texto simple  (incluyendo la clave / contraseña).

 La contraseña RCON (rconpassword) es utilizada por el servidor del juego para permitir el acceso remoto a la consola del servidor de juego.  Por defecto, la contraseña RCON también se utiliza para el acceso a la WebTool.  Sin embargo, si desea utilizar una contraseña diferente para el acceso a la WebTool, debe establecerla mediante la variable pb_sv_httpKey.

Una de las pantallas disponibles en el interior de la WebTool es la lista de jugadores.  En esta pantalla se muestra la lista de jugadores y permite a los Administradores prohibirles el acceso al servidor fácilmente.  Por defecto, esta pantalla se actualiza automáticamente en el navegador web cada 30 segundos para mostrar cuando los jugadores dejan el juego o cuando se unen.  Para cambiar la frecuencia de actualización automática, se establece mediante pb_sv_httpRefresh. Configuranado la variable pb_sv_httpRefresh a 999 se inhabilita la característica de actualización automática de la lista de jugadores de la página.

Una de las características de la WebTools es la de permitir al administrador cambiar a un nuevo mapa eligiendo el nombre desde una lista desplegable en el explorador Web.  Por defecto, la variable de configuración pb_sv_httpMaps está vacía, lo que significa que por norma los mapas "oficiales" están incluido en el menú desplegable.  Si quiere modificar las lista de mapas desplegable, debes establecer en la varible pb_sv_httpMaps el nombre los mapas, separados por un espacio, que se desea ver en la lista.  Por ejemplo, configurar pb_sv_httpMaps con "mp_beach mp_ice" significa que sólo los 2 mapas aparecerá en el menú desplegable.  Tenga en cuenta que tu no estas limitando  los mapas que están disponibles en el servidor de ninguna manera, sólo lo que se mostrará en la lista despegable de la WebTools.

PANTALLA DE INCIO DE SESION

La pantalla de inicio de sesión es donde se introduce la clave Web para el acceso a  otras pantallas.  Recuerde que la clave web es el valor establecido en la variable pb_sv_httpKey,  o, en el caso de que esté en blanco, el valor de la password RCON del  servidor de juegos.  Los cuatro botones que aparecen en la parte inferior de la página te llevan a las distintas pantallas de la WebTool, disponibles dentro de la Web, siempre que la clave se introduzca correctamente.  Estos cuatro botones aparecen en la parte inferior de todas las pantallas de la WebTools para que sea fácil navegar por las distintas zonas.

COMMAND SCREEN (PANTALLA DE COMANDOS)

El botón “Command Screen” es común en todas las pantallas, con el fin de que los comandos del juego puedan emitirse de una forma muy sencilla.  El nombre de cada botón se corresponde con el nombre exacto del comando que representa en el servidor de juegos.  Esta es también la pantalla con la lista de mapas desplegable para poder cambiar de mapa más fácilmente.  Si desea emitir un comando específico de un juego que no está incluido en alguno de los botones, introduce el comando en el campo " To console->"  y, a continuación, haga clic en el boton "To console->" para enviar comando al servidor del juego.

PLAYER LIST (LISTA DE JUGADORES)

El botón “Player List” muestra todos los jugadores y sus números de ranura (slot) PunkBuster, junto con la misma información que se muestra mediante el  comando de PunkBuster “pb_sv_plist”.  La parte inferior de esta pantalla tiene botones que te permiten echar a un jugador (kick), prohibir que se conecte al servidor (ban) y obtener una captura de pantalla de un jugador específico.  Para realizar una de estas acciones, primero haga clic en el botón correspondiente al número de slot del jugador al que desea realizar la acción. La información de ese jugador se llena automáticamente en los campos Slot# y GUID en la parte inferior de la pantalla.  Si tiene la intención de expulsar o prohibir ese jugador, puede editar el campo “Reason”, y si echas a alguien, el campo Kick Minute, cuyo valor por defecto es de 2 minutos.  Pulsa el botón correspondiente a la acción.  Tenga en cuenta que presionando el botón pb_sv_getss provocará que el Servidor PB solicite una captura de pantalla del jugador de referencia.  Sin embargo, las capturas de pantalla no son visibles a través de la interfaz de WebTool en este momento.

GAME SETINGS (VARIABLES DE CONFIGURACION DEL JUEGO)

El botón “Game Settings” permite acceder a una pantalla con las variables más comunes del servidor de juegos para cambiarlas fácilmente.  Basta con cambiar el valor de una o más variables de configuración y hacer clic en el botón Update en la parte inferior de la pantalla.  Las etiquetas de los campos se corresponden exactamente con el nombre de la cvar en el servidor del juego.  Si desea cambiar alguna variable de configuración que no se muestra en esta página, puede utilizar la opción "To console->" método que también se encuentra en la opción “Commands Screen” (descrito anteriormente).

PB SETTINGS (VARIABLES DE CONFIGURACION DE PUNKBUSTER)

El botón “PB Settings” permite acceder a la pantalla se utiliza para cambiar la configuración de PunkBuster.  Basta con cambiar el valor de una o más variables de configuracion y hacer clic en el botón “Update”en la parte inferior de la pantalla.  Con excepción del campo de la clave Web, las etiquetas de los campos se corresponden exactamente con el nombre de las variables de configuración del Servidor PunkBuster.  Por favor ten en cuenta que el comportamiento es el mismo que si se cambian  la variables de configuración del PB desde la consola del servidor y que no se guardan en el fichero de configuración de PB hasta que se use el comando pb_sv_writecfg después de hacer el cambio.  Hay un botón para este comando en los Comandos de Pantalla (Commands Screen) (descrita anteriormente).  Si modifica una variable de configuración PB y quiere que PunkBuster "recuerde" el nuevo valor incluso después de que salirte del servidor, entonces debe emitir un comando pb_sv_writecfg después de hacer el cambio.  También debería tener en cuenta que la configuración de la WebTool se puede cambiar en esta página.  Si cambia los valores de la clave de la web, el número de puerto y / o la Dirección, y luego afectarán sus actuales sesiones de WebTool.  En ese caso, debes volver a escribir una nueva URL en el navegador web y volver a empezar con el proceso de inicio de sesión para continuar utilizando la herramienta WebTool.