(see 1 picture)

The Colshape Studio is an in-game tool to create, position, resize, save and manage collision shapes (colshapes) directly inside MTA, visually — no need to work out coordinates by hand.

With it you can:

- Create collision Cuboids (boxes) and Spheres by looking at the world.
- Adjust position, size/radius and height with keys, using an orbit camera, zoom and "box zoom".
- Save a collision to a file (`data/collisions.txt`) — it becomes active on the server and is reloaded when the resource starts.
- Automatically copy the code (`createColCuboid(...)` / `createColSphere(...)`) to the clipboard, ready to paste into another script.
- Use a Manager to list, re-edit and delete collisions you already created.
- Enjoy a multi-language UI (English default, Brazilian Portuguese and Spanish) with a flag dropdown in the menu.

> In short: a WYSIWYG colshape editor for mappers and developers who need to place collision zones/areas precisely.

### How to use

Commands

| Command | Action |
|---|---|
| `F6` or `/editcol` | Open the menu (choose Cuboid/Sphere and language) |
| `F7` | Close the menu / cancel editing |
| `/showcol` | Collision visualization |
| `/colview on` \| `off` | Toggle collision visualization |
| `/coledit_lang en` \| `pt-br` \| `es` | Switch language manually |

Editing controls (side HUD)

Arrows = size · Numpad = move · `Ctrl+Z` = undo · `Shift+L-Click` = box zoom · `V` = reset focus · `M` = mouse/list · `G` = grid · `F` = snap to ground · `R` = reset to player · `B` = teleport (top/bottom) · `Ctrl+Scroll` = rotate · `R-Mouse` = orbit · `Scroll` = zoom · `H` = hide UI · `ENTER` = save and copy · `SPACE` = cancel.

### Requirements

- MTA:SA 1.5.3+.
- Functions that require it: `getLocalization()` (language auto-detection) and `setClipboard()` (copy code).
- ACL: to save/delete collisions on the server, the player must be logged into an account in the `Admin` ACL group.

### Structure

```
coleditor/
├─ meta.xml
├─ language/ # i18n: lang.lua (core) + en/pt-br/es
├─ client/
│ ├─ core/ # state.lua, camera.lua
│ ├─ editor/ # controls.lua, editor.lua
│ ├─ ui/ # render.lua (HUD), menu.lua (F6)
│ └─ input/ # binds.lua
├─ server/server.lua # saves/loads/syncs collisions
├─ ui/images/ # cuboid.png, sphere.png, flags/ (gb, br, es)
└─ data/collisions.txt


To add a new language: create `language/<code>.lua` (`Lang.register("<code>", { ... })`), register it in `meta.xml`, add the flag to `ui/images/flags/` and an entry in `Lang.available` in `lang.lua`.


Colshape Studio — create, move, resize, save and manage collision shapes (ColCuboid / ColSphere) visually, in-game. Orbit camera, zoom and box-zoom, grid snapping, undo, and a built-in manager to re-edit or delete saved shapes. Saved collisions are written to `data/collisions.txt`, loaded on resource start, and the generated `createCol...` code is copied to your clipboard. Multi-language UI (English / Português-BR / Español) with a flag dropdown and auto-detection. Open with F6 or `/editcol`. Saving/deleting requires the Admin ACL group.

...

(more)