PlatformEffector2D is for one-way platform behavior.
Use it when the player should be able to move upward through a platform and then land on top of it.
If you want the editor workflow first, start with
Create a 2D Effector in the Editor.
Good Fits
PlatformEffector2D is a strong fit for:
- jump-through platformer ledges
- floating platforms
- layered traversal routes
- levels where approach direction matters
What It Controls
Use One WaySurface Buffer
That is enough for the classic rule:
- pass upward through the platform
- collide when landing from above
This page focuses on that core one-way platform workflow.
Scene Setup
- Create or select the platform object.
- Add a collider, usually
BoxCollider2D. - Add
PlatformEffector2D. - Leave
Use One Wayenabled. - Tune
Surface Bufferif the platform feels too strict or too loose.
Practical Example: A Jump-Through Ledge
For a simple platformer ledge:
- Add a
BoxCollider2Dto a narrow platform. - Add
PlatformEffector2D. - Place the platform above the ground route.
- Jump up through it.
- Land on top of it from above.
If the character still feels like it catches the underside too aggressively,
adjust Surface Buffer and test again.
For a focused inspection scene, build a small 2D test level with a controllable probe, one one-way platform, and a normal solid platform beside it. Jump through the one-way platform from below, land on it from above, and compare that behavior against the normal platform.
How to Think About It
PlatformEffector2D changes how collisions are accepted.
It is not a movement script, and it is not a joint. That matters because the level designer can author the platform behavior directly on the platform object instead of pushing the whole burden into the player controller.
Recommended Use
Use PlatformEffector2D when the platform itself owns the rule.
That keeps the scene easier to reason about than trying to fake one-way platforms entirely from player-side collision code.