﻿==============================================================
 COMPANION GIRL MOD  -  Compañera con IA para GTA San Andreas
 Versión 1.0
 Autor: [fausto200]
 Autor skin: MrAndres5555, matttoss_ 
==============================================================

QUÉ ES
------
Una compañera que te sigue y pelea a tu lado. Cambia de arma según la
distancia al enemigo (M4 de lejos, escopeta a media distancia y bate cuerpo
a cuerpo), cae herida cuando está a punto de morir y puedes reanimarla,
besarla para curarla y, con las bajas que consiga, llamar a un familiar o
pedir un ataque aéreo.


REQUISITOS
----------
 - GTA San Andreas versión 1.0 US (la que soporta MoonLoader).
 - MoonLoader instalado (necesita su ASI loader; se instala copiando sus
   archivos en la carpeta del juego).
 - No necesita ninguna otra librería.
 - Opcional: el mod de zombies. Con él, la compañera ataca zombies por su
   cuenta (ver más abajo).


INSTALACIÓN
-----------
 1. Si no tienes MoonLoader, instálalo primero. Al terminar, en la carpeta
    del juego debe existir el archivo "moonloader.asi" y la carpeta
    "moonloader".
 2. Copia "companera.lua" dentro de:
        GTA San Andreas\moonloader\
 3. Comprueba que existe la carpeta "moonloader\config" (si no, créala).
    El mod la usa para detectar el modo zombie.
 4. Inicia el juego y empieza o carga una partida.
 5. Para comprobar que cargó, abre "moonloader\moonloader.log": debe
    aparecer "CompanionGirlMod" como script cargado.

Si cambias el archivo con el juego abierto, pulsa Ctrl+R para recargar los
scripts sin reiniciar.


CÓMO SE USA
-----------
Reclutar / despedir:  escribe  GIRL  durante la partida.
                      (La misma clave la llama y la despide.)

 TECLA   ACCIÓN
 -----   ---------------------------------------------------------
  G      Que te siga (modo normal).
  H      Que se quede quieta manteniendo la posición. Dispara a los
         enemigos que lleguen a unos 18 m, pero no se mueve.
  1      Llamar a un FAMILIAR (cuesta 10 bajas).
  2      ATAQUE AÉREO (cuesta 20 bajas).
  E      Cerca de ella (menos de 2.5 m): besarla. Si está herida:
         reanimarla.

En pantalla, arriba a la izquierda, verás su vida, su arma actual y las dos
habilidades ("ALIADO" y "BOMBA"), cada una con una barra que se llena según
tus bajas (por ejemplo 7/10). Debajo aparece un recordatorio de [G] o [H]
según el modo en que esté.

BAJAS
 Cada enemigo que ella elimine suma una baja. Hay un único contador para
 las dos habilidades, y al usar cualquiera de ellas vuelve a cero por
 completo (no solo se resta su coste). Si la despides y la vuelves a
 reclutar, las bajas también empiezan de cero.


HABILIDADES
-----------
FAMILIAR (tecla 1, 10 bajas)
 Ella llama por teléfono unos 3 segundos y luego llega un familiar
 (Grove Street) armado con M4, escopeta y bate. Pelea a tu lado durante
 60 segundos y después se retira. Si el juego lo borra, se vuelve a enviar
 hasta 2 veces. Si lo matan, se pierde esa llamada.

ATAQUE AÉREO (tecla 2, 20 bajas)
 Ella llama por teléfono unos 3 segundos. Pasa una avioneta que suelta un
 misil sobre un punto situado a unos 25 m delante de ti. La explosión
 elimina a los enemigos en 30 m a la redonda.
 IMPORTANTE: no te acerques al punto de impacto; la explosión puede
 hacerte daño.

 Si ella cae herida mientras llama, la llamada se cancela y se te
 devuelven las bajas.


HERIDA Y REANIMACIÓN
--------------------
Cuando su vida baja de 60 (tiene 300 en total), cae al suelo, queda
invulnerable y no puede luchar. Acércate a menos de 2.5 m y pulsa [E]:
la reanimación dura 2 segundos y se levanta con la vida completa.
(No cae herida si va dentro de un vehículo.)


BESO
----
Cerca de ella (menos de 2.5 m), sin enemigos alrededor y sin ir en coche,
pulsa [E]. Dura 4 segundos, la cura 60 de vida y tiene 6 segundos de
espera antes de poder repetirlo. Se interrumpe si la hieren.


MODO ZOMBIE
-----------
 - Con el mod de zombies activo (se activa escribiendo ZOMBIE) ella lo
   detecta sola y ataca a los zombies sin que tengas que hacer nada.
   Verás el aviso "Modo zombie detectado".
 - Sin el mod de zombies ("Modo normal") solo se defiende de quien la
   ataque a ella o a ti, y de los que tú dispares.


AJUSTES
-------
Abre "companera.lua" con el Bloc de notas. Al principio del archivo hay una
sección CONFIGURACIÓN con estos valores (guarda y pulsa Ctrl+R en el juego):

   TRUCO               Clave para reclutar / despedir (por defecto GIRL)
   VIDA_COMPA          Vida total de la compañera (300)
   COSTE_HAB1          Bajas para el familiar (10)
   COSTE_HAB2          Bajas para el ataque aéreo (20)
   DURACION_ALIADOS    Segundos que dura el familiar (60)
   UMBRAL_INCAPACITAR  Vida a la que cae herida (60)
   ALCANCE_ATAQUE      Distancia a la que busca enemigos (30 m)
   ALCANCE_ESPERANDO   Ídem cuando está en modo espera [H] (18 m)
   DIST_BESO           Distancia para besar (2.5 m)
   BESO_CURA           Vida que recupera con un beso (60)
   COOLDOWN_BESO       Segundos entre besos (6)
   HUD_X, HUD_Y, HUD_ESCALA   Posición y tamaño del panel

Las teclas (G, H, 1, 2, E) están fijas en el código.


PROBLEMAS FRECUENTES
--------------------
 - Escribo GIRL y no pasa nada:
     Revisa que MoonLoader esté bien instalado y que el juego sea la
     versión 1.0 US. Mira "moonloader\moonloader.log" por si el script dio
     algún error al cargar.
 - Sale "No se pudo cargar a la compañera (memoria llena)":
     El juego no tenía memoria para cargar los modelos. Inténtalo de nuevo
     o reduce otros mods de modelos.
 - Se cierra el juego al usar una habilidad:
     En "companera.lua" cambia  local DEBUG_HAB = false  por  true,
     recarga (Ctrl+R) y repite. Cada paso se guarda en
     "moonloader\config\aliados_debug.txt"; la última línea indica dónde
     se cerró. Envía ese archivo al autor.
     (Con DEBUG_HAB activo también funciona la tecla J, que muestra el
     modelo del ped más cercano. Vuelve a ponerlo en false al terminar.)
 - No veo el misil del ataque aéreo:
     Si tu juego no tiene ese modelo, el ataque ocurre igual pero sin el
     misil visible.


DESINSTALAR
-----------
Borra "companera.lua" de la carpeta "moonloader". No modifica ningún
archivo original del juego.


CRÉDITOS Y LICENCIA
-------------------
Autor: [PON AQUÍ TU NOMBRE]
Si usas este mod en un vídeo o lo redistribuyes, indica el autor original.
