PSSFFS2KXX

Popol Super Slam Fusion Full Speed 2KXX

License ?

Dependencies

Need the dialogue_manager, singleton_bundle and achievements addons.

Big Motivation

Code:
- Slopes
- Moving platform, ball walls and one way platform
- Menus and World map system
- Saving system, profile, story and achievement system
- Sound system
- Shoot system
- AI NPC and Boss implementation
Graphism:
- Popol rework graphism
- NPC, pedestrian animations
- backgrounds
- graffitis and adinkra
- tilesets and moods
- GUI and menus
- Effects, paint explosion
Other:
- Musics
- Soundeffects
- Story and characters
- Level design

Code structure to (re)implement

Selector is currently a child of Player/Actions and is reparent by code to be a child of Room. Maybe it should be a child of the room or the level, and accessed in SpecialActionHandler via a NodePath or through signals.
Implement Explosion nodes.
Rework Aiming system (better physics + time stop + 2 steps shoot).
Rework Dunkdash target graphism.
Rework Rails
Rework Ziplines.
Implement Pedestrian generator (pnj shader, gradient sampler, ...).
GUI Graphism

Godot4 migration

List of things to do

physics problem with grind
📌 dunk player position
📌 hang player position
double dash make the player stuck
state machines have memory now... (we need to restart the state machine when reentering it) [Fixed in Godot 4.1]
S.velocity is set to Vec2(0.0) every frame when animation_tree is active (really weird bug) [Fixed with a temporary solution] [seems to be fixed in Godot 4.1]
ball rework (currently a rigidbody implementation but there are physics annoying bugs godotengine/godot#76610) (Solved using GodotTilemapBaker)
player_friction and forces using Alterable
catch and ball release
📌 tileset/map rework
Improve TileMapBaker to take into account different physical layer, for example ballwall and playerwall

Work to do

Graphism :
- 📌 environment elements
- 📌 other tilesets
- 📌 other background
- 📌 all movement sprites
- GUI graphism such as tag-police
- 📌 other characters/npc
- adinkra symbols
Moveset improvment:
- add dunk
- handle crouch
- add landing anim
- add turn back anim
- improve wall jump (feet must be on wall ?)
- add slide
- with and without balls anim
- add multiple shoot types
- Death and life system
Interactive elements (baskets, pipes, jumping platform, doors and warps, wind, enemies...)
- baskets
- spawners
- activable
- destroyable blocks
- ball-doors / player-doors
- 📌 ziplines -> to rework
- 📌 Add enemies and NPC
- 📌 Add one way platforms
- 📌 pipes -> rework a bit (TODO: change bounding box + handle multiple sides + be careful on exit_throw)
- 📌 moving platform (tilemap + pathfollow2D?) (Wait4Godot)
- collectibles (spray?)
NPCs
- pedestrian generator
- interactive npc
- bosses
- ennemies
Style system (optional)
- UI for combos
- Combo and point system
- Reward ('succès') for special style achievements
Improve shooter
- 📌 Auto aim on baskets
- finalize shoot system (test with time stop/slow)
Balls :
- add several balls (bouncy ball, fire ball, linked ball, phantom ball)
- 📌 handle interactions with environment elements
- 📌 Add new powers when selection+active (such as megaBOUM, dash, RollingDestroying...)
- improve animation of balls
- add some juice and more effects
- squish anim for squish balls
Juice :
- Camera shake on heavy ball, dunks and other style action
- particles on balls, dust on footsteps & slide
- add UBER mode with new animations
Sound design
- add sounds
- add musics
- handle music variations
Add UIs
- 📌 Add HUD
- Add menus
- Add WorldMap and level selection
- 📌 Add dialogue system

Issues

Actions and Movement

Environment and Items

Weird behaviour on leaving a zipline to a rail (there is a moment when the character is on both of them)
- Implement character holder group with free_character and pickup_character methods.
Characters can leave rail if Player press crouch on it.
- Implement the riding and hanging states.
Balls can perform too big jumps at the junction of multiple Jumpers. This is due to apply_impulse not changing immediately the velocity value of a RigidBody2D. This implies applying two times the jump_impulse, which is designed to compensate the original velocity and apply the jump_velocity. [resolved by implementing a smart override_impulse that cancel directional velocity and apply impulse, but solely the last call before integrate_force will have an effect]
Get out from zipline just after passing over a Jumper results in sliding (like on ice) because can_go_timer was changed. [TODO REWORK Zipline and Rails]
📌 A ball that bounces on the ring of a basket can do multiple goals. [Partially resolve by lowering the basket goal detector]
📌 Explosion hitbox seems to be broken for squared boxes. [Partially resolved by exploding objects whose center is not in the area in the last frame of Explosion]
ZipLine or RailLine drop inside collision places results in stucked player or high velocity.
Stuck colliding on a rail can result in building speed. [TODO TEST]
Entering Pipe at perfect frame when disabling the Pipe can result in a disabled ball floating in the air. -> don't stop the tween to enter the pipe when disabling the pipe. [hard to reproduce, it happened once]
RailLine going backward vertically switch. This results also in stopping the player and having alternative vertical normal.

Getting out of CharacterPipe is biaised by the collision problem of character colliding with exit, results in in weird velocity vectors.
It is possible to use the power of a Ball that is located in another Room2D, which is undefined behaviour because the ball is not in the scene_tree.

Physics

TileMap hitboxes (bounce on corners of each tile + balls pass through 2 adjacent tiles). size up the hitboxes smartly
Physic of balls when picked up (stay physically on the ground...). complicated see rigidbody functions and how integrate_force works.
Player catching ball while inside BallWall results in stuck player. [Maybe disable the player catch area while inside ballwall?]
Problems when passing from a block just 16 pixel over the other block (results in tiny teleportation but visible due to camera instant movement).
Wind is not affecting Player when grinding and hanging [TODO implement a smart move_character(character, velocity) function for character_holder that take the character velocity at each physics process call and move the character according to the holder].
📌 Problems with physics on slopes [DAMN IT].
📌 annoying Tilemap physics problems. Partially resolved using TilemapBaker but still some problems at the junction between custom blocks (box, jumpers, ...):
- tunneling ;
- tile junction bounce problems. See this issue.
Jitter when multiple balls are above each other (with rigidbodies, physicbodies and situbodies). [TODO TEST]
Ball located just on a spawner position results in very high velocity when spawning a ball on it [hard to reproduce]. [TODO TEST]
Ballwall and PlayerWall seems broken since Godot4.

Visual and Animation

### Other

Potential Glitches

Godot Issues

in Ball.gd function change_holder: issue related to godotengine/godot#14578 and godotengine/godot#34207. See my workaround.
Z_as_relative doesn't work through script... see this issue.
Weird bounce and tunneling effect for rigidbodies: godotengine/godot#76610. This is probably the most annoying one, because the workarounds are tedious and hard (recode physics or use tile_baker and hope it works).

Memories

class_name\s*(\w*), -> class_name $1 #, @export\b\s*$(\w*)$\s*var\s*(\w*) -> @export var $2 : $1 @export_range$(\w*),\s*((\d|\.)*),\s*((\d|\.)*)$\s*var\s*(\w*) -> @export_range($2,$4) var $6 : $1 emit_signal$"(\w*)"$ -> $1.emit() emit_signal$"(\w*),\s*(.*)"$ -> $1.emit($2) (\w*\.)*connect$"(\w*)",Callable\(self,"(\w*)"$\) -> $1$2.connect(self.$3) start$Callable\((.*?)$\.bind$(.*?)$ -> start($1, $2 start$Callable\((.*?)$ -> start($1 ^\s*set\s\=\s*(\w*)\s*\#(.*?\#)*\s*$(\w*),(.*?)$

Yann-Situ/PSSFFS2KXX