Red Planet PI (Raspberry PI + Windows)

================================

RED PLANET Pi v1.0 (C) 2015/2023

================================                

  Para Raspberry Pi / Windows *

* y otros sistemas compatibles con pygame 2.1.2 (SDL 2.0.18, Python 3.9.12) o superior.

Conduce a nuestro héroe al subsuelo de la antigua estación espacial para volar todo el complejo y acabar con sus malignos habitantes.

Pero cuidado, el entorno es peligroso. Evita entrar en contacto con los alienígenas, y caer en los pozos de lava o de residuos radiactivos.

OBJETOS

=======

EXPLOSIVO: Para acabar con éxito la misión debes obtener los 15 explosivos que hay repartidos por la estación, y situarlos en el depósito de explosivos, en lo más profundo de la base marciana.

Una vez depositados, tienes que regresar al centro de control y activar el detonador.

TARJETA: En ocasiones tendrás que acceder a zonas cerradas con tarjeta de acceso, por lo que previamente deberás localizar estas tarjetas para continuar tu misión.

PUERTA: Solo podrás abrirlas si dispones de alguna tarjeta. 

Las tarjetas son de un solo uso, pero la puerta permanecerá abierta.

MUNICIÓN: Tienes la posibilidad de disparar balas de plasma contra tus enemigos, pero cuidado, no malgastes munición, ya que ésta es escasa.

Hay recargas repartidas por todo el complejo.

OXÍGENO: Vigila el estado de tus botellas de oxígeno y busca otras nuevas antes de que se agoten o morirás en el acto.

DISKETTE: Graba la situación actual de la partida para continuarla en otra ocasión.

Podrás localizarlos en las pantallas donde previamente había tarjetas. 

BURGUER, CAKE, DONUT: Sí, a los marcianos también les gustan. 

Cómetelos si quieres ver aumentar tu puntuación.

ENEMIGOS

========

INFECTADO: Anteriores compañeros que intentaron realizar la misión y no lo consiguieron.

La picadura de los aracnovirus les mantiene en un estado de NO muertos.

Se mueven de manera lineal y pueden ser muy rápidos, elimínalos antes de que te contagien.

ARACNOVIRUS/PELUSOIDE: De movimientos erráticos y rápidos.

Suelen moverse por el aire. Son los alienígenas más numerosos que han colonizado la base.

PELUSOIDE FANTY: Son muy inteligentes. Pueden permanecer agazapados esperando tu llegada.

Si te ven o te oyen, se abalanzarán sobre ti. 

En ese caso acaba con ellos cuanto antes. 

PUNTUACIÓN

==========

INFECTADO 25 puntos

ARACNOVIRUS 50 puntos

PELUSOIDE 75 puntos

FANTY 100 puntos

--------------------------

TNT 50 puntos

MUNICIÓN 75 puntos

OXÍGENO 100 puntos

TARJETA 125 puntos

PUERTA 150 puntos

--------------------------

DONUT 200 puntos

TARTA 350 puntos

HAMBURGUESA 500 puntos

CONTROL DE JUEGO

================

GAMER RETRO CLASSIC JOYPAD

----------------------------------------------------------------------

salto: W Q cur.arriba botón A / botón B / joy.arriba

acción: S A cur.abajo joy.abajo

izquierda: A O cur.izda. joy.izda.

derecha: D P cur.derecha joy.derecha

disparo*: SPACE SPACE SPACE botón X / botón Y

* también botón izquierdo del ratón

Teclas comunes a todas las configuraciones:

M:      Música Sí/No.

ESC:    Pausa / Cancelar partida.

CONSEJOS Y TRUCOS

=================

- Reserva algo de munición y oxígeno para cuando hayas colocado los explosivos y regreses al centro de control.

En caso de escasez de oxígeno sonará una alarma durante la cual la prioridad será buscar botellas nuevas.

- Extrema la precaución en los pasillos verticales. Son las zonas más traicioneras.

- Siempre que sea posible, es mejor no molestar a los FANTYS

- Usa el guardado de partida cuando la situación del juego sea adecuada, es decir, con un número de vidas y oxígeno suficiente para acabar la partida. 

Recuerda que al seleccionar un DISKETTE, se sobreescribe la anterior partida.

- Para colocar los explosivos en su emplazamiento final y para usar el detonador se debe pulsar la tecla ACCIÓN (abajo), en caso contrario no ocurrirá nada.

===================================

RED PLANET Pi  (C) PlayOnRetro 2023

===================================

PROGRAMA: salvaKantero

GRÁFICOS: salvaKantero

ILUSTRACIÓN DE PORTADA: Masterklown 

MÚSICA DEL MENÚ: Masterklown

MÚSICA IN-GAME: Centurion of war

EFECTOS DE SONIDO: Juhani Junkala

FONDO DEL MODO 16/9: NASA (Hubble, Dec 2 2022)

BETA TESTERS: Danielito Dorado, Dany Cantero, Laura Cantero, Lucas Cantero, Marina Cantero    

AGRADECIMIENTOS*: 

Mojon Twins (MK1 motor de juegos de 8bits)

DaFluffyPotato (clase Font, escalado de pantallas)

Chris (Clear Code canal de YT)

Rik Cross (Raspberry Pi Foundation)

Mark Vanstone (Raspberry Pi Press)

Ryan Lambie (Raspberry Pi Press)

Cesar Gomez (Mundo Python canal de YT)

Kenney (gráficos de teclas/ratón)

* Gracias a todos ellos por compartir sus conocimientos, técnicas y recursos 

CÓDIGO FUENTE PYTHON Y RECURSOS DISPONIBLES EN https://github.com/salvakantero/RedPlanetPi

RED PLANET Pi se publica bajo licencia GPL v3. (ver license.txt)

Gracias por jugar!!

NOTA DEL AUTOR

==============

Este proyecto se programó íntegramente en ordenadores Raspberry Pi y lenguaje Python, pensando en la gran cantidad de academias y usuarios que usan dichos ordenadores en todo el mundo para aprender informática y programación.

Si alguno de estos alumnos o jugadores casuales, accede al código fuente para estudiarlo, mejorarlo, realizar su propio juego, o simplemente revisarlo y entenderlo, entonces habrá valido la pena el esfuerzo.

ENGLISH

================================

RED PLANET Pi v1.0 (C) 2015/2023

================================                

  For Raspberry Pi / Windows *

* and other systems compatible with pygame 2.1.2 (SDL 2.0.18, Python 3.9.12) or higher.

Lead our hero to the underground of the ancient space station to blow up the whole complex and wipe out its evil inhabitants.

But be careful, the environment is dangerous. Avoid coming into contact with the aliens, and falling into the lava or radioactive waste pits.

OBJECTS

=======

EXPLOSIVE: To successfully complete the mission you must obtain the 15 explosives that are scattered around the station, and place them in the explosives depot, deep in the Martian base.

Once deposited, you have to return to the control center and activate the detonator.

CARD: Sometimes you will have to access closed areas with access cards, so you must first locate these cards to continue your mission.

DOOR: You can only open them if you have a card. 

The cards are of a single use, but the door will remain open.

MUNITION: You have the possibility to shoot plasma bullets against your enemies, but be careful, do not waste ammunition, as it is scarce.

There are reloads scattered throughout the complex.

OXYGEN: Keep an eye on the state of your oxygen bottles and look for new ones before they run out or you will die on the spot.

DISKETTE: Record the current situation of the game to continue it another time.

You will be able to locate them on the screens where there were previously cards. 

BURGUER, CAKE, DONUT: Yes, Martians like them too. 

Eat them if you want to see your score increase.

ENEMIES

========

INFECTED: Previous companions who attempted the mission and failed.

The bite of the arachnoviruses keeps them in an undead state.

They move in a linear fashion and can be very fast, eliminate them before they infect you.

ARACHNOVIRUS/PELUSOID: Erratic and fast moving.

They usually move through the air. They are the most numerous aliens that have colonized the base.

FANTY PELUSOID: They are very intelligent. They can remain crouched waiting for your arrival.

If they see or hear you, they will pounce on you. 

In that case finish them off as soon as possible. 

SCORING

==========

INFECTED 25 points

ARACNOVIRUS 50 points

PELUSOID 75 points

FANTY 100 points

--------------------------

TNT 50 points

MUNITION 75 points

OXYGEN 100 points

CARD 125 points

DOOR 150 points

--------------------------

DONUT 200 points

CAKE 350 points

HAMBURGER 500 points

GAME CONTROL

================

GAMER RETRO CLASSIC JOYPAD

----------------------------------------------------------------------

jump: W Q cur.up A button / B button / joy.up

action: S A cur.down joy.down

left: A O left curl left joy.

right: D P cur.right joy.right

trigger*: SPACE SPACE SPACE SPACE button X / button Y

* also left mouse button

Keys common to all configurations:

M: Music Yes/No.

ESC: Pause / Cancel game.

TIPS AND TRICKS

=================

- Reserve some ammunition and oxygen for when you have placed the explosives and return to the control center.

In case of oxygen shortage an alarm will sound during which the priority will be to search for new bottles.

- Use extreme caution in the vertical corridors. These are the most treacherous areas.

- Whenever possible, it is best not to disturb the FANTYS.

- Use the save game when the game situation is appropriate, i.e. with a sufficient number of lives and oxygen to finish the game. 

Remember that when you select a DISKETTE, the previous game is overwritten.

- To place the explosives in their final location and to use the detonator you must press the ACTION key (below), otherwise nothing will happen.

===================================

RED PLANET Pi (C) PlayOnRetro 2023

===================================

PROGRAM: salvaKantero

GRAPHICS: salvaKantero

COVER ILLUSTRATION: Masterklown 

MENU MUSIC: Masterklown

IN-GAME MUSIC: Centurion of war

SOUND EFFECTS: Juhani Junkala

16/9 MODE BACKGROUND: NASA (Hubble, Dec 2 2022)

BETA TESTERS: Danielito Dorado, Dany Cantero, Laura Cantero, Lucas Cantero, Marina Cantero    

ACKNOWLEDGEMENTS*: 

Mojon Twins (MK1 8bit game engine)

DaFluffyPotato (Font class, screen scaling)

Chris (Clear Code YT channel)

Rik Cross (Raspberry Pi Foundation)

Mark Vanstone (Raspberry Pi Press)

Ryan Lambie (Raspberry Pi Press)

Cesar Gomez (Python World YT channel)

Kenney (keystroke/mouse graphics)

* Thanks to all of them for sharing their knowledge, techniques and resources. 

PYTHON SOURCE CODE AND RESOURCES AVAILABLE AT https://github.com/salvakantero/RedPlanetPi

RED PLANET Pi is released under GPL v3. (see license.txt)

Thanks for playing!

AUTHOR'S NOTE

==============

This project was programmed entirely on Raspberry Pi computers and Python language, thinking about the large number of academies and users that use these computers around the world to learn computer science and programming.

If any of these students or casual players, access the source code to study it, improve it, make their own game, or simply review and understand it, then it will have been worth the effort.