Pekka Kana 2 "Greta engine"

Copyright (c) 2003 Janne Kivilahti https://github.com/poppijanne https://github.com/pistegamez

Ported to SDL by Samuli Tuomola (2010) https://github.com/stt/pk2

Ported to SDL2 by Danilo Lemos (2016-2023) https://github.com/danilolc/pk2

Hard fork by SaturninTheAlien (2023-present)

"Pekka Kana 2 (Pekka the Rooster 2) is a 2D platformer game where you control a rooster, made in the spirit of classic platformers such as Super Mario, SuperTux, Jazz Jackrabbit, Super Frog and so on." http://kiwi.mbnet.fi/pistegamez/pk2/

This repository contains the source code and resource files for the game Pekka Kana 2 created by Janne Kivilahti in 2003. The source code was released by the original author on a forum thread.

Since then a lot of things changed, including an initial SDL port by Samuli Tuomola in 2010 and then the SDL2 port, bug fixes, code redesign by Danilo Lemos (2016-2023), code redesign, bug fixes and new features by SaturninTheAlien (2023 - present)

This game was tested on Windows, GNU/Linux, Mac OS (Apple Silicon).

Binary distibution

Compiled binaries for MS Windows available here (64-bit):
https://1drv.ms/f/s!AhAm7DASof3FkH4uGUgf4msXCxHk

They were compiled using MS Visual Studio Community 2022 on MS Windows 10, so if there is any missing DLL file you perhaps need to install the latest Microsoft Visual C++ Redistributable:
https://aka.ms/vs/17/release/vc_redist.x64.exe

Compiling

Ubuntu / Debian

To compile Pekka Kana 2 into Debian GNU/Linux based distributions, you need the SDL2, SDL2_image, SDL2_mixer, Zip and Lua libraries installed on the system. To get everything you need, just run the following command on the terminal:

$ apt install build-essential libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libzip-dev liblua5.4-dev

Then run the "make" command inside the "Pekka Kana 2" directory.

$ make -j4 all

The PK2 binary will be in "bin/" directory.

$ ./bin/pekka-kana-2

To make the removal, within the compiled directory, execute this command:

$ make clean

macOS

Use Homebrew to install SDL2 packages:

brew install sdl2 sdl2_gfx sdl2_image sdl2_mixer libzip lua

Now just clone the code and run make all on pk2 directory and run /bin/pekka-kana-2, just like on Ubuntu/Debian.

Our community

• Discord: https://discord.gg/kqDJfYX
• Old forum: http://pistegamez.proboards.com/
• Pistegamez site: https://www.pistegamez.net/

User made episodes:

https://sites.google.com/view/pekka-kana-fanpage/pk2-makyunis-mapstore

To add an episode just download a zip file and put it into "/res/data/mapstore" ("/data/mapstore" on Windows).

The game can be started with the "--dev" argument to enable the cheats and "--test" followed by "episode_name/level_filename" to play/test a particular level.

This example starts the level13.map (the robot boss fight) on dev mode:

./pekka-kana-2 --dev --test "rooster island 2/level13.map"

Absolute paths to custom locations are also accepted, such as:

./pekka-kana-2 --test /home/saturnin/pk2_episodes/my_episode/my_level.map

New features

• A new sprite format .spr2 based on JSON. The legacy .spr format is still supported for compatibility reasons. All the obsolete c-style arrays in PrototypeClass have been replaced by std::vector, std::string and so there are no limits like max number of AIs and so on. There is still 12 character length limit of the sprite filename length due to the map format. Currently sprite filenames are stored as "name.spr". During the level loading, firstly "name.spr2" is searched for, then "name.spr". If the sprite name is stored as "name", only "name.spr2" is searched for.

• Support for custom SFX sounds (such as jump, splash, map sounds and so on) in zip episodes.

• New Fields in SPR2:

  • "always_active" - if true, the sprite won't deactivate when off-screen.
  • "dead_weight" - weight of the sprite corpse, if not defined the default legacy behaviour,
  • "commands" - description below.

• New AIs:

  • AI_ATTACK_1_IF_PLAYER_ABOVE (31)

  • AI_ATTACK_2_IF_PLAYER_ABOVE (32)

  • AI_TRANSFORM_IF_PLAYER_BELOW (33)

  • AI_TRANSFORM_IF_PLAYER_ABOVE (34)

  • AI_FOLLOW_COMMANDS (40)

  • AI_MOVE_X_COS_FREE (68)

  • AI_MOVE_Y_COS_FREE (69)

  • AI_TRANSFORM_IF_SKULL_BLOCKS_CHANGED (82)

  • AI_DIE_IF_SKULL_BLOCKS_CHANGED (83)

  • AI_RETURN_TO_ORIG_X_CONSTANT (84) - sprite returns to it's starting x position with constant speed and in comparison to the legacy AI_RETURN_TO_ORIG_X (28) there are no oscillations at the target x position,

  • AI_RETURN_TO_ORIG_Y_CONSTANT (85) - sprite returns to it's starting y position with constant speed and in comparison to the legacy AI_RETURN_TO_ORIG_Y (29) there are no oscillations at the target y position,

  • AI_EMIT_EVENT1_IF_DEAD (86) - a way to interact between sprites, maybe changing another set of skull blocks in the future with bigger tilesets,

  • AI_EMIT_EVENT1_IF_DAMAGED (87),

  • AI_TRANSFORM_IF_EVENT1 (88),

  • AI_DIE_IF_EVENT1 (89),

  • AI_EMIT_EVENT2_IF_DEAD (90) - similar to event1 but without shaking the screen,

  • AI_EMIT_EVENT2_IF_DAMAGED (91),

  • AI_TRANSFORM_IF_EVENT2 (92)

  • AI_DIE_IF_EVENT2 (93)

  • AI_TRANSFORM_IF_DAMAGED (129) - this AI was implemented, but not working due to a bug before,

  • AI_INFINITE_ENERGY (141) - sprite has infinite energy, it can "receive" damage but it never dies. Only DAMAGE_TYPE_ALL (like falling into the void or die command can really kill it)

  • AI_THROWABLE_WEAPON2 (142) - similar to AI_THROWABLE_WEAPON (35) but initial speed is max_speed/3.5 and the x speed of the shooter is added to the projectile speed.

  • AI_STATIC_PROJECTILE (143) - sprite has no initial speed if spawned as projectile (ammo1 or ammo2)

  • AI_DIE_IF_TOUCHES_WALL (144),

  • AI_NPC_COLLECT_BONUSES (145) - sprites with this AI can collect bonuses despite not being the player,

  • AI_DESPAWN_IF_OFFSCREEN (146) - the sprite despawns if far away from player,

  • AI_HEAL_IF_OFFSCREEN (147) - the sprite heals to its maximum health if far away from player,

  • AI_SELF_TRANSFORMATION_RANDOM_PROTOTYPE (148) - sprite turns into its Transformation Sprite (50% chances) or into its Ammo2 Sprite (50% chances) when its Reload / Charge Time is over.

  • AI_NONSTOP_VERTICAL (171)

  • AI_START_DOWN (172)

  • AI_START_UP (173)

  • AI_START_LEFT (174)

  • AI_START_RIGHT (175)

  • AI_BACKGROUND_HORIZONTAL_PARALLAX (104) - removes Y parallax,

  • AI_BACKGROUND_BRING_TO_FRONT (105) - for sorting BG (and FG) sprites despite their parallax

  • AI_BACKGROUND_SEND_TO_BACK (106)

  • AI_BONUS_CANNOT_BE_PUSHED (126)

  • AI_INFO_IF_TOUCHES_PLAYER (302)

  • AI_INFO_IF_DAMAGED (303)

  • AI_INFO_IF_DEAD (304)

  • AI_INFO_IF_BONUS_COLLECTED (305)

• New sprite destruction effects:

  • FX_DESTRUCT_SPLASH_GRAY (24)

  • FX_DESTRUCT_SPLASH_BLUE (25)

  • FX_DESTRUCT_SPLASH_RED (26)

  • FX_DESTRUCT_SPLASH_GREEN (27)

  • FX_DESTRUCT_SPLASH_ORANGE (28)

  • FX_DESTRUCT_SPLASH_VIOLET (29)

  • FX_DESTRUCT_SPLASH_TURQUOISE (30)

  • FX_DESTRUCT_SMOKELESS_EXPLOSION_GRAY (31)

  • FX_DESTRUCT_SMOKELESS_EXPLOSION_BLUE (32)

  • FX_DESTRUCT_SMOKELESS_EXPLOSION_RED (33)

  • FX_DESTRUCT_SMOKELESS_EXPLOSION_GREEN (34)

  • FX_DESTRUCT_SMOKELESS_EXPLOSION_ORANGE (35)

  • FX_DESTRUCT_SMOKELESS_EXPLOSION_VIOLET (36)

  • FX_DESTRUCT_SMOKELESS_EXPLOSION_TURQUOISE (37)

• Sprite inheritance / "parent" field.

• Lua scripting

• AI_FOLLOW_COMMANDS (40) and "commands" field in the new sprite format: Currently available commands:

waypoint_x, <tile_x>
waypoint_y, <tile_y>
waypoint_xy, <tile_x>, <tile_y>

waypoint_rx, <tiles_offset_x>
waypoint_ry, <tiles_offset_y>
waypoint_rxy, <tiles_offset_x>, <tiles_offset_y>

waypoint_orig_xy,
waypoint_seen_player,
make_sound <sound_type>,
die,
transform,
wait, <ticks>,
wait_random, <ticks_min>, <ticks_max>,
thunder
chase_player, <ticks>,
effect, <effect>,
lua, <global_lua_function_name>

Commands / waypoints are executed by the sprite in a loop unless there is "die" or "transform" command.

• Foreground sprites (type 6) - similar to background sprites,

• Back Hole sprites (type 9) - silently removes every sprite of other types, contact with it is similar to falling into the void,

• Splash as a new sprite destruction effect (24 - 30, different colors)

Fixed bugs

• Enemies can no longer deal damage to invisible player by jumping on their head,

• Evil bees can no longer pass through fast projectiles,

• Ice blocks no longer replicate while in touch with blue mouse,

• Fixed the PSound-related memory leak sometimes crashing the game while returning to the map screen after player's death.

• Fixed a potential memory leak in AI 39 (AI_DIE_WITH_MOTHER_SPPRITE)

• Removed initial splash effect if the sprite spawns in the water

• Fixed the bug causing dropped bonuses with weight 0 to levitate (now definitely!),

• Wall sprites are no longer walls after their death.

• Ambient sprites (indestructible and harmless) such as chains and white butterflies no longer block attacks.

• Fixed the bug causing indestructible sprites taking damage after transformation.

• Fixed the bug making it possible to win a level by the dead Pekka. Player corpse reaching the exit sign no longer makes the level completed.

• Killing the evil one no longer results "hiscore" music fading after reaching the exit tile.

• Fixed the dead player teleporter bug. Player corpse is no longer teleported by the teleporters.

• Fixed broken pixels in some backgrounds caused by converting the color 255 to alpha (for example backround in "Iv4n island 2/level13.map"). Currently the color-to-alpha feature is disabled while loading the background image.

• Fixed incorrectly cropped Pekka's head on the map screen.

• Fixed the "frog corpse" bug.

• Fixed the visible wind bug.

• Friendly sprites from gift no longer kill the enemy player ("Iv4n island 2/spyrooster"), but not vice versa (the hedgehog gift trap still works).

• Enemy player transformed into friendly prototype by potion is no longer enemy ("Iv4n island 2/spyrooster", robohead transformed into rooster is no longer immune to the enemies), but not vice versa (for example, rooster player is still friendly after using a pig potion).

• If there is a missing tileset or sprite prototype there will be a dialog window and the game will quit without “Segmentation fault”.

• Fixed the glitch that some dropped bonuses like oranges dropped by hedgehogs used to nearly always move left. Also the hedgehog from the box used to move nearly always left at the beginning due to the same bug.

Plans:

• Translate all the Finnish variable names and comments to English.
• New map format, bigger maps and more tiles.
• Lua scripting (in progress)

Known bugs

• Sprites sometimes don't detect edges near BLOCK_BARRIER_DOWN (legacy bug)

Used libraries

• JSON for modern c++
  https://github.com/nlohmann/json
• SDL2, SDL2_image, SDL2_mixer
  https://www.libsdl.org/
• libzip
  https://libzip.org/
• sol2
  https://github.com/ThePhD/sol2