Actions

Difference between revisions of "SPG:Game Objects"

From Sonic Retro

m (Spikes: Size mistake fix)
(Removed unnecessary sections & repeated information, referenced new page)
Line 5: Line 5:
 
*''An object's actual Width Radius and Height Radius variables are separate to an object's '''hitbox''' width radius and height radius.''
 
*''An object's actual Width Radius and Height Radius variables are separate to an object's '''hitbox''' width radius and height radius.''
 
*''How slope data is used for solid objects is detailed in [[SPG:Solid_Objects#Sloped_Objects|Sloped Objects]].''
 
*''How slope data is used for solid objects is detailed in [[SPG:Solid_Objects#Sloped_Objects|Sloped Objects]].''
 +
*''More detailed information about how hitboxes and trigger areas work, as well as the Player's hitbox, can be found at [[SPG:Hitboxes]].''
  
 
==Introduction==
 
==Introduction==
  
 
Objects move in various ways, some simple and some rather complex. It may be enough to simply observe an object to know how it acts, but this isn't the case most of the time where greater depth is required.  
 
Objects move in various ways, some simple and some rather complex. It may be enough to simply observe an object to know how it acts, but this isn't the case most of the time where greater depth is required.  
 
===Hitboxes===
 
 
Hitboxes are the game's simplified way of giving an object a size. Each object has it's own size defined with a Width Radius and a Height Radius, and they aren't always obvious. Visual examples will be given for most objects in this guide.
 
 
''Note: More detailed information about how hitboxes and solid objects work, as well as the Player's hitbox, can be found at [[SPG:Solid_Objects|Solid Objects]].
 
 
====Triggers====
 
 
Sometimes, but rarely, an object will forgo the hitbox system entirely and instead perform it's own custom checks on the Player's position, checking if it is within some kind of rectangle. This serves the same purpose as hitboxes, but is fundamentally different. For one, it happens on the object side while hitboxes are checked at the end of the Player's code. Secondly, a trigger can be a rectangle of any size, without using radius values. So they will be described as having a top left position, and a complete width and complete height. Just a normal rectangle. What you see is what you get with these.
 
 
Because these are totally separate and do not involve the Player's hitbox at all, they will be differentiated as "Triggers" or trigger areas.
 
  
 
==Rings==
 
==Rings==

Revision as of 07:35, 26 November 2022

Sonic Physics Guide
Collision
Physics
Gameplay
Presentation
Special

Notes:

  • The research applies to all four of the Sega Mega Drive games and Sonic CD.
  • Variables and constants for Sonic and other characters such as X Position and acc will be referenced frequently, they can be found in Basics.
  • An object's actual Width Radius and Height Radius variables are separate to an object's hitbox width radius and height radius.
  • How slope data is used for solid objects is detailed in Sloped Objects.
  • More detailed information about how hitboxes and trigger areas work, as well as the Player's hitbox, can be found at SPG:Hitboxes.

Introduction

Objects move in various ways, some simple and some rather complex. It may be enough to simply observe an object to know how it acts, but this isn't the case most of the time where greater depth is required.

Rings

SPGRingHitbox.png

Rings have a hitbox with a width radius of 6 and a height radius of 6, resulting in a 13 x 13 rectangle. (while their sprite is larger, at 16px), so the Player can get quite close to a ring before a collision occurs and they collect it.

Scattered Rings

When a ring is bouncing around, it has a Width Radius of 8 and a Height Radius of 8 resulting in a 17 x 17 rectangle.

Ring Gravity

Rings do not have same gravity constant as the Player does. Instead, their gravity is a force of 0.09375. So, this value is added to the rings' Y Speed every frame.

Ring Bounce

When the scattered rings hit the ground, their vertical speed is multiplied by a factor of -0.75. This has the effect of reversing their vertical motion, as well as slowing it somewhat. This calculation is performed after the addition of the gravity. Their horizontal speed is unaffected by bouncing.

Rings only check for the floor once every 4 frames, using a sensor at their X Position and Y Position + Height Radius.

Clearly, when the rings bounce off the floor, they do so so imprecisely as on 75% of frames they are not even checking for it. So they sometimes pass well into the ground before deciding to bounce away. This is really not noticed during normal play, and was necessary to avoid too much slowdown.

But there are further limitations on bouncing rings, probably also in place to avoid processor load. They are totally unaffected by walls (they do not cast any wall sensors), and are only concerned with vertical surfaces. These checks also only happen when the ring is moving downwards (Y Speed > 0) thus they can also fly up through ceilings. This can actually become a bother to the Player if they are struck in a small corridor, as most of their rings are lost in the ceiling and don't fall back down to be regathered. To make things worse, to disperse the processor load, the floor check only happens every 4 frames, offset for each ring, meaning rings will tend to fall through floors entirely.

Ring Lifespan

All scattered rings are destroyed after 256 steps if they have not been regathered. Also, if they leave the horizontal view boundaries, they are destroyed. Again, on a more powerful system, you may choose not to include this feature.

Ring Animations

Fixed rings have 4 frames of animation, and spend 8 steps showing each frame before moving to the next. Scattered rings are more complicated, in that they have a much faster animation speed when they are created (1 frame per 2 steps), but this slows down over their lifespan.

The way you achieve this depends on how you animate your sprites. If you're using animation speed instead of frame duration, your formula is:

    animationSpeed = floor(lifespanTimer * 0.5 / ringLifespan)

If you are using Variable Speed Animation System, your formula is a bit different:

    frameDuration = floor(ringLifespan * 2 / lifespanTimer)

Spikes

Spikes in Sonic 1 vary in size. A single object can either contain 1 or 4 or more spikes. The solid width (or height if the spikes are horizontal) of the object is also extended to match.

Spikes in Sonic 2 onwards (both vertical and horizontal) spikes are more consistent, and have a Width Radius of 16 and a Height Radius of 16, resulting in a 33 x 33 rectangle, this is their solid size.

Moving Spikes

Moving spikes retract into and extend out of walls. The game achieves this by simply moving the object 32 pixels each time they move. The spikes will move once every 64 frames. While moving they will retract or extend by 8px per frame until the new position has been reached.

Spike Damage

Spikes will hurt the Player if the Player makes contact with the correct side (like landing on upwards facing spikes, or pushing/running into sideways facing spikes). Contact with any other side of the spikes will not hurt the Player.

Springs

Red springs propel the Player at a speed of 16, and yellow Springs at a speed of 10. If the Spring faces up or down, the value is either negative or positive, respectively, and Y Speed is set to it. If the Spring faces left or right, the value is either negative or positive, respectively, and X Speed is set to it. Vertical Springs don't affect X Speed and likewise horizontal Springs don't affect Y Speed.

Vertical Springs

SPGVerticalSpringHitbox.png

Vertical Springs (both up and down) have a Width Radius of 16 and a Height Radius of 8, resulting in a 33 x 17 rectangle, this is their solid size.

Activation

Vertical Springs simply activate if the Player touches the correct side.

On the frame of collision, the game will add or subtract 8 from the Player's Y Position to pull the player 8 pixels inside of the Spring.

Horizontal Springs

SPGHorizontalSpringHitbox.png

Horizontal Springs (both left and right) have a Width Radius of 8 and a Height Radius of 14, resulting in a 17 x 31 rectangle, this is their solid size.

This Height made sense in Sonic 1 with smaller Springs, but was not altered in subsequent games.

Activation

Much like vertical Springs, horizontal Springs will activate when you touch the correct side. They will only propel the Player while they are grounded.

On the frame of collision, the game will add or subtract 8 from the Player's X Position to pull the player 8 pixels inside of the Spring.

When the Player bounces away from a horizontal Spring (red or yellow) the control lock timer is set to 16. This means they cannot brake or otherwise affect their X Speed for 16 steps. Why lock the horizontal controls? You are likely to be pressing in the direction of the Spring as you run into it, and this would cause the Player to bounce away in their braking animation. Temporarily ignoring input is a quick and elegant solution.

Sonic 2 Onwards

However in Sonic 2 (16-bit) onwards, touching the horizontal Spring object isn't the only way to activate them. If the Player is standing on a Spring facing right and you slowly step off it and land on the floor nearby (moving right without turning) the Spring will activate, even though it is impossible to have pushed into the Spring . So something extra is occurring. This happens because if the Player is not moving towards the Spring (so either standing still or moving away), the game checks if their X and Y positions are within a box which surrounds the Spring. This box is much larger than the Spring itself, spanning vertically from the Spring's Y - 24 to the Spring's Y + 24 and horizontally from the Spring's X to the Spring's X + (40 in the Spring's direction).

The result of this is you can walk up to a Spring, stop, and if you are within 40 pixels of it you will be propelled away. Keeping in mind the normal Width Radius for the solid area of these Springs is 8, this can happen incredibly and noticeably early. This is all in addition to the normal Spring activation by touching the actual side of it.

Diagonal Springs

There are no diagonal Springs in Sonic the Hedgehog (16-bit). But there are in Sonic 2 (16-bit), 3, K, and CD.

SPGDiagonalSpringHitbox.png

Diagonal Springs are sloped solid objects. They have a Width Radius of 16 and a Height Radius of 16, resulting in a 33 x 33 rectangle, this is their solid size.

Their height array is as follows:

[16, 16, 16, 16, 16, 16,
16, 16, 16, 16, 16, 16, 14, 12, 10, 8, 6, 4, 2, 0, -2, -4,
-4, -4, -4, -4, -4, -4]

Diagonal Springs facing down will be the same just with everything flipped vertically, just like those facing left are the same with everything flipped horizontally.

Activation

If the Diagonal Spring is facing upwards at all, the Player needs to land on top of the Spring to activate it. If it's facing down at all, the Player needs to touch the underneath.

However, there is an additional check. Diagonal Springs facing right at all will only bounce the Player if the Player's X Position > (Spring's X Position - 4). For those facing left at all, the Spring will bounce if the Player's X Position < (Spring's X Position + 4).

On the frame of collision, the game will add or subtract 8 from the Player's X and Y Positions (in the diagonal direction into the spring) to pull the Player 8 pixels inside of the Spring.

Strength

Sonic 2, 3, and K work the same way, but Sonic CD is different.

In Sonic 2, 3, and K, a diagonal Spring sets both X Speed and Y Speed to the Spring's value, with the appropriate sign. So a red Spring facing up and to the right sets Y Speed to -16 and X Speed to 16. The trouble with this method is that the Player is technically bounced faster diagonally than horizontally or vertically. This is because they didn't bother to calculate the sine functions.

In Sonic CD, they do however. Conveniently, the absolute sine and cosine of a 45 degree angle are the same, so you only need one value. It comes out to 11.3125 for Red Springs and 7.0703125 for Yellow ones.

Spring Animation

Springs have 3 subimages, which are relaxed, compressed, and extended. When activated, the compressed subimage plays for 1 frame (the frame of collision), the relaxed subimage plays for 2 frames, the extended subimage plays for 6 frames, then the Spring returns to being relaxed.

The Spring stops acting solid to the while it animates, and becomes solid again when it relaxes.

Item Monitors

SPGItemMonitorHitbox.png

Item Monitors have a Width Radius of 15 and a Height Radius of 15, resulting in a 31 x 31 rectangle, this is their solid size you can push against.

The hitbox is 1 pixel larger on every side, with a width radius of 16 and a height radius of 16, resulting in a 33 x 33 rectangle.

As noted in Solid Objects, Item Monitor solid collision differs a little from normal solid objects, most notably having no underside collision.

They have a gravity of 0.21875 while falling.

Breaking The Monitor

Item Monitors do not always act solid to the Player (as noted in Solid Objects) and this allows the player to get close enough within the Monitor to make contact with the hitbox, however the Player can also potentially touch the hitbox while the Monitor IS acting Solid.

On any given frame, after the Player moves towards and overlaps the Item Monitor (but before the Item Monitor runs it's solid object code to push the Player back out) if the Player was travelling fast enough, the Player can touch the Item Monitor's hitbox.

Hitbox Reaction

An Item Monitor breaks when the Player touches it's hitbox, however there are a few other checks performed after contact with the hitbox is made.

If the Player's Y Speed is greater than or equal to 0:

  • If they are in their roll animation, the Item Monitor will break. Otherwise if the Player isn't rolling, nothing will happen.

Otherwise, if the Player's Y Speed is less than 0:

  • If their Y Position is greater than or equal to than the Item Monitor's Y Position + 16, the Item Monitor will bounce up with a Y Speed of -1.5 knocking the Item Monitor upwards and the Player's Y Speed is reversed. Otherwise if the Player is too high, nothing will happen.

If the Item Monitor breaks it will no longer act solid and its hitbox will be inactive, however if it remains intact the Item Monitor can continue to act solid as if nothing happened.

Bumpers

Bumpers such as those in Spring Yard Zone set the Player's X Speed to 7*cosine(p), and Y Speed to 7*-sine(p), where p is the angle measured from the bumper's centre to the Player's. This is regardless of the Player's velocity when they hit the bumper.

SPGBumperHitbox.png

Bumpers have a hitbox with a width radius of 8 and a height radius of 8, resulting in a 17 x 17 rectangle. Other than the hitbox speed repulsion, there is no solidity to bumpers.

Breakable Blocks and Rocks

When the Player jumps on top of breakable objects, such as the rocks in Hill Top Zone, blocks in Marble Zone, or the tube caps in Chemical Plant Zone, they bounce away with a Y Speed of -3. X Speed is unaffected.

The block produces 4 segments. These segments have a gravity of 0.21875. Their initial x and y speeds are (-2, -2) & (2, -2) for the top two, and (-1, -1) & (1, -1) for the bottom two.

Breaking Walls

In Sonic 1, 2, 3, & K, the character's absolute X Speed must exceed 4.5 in order to break through destructible walls when rolling (except for Knuckles, who busts walls on contact, and doesn't need to be rolled up). X Speed is unaffected by the collision, as well.

However, when Knuckles breaks walls in Sonic 3 & Knuckles, though their X Speed is unaffected, they don't move during the frame in which they hit the wall. The same thing is true when the Player spindashes through a wall in Sonic 3 & Knuckles.

In Sonic CD, the X Speed threshold is removed. The Player can break through destructible walls by simply jumping near them, or rolling into them at any speed.

Buttons

SPGButtonHitbox.png

Buttons simply act solid and have a Width Radius and Height Radius which is smaller than the button when not pressed. When the Player is standing on it, the subimage changes to pressed and the switch is activated.

Checkpoints

SPGCheckpointTrigger.png

Checkpoints appear to have a hitbox which will trigger when the Player touches it... but it doesn't. The checkpoint does it's own evaluation on the Player's position to trigger a reaction. This is one of the "triggers" I mentioned at the top of this guide.

The trigger top left is Checkpoint X Position - 18 and Checkpoint Y Position - 64, the trigger size is 16 x 104.

Of course, the Y Position of a checkpoint is not centred on the entire thing, it's more closely centred on the pole, excluding the part at the top. This is why the trigger is larger above the Y Position than below it.

Bridges

The bridges in Sonic 1, 2 and 3 are known for their dynamic movement as the Player moves over them. Bridges are set up with a controller object and an array of log objects which the controller object creates, though this can just be an array of values to represent the segments in most engines now. The controller object contains a few variables: There's the length (in segments) of the bridge, which is usually 12, but it can be longer; there's the index of the segment the Player is standing on, which starts at 0 for the leftmost segment and ends at length-1.

Bridge Collision

Collision with a bridge while you aren't already on it is rather simple. The controller object is actually one of the logs, the middle log (or the log just to the right of the middle on even bridges, which is usual). This log acts as a platform as wide as the entire bridge using the length variable (and accounts for any uncentred-ness). Essentially the bridge is one large normal jump through platform at that log's Y, though the game will also check that your YSpeed >= 0 before doing any of the normal platform collision. The horizontal range check is also different, where the Player's X Position must be over the top of a log (meaning, within the bridge's entire horizontal area) to collide with the bridge at all. The other logs of the bridge have no collision at all.

However, once you are on the bridge, the game simply sets your Y Position so that you are standing on top of the log index your X Position is currently over. Normal method for walking off platforms is used to exit the bridge at either end.

Dip Amount

The "dip" amount is the lowest the bridge can go at any given time. This changes depending on the log the Player is standing on. To get the current maximum dip amount in pixels the bridge controller uses predetermined values for each log.

The values go up in 2's, starting at 2 and continuing to the middle, with the other side being a mirror of the first half. For example, a bridge with length 5 will have the values

2, 4, 6, 4, 2 

and a bridge with length 6, the values would be

2, 4, 6, 6, 4, 2 

The bridges commonly found in Sonic games (12 segments in length) would have the values

2, 4, 6, 8, 10, 12, 12, 10, 8, 6, 4, 2 

To get the current maximum dip for the bridge, the game uses the value from the log currently being stood on. We'll call the current value MaxDip.

Calculating Each Log Dip

The Y Position of the segments in the bridge depend on the log that the Player is currently standing on, as so:

SPGBridge.png The Player is on the 5th segment, we'll call this the CurrentSegment and it's value is 5.

In this example, the dip would look as follows:

2, 4, 6, 8, 10, 12, 12, 10, 8, 6, 4, 2

So the current MaxDip for the bridge will be the 5th log's value, which is 10.

To calculate the position of each log, we calculate how far it is from CurrentSegment relative to the edge it's near. We will call this value LogDistance.

 Segment 0 is 1/5 of the way to CurrentSegment, so it's LogDistance is 1/5 or 0.2.
 Segment 1 is 2/5 of the way to CurrentSegment, so it's LogDistance is 2/5 or 0.4. 
 Segment 4 is 5/5 of the way to CurrentSegment, so it's LogDistance is 5/5 or 1. 


Working from the other side, we use the distance from the end to CurrentSegment, rather than from the start.

 Segment 11 is 1/8 of the way to CurrentSegment, so it's LogDistance is 1/8 or 0.125.
 Segment 6 is 6/8 of the way to CurrentSegment, so it's LogDistance is 6/8 or 0.75.


(Since we've already calculated segment 4 from one direction, there's no need to do it from the other).

We then use LogDistance to calculate it's position:

 LogY = BridgeY + MaxDip * sine(90 * LogDistance).


Some custom code to calculate these automatically may go as follows:

Notes:

  • This assumes first segment index starts at 0 in the loop, but CurrentSegment (the log currently stood on) would start at 1.
  • If the Player is not on any of the logs (from walking off), the max dip is just 0 so the bridge won't need to run this code. In addition, the logs don't need to update when the Player jumps off apart from slowly relaxing the bridge.
  • It does not account for any smoothing of the bridge movement, like in Sonic Mania
  • Sine here uses degrees not radians. Because the original game uses 256 angles rather than 360, there may be slight differences with the sine function causing some logs to be a pixel off (never the logs being stood on, mainly the logs towards the sides). It's tiny and unnoticeable, but can be corrected with extra work to recreate the functions in the original game.
 // get the current segment stood on
 CurrentSegment = floor((the Player's X position - Bridge's start X) / 16) + 1
 
 // get the current maximum dip for the bridge
 if CurrentSegment <= SegmentAmount / 2
   MaxDip = CurrentSegment * 2   //working from the left side in
 else 
   MaxDip = ((SegmentAmount - CurrentSegment) + 1) * 2   // working from the right side in
 // the above can be done upon bridge creation, getting the max dip for all segments and placing them in an array for later use
 
 // loop through all segments and find their y positions
 for (i = 0; i < SegmentAmount; i ++)
 {
   // Get difference in position of this log to current log stood on
   difference = abs((i + 1) - CurrentSegment);
   
   // Get distance from current log to the closest side, depending if before or after CurrentSegment
   if (i < CurrentSegment) 
     log_distance = 1 - (difference / CurrentSegment) //working from the left side in
   else 
     log_distance = 1 - (difference / ((SegmentAmount - CurrentSegment) + 1))   // working from the right side in
   
   // get y of log using max dip and log distance
   LogY[i] = BridgeY + floor(MaxDip * sine(90 * log_distance))   //the final y position for the log
 }


Meanwhile, all these dip values are multiplied by the sine of the angle in the controller object that counts to 90 when the Player is standing on top, and down to 0 when the Player gets off, so the dip will smoothly increase with time when the Player jumps on to the bridge, and then smoothly decrease when they leave it. It takes 16 frames for bridge to return itself to its original position from full tension, resulting in a step of 5.625. As noted above, original uses 256 angles, so the actual angle range in the controller object is 0~64, with step of 4.

End of Level Capsules

Sonic 1 Method

Explosion

For 60 steps, every 8 steps, spawn explosion at capsule position plus random x,y offset (Max horizontal offset of 31 pixels, and according to calculations, vertical is the same). At end of those 60 steps, start with the animals

Animals

Switch to exploded frame. Spawn 8 animals at capsule position -28x, +32y, horizontally separated by 7, with alarms starting from 154 and decreasing by 8 per animal (animals don't jump out until their alarm reaches zero).

For 150 steps, every 8 steps, spawn animal at random X Position amongst the existing animal group (but tighter in, not near edges), with their alarm set to 12.

When all animal objects have disappeared, run "Got Through" message.

Sonic 2 Method

Explosion

An explosion spawns at lock's position, move lock at +8x, -4y. Wait 29 steps.

Animals

8 animals spawn at capsule position -28x, +32y, horizontally separated by 7, with alarms starting from 154 and decreasing by 8 per animal (the animals don't jump out until their alarm reaches zero).

For 180 steps, every 8 steps, an animal will spawn at random X Position amongst the existing animal group (but tighter in, not near edges), with their alarm set to 12.

When all animal objects have disappeared, the game will run the 'Got Through' message.

S Tunnels

The S Tunnels in Green Hill Zone simply keep the Player rolling at all times. If their speed reaches 0 and they stand up, the game acts as if you have pressed down and they roll again instantly. Since the S tunnels have no flat ground, the Player will always roll down it and should never just crouch. However, as part of the function making the Player roll, if their gsp does happen to be 0, it will set their gsp to 2.

Pushable Blocks

Pushable blocks move 1 pixel at a time while being pushed (the mechanics of which can be found in the Solid Objects page).

Falling Down

Pushable blocks are checking below themselves with a single sensor (only on the frames the block actually moves) to ensure there is floor beneath them. It will ignore the floor if the distance found is greater than 0. If they find no floor when they get pushed, they will switch to their falling state. While in this state, to prepare, and to avoid falling too soon and clipping the corner, they will begin to move horizontally at a speed of 4 in the direction of the push until they have moved 16 pixels. At this point they are completely over the ledge that they originally detected. They will then proceed to fall and land as normal.

Seesaws

SPGSeesawHitbox.gif

The Seesaws in Sonic the Hedgehog (16-bit) are sloped platform (jump through) objects. They have a Width Radius of 48 and a Height Radius of 8, resulting in a 97 x 17 rectangle, this is their solid size.

Because it's a platform, it has no extra slope information on either side. The height arrays are as follows:

When sloped down toward the right:

[36, 36, 38, 40, 42, 44, 42, 40, 38, 36, 35, 34, 33, 32, 31, 30, 29, 28, 27, 26, 25, 24, 23, 22, 21, 20, 19, 18, 17, 16, 15, 14, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 2, 2, 2, 2]

Sloped down toward the left is the same as the above, but in the opposite order (the game just reverses the above list dynamically):

[2, 2, 2, 2, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 38, 40, 42, 44, 42, 40, 38, 36, 36]

When straight:

[21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21]

Which isn't a slope at all, of course, but it does result in raising the platform collision area up well above the Seesaw's Y Positon.

Lastly, the spike ball simply has a hurt hitbox with a Width Radius of 8 and a Height Radius of 8, resulting in a 17 x 17 rectangle.

Rotation

The Seesaw can be in 3 states, sloped toward the left, sloped toward the right, and straight.

When the Player is standing/lands on on a Seesaw, the Seesaw's state changes based on the Player's X position. The seesaw will be straight if the Player's X is within a radius of 8 pixels of the Seesaw's X position, otherwise it will slope to whatever side they are on.

Launching the Spike Ball

When the Player lands on the Seesaw, and the seesaw's rotation is changed, it will launch a spike ball upwards. The speed of which is based on both where you landed and your landing speed.

If the Player landed in the middle (meaning, within the range that the board remains straight) the spike ball will launch with an XSpeed of 1.078125 and YSpeed of -8.09375.

Otherwise, if the Player's speed is less than 10 on landing, the spike ball will launch with an XSpeed of 0.796875 and YSpeed of -10.9375.

Otherwise, the spike ball will launch with an XSpeed of 0.625 and YSpeed of -14.

Of course, all these X Speeds would be negative if the spike ball started on the right side.

The spike ball has a gravity of 0.21875.

Launching The Player

When the spike ball lands, the Player simply launches with whatever Y Speed the spike ball launched at.

Flippers

FlipperHitbox.gif

The flippers in Casino Night Zone are sloped solid objects. They have a Width Radius of 24 and a Height Radius of 6, resulting in a 49 x 13 rectangle, this is their solid size.

The height arrays are as follows:

When down:

[7,  7,  7,  7,  7,  7,  
7,  8,  9, 10, 11, 10,  9,  8,  7,  6, 5,  4,  3,  2,  1,  0, -1, -2,-3, -4, -5, -6, -7, -8,
-9, -10, -11, -12, -13, -14]

When straight:

[6,  6,  6,  6,  6,  6,  
7,  8,  9,  9,  9,  9,  9,  9,  8,  8, 8,  8,  8,  8,  7,  7,  7,  7,  6,  6,  6,  6,  5,  5,  
4,  4, 4,  4,  4,  4]

When up:

[5,  5,  5,  5,  5,  6,  
7,  8,  9, 10, 11, 11, 12, 12, 13, 13, 14, 14, 15, 15, 16, 16, 17, 17, 18, 18, 17, 17, 16, 16,
16, 16, 16, 16, 16, 16]

When the Player lands on them, they are forced into a roll. While on them, Ground Speed is set to 1 (or -1 if the flipper is facing left), and horizontal input is ignored.

Flipping The Player

When the player presses jump, the flipper activates, and the Player is launched at new X and Y speeds based on their X Position relative to the flipper.

Here's some code which emulates what the game does to calculate the Player's new X and Y speeds when flipping.

// Difference between player's X Position and flipper's X Position, offset by 35
var xdiff;
if flipper's direction == 1 //(1 facing right, -1 facing left)
  x_diff = (player's X Position - flipper's X Position) + 35;
else
  x_diff = (flipper's X Position - player's X Position) + 35;
       
// Difference modified to be used as speed multiplier            
var multiplier = min(x_diff, 64);
multiplier = multiplier * 32;
multiplier += 2048;
multiplier = -multiplier / 256;

// Difference modified to be used as angle for sine and cosine
var angle = (x_diff / 4) + 64;

// Get degree angle to use for sine and cosine in modern game engines
var degree_angle = (256 - angle) * 1.40625;

// Calculate sine and cosine
var sine = sin(degree_angle) * multiplier;
var cosine = cos(degree_angle) * multiplier;

// Launch player
player's X Speed = cosine * flipper's direction;
player's Y Speed = -sine;

Note:

  • The jumping flag is not set when launched, because if it were, your velocity would be cut short if you let go of jump.

Animation

When the flipper is activated, it animates through each subimage (straight, up, straight), which each last for 4 frames. Then it resets to being down.

Note:

  • Each subimage also uses it's accompanying height array for the slopes.

Fans (Horizontal)

The horizontal fans in Star Light Zone push the Player back, but don't actually affect their speed at all. What is actually happening is just an X Position shift each frame, based on how far away from the fan the Player is.

Because it doesnt affect the speed, the Player can accelerate and run full speed while in the fan's influence.

Activation Area

The fan will affect the player if the Player's X Position is within the range:

fan's X Position - 80  to  fan's X Position + 160
or if the fan is facing left:
fan's X Position - 160  to  fan's X Position + 80

and if the Player's Y Position is within the range:

fan's Y Position - 96  to  fan's Y Position + 16

Fan Force

Here's some code which emulates how the game calculates how far to push the Player back:

// Distance
var x_diff = player's X Position - fan's X Position;
if fan's direction == -1 //(1 facing right, -1 facing left)
    x_diff = -x_diff;
        
// Calculate force
var fan_force = floor(x_diff);
if x_diff < 0
{
    // The Player is behind the fan (will invert and "double" the distance, because it is half the size of the area infront)
    fan_force = -(fan_force - 1)
    fan_force = fan_force * 2;
}

// Calculate final force based on distance
fan_force = fan_force + 96;
fan_force = (256 - fan_force) >> 4; // ">> 4" here is equivalent to dividing by 16, floored. You can substitute it for normal division to get a smoother motion.
if (fan's direction == -1) fan_force = -fan_force;

// Move the player
player's X Position += fan_force;

Fans (Vertical)

Vertical fans from Oil Ocean Zone work almost exactly the same way as horizontal fans, but on the Y axis.

Activation Area

The fan will affect the player if the Player's X Position is within the range:

fan's X Position - 64  to  fan's X Position + 64

and if the Player's Y Position is within the range:

fan's Y Position - 96  to  fan's Y Position + 48

Fan Force

Here's some code which emulates how the game calculates how far to push the Player upwards:

// Distances
var x_diff = player's X Position - fan's X Position;
var y_diff = (player's Y Position + oscillation) - fan's Y Position; // oscillation is a value which oscillates from 0 to 15 and back on a sine wave once every 88 frames

// Calculate force
var fan_force = floor(y_diff);
if y_diff > 0
{
    fan_force = -(fan_force + 1)
    fan_force = fan_force * 2;
}
fan_force = fan_force + 96;
fan_force = (-fan_force) >> 4; // ">> 4" here is equivalent to dividing by 16, floored. You can substitute it for normal division to get a smoother motion.

// Move the player
player's Y Position += fan_force;
player's Y Speed = 0;

Spike Traps

When Marble Zone Spike traps fall, their Y Speed increases by 0.4375 each frame. When they reach full length, they spend about 60 frames there. After this they begin to rise by 0.5px per frame, or 1 pixel every 2 frames. The length they can fall varies.

SPGSpikeTrapHitbox.png

They have a solid box at the top (which the Player can walk on & push against) however the spike area is a damage hit box which will simply hurt the Player upon contact but doesn't have solidity.

Conveyor Belts

A Scrap Brain Zone conveyor belt will simply add the belt speed to the Player's X Position, their speeds are unaffected.

Spring Ramps

Spring ramps aren't quite as simple as normal Springs. Firstly, they have a specific region where they actuate.

SPGSpringRampActuationRegion.png

The ramp will activate if their X Position is within the green region as they stand on it.

When a Spring ramp activates they don't bounce the Player instantly, instead, the Player moves down a bit as the animation plays. There are 2 subimages, normal and down, and these both have different collision height arrays as shown below.

SPGSpringRampSolidty.png

Spring ramps are sloped solid objects. They have a Width Radius of 28 and a Height Radius of 8, resulting in a 57 x 17 rectangle, this is their solid size.

The height arrays are as follows:

When relaxed:

[8,  8,  8,  8,  8,  8,  
8,  9, 10, 11, 12, 13, 14, 15, 16, 16, 17, 18, 19, 20, 20, 21, 21, 22, 23, 24, 24, 24, 24, 24, 24, 24, 24, 24,
24, 24, 24, 24, 24, 24]

When pressed:

[8,  8,  8,  8,  8,  8,  
8,  9, 10, 11, 12, 12, 12, 12, 13, 13, 13, 13, 13, 13, 14, 14, 15, 15, 16, 16, 16, 16, 15, 15, 14, 14, 13, 13, 
13, 13, 13, 13, 13, 13]

Once activated it plays the down subimage for 4 frames, and the Player will lower with it but is otherwise unaffected and will keep walking. On the next frame it's back up and the Player is raised again but still unaffected, on the frame after this they will actually be in the air.

So how fast do they bounce the Player? Well, that's not perfectly simple either. It will bounce the Player up with a Y Speed of -4, and depending on their X Position relative to the ramp it will subtract a second modifier from their Y Speed. This is all dependant on the positions where the Player's X Position is right now as they are bounced, not where they were when activated it.

SPGSpringRampPowerSteps.png

From left to right this modifier can be 0, 1, 2, 3 or 4.

So if the Player happened to be in section 3, their Y Speed would become -4, minus the modifier of 2, resulting in -6.

X Speed is also affected, if absolute X speed happens to be larger than or equal to 4, the modifier will be added to (or subtracted from) X Speed. If the Player is in section 3 (which has a modifier of 2), and they have an X Speed of 5, their speed would become 5 + 2.

Note:

  • This all gets capped at 6 in Sonic 2 due to the speed cap still being present in the air.

Spring Caps

The red spring caps that cover the tubes in Chemical Plant Zone work like springboards, but are slightly stronger than a Yellow springboard. They set the Player's Y Speed to -10.5 upon collision.

Spinners

The black spinners that propel you forward in Chemical Plant Zone set the Player's X Speed to 16, unless if they're already moving faster than that.

Ski Lifts

The ski lifts in Hill Top Zone move with an X Speed of 2, and a Y Speed of 1.

Balloons

The balloons in Carnival Night Zone set Y Speed to -7 when the Player collides with them, no matter what their angle of collision. X Speed is not affected.

SPGBalloonHitbox.png

Balloons have a hitbox with a Width Radius of 8 and a Height Radius of 8, resulting in a 17 x 17 rectangle.

Cannons

The cannons in Carnival Night Zone set Sonic's X Speed to 16*cosine(p), and Y Speed to 16*-sine(p), where p is the angle of the cannon.

Bouncy Mushrooms

The mushrooms in Mushroom Hill Zone work just like springboards, only each successive bounce is higher than the last, up to three bounces. The first bounce sets Y Speed to -6.5, the second, -7.5, and the third, -8.5.

Points

When you hit a Badnik or other point-bearing item (such as Bumpers), a small score notification will fly up out of it. After it spawns at the object's X and Y Position, it begins with a Y Speed of -3, and will slow down by 0.09375 each frame. Once it is no longer moving, it will vanish. This will take around 32 frames.