    FreedroidRPG: LÉEME
   ----------------------

0. Índice
=========
  1. Introducción
  2. Instalar y Jugar
  3. Controles básicos
  4. Problemas conocidos
  5. Resolución de pantalla
  6. Preguntas frecuentes
     - Miscelánea
     - Gráficos
     - Sonido
     - Editor de Niveles y Desarrollo
  7. Contáctenos
  8. Licencia


1. Introducción
================
 El juego cuenta la historia de un mundo destruido por un conflicto entre
 robots y sus amos humanos. Juega como Tux en una misión para salvar el
 mundo de los pérfidos asesinos robots rebeldes que no conocen compasión. Tú
 escoges  cuál camino deseas seguir, y la libertad de elección está
 en todas partes en el juego.

 FreedroidRPG presenta un sistema de combate en tiempo real con armas melée y
 y a distancia, bastante parecido al juego privativo Diablo. Hay un
 innovador sistema de programas que pueden ser lanzados para tomar
 control de robots enemigos, alterar su comportamiento, o mejorar las propias
 características. Puedes usar más de 150 distintos tipos de objetos y
 luchar contra incontables enemigos camino hacia tu destino. Un avanzado
 sistema de diálogos provee transfondo de historia e
 inmersivas situaciones de rol.

 El juego es completo, totalmente jugable, y puede proveer unas 10 horas
 de diversión. Aún está siendo activamente desarrollado, y la ayuda es bienvenida en
 muchas áreas. Gente con - o intentando adquirir - habilidades de programación,
 edición de mapas o escritura hallará en FreedroidRPG un trepidante y
 dinámico proyecto en el cual puedan expresar su creatividad.


2. Instalar y Jugar
==================
 Tanto la última versión estable como las versiones preliminares Windows/MacOsx están en ftp://ftp.osuosl.org/pub/freedroid/
 Para ayuda general con la instalación, por favor refiérase al documento INSTALL localizado en el mismo directorio que este.
 Para más información, vea INSTALL.freedroidRPG
 Los paquetes necesarios para compilar dependen de su distribución. Están listados en INSTALL.freedroidRPG
 Básicamente, solo tiene que:

    ./configure
    make
    make install

 Si no quiere instalar el juego, no seleccione "make install". Solo vaya al subdirectorio src/ y ejecute
    ./freedroidRPG
 Para opciones avanzadas, ejecute "freedroidRPG --help" (en una terminal) para obtener una lista completa de opciones de línea de comandos.


3. Controles
============
 Movimiento
 
  El juego es controlado usando el mouse. Haga click izquierdo en las posiciones a las que desee moverse.
  Mantenga presionado el botón para continuar moviéndose en esa dirección. Mantener CTRL le hará correr.

 Ataque

  Click izquierdo en un enemigo causará que Tux se aproxime al droide y comience a atacarlo con el
  arma actual. Si el arma actual es una pistola entonces Tux se mantendrá quieto y disparará al droide.

 Funciones especiales

  Use el click derecho para activar la habilidad o programa seleccionado.

 Teclas por defecto (la mayor parte puede ser reasignada con la configuración de teclas accesible en juego - F1)

  Escape ... Mostrar menú principal
  F1 ... Mostrar configuración de teclas
  F2 ... Cambiar a pantalla completa (sólo Linux)
  F3 ... Guardado rápido
  F4 ... Carga rápida
  F5 a F12 ... Selección rápida de programas 1 a 8

  I ... Panel de inventario
  C ... Panel de personaje
  S ... Panel de Habilidades/Programas
  Espacio ... Cerrar todos los paneles abiertos
  Q ... Registro de misiones
  0 a 9 ... Usar objetos de inventario rápido 0 a 9

  P... Pausa
  Mantener A ... Atacar manteniando la posición
  Mantener Shift ... Mantener el objetivo actual seleccionado moviéndose
  Tabulador ... Conmutar automapa (si disponible)

  R ... Recargar arma
  Mantener Ctrl ... Correr
  U ... Conmutar correr siempre.

  Mantener X ... Mostrar etiquetas de objetos en el suelo
  Z ... Conmutar mostrar etiquetas de objetos en el suelo
  T ... Conmutar transparencia de muros cuando Tux se aproxima
  Ctrl + Q ... Cerrar el juego
  Ctrl + G ... Conmutar bloquear entrada (prevenir que el cursor escape la ventana del juego)
  Imprimir ... Tomar captura de pantalla (guardada en el subdirectorio ./.freedroid_rpg/ de su directorio personal)

  Flechas ... Mover
     Arriba ... Norte
     Abajo ... Sur
     Derecha ... Este
     Izquierda... Oeste


4. Problemas Conocidos
================
 General
   * Algunas armas Meleé y a distancia aún tienen espadas/rifles láser de relleno para sus animaciones de sujección y disparo.
	 Si tiene usted habilidad con el modelado 3D, por favor ayúdenos a solventar esto.
   * Cuando inicias el juego en modo OpenGL y algo se sobrepone a la ventana del juego mientras este se inicia,
	 la imagen del fondo se ve muy extraña. Si hace click en alguno de las entradas del menú, debería
	 retornar al aspecto planeado.
   * Usar alt tab para cambiar hacia/desde el juego en OpenGL mientras una ventana emergente estática es mostrada vuelve la pantalla completamente negra.
	 Hacer click o presionar la tecla requerida para cerrar la ventana emergente redibujará/traerá de vuelta la pantalla.

 Mac
   * Documentos Abiertos: OSX limita el número máximo de documentos abiertos (256 en 10.6). Esto puede llevar a errores
	 en la carga de imágenes: "En Función: get_iso_image_from_file_and_path. No se pudo cargar imaen
	 /usr/local/share/freedroidrpg/graphics/obstacles/<nombre>.png"
	 Solución:
		1) Comprobar el valor de máximos documentos abiertos con $ ulimit -n
		2) Establecer nuevo valor de límite de documentos abiertos con $ ulimit -n 2048
	(Problema #2913487)
   * Renderizado de fuentes: si no obtiene fuentes en el menú principal con SDL o, si estando en el modo openGL, el juego
	muestra el mensaje de error "En función: PutCharFont. La superficie para el carácter 46 era un puntero NULL",
	verifique la configuración de pantalla y fije el perfil de color en sRGB.
	(Problemas #2913485 y #2913484)
   * SDL instalada mediante MacPorts: si tiene una CPU Big-Endian (PowerPC), la SDL instalada mediante MacPorts le dará a FreedroidRPG
	información incorrecta sobre el orden de bytes, por lo que los colores podrían estar mal y
	no podría iniciar una nueva partida, ya que el juego fallaría.
	Para arreglarlo, edite el archivo /opt/include/SDL/SDL_config.h con los permisos de root, de forma que la línea
		#define SDL_BYTEORDER=1234
	diga
		#define SDL_BYTEORDER=4321
	Luego de editar y guardar el archivo, recompile FreedroidRPG. Así debería funcionar correctamente.
	También sirve usar una SDL compilada desde la fuente, en lugar una compilada de MacPorts.

 Linux
   * Pulseaudio: si usa SDL-pulseaudio, es probable que no tenga sonido. Este problema no es
	 de FreedroidRPG, sino que de Pulseaudio y sus plugins que, en general, siguen teniendo poco desarrollo. Se recomienda usar,
	 por ejemplo, SDL-esd o SDL-alsa hasta que estos problemas hayan sido solucionados por sus desarrolladores.
   * Tarjetas gráficas Intel 915/945/IDG (EEE PC, netbook, etc.): Mesa 7.9-devel tiene un problema que hace que el juego
   	 corra lentamente y ocupe mucha memoria. Para arreglarlo, instale y lance "driconf", y configure 
	 "Habilitar teselado de texturas" en "No".   
   * Debido a los drivers de hardware y software, puede que la opción "Corrección gamma" no tenga efecto.


5. Resolución de pantalla
=====================
 Hay unas pocas configuraciones de alta resolución a las que solo puede accederse desde la línea de comando. Están ml probadas
 y, por lo tanto, se consideran defectuosas y no tienen soporte. SIn embargo, aún pueden ser de utilidad para
 muchos, especialmente para LCD de pantalla ancha en pantalla completa.

 Para obtener una lista actualizada de las resoluciones disponibles, use "freedroidRPG -r99".

 Algunos problemas de las resoluciones sin soporte:
	- El retrato en los cuadros de diálogo se sale del borde.
	- Radio de iluminación no centrado.
	- A veces, desplazamiento incorrecto del texto al hablar con personajes no jugables.


6. Preguntas frecuentes
============
Preguntas frecuentes / Miscelánea:

	P: ¿Necesito tener Linux para jugar FreedroidRPG?
	R: Si bien se recomienda el uso de Linux para el bienestar del administrador del
	   sistema, hay ejecutables de FreedroidRPG disponibles para MIcrosoft Windows.
	   Tenga en cuenta que, como el equipo de desarrollo de FreedroidRPG no usa 
	   Microsoft Windows, está mucho menos testeado. Se aprecia toda la ayuda 
	   que puedan brindar los usuarios de Windows, ya sea con testeo o retroalimentación.

	P: ¿Cómo puedo suscribirme/cancelar la suscripción a la lista de correos?
	R: FreedroidRPG tiene dos listas de correo. Una es para hablar de cosas relacionadas con
	   FreedroidRPG. La otra es una lista con registros de cambios generados automáticamente desde nuestro 
	   servidor de desarrollo y, por lo tanto, suele ser de interes solo para desarrolladores.
	   De todos modos, puede suscribirse, darse de baja o cambiar sus opciones de suscripción
			en la siguiente página:
	   https://sourceforge.net/mail/?group_id=54521


Preguntas frecuentes / Gráficos:

	P: El juego está *extremadamente* lento en mi Windows con salida OpenGL.
	R: Puede que esté usando los drivers de OpenGL que vienen con su
	   sistema operativo de Microsoft. Estos drivers no usan aceleración de software
	   y, por lo tanto, son extremadamente lentos. Tendrá que descargar e instalar un
	   driver apto para OpenGL para su tarjeta gráfica. Generalmente, se puede descargar 
	   desde la página oficial de la compañía fabricante (Nvidia, AMD/ATI, etc.).
	   Tenga en cuenta que, si no puede hacer que OpenGL funcione bien en su
	   sistema, puede ejecutar el juego en modo de salida SDL. Para esto, debe
	   usar un "prompt de línea de comandos MS-DOS" y escribir

	   freedroidRPG -n 

	   dentro de la línea de comando. También puede crear un enlace a freedroidRPG.exe,
	   editar las propiedades del enlace, y añadir la -n luego de freedroidRPG.exe en
	   el cuadro de propiedades del enlace.

	P: El juego está *extremadamente* lento en mi Linux con OpenGL habilitado.
	R: Puede que esto suceda si no usa OpenGL acelerado por hardware.
	   Se debería evitar el software OpenGL. Si no tiene OpenGL acelerado por hardware
	   en su sistema (porque, por ejemplo, su fabricante de tarjetas gráficas
	   no hace drivers aptos para Linux), estará mejor si deshabilita por completo
	   el soporte de OpenGL. Para esto, puede usar la línea de comando switch -n,
	   es decir,

	   freedroidRPG -n

	   comenzar el juego con OpenGL deshabilitado. Los gráficos volverán
	   al modo SDL.
	P: Uso Linux con varios monitores en el modo TwinView (Xinerama), sin embargo, el modo
	   pantalla completa está centrado en la división entre ambos monitores. Preferiría que
	   estuviese centrado en una de las pantallas.
	R: Para que el juego ocupe solo un monitor en pantalla completa, haga lo siguiente:
	   1. Asegúrese de usar la versión SDL 1.2.14 o superior.
	   2. Configure la variable ambiental "SDL_VIDEO_FULLSCREEN_DISPLAY" con el número correspondiente
			al monitor que desea ocupar: 0 es la primera pantalla, 1 es la segunda, etc.

	   Si eso no funciona, debe agregar metamodos de monitor individual al archivo xorg.conf.
	   Tendrá que reiniciar el servidor X para que los cambios tengan efecto.

Preguntas frecuentes / Sonido:

	P: Mi sonido no funciona con FreedroidRPG. No puedo escuchar nada.
	R: 1. Asegúrese de que el sonido funciona en otros programas. Si no
		    escucha nada al reproducir archivos mp3 u ogg,
		    significa que el problema es de la configuración del sistema de sonido de su equipo,
		    no de FreedroidRPG. En ese caso, debe instalar la
		    tarjeta de sonido apropiadamente.
	   2. Revise si tiene instaladas las bibliotecas SDL_mixer. Use
		    "locate SDL_mixer" y vea si obtiene varios resultados. Si no,
		    el problema es la biblioteca SDL_mixer perdida.
		    También revise si tiene instalados libogg y libvorbis.
	   3. Si se compiló desde la fuente, verifique que el script ./configure
		    detecte correctamente la biblioteca SDL_mixer. Para eso, mire la salida del
		    comando ./configure. Debería haber algo como:

		      checking for Mix_ChannelFinished in -lSDL_mixer... yes

		    En cambio, si hay algo como

		      checking for Mix_ChannelFinished in -lSDL_mixer... no

		    significa que ./configure no detectó la instalación de SDL_mixer.
		    Asegúrese de tener los paquetes SDL_mixer y
		    SDL_mixer_devel o instale SDL_mixer desde la fuente.
		    Puede descargar todo desde aquí:

		      https://github.com/libsdl-org/SDL_mixer

		    Si compiló desde la fuente, ahora tendrá que recompilar, ya que la
		    compilación anterior no incluyó el módulo de sonido de FreedroidRPG. Si
		    se instala SDL_mixer adecuadamente, debería funcionar luego de
		    recompilar.

	P: Mi sonido se retrasa. Todos los sonidos parecieran tener problemas de sincronización.
	R: Puede que un sound daemon se esté ejecutando en su sistema. Muchos administradores
	   como, por ejemplo, KDE, inician un sound daemon por defecto al arrancar. Para deshacerse de
	   los sound daemons más comunes, pruebe (como root, preferiblemente)

	   killall -9 artsd
	   killall -9 esd
	   killall -9 yiff
	   killall -9 pulseaudio

	   Luego, puede volver a intentar jugar FreedroidRPG. Ya no debería haber
	   problemas de sincronización de sonido.

Preguntas frecuentes / Editor de niveles y desarrollo:

	P: ¿Hay un editor de niveles?
	R: Sí, hay un editor de niveles integrado en FreedroidRPG. Se puede acceder
       desde el menú principal o ejecutando

		  freedroidRPG -e

       Cada botón del editor tiene globos de ayuda que le facilitarán el proceso.
       Intente usarlo y no dude en pedir
       asistencia en IRC o en la lista de correos.

	P: ¿Cómo puedo obtener la última versión de desarrollo del juego?
	R: Es bastante simple si usa Linux:
	      git clone https://codeberg.org/freedroid/freedroid-src.git
	   Si usa Windows, recomendamos usar una herramienta como 
	      http://www.collab.net/downloads/giteye?CID=tigris
	   Si sigue teniendo problemas, háblelo con las personas de
	   la lista de correos de discusión o pregunte en el canal IRC.

	P: Me gustaría ayudar en el desarrollo de FreedroidRPG. ¿Qué debo hacer?
	R: En primer lugar, recomendamos que revise https://www.freedroid.org/developer-area/contribute/
	   En segundo lugar, puede contactarnos mediante IRC (ver "Contáctenos" más abajo)
	   o mediante la lista de correo de discusión de freedroid.
	   Luego, obtenga desde git la última versión de desarrollo del juego.
	   Entonces puede hacer un pequeño parche o discutir cualquier
	   idea más grande que tenga en mente con la gente en la lista de correo de discusión o IRC, para
	   que haya seguridad se que todos los desarrolladores están trabajando en la misma dirección, y 
	   estar al tanto de qué está pasando y quién está trabajando en qué.


7. Contáctenos
===========
 Página web    ................ https://www.freedroid.org
 Pág. de origen del proyecto... https://codeberg.org/freedroid
 Canal IRC ................ #freedroid en irc.libera.chat o
                                https://web.libera.chat/#freedroid
 Lista de correos.............. freedroid-discussion@lists.sourceforge.net
 Seguimiento de errores........ https://bugs.freedroid.org/


8. Licencia
===========
 Este juego está patentado por GPL. Algunas otras herramientas tienen una licencia más permisiva. 
  Consulte el archivo FILES en la misma carpeta que este documento.
