PowerfulFreeze 1.0.0

PowerfulFreeze lets your staff freeze a player on the spot in one of three styles, with per-freeze modifiers and an optional Freeze Gun. It works on its own through chat and console commands, and if you also run PowerfulAdmin it adds an in-game panel for managing freezes.

>>> No dependency required. Install PowerfulAdmin only if you want the UI.

Why PowerfulFreeze?

• Works on its own. Commands and enforcement need no other plugin. PowerfulAdmin is optional and only adds the panel.
• Three freeze modes. A frozen loading screen, an in-world position lock, or an invisible chair. Pick whichever fits the situation.
• Per-freeze modifiers. Invulnerability, no-deal-damage, vanish, keep-alive, mute, hide-from-map and item lock, each toggled on its own.
• A Freeze Gun. Give moderators a weapon that freezes whoever they hit, with an in-hand menu to change duration and mode while holding it.
• Timed or permanent. Any duration like 30m, 2h, 1d12h, or leave it permanent. Frozen players see a countdown.
• An in-game panel. Search, page, freeze, extend and unfreeze from a UI that matches your PowerfulAdmin theme (needs PowerfulAdmin).
• Survives reconnects and restarts. Freezes are saved and re-applied when the player returns or the server reboots.

Freeze modes

• Screen. The target gets a full-screen frozen overlay showing the reason and the time left. There is nothing to play through.
• Position Lock. The player stays in the world and can look around, but is snapped back the moment they try to move. Useful when you want to talk to someone and keep them in place.
• Mount. The target is seated on an invisible chair and cannot get off.

Modifiers

Each freeze can carry any combination of these, set from the panel or applied by default from the config:

• No take damage - the frozen player cannot be hurt.
• No deal damage - the frozen player cannot hurt anyone.
• Vanish - the player is hidden from everyone except staff with the see-vanish permission.
• No death - keeps the player alive by stopping bleeding, cold and radiation from killing them.
• Mute - blocks the player's chat and voice.
• Hide from map - removes the player from their team for the duration, so they drop off the team map.
• Lock items - the player cannot move or drop items.

The Freeze Gun

Give moderators a weapon that freezes on hit

• Configurable item, skin and name (default: a marked revolver called "Freeze Gun").
• Freezes any player it hits for the gun's current duration and mode.
• Press reload while holding it to open an in-hand menu and change the duration or mode.
• Optional infinite ammo and no condition loss, so it does not run dry or break.
• Optional auto-removal from players who do not have the permission.

Hand it out with /freezegun (or pf.gun.give).

The in-game panel (requires PowerfulAdmin)
A Freeze section in the Tools category:

• A freeze list with search by name or SteamID, and pagination.
• Each entry shows the name, SteamID, mode and the time left (or "permanent").
• A detail view with the reason, who set it, the mode, the date, a live countdown, quick +/- time buttons and modifier toggles.
• One-click Unfreeze with a confirmation step.
• Freeze composer: a searchable, paged player picker, reason templates and a free-text reason, duration presets or a custom value, mode selection and modifier toggles.
• A Freeze action in the player popup, anywhere in the panel.
• It follows your active theme.

Every action is written to PowerfulAdmin's Logs.

Commands

Chat:

/freeze <name|steamid> [duration] [mode] [reason]

/unfreeze <name|steamid>

/freezeinfo <name|steamid>

/freezegun                 - give yourself the freeze gun

/freeze help               - show all commands

Console / RCON:

pf.freeze <name|steamid> [duration] [mode] [reason]
pf.unfreeze <name|steamid>
pf.info <name|steamid>
pf.list [page]             - paged active freeze list
pf.ui                      - open the in-game panel (in-game player only)
pf.gun.give                - give yourself the freeze gun

Duration examples: 30m, 2h, 7d, 1d12h. Empty or 0 means permanent.

Mode keywords: screen, world / pos / lock (position lock), mount / chair (invisible chair). Leave it out to use the default mode.

Permissions

• powerfulfreeze.freeze - Freeze, extend, and edit modifiers
• powerfulfreeze.unfreeze - Unfreeze
• powerfulfreeze.view - Open the Freeze section and view freeze info
• powerfulfreeze.gun - Receive and use the Freeze Gun
• powerfulfreeze.seevanishforfreezed - See players frozen with the Vanish modifier

Configuration

{
  "DefaultMode": "LoadingScreen",
  "BroadcastFreezes": true,
  "NotifyFrozen": true,
  "ServerName": "",
  "DefaultFlags": "NoDeath",
  "GunEnabled": true,
  "GunItem": "pistol.revolver",
  "GunDefaultDuration": "5m",
  "GunBlockDamage": true,
  "GunSkin": 0,
  "GunName": "Freeze Gun",
  "GunInfiniteAmmo": true,
  "GunRemoveUnpermitted": true
}

• DefaultMode - mode used when none is given: `LoadingScreen`, `PositionLock` or `Mount`.
• DefaultFlags - modifiers put on a new freeze by default (combine with commas, e.g. `NoDeath, Mute`).
• BroadcastFreezes / NotifyFrozen - announce freezes to everyone / notify the frozen player.
• GunEnabled / GunItem / GunSkin / GunName - the Freeze Gun's behavior and appearance.
• GunDefaultDuration / GunBlockDamage - the gun's starting duration, and whether its shots deal no real damage.
• GunInfiniteAmmo - never run out of ammo or lose condition.
• GunRemoveUnpermitted - take the gun away from players without the gun permission.

When PowerfulAdmin is installed, most of these can also be changed from the Settings page without editing the file.

Installation

1. Drop PowerfulFreeze.cs into your plugins folder (Carbon: carbon/plugins/, Oxide: oxide/plugins/).
2. The plugin loads and generates its config. There is nothing else to set up before you can freeze someone.
3. Grant the permissions above to your staff groups.
4. (Optional) Install PowerfulAdmin to get the in-game freeze panel.
5. Use the commands above, or open the Freeze section in the panel (Tools category) if PowerfulAdmin is installed.

Localization

English and Russian ship with the plugin. Every message lives in the language files, so you can translate or reword anything for your community.

Questions or bug reports? Reach out on our Discord.