MTA:SA 3D Editor Resource (pAttach support)

Language: English | Čeština

Welcome to the MTA:SA 3D Object Editor Resource repository! This resource is designed to provide an easy-to-use tool for editing 3D objects within Multi Theft Auto: San Andreas (MTA:SA). Whether you're a seasoned MTA developer or just starting out, this resource aims to simplify the process of editing 3D objects on your MTA server.

Features

Intuitive Interface: The 3D Object Editor comes with a user-friendly interface that makes editing objects a breeze.
Real-time Preview: See your changes in real-time as you modify the object's properties.
Customization: Adjust object properties such as position, rotation, and scale.
Made a mistake: Undo and redo your edits, making sure you stay up-to-date with what you wanted.
Everything to your liking: Disable certain features if you feel like it.
Export Options: Deeply integrate the resource into your server per your liking.

Installation

Download the latest version of the resource from the Releases section.
Extract the downloaded archive.
Place the extracted folder in the resources directory of your MTA:SA server.
Add the resource to your server's configuration file (mtaserver.conf) under the resources section:
```
<resource src="3DEditor" />
```
Restart your MTA:SA server to ensure that the new resource is loaded and available for use.

Usage

Launch your MTA:SA client and join your server.
In any script, start by creating an object.

Afterwards, call the export with the element

Clientside Example

function test()
   local obj = createObject(935, 0, 0, 0)
   exports.3DEditor:startEdit(obj, [disableMoving, disableRotating, disableScaling])
end
addEventHandler("onClientResourceStart", resourceRoot, test)

Serverside Example (Make sure to use all arguments, where player defines the editor controller)

function test(player)
   local obj = createObject(935, 0, 0, 0)
   exports.3DEditor:startEdit(obj, disableMoving, disableRotating, disableScaling, player)
end
addCommandHandler("testing", test)

Use the editor's interface to create, edit, and manipulate 3D objects in real-time.
Once you're satisfied with your creation, use the save button.

A server and client event is going to be triggered, this is where you need to check for the (res) (and "client" if on the server) and apply your changes.

You can implement saving to MySQL/SQLite or just manipulate with the values however you please.

function listener(res, object, cx, cy, cz, rx, ry, rz, sx, sy, sz)
   if res == resource and source == player then
      saveFurniturePosition(player, object, cx, cy, cz, rx, ry, rz, sx, sy, sz)
   end
end
addEventHandler("3DEditor:savedObject", root, listener)

Contributing

Contributions are welcome! If you have ideas for improvements or new features, feel free to create issues or pull requests. Please follow the established coding and contribution guidelines.

License

This project is licensed under the GNU General Public License version 3.0.

Credits

Derbosik & Nando - Lead Developers
wavesk & Denas1 - Giving ideas for improvements

Special thanks to the MTA community for their support and inspiration.

We hope you enjoy using the MTA:SA 3D Object Editor Resource! If you encounter any issues or have questions, please don't hesitate to open an issue. Happy object editing!