https://github.com/Patrick2562/mtasa-pAttach

Optimized bone attach thanks to the new MTA functions/events.
https://github.com/Patrick2562/mtasa-pAttach

Last synced: about 2 months ago
JSON representation

Optimized bone attach thanks to the new MTA functions/events.

• Host: GitHub
• URL: https://github.com/Patrick2562/mtasa-pAttach
• Owner: Patrick2562
• License: gpl-3.0
• Created: 2021-04-06T20:49:34.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2023-07-17T16:47:55.000Z (over 1 year ago)
• Last Synced: 2023-10-20T22:16:36.565Z (about 1 year ago)
• Language: Lua
• Homepage:
• Size: 46.9 KB
• Stars: 28
• Watchers: 2
• Forks: 15
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mta-sa - pAttach - Optimized bone attach using new MTA functions/events. (Libs and utils)

README

        
# pAttach

Optimized bone attach thanks to the new MTA functions/events.

This resource doesn't match with well known bone_attach, you can not use the same parameters!

# Documentation

You can find the documentation on Wiki page. [(click here)](https://github.com/Patrick2562/mtasa-pAttach/wiki)

# Performance Comparison

\- There are not so much similiar resources but I will run some performance tests on them.

CPU usages (Ryzen 5 2600), streamed-in/out attached objects to a ped, on default MTA server with play gamemode.

| Objects count | pAttach (in_stream) | pAttach (out_of_stream) | attachToBones (in_stream) | attachToBones (out_of_stream) | bone_attach (in_stream) | bone_attach (out_of_stream) |

| :------------ | :-----------------: | :---------------------: | :-----------------------: | :---------------------------: | :---------------------: | :-------------------------: |

| 10 objects    |        0.63%        |            -            |           0.84%           |             0.15%             |          1.64%          |            0.17%            |

| 100 objects   |        4.56%        |            -            |           6.44%           |             0.38%             |         12.82%          |            0.43%            |

| 500 objects   |       28.87%        |            -            |          36.91%           |             1.36%             |         69.40%          |            1.62%            |

| 1000 objects  |       46.34%        |            -            |          61.62%           |             2.60%             |         113.12%         |            3.11%            |

# How to use

\- Server sided example to attach objects (parachute, weapon, hat) to player.

```lua

addCommandHandler("testattach", function(player)

    local backpack = createObject(371, 0, 0, 0)

    exports.pAttach:attach(backpack, player, "backpack", 0, -0.15, 0, 0, 90, 0)

    local weaponRight = createObject(356, 0, 0, 0)

    exports.pAttach:attach(weaponRight, player, "weapon")

    local weaponLeft = createObject(356, 0, 0, 0)

    exports.pAttach:attach(weaponLeft, player, 34, 0.02, 0.05, 0, 20, 190, 190)

    local hat = createObject(1265, 0, 0, 0)

    setObjectScale(hat, 0.5)

    exports.pAttach:attach(hat, player, "head", 0.1, -0.05, 0, 0, 90, 0)

end)

```



# Known issues

\- There are desynchronization problems when attaching a player to ped or player.