/[ambar]/ambar/documentos/guia_colaborador_mine.lyx
ViewVC logotype

Diff of /ambar/documentos/guia_colaborador_mine.lyx

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.17 by pabloruiz, Tue Jul 23 12:00:36 2002 UTC revision 1.18 by pabloruiz, Tue Jul 23 19:04:06 2002 UTC
# Line 40  Una guía para el colaborador Line 40  Una guía para el colaborador
40  \emph default  \emph default
41  versión 0.9  versión 0.9
42  \series default  \series default
43  5  6
44  \series bold  \series bold
45    
46  \newline  \newline
# Line 123  Ancho, alto y profundo es el reino de lo Line 123  Ancho, alto y profundo es el reino de lo
123  \SpecialChar ~  \SpecialChar ~
124  \SpecialChar ~  \SpecialChar ~
125  \SpecialChar ~  \SpecialChar ~
126    \SpecialChar ~
127    \SpecialChar ~
128    \SpecialChar ~
129    
130  \series bold  \series bold
131  Sobre los Cuentos de Hadas, JRR Tolkien  Sobre los Cuentos de Hadas, JRR Tolkien
# Line 244  divide Line 247  divide
247    
248  Cuando la situación la controla un ordenador en vez de una persona, todos  Cuando la situación la controla un ordenador en vez de una persona, todos
249   los casos han de manejarse como la situación en la casa descrita arriba   los casos han de manejarse como la situación en la casa descrita arriba
250   pues éste es incapaz de diferencial cuándo es importante la división en   pues éste es incapaz de diferenciar cuándo es importante la división en
251   zonas del terreno y cuándo no.   zonas del terreno y cuándo no.
252  \layout Standard  \layout Standard
253    
# Line 276  Las salas se componen básicamente de 4 c Line 279  Las salas se componen básicamente de 4 c
279    
280  \layout Itemize  \layout Itemize
281    
282  Descripción.  Descripción
   
283  \layout Itemize  \layout Itemize
284    
285  Objetos existentes  Objetos existentes
# Line 582  Salas. Line 584  Salas.
584   (PJs) personajes no jugadores (PNJs) y en donde se encuentran los objetos.   (PJs) personajes no jugadores (PNJs) y en donde se encuentran los objetos.
585  \layout Standard  \layout Standard
586    
587  En las salas que hemos descrito anteriormente hemos mencionado a existencia  En las salas que hemos descrito anteriormente hemos mencionado la existencia
588   de tres objetos muy diferentes.   de tres objetos muy diferentes.
589   Unas ramitas de tomillo, un cuchillo de cocina y una pluma de ave para   Unas ramitas de tomillo, un cuchillo de cocina y una pluma de ave para
590   escribir.   escribir.
# Line 590  En las salas que hemos descrito anterior Line 592  En las salas que hemos descrito anterior
592    
593  Veamos cómo son por dentro exactamente estos ficheros (véase el apéndice  Veamos cómo son por dentro exactamente estos ficheros (véase el apéndice
594   titulado   titulado
595  \begin_inset Quotes eld  \series bold
 \end_inset  
   
596  Cómo fabricar objetos  Cómo fabricar objetos
597  \begin_inset Quotes erd  \series default
 \end_inset  
   
598  )  )
599  \layout Paragraph  \layout Paragraph
600    
# Line 679  python Line 677  python
677  python  python
678  \series default  \series default
679   como lenguaje de programación por motivos históricos (el fundador del proyecto,   como lenguaje de programación por motivos históricos (el fundador del proyecto,
680   Pablo Ruiz Múzquiz comenzó a programar   Pablo Ruiz Múzquiz comenzó a programar 'ambar' -precursor de Minë- en
681  \begin_inset Quotes eld  \series bold
682  \end_inset  python
683    \series default
684  ambar  ) y por motivos prácticos (
685  \begin_inset Quotes erd  \series bold
686  \end_inset  python
687    \series default
688   -precursor de Minë- en python) y por motivos prácticos (python resuelve   resuelve con elegancia muchos de los problemas que aparecen en el diseño
689   con elegancia muchos de los problemas que aparecen en el diseño de un juego   de un juego de estas características, es multiplataforma y la curva de
690   de estas características, es multiplataforma y la curva de aprendizaje   aprendizaje es muy suave, lo que facilita nuevos colaboradores).
  es muy suave, lo que facilita nuevos colaboradores).  
691  \layout Standard  \layout Standard
692    
693  También utilizamos  También utilizamos
# Line 772  collapsed false Line 769  collapsed false
769  Modelo de datos  Modelo de datos
770  \layout Standard  \layout Standard
771    
772  Este es el bloque más significativo, que contiene el diseño "conceptual".  Éste es el bloque más significativo, que contiene el diseño
773    \emph on
774    conceptual
775    \emph default
776    .
777   Cada clase de aquí representa una entidad del juego tal como lo ven los   Cada clase de aquí representa una entidad del juego tal como lo ven los
778   usuarios (personajes, salas, objetos...).   usuarios (personajes, salas, objetos...).
779  \layout Standard  \layout Standard
# Line 946  ConnectionHandler y Connection represent Line 947  ConnectionHandler y Connection represent
947    
948  TimerHandler y Timer son temporizadores, o cronómetros, útiles para medir  TimerHandler y Timer son temporizadores, o cronómetros, útiles para medir
949   tiempos.   tiempos.
950  \layout Standard   Utils es un módulo "cajón de sastre" para meter funciones sencillitas y
   
 Utils es un módulo "cajón de sastre" para meter funciones sencillitas y  
951   variadas.   variadas.
952  \layout Section  \layout Section
953    
# Line 960  Hemos seguido unas reglas básicas de cod Line 959  Hemos seguido unas reglas básicas de cod
959   En primer lugar, tenemos un fichero fuente por cada clase, con el mismo   En primer lugar, tenemos un fichero fuente por cada clase, con el mismo
960   nombre de la clase en minúsculas (p.   nombre de la clase en minúsculas (p.
961   ej.   ej.
962   la clase DialogoCrear está en dialogocrear.py).   la clase
963    \family typewriter
964    \size small
965    DialogoCrear
966    \family default
967    \size default
968     está en dialogocrear.py).
969   Todos los ficheros tienen al principio la nota de "CopyLeft", el comentario   Todos los ficheros tienen al principio la nota de "CopyLeft", el comentario
970   que indica su contenido, los import, y la clase.   que indica su contenido, los import, y la clase.
971   Todas las clases tienen un bloque de comentarios explicando la clase con   Todas las clases tienen un bloque de comentarios explicando la clase con
# Line 969  Hemos seguido unas reglas básicas de cod Line 974  Hemos seguido unas reglas básicas de cod
974  \layout Standard  \layout Standard
975    
976  Al escribir el código se siguen unas normas de diseño, que se pueden consultar  Al escribir el código se siguen unas normas de diseño, que se pueden consultar
977   en el apéndice titulado 'Normas de diseño de código fuente de Minë'.   en el apéndice titulado
978    \series bold
979    Normas de diseño de código fuente de Minë
980    \series default
981    .
982  \layout Standard  \layout Standard
983    
984  Al leer el código es fundamental leer las clases siguiendo el diagrama,  Al leer el código es fundamental leer las clases siguiendo el diagrama,
# Line 987  El bucle principal del programa está en Line 996  El bucle principal del programa está en
996   alguien).   alguien).
997   Por ejemplo, si un jugador escribe algo desde su terminal, el objeto de   Por ejemplo, si un jugador escribe algo desde su terminal, el objeto de
998   tipo InterfazPJ correspondiente a ese jugador recibe una llamada al método   tipo InterfazPJ correspondiente a ese jugador recibe una llamada al método
999   comando_recibido().  
1000    \family typewriter
1001    \size small
1002    comando_recibido()
1003    \family default
1004    \size default
1005    .
1006  \layout Chapter  \layout Chapter
1007    
1008  Apéndices  Apéndices
# Line 1009  El sistema de conversación con los PNJ e Line 1024  El sistema de conversación con los PNJ e
1024   jugadores las tareas de:   jugadores las tareas de:
1025  \layout Itemize  \layout Itemize
1026    
1027  Crear nuevas conversaciones PJ - PNJ por parte de los maestros de salas.  Crear nuevas conversaciones PJ - PNJ por parte de los maestros de lugares.
1028  \layout Itemize  \layout Itemize
1029    
1030  Interactuar con los PNJs durante el juego.  Interactuar con los PNJs durante el juego.
# Line 1018  Interactuar con los PNJs durante el jueg Line 1033  Interactuar con los PNJs durante el jueg
1033  Otro objetivo importante es el permitir que los PNJs ayuden a crear un entorno  Otro objetivo importante es el permitir que los PNJs ayuden a crear un entorno
1034   de juego creíble y una historia interesante.   de juego creíble y una historia interesante.
1035   La conversación que se puede sostener con un PNJ la creará un Maestro de   La conversación que se puede sostener con un PNJ la creará un Maestro de
1036   Salas, con un mecanismo similar al que se usa para crear habitaciones.   Lugares, con un mecanismo similar al que se usa para crear habitaciones.
1037  \layout Standard  \layout Standard
1038    
1039  Cada conversación estará centrada en "temas" que tienen asociado un fragmento  Cada conversación estará centrada en "temas" que tienen asociado un fragmento
# Line 1076  Como muestra, éste es un fragmento del d Line 1091  Como muestra, éste es un fragmento del d
1091  \size footnotesize  \size footnotesize
1092  - Bienvenido, mi joven aprendiz.  - Bienvenido, mi joven aprendiz.
1093   ¿Estás preparado para comenzar tu instrucción sobre habilidades de supervivenci   ¿Estás preparado para comenzar tu instrucción sobre habilidades de supervivenci
1094  a en el mundo de la Tierra Media? Asientes con admiración y respeto.  a en el mundo de la Tierra Media?
1095    \layout Standard
1096    
1097    
1098    \family typewriter
1099    \size footnotesize
1100    - Asientes con admiración y respeto.
1101    
1102  \layout Standard  \layout Standard
1103    
# Line 1120  a en el mundo de la Tierra Media? Asient Line 1141  a en el mundo de la Tierra Media? Asient
1141    
1142  \family typewriter  \family typewriter
1143  \size footnotesize  \size footnotesize
1144  - Lo primero que debes dominar es el funcionamiento de la linea de comandos.  - Lo primero que debes dominar es el funcionamiento de la línea de comandos.
1145   No irás muy lejos si no sabes siquiera cómo desplazarte, ¿verdad? También   No irás muy lejos si no sabes siquiera cómo desplazarte, ¿verdad? También
1146   es importante que sepas cómo combatir, y por cierto que deberás aprender   es importante que sepas cómo combatir, y por cierto que deberás aprender
1147   el arte de una buena conversación si quieres llegar a alguna parte.   el arte de una buena conversación si quieres llegar a alguna parte.
# Line 1155  a en el mundo de la Tierra Media? Asient Line 1176  a en el mundo de la Tierra Media? Asient
1176    
1177  \family typewriter  \family typewriter
1178  \size footnotesize  \size footnotesize
1179  - ¿Podrías darme algún ejemplo de manejo de la linea de comandos, mi buen  - ¿Podrías darme algún ejemplo de manejo de la línea de comandos, mi buen
1180   mentor?   mentor?
1181  \layout Standard  \layout Standard
1182    
# Line 1696  Pasamos ahora a la chicha del asunto. Line 1717  Pasamos ahora a la chicha del asunto.
1717  \layout Standard  \layout Standard
1718    
1719  en donde cada uno puede cambiar tanto el autor como el área pero no la version  en donde cada uno puede cambiar tanto el autor como el área pero no la version
1720   (¡ojo! NO poner tildes en 'area="loquesea"').   (¡ojo! NO poner tildes en
1721   Lo de version="1.1" dejadlo así, es una manera de que el programa no se  \family typewriter
1722   haga lios segun vayamos evolucionando el formato de este fichero.  \size small
1723    'area="loquesea"'
1724    \family default
1725    \size default
1726    ).
1727     Lo de
1728    \family typewriter
1729    \size small
1730    version="1.1"
1731    \family default
1732    \size default
1733     dejadlo así, es una manera de que el programa no se haga lios segun vayamos
1734     evolucionando el formato de este fichero.
1735   Cada vez que se haga un cambio aumentaremos el numero de version, y el   Cada vez que se haga un cambio aumentaremos el numero de version, y el
1736   programa se negara a cargar ficheros con una version distinta a la que   programa se negara a cargar ficheros con una version distinta a la que
1737   el entiende.   el entiende.
1738   Para no desaprovechar el trabajo realizado, normalmente proporcionaremos   Para no desaprovechar el trabajo realizado, normalmente proporcionaremos
1739   un script para convertir automaticamente los ficheros a las nuevas versiones   un script para convertir automaticamente los ficheros a las nuevas versiones
1740   (si es posible hacerlo).   (si es posible hacerlo).
1741   Esto lo decimos para que la gente no se lleve a engaño y crea que version="1.1"   Esto lo decimos para que la gente no se lleve a engaño y crea que
1742    \family typewriter
1743    \size small
1744    version="1.1"
1745    \family default
1746    \size default
1747   se refiere a la versión de su sala...   se refiere a la versión de su sala...
1748   Si deseáis realizar algún comentario, hacedlo en el campo -opcional- de   Si deseáis realizar algún comentario, hacedlo en el campo -opcional- de
1749   comentario="" (ej: comentario="Sala de pruebas, intento de tener una sala  
1750   con personajes no jugadores").  \family typewriter
1751    \size small
1752    comentario=""
1753    \family default
1754    \size default
1755     (ej:
1756    \family typewriter
1757    \size small
1758    comentario="Sala de pruebas, intento de tener una sala con personajes no
1759     jugadores"
1760    \family default
1761    \size default
1762    ).
1763   No confundir tampoco con la version del lenguaje XML de la primera linea   No confundir tampoco con la version del lenguaje XML de la primera linea
1764   del fichero.   del fichero.
1765    
# Line 1732  Bien. Line 1782  Bien.
1782    
1783  \layout Standard  \layout Standard
1784    
1785  dentro de <id></id> habréis de poner una sola palabra que identifique de  dentro de
1786   forma unívoca al fichero en donde se guarda la sala.  \family typewriter
1787    \size small
1788     <id></id>
1789    \family default
1790    \size default
1791     habréis de poner una sola palabra que identifique de forma unívoca al fichero
1792     en donde se guarda la sala.
1793   Para ello, la recomendación (por llamarlo de alguna manera) es que escribáis   Para ello, la recomendación (por llamarlo de alguna manera) es que escribáis
1794    
1795  \layout Standard  \layout Standard
1796    
1797    
1798    \family typewriter
1799    \size small
1800  nombre_de_area-nombre_de_sala.  nombre_de_area-nombre_de_sala.
1801    
1802  \layout Standard  \layout Standard
# Line 1756  Si existe un área llamada "poblado" y cr Line 1815  Si existe un área llamada "poblado" y cr
1815   el campo área de todas las salas que pertenezcan a la posada del poblado.   el campo área de todas las salas que pertenezcan a la posada del poblado.
1816   La parte del id de una sala que se refiere a la sala en sí también puede   La parte del id de una sala que se refiere a la sala en sí también puede
1817   contener más de dos palabras pero siempre separadas por guiones bajos (a   contener más de dos palabras pero siempre separadas por guiones bajos (a
1818   modo de espacios), como por ejemplo; piso01_cuarto02.   modo de espacios), como por ejemplo;
1819    \family typewriter
1820    \size small
1821    piso01_cuarto02
1822    \family default
1823    \size default
1824    .
1825   Con lo que el id completo resultaría ser:   Con lo que el id completo resultaría ser:
1826  \newline  \newline
1827    
# Line 1918  ha de provocar al viajante una sensación Line 1983  ha de provocar al viajante una sensación
1983    
1984  \layout Standard  \layout Standard
1985    
1986  Si leéis los dos 'items' dentro de <descripcion></descripcion> veréis que  Si leéis los dos 'items' dentro de
1987   uno lleva un "dificultad='12'" y el otro no.  \family typewriter
1988   ¿Por qué? Digamos que una sala SIEMPRE tiene un <item> sin dificultad que  \size footnotesize
1989   se le aparecerá a todo quisque que asome la pata por ahí mientras que aquellos  <descripcion></descripcion>
1990   <item> con dificultad aparecerán impresos sólo a aquellos personajes que  \family default
1991   superen una tirada interna de percepción del programa.  \size default
1992     veréis que uno lleva un
1993    \family typewriter
1994    \size footnotesize
1995    "dificultad='12'"
1996    \family default
1997    \size default
1998     y el otro no.
1999     ¿Por qué? Digamos que una sala SIEMPRE tiene un
2000    \family typewriter
2001    \size footnotesize
2002    <item>
2003    \family default
2004    \size default
2005     sin dificultad que se le aparecerá a todo quisque que asome la pata por
2006     ahí mientras que aquellos
2007    \family typewriter
2008    \size footnotesize
2009    <item>
2010    \family default
2011    \size default
2012     con dificultad aparecerán impresos sólo a aquellos personajes que superen
2013     una tirada interna de percepción del programa.
2014   Para que os hagáis una idea de a qué equivalen ciertos valores en la dificultad   Para que os hagáis una idea de a qué equivalen ciertos valores en la dificultad
2015   ahí va una tabla resumen orientativa.   ahí va una tabla resumen orientativa.
2016    
# Line 2171  Las salidas en una sala Line 2258  Las salidas en una sala
2258    
2259  IMPORTANTE: los siguientes datos se refieren a las posibles salidas.  IMPORTANTE: los siguientes datos se refieren a las posibles salidas.
2260   se recomienda que se relacionen items de descripcion con alguna salida.   se recomienda que se relacionen items de descripcion con alguna salida.
2261   para ello colocad el mismo valor de dificultad en aquellos <item> y salidas   para ello colocad el mismo valor de dificultad en aquellos
2262   relacionados.  \family typewriter
2263    \size footnotesize
2264    <item>
2265    \family default
2266    \size default
2267     y salidas relacionados.
2268   Luego pondremos un ejemplo.   Luego pondremos un ejemplo.
2269    
2270  \layout Standard  \layout Standard
# Line 2291  Analicemos esto detenidamente. Line 2383  Analicemos esto detenidamente.
2383    
2384  \layout Standard  \layout Standard
2385    
2386  lo primero es escribir <salidas> (y lo último </salidas>).  lo primero es escribir
2387    \family typewriter
2388    \size footnotesize
2389    <salidas>
2390    \family default
2391    \size default
2392     (y lo último
2393    \family typewriter
2394    \size footnotesize
2395    </salidas>
2396    \family default
2397    \size default
2398    ).
2399   Entremedias, y en este caso, tenemos 7 -siete- posibles direcciones a las   Entremedias, y en este caso, tenemos 7 -siete- posibles direcciones a las
2400   que ir.   que ir.
2401   Escribe tan sólo aquellas que de verdad existan o déjalas vacías.   Escribe tan sólo aquellas que de verdad existan o déjalas vacías.
2402    
2403  \layout Standard  \layout Standard
2404    
2405  Por ej: <abajo></abajo> quiere decir que no hay nada hacia abajo.  Por ej:
2406    \family typewriter
2407    \size footnotesize
2408    <abajo></abajo>
2409    \family default
2410    \size default
2411     quiere decir que no hay nada hacia abajo.
2412   Para eso, simplemente no lo escribas.   Para eso, simplemente no lo escribas.
2413    
2414  \layout Standard  \layout Standard
2415    
2416  Cojamos la primera salida de nuestro ejemplo:  Cojamos la primera salida de nuestro ejemplo:
2417    \newline
2418    
2419  \layout Standard  \layout Standard
2420    
2421    
# Line 2391  Los jugadores tambien pueden usar la pri Line 2503  Los jugadores tambien pueden usar la pri
2503  Bien.  Bien.
2504   también está la dificultad.   también está la dificultad.
2505   Si creéis que una de las salidas no es visible a simple vista podéis poner   Si creéis que una de las salidas no es visible a simple vista podéis poner
2506   un dificultad="37" que se aplicará de la misma forma que los items de la   un
2507   descripcion de antes.  \family typewriter
2508    \size footnotesize
2509    dificultad="37"
2510    \family default
2511    \size default
2512     que se aplicará de la misma forma que los items de la descripcion de antes.
2513    
2514  \layout Standard  \layout Standard
2515    
# Line 2422  Un personaje que sea capaz de ver un ite Line 2539  Un personaje que sea capaz de ver un ite
2539  \layout Standard  \layout Standard
2540    
2541  cada uno en su respectivo sitio dentro del fichero, claro.  cada uno en su respectivo sitio dentro del fichero, claro.
2542   No abuséis mucho de las dificultad=' '.   No abuséis mucho de las
2543    \family typewriter
2544    \size footnotesize
2545    dificultad=' '
2546    \family default
2547    \size default
2548    .
2549   Usadlo con mesura.   Usadlo con mesura.
2550   Se trata de la Tierra Media, no de un laberinto oscuro.   Se trata de la Tierra Media, no de un laberinto oscuro.
2551   Una salida con dificultad por sala es una auténtica burrada.   Una salida con dificultad por sala es una auténtica burrada.
# Line 2789  volumen: Se refiere, no al volumen físic Line 2912  volumen: Se refiere, no al volumen físic
2912   MUY grande.   MUY grande.
2913   una persona normal ocupa 1 unidad de volumen (un hobbit 0.5 u.vol).   una persona normal ocupa 1 unidad de volumen (un hobbit 0.5 u.vol).
2914   Un dragón puede ocupar desde 30 hasta 500 u.vol.   Un dragón puede ocupar desde 30 hasta 500 u.vol.
2915   Si ponéis volumen="0" nadie podrá entrar.   Si ponéis
2916   si ponéis volumen="0.5", sólo los hobbits podrán entrar y sólo de UNO en  \family typewriter
2917   UNO.  \size footnotesize
2918    volumen="0"
2919    \family default
2920    \size default
2921     nadie podrá entrar.
2922     si ponéis
2923    \family typewriter
2924    \size footnotesize
2925    volumen="0.5"
2926    \family default
2927    \size default
2928    , sólo los hobbits podrán entrar y sólo de UNO en UNO.
2929    
2930  \begin_deeper  \begin_deeper
2931  \layout Standard  \layout Standard
2932    
2933  Una plaza del pueblo, si la consideráis una sala única, podría tener volumen=200  Una plaza del pueblo, si la consideráis una sala única, podría tener
2934    \family typewriter
2935    \size footnotesize
2936    volumen='200'
2937    \family default
2938    \size default
2939   ó mucho más si se trata de Minas Tirith pero recomendamos que a partir   ó mucho más si se trata de Minas Tirith pero recomendamos que a partir
2940   de 200 subdividáis la estancia en varias o incluso convirtáis una zona   de 200 subdividáis la estancia en varias o incluso convirtáis una zona
2941   con ambiente propio en un área diferente.   con ambiente propio en un área diferente.
2942   Es decir, es mejor escribir 'minastirith_ciudad-plaza01_norte01' volumen=80   Es decir, es mejor escribir '
2943   'minastirith_ciudad-plaza01_sur01' volumen=90 que 'mintastirith-plaza01'  \family typewriter
2944   volumen=170.  \size footnotesize
2945    minastirith_ciudad-plaza01_norte01
2946    \family default
2947    \size default
2948    '
2949    \family typewriter
2950    \size footnotesize
2951    volumen='80'
2952    \family default
2953    \size default
2954    
2955    \family typewriter
2956    \size footnotesize
2957    'minastirith_ciudad-plaza01_sur01'
2958    \family default
2959    \size default
2960    
2961    \family typewriter
2962    \size footnotesize
2963    volumen='90'
2964    \family default
2965    \size default
2966     que
2967    \family typewriter
2968    \size footnotesize
2969    'mintastirith-plaza01
2970    \family default
2971    \size default
2972    '
2973    \family typewriter
2974    \size footnotesize
2975    volumen='170'
2976    \family default
2977    \size default
2978    .
2979   Siempre habrá excepciones, naturalmente, pero se apela al sentido común   Siempre habrá excepciones, naturalmente, pero se apela al sentido común
2980   del 'maestro de lugares'.   del 'maestro de lugares'.
2981   Un cuarto corriente estaría entre volumen=6 y volumen=15.   Un cuarto corriente estaría entre
2982    \family typewriter
2983    \size footnotesize
2984    volumen='6'
2985    \family default
2986    \size default
2987    y
2988    \family typewriter
2989    \size footnotesize
2990    volumen='15'
2991    \family default
2992    \size default
2993    .
2994    
2995  \layout Standard  \layout Standard
2996    
# Line 2820  luz: esto que parece una tontería NO lo Line 3005  luz: esto que parece una tontería NO lo
3005   la luz tomará un valor entre 0 (oscuridad total) y 100 (¿el negro? ¿qué   la luz tomará un valor entre 0 (oscuridad total) y 100 (¿el negro? ¿qué
3006   es el negro?).   es el negro?).
3007   No cometáis el error de describir la sala como 'oscura y viscosa' y poner   No cometáis el error de describir la sala como 'oscura y viscosa' y poner
3008   luz=78.  
3009    \family typewriter
3010    \size footnotesize
3011    luz='78'
3012    \family default
3013    \size default
3014    .
3015    
3016  \begin_deeper  \begin_deeper
3017  \layout Standard  \layout Standard
3018    
3019  Al mediodía en la plaza mayor podríamos tener luz=70.  Al mediodía en la plaza mayor podríamos tener
3020   Por la noche, con luna llena, luz=30 En un cuarto con ventana, a media  \family typewriter
3021   tarde, luz=50.  \size footnotesize
3022   En los pasadizos de Moria, luz=20  luz='70'
3023    \family default
3024    \size default
3025    .
3026     Por la noche, con luna llena,
3027    \family typewriter
3028    \size footnotesize
3029    luz='30'
3030    \family default
3031    \size default
3032     En un cuarto con ventana, a media tarde,
3033    \family typewriter
3034    \size footnotesize
3035    luz='50'
3036    \family default
3037    \size default
3038    .
3039     En los pasadizos de Moria,
3040    \family typewriter
3041    \size footnotesize
3042    luz='20'
3043    \family default
3044    \size default
3045    
3046  \layout Standard  \layout Standard
3047    
3048  Escribid el luz="" el máximo posible de luz atendiendo al mediodía.  Escribid el
3049    \family typewriter
3050    \size footnotesize
3051    luz=""
3052    \family default
3053    \size default
3054     el máximo posible de luz atendiendo al mediodía.
3055   El programa, según qué hora sea, hará un pequeño ajuste automático.   El programa, según qué hora sea, hará un pequeño ajuste automático.
3056    
3057  \layout Standard  \layout Standard
# Line 2840  La luz afecta a la percepión del persona Line 3060  La luz afecta a la percepión del persona
3060   salidas o personajes escondidos), al combate (poca luz lo entorpece pero   salidas o personajes escondidos), al combate (poca luz lo entorpece pero
3061   demasiada también), a los atributos de ciertas razas como los orcos por   demasiada también), a los atributos de ciertas razas como los orcos por
3062   ejemplo, etc.   ejemplo, etc.
3063   Una luz=90 se considera mágica, a la igual que una luz=10 se considera   Una
3064   obra de algún tipo de hicería oscura.  \family typewriter
3065    \size footnotesize
3066    luz='90'
3067    \family default
3068    \size default
3069     se considera mágica, al igual que una
3070    \family typewriter
3071    \size footnotesize
3072    luz='10'
3073    \family default
3074    \size default
3075     se considera obra de algún tipo de hicería oscura.
3076    
3077  \end_deeper  \end_deeper
3078  \layout Itemize  \layout Itemize
# Line 2851  aura: Llegamos a una de las propiedades Line 3082  aura: Llegamos a una de las propiedades
3082   idea.   idea.
3083   El aura es la sensación de bondad o maldad que despide una sala.   El aura es la sensación de bondad o maldad que despide una sala.
3084   Un 0 significaría encontrarse en las propias entrañas de Melkor y un 100   Un 0 significaría encontrarse en las propias entrañas de Melkor y un 100
3085   haber cantado con los Ainur el Ainulindale.   haber cantado con los Ainur el Ainulindalë.
3086   Los valores con los que se trabajará normalmente estarán en el rango [25-75]   Los valores con los que se trabajará normalmente estarán en el rango [25-75]
3087   y sólo de forma MUY excepcional se debería poner un 90 (el mismo centro   y sólo de forma MUY excepcional se debería poner un 90 (el mismo centro
3088   de Lórien) o un 15 (el trono de Sauron).   de Lórien) o un 15 (el trono de Sauron).
3089   El aura es algo que también tienen los objetos y los personajes, tanto   El aura es algo que también tienen los objetos y los personajes, tanto
3090   jugadores como controlados por el ordenador.   jugadores como controlados por el ordenador.
3091   Esto quiere decir que un orco tendrá típicamente un valor de aura=35 mientras   Esto quiere decir que un orco tendrá típicamente un valor de
3092   que un elfo, dependiendo de su casta podrá alcanzar aura=70.  \family typewriter
3093    \size footnotesize
3094    aura='35'
3095    \family default
3096    \size default
3097     mientras que un elfo, dependiendo de su casta podrá alcanzar
3098    \family typewriter
3099    \size footnotesize
3100    aura='70'
3101    \family default
3102    \size default
3103    .
3104   El aura de la sala no sólo sirve para hacernos una idea del ambiente que   El aura de la sala no sólo sirve para hacernos una idea del ambiente que
3105   se 'respira' en ella sino que puede afectar de forma directa a los personajes   se 'respira' en ella sino que puede afectar de forma directa a los personajes
3106   que se encuentren en ella y que posean auras muy diferentes a las de la   que se encuentren en ella y que posean auras muy diferentes a las de la
3107   sala.   sala.
3108   Un orco de aura=30 que entre en un santuario élfico de aura=70 verá disminuido   Un orco de
3109   su potencial a prácticamente la mitad o incluso puede morir con sólo tocar  \family typewriter
3110   un objeto puesto que una diferencia de 40 puntos en aura es excesiva.  \size footnotesize
3111   Un camino perdido en mitad de la Tierra Media tendrá un aura=50.  aura='30'
3112    \family default
3113    \size default
3114     que entre en un santuario élfico de
3115    \family typewriter
3116    \size footnotesize
3117    aura='70'
3118    \family default
3119    \size default
3120     verá disminuido su potencial a prácticamente la mitad o incluso puede morir
3121     con sólo tocar un objeto puesto que una diferencia de 40 puntos en aura
3122     es excesiva.
3123     Un camino perdido en mitad de la Tierra Media tendrá un
3124    \family typewriter
3125    \size footnotesize
3126    aura='50'
3127    \family default
3128    \size default
3129    .
3130   Tened en cuenta en qué época estáis escribiendo vuestra área.   Tened en cuenta en qué época estáis escribiendo vuestra área.
3131   Si lo hacéis a mediados de la tercera edad los valores son los que os hemos   Si lo hacéis a mediados de la tercera edad los valores son los que os hemos
3132   dicho pero según avanza el señor oscuro y llegamos al Señor de los Anillos   dicho pero según avanza el señor oscuro y llegamos al Señor de los Anillos
# Line 2876  aura: Llegamos a una de las propiedades Line 3136  aura: Llegamos a una de las propiedades
3136    
3137  combate: puede tomar dos valores.  combate: puede tomar dos valores.
3138   'si' o 'no'.   'si' o 'no'.
3139   en principio todo sitio permite el combate pero a veces conviene reservar   en principio todo sitio permite el combate (así que si no pones, se sobreentien
3140   ciertos lugares para la curación o para charlar sin ser molestados, o quizá  de que has puesto
3141   es que no hay apenas sitio (volumen=2) para hacerlo, y entonces podéis  \family typewriter
3142   poner combate="no".  \size footnotesize
3143    combate='si'
3144    \family default
3145    \size default
3146    ) pero a veces conviene reservar ciertos lugares para la curación o para
3147     charlar sin ser molestados, o quizá es que no hay apenas sitio (
3148    \family typewriter
3149    \size footnotesize
3150    volumen='2'
3151    \family default
3152    \size default
3153    ) para hacerlo, y entonces podéis poner
3154    \family typewriter
3155    \size footnotesize
3156    combate="no"
3157    \family default
3158    \size default
3159    .
3160    
3161  \layout Itemize  \layout Itemize
3162    
# Line 2889  ocultabilidad: esto resume dos aspectos Line 3166  ocultabilidad: esto resume dos aspectos
3166   un valor de cero '0' indica que es imposible ocultarse por los motivos   un valor de cero '0' indica que es imposible ocultarse por los motivos
3167   que sean mientras que un valor de 100 quiere decir que ni tú mismo serías   que sean mientras que un valor de 100 quiere decir que ni tú mismo serías
3168   capaz de encontrarte aunque te palparas.   capaz de encontrarte aunque te palparas.
3169   Un valor estándar para estancias en casas podría ser de ocultabilidad=15.   Un valor estándar para estancias en casas podría ser de
3170    \family typewriter
3171    \size footnotesize
3172    ocultabilidad='15'
3173    \family default
3174    \size default
3175    .
3176   No convirtamos la Tierra Media en el juego del escondite, no te pases dando   No convirtamos la Tierra Media en el juego del escondite, no te pases dando
3177   facilidades para ocultarse.   facilidades para ocultarse.
3178   Este valor también se tendrá en cuenta a la hora de intentar descubrir   Este valor también se tendrá en cuenta a la hora de intentar descubrir
# Line 2902  Objetos en la sala Line 3185  Objetos en la sala
3185    
3186  Y llegamos a los objetos, otra de las partes más interesantes de una sala.  Y llegamos a los objetos, otra de las partes más interesantes de una sala.
3187   En principio un objeto o lo tiene un personaje o lo tiene una sala.   En principio un objeto o lo tiene un personaje o lo tiene una sala.
3188   cada <objeto> tiene un id="fichero", una cantidad mayor que 1 (si no se   Cada <objeto> tiene un
3189   especifica se sobreentiende que es 1) y una dificultad de encontrarlo (se  \family typewriter
3190   aplica el mismo criterio que arriba) aparte, naturalmente, de un breve  \size footnotesize
3191   texto o una palabra que haga referencia a él.  id="fichero"
3192    \family default
3193    \size default
3194    , una cantidad mayor que 1 (si no se especifica se sobreentiende que es
3195     1) y una dificultad de encontrarlo (se aplica el mismo criterio que arriba)
3196     aparte, naturalmente, de un breve texto o una palabra que haga referencia
3197     a él.
3198    
3199  \newline  \newline
3200    
# Line 2950  El texto o palabra descriptivo (lo que s Line 3239  El texto o palabra descriptivo (lo que s
3239    
3240  \layout Standard  \layout Standard
3241    
3242  Una espada herrumbrosa no debería hacer referencia al fichero id="vino34",  Una espada herrumbrosa no debería hacer referencia al fichero
3243   por ejemplo.  \family typewriter
3244    \size footnotesize
3245    id="vino34"
3246    \family default
3247    \size default
3248    , por ejemplo.
3249   Pero una poción élfica reconstituyente sí podría verse a simple vista como   Pero una poción élfica reconstituyente sí podría verse a simple vista como
3250   una 'poción vitalizante' que hace referencia oculta al fichero con id="pocion_e   una 'poción vitalizante' que hace referencia oculta al fichero con
3251  lfica02".  \family typewriter
3252    \size footnotesize
3253    id="pocion_elfica02"
3254    \family default
3255    \size default
3256    .
3257   Es decir, el personaje verá sólo aquellos objetos con una dificultad aceptable   Es decir, el personaje verá sólo aquellos objetos con una dificultad aceptable
3258   (si un objeto no dispone de dificultad se sobreentiende que se ve a simple   (si un objeto no dispone de dificultad se sobreentiende que se ve a simple
3259   vista) y de éstos, sólo la descripción y la cantidad.   vista) y de éstos, sólo la descripción y la cantidad.
# Line 2976  lfica02". Line 3275  lfica02".
3275   Tened en cuenta que si hay una probabilidad alta de que aparezca un objeto   Tened en cuenta que si hay una probabilidad alta de que aparezca un objeto
3276   al entrar un personaje, al cabo de unos días aquello podría ser imposible   al entrar un personaje, al cabo de unos días aquello podría ser imposible
3277   de transitar.   de transitar.
3278   Si colocamos un maximo="3" nos aseguramos que nunca se superará esa cantidad   Si colocamos un
3279   para ese objeto en particular y esa sala.  \family typewriter
3280    \size footnotesize
3281    maximo="3"
3282    \family default
3283    \size default
3284     nos aseguramos que nunca se superará esa cantidad para ese objeto en particular
3285     y esa sala.
3286   Si no colocas un maximo, se sobreentiende el valor inicial que aparece   Si no colocas un maximo, se sobreentiende el valor inicial que aparece
3287   en la sala.   en la sala.
3288   Si el maximo es 0, no hay límite y la cantidad puede crecer indefinidamente   Si el maximo es 0, no hay límite y la cantidad puede crecer indefinidamente
# Line 2986  lfica02". Line 3291  lfica02".
3291  \layout Standard  \layout Standard
3292    
3293  En cualquier caso, cada objeto tiene un fichero y tendrás que leerte el  En cualquier caso, cada objeto tiene un fichero y tendrás que leerte el
3294   'como_escribir_un_objeto.txt' para entender del todo cómo funcionan.  
3295    \series bold
3296    Cómo fabricar un objeto
3297    \series default
3298     para entender del todo cómo funcionan.
3299    
3300  \layout Subsection  \layout Subsection
3301    
# Line 3398  Consejos Line 3707  Consejos
3707  Sé coherente.  Sé coherente.
3708   primero escribe la descripción general, luego las especiales y luego las   primero escribe la descripción general, luego las especiales y luego las
3709   propiedades, asegúrate que el sentido común impera.   propiedades, asegúrate que el sentido común impera.
3710   Un baúl en un sitio con luz="75" y ocultabilidad="2" no puede tener dificultad=   Un baúl en un sitio con
3711  "70" porque es que se ve a simple vista.  \family typewriter
3712    \size footnotesize
3713    luz="75"
3714    \family default
3715    \size default
3716     y
3717    \family typewriter
3718    \size footnotesize
3719    ocultabilidad="2"
3720    \family default
3721    \size default
3722     no puede tener
3723    \family typewriter
3724    \size footnotesize
3725    dificultad="70"
3726    \family default
3727    \size default
3728     porque es que se ve a simple vista.
3729    
3730  \layout Enumerate  \layout Enumerate
3731    
3732  No hagas lugares generadores de monstruos.  No hagas lugares generadores de monstruos.
3733   hacer algo como <encuentro id="orco03" probabilidad="95" cantidad="10">orco   hacer algo como
3734   enorme</encuentro> sólo tiene sentido en mitad de Mordor.  \family typewriter
3735    \size footnotesize
3736    <encuentro id="orco03" probabilidad="95" cantidad="10">orco enorme</encuentro>
3737    \family default
3738    \size default
3739     sólo tiene sentido en mitad de Mordor.
3740    
3741  \layout Enumerate  \layout Enumerate
3742    
# Line 3603  Intenta no forzar a que la gente escriba Line 3934  Intenta no forzar a que la gente escriba
3934    
3935  \layout Enumerate  \layout Enumerate
3936    
3937  Todos los atributos que sean dificultad="3" o atributo="constitucion" DEBEN  Todos los atributos que sean
3938   tener comillas en los valores.  \family typewriter
3939   Serán no válidos cosas como aura=3 ó volumen=34, cuidad que las comillas  \size footnotesize
3940   son las mismas y no se os escapa una mezcla como ocultabilidad='3", por  dificultad="3"
3941   ejemplo.  \family default
3942    \size default
3943     o
3944    \family typewriter
3945    \size footnotesize
3946    atributo="constitucion"
3947    \family default
3948    \size default
3949     DEBEN tener comillas en los valores.
3950     Serán no válidos cosas como
3951    \family typewriter
3952    \size footnotesize
3953    aura=3
3954    \family default
3955    \size default
3956     ó
3957    \family typewriter
3958    \size footnotesize
3959    volumen=34
3960    \family default
3961    \size default
3962    , cuidad que las comillas son las mismas y no se os escapa una mezcla como
3963    
3964    \family typewriter
3965    \size footnotesize
3966    ocultabilidad='3"
3967    \family default
3968    \size default
3969    , por ejemplo.
3970    
3971  \layout Enumerate  \layout Enumerate
3972    
# Line 3756  Propiedades generales Line 4115  Propiedades generales
4115  Y llegamos a las propiedades generales.  Y llegamos a las propiedades generales.
4116   Para aura consúltese el Apéndice   Para aura consúltese el Apéndice
4117  \series bold  \series bold
4118  Cómo sonstruir una sala  Cómo construir una sala
4119  \series default  \series default
4120  .  .
4121   volumen: lo que ocupa.   volumen: lo que ocupa.
4122   desde 0 (despreciable) hasta infinito.   desde 0 (despreciable) hasta infinito.
4123   Una caja de zapatos ocupa volumen='0.2'.   Una caja de zapatos ocupa
4124   volumen='1' es como una persona adulta así que con esa referencia debería  \family typewriter
4125   valer.  \size footnotesize
4126    volumen='0.2'
4127    \family default
4128    \size default
4129    .
4130    
4131    \family typewriter
4132    \size footnotesize
4133    volumen='1'
4134    \family default
4135    \size default
4136     es como una persona adulta así que con esa referencia debería valer.
4137    
4138  \layout Itemize  \layout Itemize
4139    
# Line 3798  TABLA de precios (copiado de MERP) 10me Line 4168  TABLA de precios (copiado de MERP) 10me
4168   de plata 10mp = 1 moneda de oro 100mo= 1 moneda de mithril   de plata 10mp = 1 moneda de oro 100mo= 1 moneda de mithril
4169  \layout Standard  \layout Standard
4170    
4171  Así, si algo cuesta 3 monedas de oro, en valor pon valor="3000".  Así, si algo cuesta 3 monedas de oro, en valor pon
4172    \family typewriter
4173    \size footnotesize
4174    valor="3000"
4175    \family default
4176    \size default
4177    .
4178    
4179  \end_deeper  \end_deeper
4180  \layout Itemize  \layout Itemize
# Line 4086  El gasto es el número de cargas que gast Line 4462  El gasto es el número de cargas que gast
4462  \layout Standard  \layout Standard
4463    
4464  La duración en el efecto se refiere al número de segundos que dura el efecto  La duración en el efecto se refiere al número de segundos que dura el efecto
4465   (pon 0 si es definitivo, o no pongas duración=   (pon 0 si es definitivo, o no pongas
4466  \begin_inset Quotes erd  \family typewriter
4467  \end_inset  \size footnotesize
4468    duración=''
4469    \family default
4470  \begin_inset Quotes erd  \size default
 \end_inset  
   
4471  ).  ).
4472   El tiempo lo lleva el servidor de Minë así que será independiente de los   El tiempo lo lleva el servidor de Minë así que será independiente de los
4473   ordenadores de los jugadores.   ordenadores de los jugadores.
# Line 4335  Te sientes mucho mejor. Line 4709  Te sientes mucho mejor.
4709    
4710  En este caso, para beber la poción no hemos especificado dos usos, uno por  En este caso, para beber la poción no hemos especificado dos usos, uno por
4711   cada mano, porque resulta irrelevante.   cada mano, porque resulta irrelevante.
4712   Como vemos, este objeto requiere una mínima coordinación cabeza-mano (destreza=   Como vemos, este objeto requiere una mínima coordinación cabeza-mano (
4713  \begin_inset Quotes erd  \family typewriter
4714  \end_inset  \size footnotesize
4715    destreza='3'
4716  3  \family default
4717  \begin_inset Quotes erd  \size default
4718  \end_inset  ) y un aura aceptable (
4719    \family typewriter
4720  ) y un aura aceptable (aura=  \size footnotesize
4721  \begin_inset Quotes erd  aura='47
4722  \end_inset  \family default
4723    \size default
4724  47  ').
 \begin_inset Quotes erd  
 \end_inset  
   
 ).  
4725   Si se cumplen estos requisitos, la vida subirá 15 puntos.   Si se cumplen estos requisitos, la vida subirá 15 puntos.
4726   Es posible que personajes con habilidades especiales puedan sacar más partido   Es posible que personajes con habilidades especiales puedan sacar más partido
4727   a esta poción.   a esta poción.
# Line 4689  En Python, el mapa entre T.A.D. Line 5059  En Python, el mapa entre T.A.D.
5059  \layout Description  \layout Description
5060    
5061  ejemplo Sala.id, Sala.autor, etc.  ejemplo Sala.id, Sala.autor, etc.
5062   son atributos, y Sala.__init__(), Sala.entrar_personaje(), etc.   son atributos, y
5063    \family typewriter
5064    \size footnotesize
5065    Sala.__init__(), Sala.entrar_personaje()
5066    \family default
5067    \size default
5068    , etc.
5069   son funciones miembro.   son funciones miembro.
5070  \end_deeper  \end_deeper
5071  \layout Enumerate  \layout Enumerate
# Line 4790  Por otro, las propiedades tienen restric Line 5166  Por otro, las propiedades tienen restric
5166   en las privadas).   en las privadas).
5167  \layout Description  \layout Description
5168    
5169  ejemplo son invariantes Sala.area != None, aura in range(0,100), n_jugadores  ejemplo son invariantes
5170   >= 0, n_jugadores <= len(personajes), etc.  \family typewriter
5171   El__init__() debe dar valores a todos los atributos que satisfagan todas  \size footnotesize
5172   las invariantes.  Sala.area != None, aura in range(0,100), n_jugadores >= 0, n_jugadores <=
5173     len(personajes)
5174    \family default
5175    \size default
5176    , etc.
5177     El
5178    \family typewriter
5179    \size footnotesize
5180    __init__()
5181    \family default
5182    \size default
5183     debe dar valores a todos los atributos que satisfagan todas las invariantes.
5184   No se admite, por ejemplo, crear una sala con area == None, y luego darle   No se admite, por ejemplo, crear una sala con area == None, y luego darle
5185   un valor más tarde.   un valor más tarde.
5186   Sí se admite que el __init__ la inicialice a None y más tarde llame a una   Sí se admite que el
5187   función que lee el área de un fichero y actualice el valor, siempre y cuando  \family typewriter
5188   todo ello ocurra dentro de la ejecución de __init__.  \size footnotesize
5189    __init__()
5190    \family default
5191    \size default
5192     la inicialice a None y más tarde llame a una función que lee el área de
5193     un fichero y actualice el valor, siempre y cuando todo ello ocurra dentro
5194     de la ejecución de
5195    \family typewriter
5196    \size footnotesize
5197    __init__()
5198    \family default
5199    \size default
5200    .
5201  \layout Standard  \layout Standard
5202    
5203  En Python no hay ningún mecanismo para expresar invariantes, así que lo  En Python no hay ningún mecanismo para expresar invariantes, así que lo

Legend:
Removed from v.1.17  
changed lines
  Added in v.1.18

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26