This script allows x staff groups that are able to forcefully jail a player and locking them into a closed area, to where they can’t move depending on how much time you’ve jailed that individual for. This script is useful for semi/serious RP servers, to send those who’s character died into Admin Jail, to where they are no longer able to use that character anymore and or servers who just want to put an individual on “timeout”. The time jailed is saved in the database & will not go down unless the designated player is connected into the server & on that character.
Configurable groups to have access to the commands.
Configurable text (language).
Configurable admin-jail location.
Configurable admin-jail release location.
Configurable admin-jail list command - shows all the players currently admin-jailed/cked.
Optionable routing buckets configuration on load-in / adminjail.
Discord webhook logging (track who jails/releases & updates time).
./adminjail (playerID, reason, time) - jail a player for x time.
./adminjailtime - see the current time you have left.
./adminjailrelease (playerID) - release a player from admin-jail.
./adminjaillist - shows all the players currently admin-jailed/cked.
./ck (playerID) - locks the players character slot that they are currently on.
./enablechar char#:license - to reactivate the characters license.
This resource is drag/drop if ESX, aside from configuring the config to your needs. IF you're on QB framework, remove the es_extended line from the fxmanifest & also change your settings inside Config.lua. RUN the SQL, then you will just need to add the following inside of your server.cfg, restart your server & you're good to go.
ensure adminplus-adminjail
Feel free to check the config.lua & customize what jobs have access, the job grade, the pricing & also the cooldown.
Fixed locales missing (reported in Discord Ticket)
Allowed editing to client/main.lua for controls to be modified (disable specific controls so users can't click specific controls/keys).
Added Job compatability (add what jobs have access to adminjail / adminjailrelease) (suggestion requested in Discord Ticket.
Fixed chat display not changing even when you changed it inside of the locales. (useful for other languages etc..)
Added Chat Suggestion when doing the commands.
Added /ck command - will lock the individuals character slot they are playing on.
Updated /ck for VMS_MULTICHARS (shouldn't show error anymore when /ck)
-- READ THE README & ADD THE FOLLOWING TO THE VMS_MULTICHARS Changeable command name & chat message. Option to turn both on/off.
Added a distance check HIGHLY RECOMMEND UPDATING so player gets teleported back if x distance from jail location.
Now supports QB Framework!
Moved Webhook to server-side to avoid server dumpers spamming your webhooks.
Removed unnecessary client triggers.
Removed ESX imports from fxmanifest (not needed).
Fixed CK/UNCK options so that they don't show in adminjaillist if not enabled via config.
Added Routing Bucket Feature (togglable) for trolls to be in their own session instead of being public with other players.
REPLACE ALL FILES
Added UI showing admin jail time on screen (command is also still a thing if needed). ✅
-- ███████████████████████████████████████████████████████████████████████████ --
Config = {}
Config.Framework = 1 -- (ESX == 1), (QB == 2)
Config.FrameworkExport = 'es_extended' -- (ESX == 'es_extended'), (QB == 'qb-core')
Config.releaseLocation = vector3(187.1704, -919.8855, 29.8055-1) -- where do you want the player to be teleported when out of adminjail/ck?
Config.chatMessages = false -- do you want the adminjail to notify other players in chat when adminjailed etc?
Config.reduceTimeOffline = false -- set to true if you want admin jail time to decrease even when the player is offline.
Config.routingBucket = true -- do you want to enable routing buckets? (this will put players into a random session so they are likely not to be with another player, more so for trolls)
Config.AdminJailCommand = 'adminjail'
Config.AdminJailCommandRelease = 'adminjailrelease'
Config.AdminJailTime = 'adminjailtime'
Config.AdminJailList = 'adminjaillist'
Config.DistanceCheck = 20.0 -- how far they can go away from Config.jailLocation before they're teleported back.
Config.DistanceMessage = 'You were teleported back to admin-jail for trying to get away.'
Config.DisabledControls = {24, 257, 25, 263, 45, 22, 44, 37, 23, 288, 289, 170, 167, 73, 59, 71, 72, 36, 47, 264, 257, 140, 141, 142, 143, 75} -- 245 for T keybind (chat)
Config.ckToggle = false -- toggle CK
Config.ckCommand = 'ck' -- cmd to CK
Config.unckToggle = false -- toggle unCK
Config.unckCommand = 'unck' -- cmd to unCK
Config.ckAnnounce = false -- do you want to alert in that when someone is CKed?
-- Chat Messages IF ENABLED. -- (mainly for changing the RGBA colors & modifications -- don't touch if you don't know what you're doing)
Config.Admin_Jail_Updated = '<div style="color: rgba(255, 99, 71, 1); width: fit-content; max-width: 125%; word-break: break-word; "> {0} </div>'
Config.Admin_Jail_Sent = '<div style="color: rgba(255, 99, 71, 1); width: fit-content; max-width: 125%; word-break: break-word; "> {0} </div>'
Config.CK_Announce_Chat = '<div style="width: fit-content; max-width: 125%; word-break: break-word; "><span style="color: rgba(255, 99, 71, 1);">{0}</span> <span style="color: rgba(255, 255, 255, 1);">{1}</span></div>'
--
Config.AcePerm = false -- check readme
Config.AdminGroups = {
'god',
'admin',
'mod',
'superadmin',
'tester',
'developer',
'management',
'owner'
}
-- to run /ck & /adminjail -- (don't have access to /unck & /adminjailrelease to avoid abuse from the job)
Config.Jobs = {
{ name = 'police', grade = 6 },
{ name = 'ambulance', grade = 6 },
}
Config.jailLocation = {
x = 3557.8950, -- x Coordinate
y = 3659.7058, -- y Coordinate
z = 28.1219-1 -- z Coordinate
}
Config.EnableWebhook = false -- (if true add webhook to server side) adminplus-adminjail/server/webhooks.lua
Config.Strings = {
adminjail = 'send an individual to Admin Jail',
adminjailrelease = 'release an individual from Admin Jail',
adminjailchecktime = 'check the time of a person in Admin Jail',
adminjailtimecommand = 'Check remaining jail time',
insufficientpermissions = 'insufficient permission to use this command',
invalid_player_id = 'invalid Player ID',
invalid_reason = 'invalid reason',
invalid_time = 'invalid time',
player_not_found = 'player not found',
usage_admin_release = 'Usage: /adminjailrelease [playerId]',
usage_admin_jail = 'Usage: /adminjail [playerId] [reason] [time]',
usage_admin_ck = 'Usage: /ck [playerId]',
admin_jail_fail_remove = 'Failed to remove Admin Jail record from the database',
admin_jail_fail_insert = 'Failed to insert admin jail record into the database',
admin_jail_fail_update = 'Failed to update admin jail record in the database',
admin_jail_released = 'You have been released from Admin Jail!',
admin_jail_sent = 'You have been sent to Admin Jail!',
time = ' \nTime: ',
admin_jail_updated = 'Your Admin Jail time has been updated! \nTime Updated: ',
remaining_jail_time = 'Your remaining jail time:',
remaining_jail_time_other = 'remaining jail time:',
minutes = ' minute(s) ',
seconds = ' seconds',
player = ' player ',
reason = ' \nReason: ',
staff = ' \nStaff: ',
active_admin_jail = 'You have an active Admin Jail sentence.',
no_active_admin_jail = 'You do not have an active jail sentence.',
no_active_admin_jail_other = 'does not have an active jail sentence.',
chat_message_sent_to_jail = '%s has sent %s to Admin Jail for %s minute(s). Reason: %s',
chat_message_has_updated = '%s has updated %s Admin Jail time to %s minute(s). Reason: %s',
--
ck = 'send an individiual to be CKed',
ckrelease = 'release an individual from being CKed',
usage_ck_admin_jail = 'Usage: /ck [playerId]',
chat_ck_message_sent_to_jail = '%s has has been sent to the morgue. Reason: %s',
chat_ck_message_has_updated = '%s has updated %s Admin Jail time to %s minute(s). Reason: %s',
admin_ck_fail_update = 'User is already in the morgue.',
admin_ck_fail_remove = 'Failed to remove CK record from the database',
admin_ck_sent = 'You have been sent to the Morgue!',
admin_ck_fail_insert = 'Failed to insert CK record into the database',
usage_ck_release = 'Usage: /unck [playerId]',
admin_ck_released = 'You have been released from the Morgue!',
-- client side menu notifications
admin_menu_name = 'Admin Jail Features',
admin_menu_list = 'Admin Jail List ',
admin_menu_reason = 'Reason: ',
admin_menu_jail_time = '\nJail Time: ',
admin_menu_update_user_time = 'Update admin-jail time',
admin_menu_update_user_time_desc = 'Update the admin-jail time of this individual.',
admin_menu_update_input_user_time = 'Update admin-jail time for "',
admin_menu_update_input_user_time_desc = 'How many minutes do you want this character to be admin-jailed for? ',
admin_menu_remove_admin_jail_title = 'Remove admin-jail',
admin_menu_remove_admin_jail_desc = 'Remove the admin-jail of this individual.',
admin_menu_remove_ck_title = 'Un Character Kill',
admin_menu_remove_ck_desc = 'Remove the character kill of this individual.',
admin_menu_remove_copy_title = 'Copy Identifier',
admin_menu_remove_copy_desc = 'Copy character\'s identifier.',
admin_menu_remove_back_title = 'Back',
admin_menu_remove_back_desc = 'Go back to admin-jail history.',
admin_menu_clipboard = 'Copied identifier to clipboard \n',
-- server side menu notifications
admin_menu_remove_admin_jail = 'Character Admin-Jail removed from database: ',
admin_menu_remove_admin_jail_online = 'Character is in the city and was successfully removed from admin-jail.',
admin_menu_remove_admin_jail_offline = 'Character is not in the city but was successfully removed from admin-jail.',
admin_menu_fail_remove_license = 'Failed to remove license from database: ',
admin_menu_ck_remove = 'Character-Kill removed from database: ',
admin_menu_remove_ck_online = 'Character is in the city and was successfully un-cked.',
admin_menu_remove_ck_offline = 'Character is not in the city but was successfully un-cked.',
admin_menu_update_time = 'Updated admin jail time for: ',
admin_menu_fail_update_time = 'Failed to update admin jail time for: ',
}
Config.Debug = false
-- ███████████████████████████████████████████████████████████████████████████ --
