Skip to content

Commit f2e0401

Browse files
Fernando-A-RochaFernando-A-Rocha
authored
Merge pull request #39 from Fernando-A-Rocha/fixes-v4
Fixes
2 parents 44c5eb5 + 47f3261 commit f2e0401

File tree

9 files changed

+5529
-5485
lines changed

9 files changed

+5529
-5485
lines changed

‎.github/docs/custom_editor/README.md‎

Lines changed: 45 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,45 @@
1-
![Newmodels Map Editor Banner](https://i.imgur.com/ln6mrLr.png)
2-
3-
The Newmodels Map Editor Project consits of **🧬experimental🧬** customized MTA:SA Map Editor resources to support new model IDs for vehicles, objects and skins using newmodels ([mta-add-models Project](https://github.com/Fernando-A-Rocha/mta-add-models#readme)).
4-
5-
MTA forum thread: [link](https://forum.mtasa.com/topic/133212-rel-add-new-models-library/#comment-1003395)
6-
7-
## Support/Help
8-
9-
If you need help with anything related to this project, please read the corresponding section on the MTA forum thread linked above.
10-
11-
## Installation
12-
13-
1. Follow the instructions on the [New-Models Editor v3.1.0 release page](https://github.com/Fernando-A-Rocha/mtasa-resources/releases/tag/v3.1.0-newmodels-editor).
14-
15-
2. Make sure you installed `newmodels` & `newmodels-engine` which you can obtain from the [mta-add-models v3.1.0 release page](https://github.com/Fernando-A-Rocha/mta-add-models/releases/tag/v3.1.0).
16-
* Tutorial [here](/README.md#install).
17-
* Both of these are required for the New-Models Map Editor to work.
18-
* Make sure you have the right compatible versions of both resources installed.
19-
20-
3. Use **refresh** command in your server console to apply the resource changes.
21-
22-
## Usage
23-
24-
To use new models in your map, the editor needs to know which models have been added. The `models list` is stored inside XML files for objects, vehicles & skins in the `editor_gui` resource. We opted by not changing how the Map Editor reads these files, so it would be easier to update the Map Editor in the future.
25-
26-
The resource `editor_newmodels` is responsible for applying the new models to the editor GUI. It reads them from `newmodels` and adds the new models to the `models list` XML files.
27-
28-
This happens automatically when `editor_newmodels` is started. You can also use the command `/editor_newmodels` to force-update the models list.
29-
30-
You can place down new vehicles, objects and skins in your map. The editor script sets the element datas when spawning the elements.
31-
When saving the map, the element datas are saved in the XML file. When a map is loaded, it will set all those datas => setting the correct new model IDs.
32-
33-
This means that the map can be loaded on any server that has the same new models in their `newmodels` resource, not requiring the custom map editor which is just for creating the maps :-)
34-
35-
**Happy mapping!**
36-
37-
## Contributing
38-
39-
Want to help make this project better? See [this note](https://github.com/Fernando-A-Rocha/mta-add-models#final-note).
40-
41-
## Credits
42-
43-
* [Fernando](https://github.com/Fernando-A-Rocha)
44-
* [Rick](https://github.com/httpRick)
45-
* [MTA:SA Resources Contributors](https://github.com/multitheftauto/mtasa-resources)
1+
![Newmodels Map Editor Banner](https://i.imgur.com/ln6mrLr.png)
2+
3+
The Newmodels Map Editor Project consits of **🧬experimental🧬** customized MTA:SA Map Editor resources to support new model IDs for vehicles, objects and skins using newmodels ([mta-add-models Project](https://github.com/Fernando-A-Rocha/mta-add-models#readme)).
4+
5+
MTA forum thread: [link](https://forum.mtasa.com/topic/133212-rel-add-new-models-library/#comment-1003395)
6+
7+
## Support/Help
8+
9+
If you need help with anything related to this project, please read the corresponding section on the MTA forum thread linked above.
10+
11+
## Installation
12+
13+
1. Follow the instructions on the [New-Models Editor v3.2.0 release page](https://github.com/Fernando-A-Rocha/mtasa-resources/releases/tag/v3.2.0-newmodels-editor).
14+
15+
2. Make sure you installed `newmodels` & `newmodels-engine` which you can obtain from the [mta-add-models v3.2.0 release page](https://github.com/Fernando-A-Rocha/mta-add-models/releases/tag/v3.2.0).
16+
* Tutorial [here](/README.md#install).
17+
* Both of these are required for the New-Models Map Editor to work.
18+
* Make sure you have the right compatible versions of both resources installed.
19+
20+
3. Use **refresh** command in your server console to apply the resource changes.
21+
22+
## Usage
23+
24+
To use new models in your map, the editor needs to know which models have been added. The `models list` is stored inside XML files for objects, vehicles & skins in the `editor_gui` resource. We opted by not changing how the Map Editor reads these files, so it would be easier to update the Map Editor in the future.
25+
26+
The resource `editor_newmodels` is responsible for applying the new models to the editor GUI. It reads them from `newmodels` and adds the new models to the `models list` XML files.
27+
28+
This happens automatically when `editor_newmodels` is started. You can also use the command `/editor_newmodels` to force-update the models list.
29+
30+
You can place down new vehicles, objects and skins in your map. The editor script sets the element datas when spawning the elements.
31+
When saving the map, the element datas are saved in the XML file. When a map is loaded, it will set all those datas => setting the correct new model IDs.
32+
33+
This means that the map can be loaded on any server that has the same new models in their `newmodels` resource, not requiring the custom map editor which is just for creating the maps :-)
34+
35+
**Happy mapping!**
36+
37+
## Contributing
38+
39+
Want to help make this project better? See [this note](https://github.com/Fernando-A-Rocha/mta-add-models#final-note).
40+
41+
## Credits
42+
43+
* [Fernando](https://github.com/Fernando-A-Rocha)
44+
* [Rick](https://github.com/httpRick)
45+
* [MTA:SA Resources Contributors](https://github.com/multitheftauto/mtasa-resources)

‎[examples]/newmodels-engine/meta.xml‎

Lines changed: 29 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,29 @@
1-
<meta>
2-
<!-- This resource is available in the repository below.
3-
Its version now matches the main newmodels version!
4-
5-
https://github.com/Fernando-A-Rocha/mta-add-models -->
6-
7-
<info author="Fernando"
8-
name="newmodels Engine"
9-
description="useful functions to make good use of newmodels in your server"
10-
version="3.1.0"
11-
type="script" />
12-
13-
<include resource="newmodels" />
14-
15-
<!-- Main Script -->
16-
<script src="shared.lua" type="shared" cache="false"/>
17-
18-
<!-- Testing script (optional - you can remove it) -->
19-
<script src="testing_server.lua" type="server"/>
20-
21-
<!-- Exported Functions -->
22-
<export function="createObject" type="shared"/>
23-
<export function="createVehicle" type="shared"/>
24-
<export function="createPed" type="shared"/>
25-
<export function="createPickup" type="shared"/>
26-
<export function="setPickupType" type="shared"/>
27-
<export function="setElementModel" type="shared"/>
28-
<export function="getElementModel" type="shared"/>
29-
</meta>
1+
<meta>
2+
<!-- This resource is available in the repository below.
3+
Its version now matches the main newmodels version!
4+
5+
https://github.com/Fernando-A-Rocha/mta-add-models -->
6+
7+
<info author="Fernando"
8+
name="newmodels Engine"
9+
description="useful functions to make good use of newmodels in your server"
10+
version="3.2.0"
11+
type="script" />
12+
13+
<include resource="newmodels" />
14+
15+
<!-- Main Script -->
16+
<script src="shared.lua" type="shared" cache="false"/>
17+
18+
<!-- Testing script (optional - you can remove it) -->
19+
<script src="testing_server.lua" type="server"/>
20+
21+
<!-- Exported Functions -->
22+
<export function="createObject" type="shared"/>
23+
<export function="createVehicle" type="shared"/>
24+
<export function="createPed" type="shared"/>
25+
<export function="createPickup" type="shared"/>
26+
<export function="setPickupType" type="shared"/>
27+
<export function="setElementModel" type="shared"/>
28+
<export function="getElementModel" type="shared"/>
29+
</meta>

0 commit comments

Comments
 (0)