# Stopfire Settings

Stopfire is a weapon-restriction system. When applied, the player **cannot use any weapons** for a set number of minutes. The count decrements in real time.

***

### Config Variables

```lua
Config.MinActions = 1      -- Minimum minutes staff can apply
Config.MaxActions = 200    -- Maximum minutes staff can apply

Config.StopfireTextPos = { 0.78, 0.92 }  -- HUD text position
```

| Variable                 | Default          | Description                        |
| ------------------------ | ---------------- | ---------------------------------- |
| `Config.MinActions`      | `1`              | Minimum sentence in minutes        |
| `Config.MaxActions`      | `200`            | Maximum sentence in minutes        |
| `Config.StopfireTextPos` | `{ 0.78, 0.92 }` | Screen position of the HUD counter |

***

### How Stopfire Works

1. Staff applies Stopfire from the panel (enters a minute value)
2. Player receives the sentence — counter appears on their HUD
3. Every **real minute**, the server decrements the counter by 1
4. While active, every frame:
   * All weapons are removed
   * Player is forced to unarmed
   * Attack/weapon controls are disabled
5. When the counter reaches 0, the sentence ends automatically

***

### HUD Text Position

The Stopfire counter is displayed as a 2D text overlay on screen. Position is defined as `{ x, y }` in normalized screen coordinates (0.0 = left/top, 1.0 = right/bottom).

```lua
Config.StopfireTextPos = { 0.78, 0.92 }
-- x = 0.78 → near the right side
-- y = 0.92 → near the bottom
```

**Common positions:**

| Position      | x    | y    |
| ------------- | ---- | ---- |
| Bottom right  | 0.78 | 0.92 |
| Bottom center | 0.5  | 0.95 |
| Top right     | 0.85 | 0.05 |
| Bottom left   | 0.18 | 0.92 |

***

### Database Table

Active Stopfire sentences are stored in `stopfire_actions`:

```sql
SELECT * FROM stopfire_actions;
```

To manually end a player's Stopfire:

```sql
DELETE FROM stopfire_actions WHERE identifier = 'citizenid_here';
```

To manually check a player's remaining time:

```sql
SELECT actions_remaining FROM stopfire_actions WHERE identifier = 'citizenid_here';
```

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mohssins.gitbook.io/mohscriptsdocs/moh-stoptroll/stopfire-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.