Usage guide for Billy’s Admin Sits (bAdminSits)

This guide will try its best to assist you with the powerful admin sit addon named Billy’s Admin Sits.

This addon is included FREE for Physgun Clients!

Setting up a sit room/sit position

By default there are no sit rooms created when Billy’s Admin Sits is first installed.

We recommend building a room yourself, you can even decorate it if you see fit! Persistent/PermaProps will do just fine.

After the next server start Billy’s Admin Sit will recognize the sit room.

To set the sit position; type !sitpos.

The sit position is tied to the current map. You can have multiple different sit locations per map.

If a sit is created but the map does not have a sit position set, the sit will simply start where the staff member is standing.

Permissions

Setting up permissions for bAdminSits is extremely easy, simply follow the steps below.

1. Type !openpermissions in chat
2. Navigate to the Billy's Admin Sits tab
3. Configure your permissions how you see fit!

Automatically Set “Staff on Duty” Job in Sit

Most servers have a staff on duty job for staff members not engaging in roleplay, bAdminSits makes it extremely easy to pop in on this job when a sit starts then pop right back out once the sit is over! Making staffs’ lives so much easier.

They will be added back to their original job with their original loadout after the sit has ended as-well!

Some custom addons (e.g. an inventory system) may cause staff members to lose items or progress. Please use with caution.

Here is an example of a Staff on Duty job that will automatically assign staff members to the role if they engage in a sit.

TEAM_STAFF = DarkRP.createJob("Staff on Duty", {
  color = Color(255, 0, 0, 255),
  model = "models/player/combine_super_soldier.mdl",
  description = [[Staff on Duty]],
  weapons = {},
  command = "staff",
  max = 5,
  salary = 0,
  admin = 1,
  vote = false,
  hasLicense = false,
  candemote = false,
  category = "Citizens",
      StaffOnDuty = true,
  })

The StaffOnDuty boolean is what determines which job a staff member will become when starting/entering a sit.

Create Sits

This is a permission for bAdminSits.

This permission allows the selected access group(s) to create sits, and generally just use the !sit command.

Target Staff

This is a permission for bAdminSits.

This permission allows the selected access group(s) to forcefully add/remove staff to/from a sit.

Join Any Sit

This is a permission for bAdminSits.

This permission allows the selected access group(s) to forcefully join any active sit.

Usage guide for the !sit command

The !sit command is an extremely powerful utility to interface with bAdminSits.

With the !sit command, you can open the help page, create sits, add people to sits, invite staff to sits, remove people from sits and end a sit.

If you do not have permission to forcefully add staff to a sit, you will only be-able to invite them.

Creating a sit

This will go over how to create a sit with a single or multiple players.

To create a sit; type !sit [player name] [player name] ... where [player name] is replaced by the name of players.

Lua API for Creating a sit

GAS.AdminSits:CreateSit(CreatorPlayer, {Player1, Player2, ...})

Adding players to a sit

To add players to a sit; type !sit [player name] [player name] ...

Lua API for Adding players to a sit

GAS.AdminSits:AddPlayerToSit(Player, Sit)

Removing players from a sit

To remove players from a sit; type !sit [player name] [player name] ...

Lua API for Removing players from a sit

GAS.AdminSits:RemovePlayerFromSit(Player, Sit)

Ending a sit

To end a sit, simply type !sit

Lua API for Ending a sit

GAS.AdminSits:EndSit(Sit)

Recreating a sit

To recreate the sit you just previously ended, simply type !resit.

Usage guide for using the sit menu

When you create or join a sit, you will see the sit menu.

Sit Information

Billy’s Admin Sits give a wide variety of sit information when a sit is conducted.

Player Status

Player Operating System

Icon	Operating System
	Windows
	macOS/OS X
	Linux

Other Icons

Icon	Meaning
	Staff Member
	Speaking (Voice Chat)
	Typing in chat

Sit player functions

Most of these actions cannot be performed on staff members.

Usage guide for using the Physgun

Yep that’s right! You can use the physgun to start a sit or remove players from a sit!

Creating a sit with the Physgun

Pick up the player you want to add to a sit and press RELOAD (default R) with your physgun.

Removing players from a sit

Pick up the player you want to add to a sit and press RELOAD (default R) with your physgun.

Sit behavior and how it works

There is a lot of behavior checks Billy’s Admin Sits go through to help assist staff to the best of its ability.

Disconnected players

• If a player disconnects during a sit; all staff in the sit will be informed and their SteamID recorded.
• If the player reconnects, and the sit is still active, they will be added back automatically.
• If the player reconnects but the sit has ended, the sit creator will be notified.

Distraction-free Environment

With a Physgun Server bAdminSits will ideally cause almost 0 performance impact since Physgun Servers multi thread with the game and network thread (Over 100% CPU).

Disabled Actions

During a sit, players (NOT staff) will not be able to perform disruptive actions such as spawning props, switching teams, using weapons, or exploiting DarkRP features.

DarkRP Notes

If a player is arrested or unarrested, they’ll always be teleported to the sit, instead of jail.

When the sit has ended

When the sit has ended, all players will be teleported back to their original positions and angles. If stuck, the sit creator will be notified.

Usage guide for sit invites

Sit invites allow staff members to invite each other to sits if they cannot force staff into sits.

Inviting staff to a sit

To invite staff: !sit [staff name] [staff name] ...

Staff invites expire after roughly 30 seconds.

Responding to a sit invite

When you get a sit invite you can either join or dismiss it.