AtomicBot
⇠ Back to Help Center

Prison System (Player Punishment Module)

The Prison System is AtomicBot’s built-in punishment feature. When a player is flagged as a prisoner, they lose access to key bot features and are forcibly teleported to your designated prison location every time they log in. Admins can add, release, and manage prisoners entirely through Discord.

How the System Works

  • Players added to the rust_prisoners table are marked as active prisoners.
  • When they join the server, AtomicBot immediately teleports them to the prison coordinates.
  • Other bot features detect prisoner status and automatically deny access.
  • Admins manage everything through the /prison command.

All enforcement happens automatically. Once flagged, the bot does the rest.

Prison Modes

AtomicBot supports two levels of punishment, toggled via /prison mode.

🔸 Basic Mode

  • Player is teleported to prison on every login.
  • All other bot systems still function normally.

🔴 Advanced Mode

  • Teleport enforcement (same as basic)
  • Snag-A-Whip disabled — player cannot spawn vehicles
  • Kits disabled — both “I Need” & “I Have” emote kits
  • Claims disabled — BattlePass and shop delivery blocked

All handlers check isImprisoned() before completing actions.

Automatic Join Enforcement

When a flagged prisoner joins the server, the watcher immediately teleports them to the prison coordinates: 

"Atomic0utlaw-_- [PS5] has entered the game"

→ global.teleportpos X,Y,Z "Atomic0utlaw-_-"

There is no bypass. The only way out is for an admin to release them.

Features Blocked for Prisoners

These systems include a prison check and will refuse to complete actions if a player is imprisoned:

  • Snag-A-Whip — funny denial messages instead of vehicles
  • I Need kits — kit distribution blocked
  • I Have kits — VIP tools blocked
  • Reward Claiming — BattlePass + shop delivery blocked

Additional systems can be added later (teleports, gambling, ZORP interactions).

Admin Commands

All commands require the server’s configured Admin Role.

/prison toggle

Enable or disable the entire system.

/prison mode

Switch between Basic and Advanced punishment.

/prison setcoords

Set the teleport destination for prisoners.

/prison add <player>

Flag a player as imprisoned.

/prison release <player>

Unflag a prisoner and restore full bot access.

/prison list

View all active prisoners.

Database Tables

The Prison System uses two key tables: 

guild_servers
 ├─ prison_enabled (0/1)
 ├─ prison_x / prison_y / prison_z
 └─ prison_mode (basic / advanced)  
rust_prisoners
 ├─ guild_id
 ├─ player_name
 ├─ active (1 = in prison)
 └─ timestamps

Troubleshooting

  • Player is not teleported → Coordinates not set.
  • Prison mode not applying → System disabled via /prison toggle.
  • Player still gets kits/whips → Check if mode is set to advanced.
  • Snag-A-Whip still works → Prison check missing in custom handler.