El inicio

Lo primero a escribir en aventura.js, son la información (el nombre de la aventura, la versión, etc) y los colores que utilizaremos en la aventura.

Información de la aventura

Es muy necesario darle valores a la distinta información que se soporta sobre la aventura. Si bien el juego funcionará igualmente, es un toque de profesionalidad importante.

    ctrl.ponTitulo( "La isla de Montecristo" );
    ctrl.ponIntro( "Despu&eacute;s de huir del castillo de <b>If</b>, \
        arribas a la <i>Isla \
        de Montecristo</i>, para tratar de encontrar el tesoro del que \
        el abate te confes&oacute; su existencia y paradero."
    );
    ctrl.ponImg( "res/islaMontecristo.jpg" );
    ctrl.ponAutor( "baltasarq@gmail.com" );
    ctrl.ponVersion( "201310" );

Todas estas funciones aceptan un solo parámetro, de texto. ponTitulo() define el título de la aventura. ponIntro() el texto introdutorio, ponImg(), una imagen para la portada del juego, si se desea, ponAutor() el nombre del autor, y ponVersion(), un número de serie o de versión para la aventura (yyyymm, donde y es el año y m el mes de publicación, funcionará perfectamente).

Nótese que en el texto introductorio se puede utilizar cualquier etiqueta HTML que se desee.

Primera localidad, y el jugador

Para poder comenzar a jugar, será necesario crear una primera Loc y un Persona jugador. El jugador se crea de la misma forma que cualquier otro personaje, sólo es necesario avisar de que esta localidad es el principio de la aventura, y este personaje es el personaje jugador.

    const locPlaya = ctrl.lugares.creaLoc( "Costa de Montecristo",
                        [ "playa", "cala", "caleta" ],
                        "En la costa, el mar lame los ${guijarros, ex guijarros}. \
                        ${Escarpados peñascos,ex peñascos} escalan las cimas con desniveles \
                        imposibles, y continúan \
                        al ${este,este} en forma de ${cantiles, ex cantiles}. \
                        Puedes ver también el ${bote, ex bote} en el \
                        que llegaste."
    );
    
    const jugador = ctrl.personas.creaPersona( "Edmundo Dantés",
                        [ "jugador" ],
                        "Huído del castillo de If, tienes una pinta \
                        deplorable en este momento.",
                        locPlaya
    );
    
    ctrl.lugares.ponInicio( locPlaya );
    ctrl.personas.cambiaJugador( jugador );

creaLoc() crea una nueva localidad. Sus parámetros son: nombre, sinónimos, y descripción. creaPersona() crea un nuevo personaje, con los parámetros: nombre, sinónimos, descripción y localidad donde aparece. Aunque en el caso del personaje jugador no tendría sentido, para jugadores que todavía no se desea que aparezcan se puede indicar como localidad ctrl.lugares.limbo, una localidad especial donde residen objetos o personajes que todavía no han intervenido en la aventura, o que ya lo han hecho y han desaparecido.

Nótese que los sinónimos son vectores en Javascript, y se delimitan mediante corchetes ([ y ]), y los elementos se separan por comas.

Además, ctrl ofrece una función ini() que por defecto no hace nada, pero en la que se pueden definir instrucciones que se ejecutarán antes del comienzo del juego. Se ejecuta después de haber ejecutado las funciones ini() de las localidades, objetos y personas.

    const locPlaya = ctrl.lugares.creaLoc( "Costa de Montecristo",
                        [ "playa", "cala", "caleta" ],
                        "En la costa, el mar lame los ${guijarros, ex guijarros}. \
                        ${Escarpados peñascos,ex peñascos} escalan las cimas con desniveles \
                        imposibles, y continúan \
                        al ${este,este} en forma de ${cantiles, ex cantiles}. \
                        Puedes ver también el ${bote, ex bote} en el \
                        que llegaste."
    );
    
    const jugador = ctrl.personas.creaPersona( "Edmundo Dantés",
                        [ "jugador" ],
                        "Huído del castillo de If, tienes una pinta \
                        deplorable en este momento.",
                        locPlaya
    );
    
    ctrl.ini = function() {
        ctrl.lugares.ponInicio( locPlaya );
        ctrl.personas.cambiaJugador( jugador );
    };

Los colores, y los estilos en general, se especifican en el archivo CSS: fijs.css. La explicación sobre CSS va más allá del alcance de esta documentación.

• Archivos CSS
• Estándar HTML para colores.

NOTA: En las primeras versiones se podían modificar los colores mediante llamadas a una función de ayuda llamada setColor(), que devolvía true si el color se había cambiado. Esta función ya no tiene efecto, y siempre devuelve true.