# Restricted Areas

The **Restricted Areas** editor page lets you create editable zones that check access restrictions and move unauthorized players to a configured safe location.

<div data-full-width="false"><figure><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-900442ae63312c69a25d33a9706700b49b69bc5f%2Fcapt_areas.png?alt=media" alt=""><figcaption></figcaption></figure></div>

### Editor Settings

<table data-full-width="false"><thead><tr><th>Setting</th><th>Type</th><th>Info</th></tr></thead><tbody><tr><td>Name</td><td>Text</td><td>Choose a display name for the restricted area</td></tr><tr><td>Area position (X/Y/Z)</td><td>Vector3</td><td>Set center position of the restricted volume</td></tr><tr><td>Area heading</td><td>Number/List</td><td>Set area orientation (mainly for rectangle shape)</td></tr><tr><td>Width</td><td>Number/List</td><td>Set area width</td></tr><tr><td>Height</td><td>Number/List</td><td>Set area height (used for bounding-box dimensions)</td></tr><tr><td>Depth</td><td>Number/List</td><td>Set area depth/vertical range</td></tr><tr><td>Shape</td><td>Toggle/List</td><td>Switch between rectangle (<code>1</code>) and cylinder (<code>2</code>)</td></tr><tr><td>Safe position (X/Y/Z)</td><td>Vector3</td><td>Set fallback/safe teleport position for unauthorized players</td></tr><tr><td>Use current coords as safe zone</td><td>Action</td><td>Copy current player position into <code>safeCoord</code></td></tr><tr><td>Notify text</td><td>Text</td><td>Set message shown when a player is moved out of the restricted area</td></tr><tr><td>Restrictions</td><td>Action</td><td>Open restrictions editor (job/item/vehicle/vip rules)</td></tr><tr><td>Proximity</td><td>Number</td><td>Set interaction/subscription distance in meters</td></tr><tr><td>Load only interiors</td><td>Toggle</td><td>Load this area only while players are in interiors</td></tr><tr><td>Add restricted area</td><td>Action</td><td>Create a new area near the current player position</td></tr><tr><td>Delete restricted area</td><td>Action</td><td>Delete selected area</td></tr></tbody></table>

## RestrictionTypes

Inside the restrictions sub-menu, visible fields depend on selected restriction type.

<table data-full-width="false"><thead><tr><th>Restriction type</th><th>Fields</th><th>Info</th></tr></thead><tbody><tr><td><code>job</code></td><td><code>job</code>, <code>grade</code></td><td>Require player job name and minimum/equal grade (grade can be <code>-1</code> as any)</td></tr><tr><td><code>item</code></td><td><code>itemName</code>, <code>itemCount</code></td><td>Require inventory item and amount</td></tr><tr><td><code>vehicle</code></td><td><code>vehicleHash</code>, <code>vehiclePlate</code></td><td>Require specific vehicle model/hash and optionally plate</td></tr><tr><td><code>vip</code></td><td><em>type only</em></td><td>Use VIP access check in restriction logic</td></tr></tbody></table>

## Area Shapes

You can choose between two area shapes.

<table data-full-width="false"><thead><tr><th width="127">Preview</th><th>Type</th></tr></thead><tbody><tr><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-54da22e3b159c402ece8b13e0263ae0c3341d62a%2Farea_sphere.png?alt=media" alt=""></td><td>Sphere</td></tr><tr><td><img src="https://1037498771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MZErcztD5BvrKnwRGJq%2Fuploads%2Fgit-blob-6b4ba67d6287c3828014c8cdd6c995cbedfe200f%2Farea_rectangle.png?alt=media" alt=""></td><td>Rectangle</td></tr></tbody></table>

## Preview of Restricted Area

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFicarM3Z9iXA9Tfz78vZ%2Fuploads%2F1vpFxMp8ZmT63lCJ886J%2Farea_action.mp4?alt=media&token=eece2f20-e931-4c0a-be7b-a4a835226e1a>" %}