Subscribe to download
Auto Unstuck

Auto Unstuck is a server addon that detects whenever a player is stuck. It is very good at detecting this as it uses the player's bounding box which is what players use for collisions.

When a player is detected as being stuck, Auto Unstuck will wait (3 seconds by default) warning the player first and then teleporting the player out if they are still stuck.


• AutoUnstuck_Enabled <0/1>

• AutoUnstuck_TPNearSpot <0/2> (2 by default) - On 1 Auto Unstuck will TP the player to the closest available navmesh outside of obstruction, 2 will teleport the player to the last place they were NOT stuck at. (If there's no navmesh on the map, 2 will be used anyway)

• AutoUnstuck_TPEntityClass <entity classname> (info_player_start by default ) - the entities' classname Auto Unstuck should pick randomly for players to teleport to when they are stuck (If TPNearSpot is on this is the fallback teleport if for some reason TPNearSpot failed to teleport the player)

• AutoUnstuck_TimeForTP <seconds> (3 by default ) - The amount of seconds Auto Unstuck should wait for before teleporting the player

• AutoUnstuck_Announce <0/1> (1 by default ) - If on will put [Auto Unstuck] <Name> was teleported because they were stuck! in the chat whenever someone is teleported

(This will not show to the person who got stuck)

• AutoUnstuck_IgnorePlayers <0/1> (0 by default) - If on, Auto Unstuck will not do anything if a player is stuck inside another player.

• AutoUnstuck_If_PersonalEnt <0/1> (1 by default ) - If off, Auto Unstuck will not do anything if the person that is stuck is inside their own entity

• AutoUnstuck_If_Admin <0/1> (1 by default ) - If off, Auto Unstuck won't do anything if the person that is stuck is an administrator on the server

• AutoUnstuck_NearNPCs <0/1> (1 by default) - If off, Auto Unstuck will attempt to find a TP spot that is away from NPCs

• AutoUnstuck_NPC_Distance <number> (500 by default) - The distance Auto Unstuck will try to avoid teleporting the player to (if AutoUnstuck_NearNPCs is set to 0)


You can use these hooks to run your own code on Unstuck events

• AU.PlayerStuck ( ply ) - When it detects a player as being stuck
• AU.PlayerNoLongerStuck ( ply )
• AU.PlayerTeleported ( ply, pos )
• AU.CanHandlePlayer ( ply ) - Return false to disable detection on a player


Auto Unstuck functions as intended for Sandbox, DarkRP, TTT, Murder, nZombies, Zombie Survival and many others!

Tested with many different playermodels from the workshop, Auto Unstuck is guaranteed to work fine on all servers including DarkRP ones that use plenty of different jobs.

Auto Unstuck will calculate the correct size should the player ever get too big. Tested from scale 0.1 to 30!

Auto Unstuck will still be able to teleport players even if the AutoUnstuck_TPEntityClass does not exist on the map as long as there's a spawn point on it.

Gamemodes that replace the player entity (Like Prop Hunt, Ragdoll Combat, etc)