sd-zonecreator

A visual zone creation tool featuring an interactive map interface, real-time 3D preview, multiple export formats and more!

If you have any issues or suggestions, feel free to PR, create an issue or join my discord: https://discord.gg/FzPehMQaBQ

📋 Dependencies

• ox_lib

🎯 Features

Core Features

• Interactive Map - Click to place zone points on a high-resolution GTA V satellite map
• Real-time 3D Preview - View your zone in-game with a free-fly camera system
• Multiple Export Formats - Export to PolyZone, ox_lib, vector2, or vector3 formats
• Import Support - Paste existing zone code to edit and visualize zones
• Grid Mode - Displays a grid overlay and snaps points to 10-unit intervals.
• Auto Ground Z - Automatically calculates ground height at the zone center
• Multi-Zone Management - Create and manage multiple zones in a single session

Template Shapes

Quickly create zones using pre-built shape templates:

Shape	Description
Rectangle	4-point square/rectangular zone
Circle	16-point circular approximation
Triangle	3-point triangular zone
Pentagon	5-point pentagonal zone
Hexagon	6-point hexagonal zone
Star	10-point star shape
L-Shape	6-point L-shaped zone

All templates support:

• Drag to Position - Drag the center marker to reposition the shape
• Scale Slider - Adjust the size from 5 to 3000 units
• Rotation Slider - Rotate the shape from 0° to 360°

Point Management

• Click on Map - Add a new point to the active zone
• Drag Points - Click and drag any point marker to reposition it
• Right-click Point - Delete a single point
• Click on Polygon Edge - Insert a new point on the closest edge
• Shift + Drag - Box select multiple points
• Delete Selected - Remove all selected points at once

Map Tools

Tool	Shortcut	Description
Snap to Grid	G	Snap points to 10-unit grid (shows grid overlay)
Show Distances	D	Display distance labels between adjacent points
Undo	Ctrl+Z	Undo last action
Redo	Ctrl+Y	Redo last undone action
Search Location	Ctrl+F	Jump to specific X, Y coordinates
Jump to Player	Button	Center map on your current position

📦 Installation

1. Download the latest release (ZIP, NOT SOURCE)
2. Ensure ox_lib is started before sd-zonecreator
3. Add sd-zonecreator to your resources folder
4. Add ensure sd-zonecreator to your server.cfg

---

🛠️ Usage

Opening the Zone Creator

Use the command to open the zone creator interface: (it's locked to group.admin)

/zonecreator

Creating a Zone

1. Click on the map to place zone points
2. Add at least 3 points to form a polygon
3. Adjust the zone name, thickness, and ground Z as needed
4. Use "View Zone" to preview your zone in-game with a 3D camera

Exporting Zones

Click any of the export buttons to copy the zone data to your clipboard:

Format	Description
PolyZone	Full PolyZone.Create code with all parameters
ox_lib	Full lib.zones.poly code for ox_lib
vec2	List of vector2 coordinates (x, y)
vec3	List of vector3 coordinates (x, y, z)

Importing Zones

1. Click the "Import" tab
2. Paste existing zone code (supports PolyZone, ox_lib, or vector formats)
3. Click "Import Zone" to load the zone for editing

Zone Viewer Controls

When viewing a zone in 3D:

Control	Action
W A S D	Move camera horizontally
Q / E	Move camera up / down
Mouse	Look around
Shift	Sprint (faster movement)
Arrow Up / Down	Adjust zone thickness
Backspace	Exit viewer and return to map

---

🎨 Export Examples

PolyZone Output

local myZone = PolyZone:Create({
    vector2(100.0, 200.0),
    vector2(150.0, 200.0),
    vector2(150.0, 250.0),
    vector2(100.0, 250.0),
}, {
    name = "myZone",
    minZ = 25.0,
    maxZ = 175.0,
})

ox_lib Output

local myZone = lib.zones.poly({
    name = "myZone",
    points = {
        vec3(100.0, 200.0, 30.0),
        vec3(150.0, 200.0, 30.0),
        vec3(150.0, 250.0, 30.0),
        vec3(100.0, 250.0, 30.0),
    },
    thickness = 150,
    onEnter = function(self)
        print('Entered', self.name)
    end,
    onExit = function(self)
        print('Exited', self.name)
    end,
})

vector2 Output

vector2(100.0, 200.0),
vector2(150.0, 200.0),
vector2(150.0, 250.0),
vector2(100.0, 250.0),

vector3 Output

vector3(100.0, 200.0, 30.0),
vector3(150.0, 200.0, 30.0),
vector3(150.0, 250.0, 30.0),
vector3(100.0, 250.0, 30.0),