# Player Motion
\nPlayer Motion is an explosion-based library that uses subtick timing to ensure that only one player is pushed by the blast without any side effects.<\/p>\n
Credit to @BigPapi13 for making the original library this is inspired by. This project aims to succeed it.<\/p>\n
Credit to `nedraw` from the minecraft commands discord for the ender crystal methodology & implementation this is now based on.<\/p>\n
Credit to @SuperSwordTW for helping make significant math performance & stability improvements.<\/p>\n
## How to use<\/p>\n
### Launching a player where in a specific direction<\/p>\n
“`mcfunction
\nscoreboard players set $strength player_motion.api.launch 10000
\nfunction player_motion:api\/launch_looking
\n“`
\n– `$strength` represents motion in blocks\/tick, scaled by 10000. A strength of 10000 will push the player at 1 block\/tick
\n– The facing direction in which the function is called is the direction the player will be launched
\n– Only the player executing the command will receive a motion update<\/p>\n
### Launching a player with xyz vector<\/p>\n
“`mcfunction
\nscoreboard players set $x player_motion.api.launch 500
\nscoreboard players set $y player_motion.api.launch 12000
\nscoreboard players set $z player_motion.api.launch -3125
\nfunction player_motion:api\/launch_xyz
\n“`
\n– `$x`, `$y`, and `$z` are the strength in blocks\/tick to launch the player in the x, y, and z directions
\n– As before, only the player executing the command will be launched<\/p>\n
*Note: These functions are *additive* and will apply motion in addition to existing motion rather than directly setting it to whatever input you send <\/p>\n
## Limitations + Known Issues<\/p>\n
While this library is likely the closest we’ve gotten to perfect player motion manipulation, there are some limitations worth mentioning:
\n– **MSPT Inconsistency**: Even though the motion applied is constant, the rate at which the server and client update may vary, and calling motion updates per tick may result in inconsistencies when these variations become too large. For consistent results, the library should only be used for instantaneous bursts of motion, and continuous forces should instead rely on riding-based methods or levitation, depending on the context.<\/p>\n
If you know any possible solutions or would like to help fixing these problems, please let me know!<\/p>\n","protected":false},"excerpt":{"rendered":"
Explosion-based library that uses subtick timing to ensure that only one player is pushed by the blast without any side effects.<\/p>\n","protected":false},"featured_media":122612,"template":"","meta":{"_minecraft_slug":"player_motion","_minecraft_project_id":"oDhxdGVZ","_minecraft_author":"MulverineX","_minecraft_license":"MIT","_minecraft_downloads":4700,"_minecraft_follows":52,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"player_motion.zip","_minecraft_size_bytes":148640,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T01:11:23.192982Z","_minecraft_date_created":"2024-03-26T07:02:54.791050Z","_minecraft_date_modified":"2025-08-19T01:39:47.653325Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/player_motion","_minecraft_icon_attachment_id":122612,"_minecraft_imported_at":"2026-06-07T05:01:03+00:00","_minecraft_import_hash":"1eea85672a278ab62929f6a830671e00","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,89,873],"mod_loader":[86],"minecraft_version":[101,102,62,73,74,38,78,79,80,81,67,68],"class_list":["post-122611","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-game-mechanics","mod_category-library","mod_loader-datapack","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-24w37a","minecraft_version-24w38a"],"yoast_head":"\n