https://github.com/vrlabs/rigidbody-launcher
Launch an object with collision against the world.
https://github.com/vrlabs/rigidbody-launcher
Last synced: 9 months ago
JSON representation
Launch an object with collision against the world.
- Host: GitHub
- URL: https://github.com/vrlabs/rigidbody-launcher
- Owner: VRLabs
- License: mit
- Created: 2022-01-08T16:34:22.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-04T20:41:54.000Z (over 1 year ago)
- Last Synced: 2025-09-07T06:33:46.981Z (9 months ago)
- Language: C#
- Homepage:
- Size: 32.4 MB
- Stars: 16
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Rigidbody Launcher
[](https://github.com/VRLabs/Rigidbody-Launcher/releases/latest)
[](https://github.com/VRLabs/Rigidbody-Launcher/blob/main/LICENSE)
[](https://img.shields.io/badge/Quest-Incompatible-red?logo=Meta)
[](https://unity.com/releases/editor/whats-new/2022.3.22)
[](https://vrchat.com/home/download)
[](https://discord.vrlabs.dev/)
[](https://patreon.vrlabs.dev/)
Launch an object with collision against the world
### ⬇️ [Download Latest Version](https://github.com/VRLabs/Rigidbody-Launcher/releases/latest)
### 📦 [Add to VRChat Creator Companion](https://vrlabs.dev/packages?package=dev.vrlabs.rigidbody-launcher)
---
## How it works
* A configurable joint is connected to a [world-constrained](https://github.com/VRLabs/World-Constraint) kinematic rigidbody and given velocity on the Z-axis.
* The joint has collision and stops against the world.
* A particle system under the joint dies with collision, causing a [particle stop action disable](https://docs.unity3d.com/ScriptReference/ParticleSystemStopAction.html), triggering a contact-driven parameter change.
## Install guide
https://github.com/VRLabs/Rigidbody-Launcher/assets/76777936/9f288264-7a4b-4790-b6c3-38a1180a3ea5
* Merge the Animator Controller ``Rigidbody Launcher FX`` to your own FX Controller, using the [Avatars 3.0 Manager](https://github.com/VRLabs/Avatars-3.0-Manager) tool.
* Drag & drop the ``Rigidbody Launcher`` prefab into the base of your Hierarchy.
* Right click and unpack the prefab, then drag & drop it onto your avatar.
* Move ``Rigidbody Launcher Target`` outside of ``Rigidbody Launcher`` and place it anywhere in your avatar's hierarchy. Adjust the transforms as needed.
## How to use
* Place the objects you want to to use inside ``Rigidbody Launcher`` -> ``Container``.
* Alternatively you can constrain the objects to ``Container``.
* ``RigidbodyLauncher/Control`` parameter must be true for the system to fire, and false to reset.
* To change speed, you can edit the ``Launcher Fire.anim`` animation clip and change the ``Target Velocity``. You need to use a negative value.
* You can also change the ``Maximum Force`` property under the ``X/Y/Z Drive`` sections of the ``Rigidbody Launcher/Kinematic Rigidbody/Collision`` configurable joint.
* Other properties of the joint on ``Collision`` are editable depending on the rigidbody motion you want to achieve.
* To launch the rigidbody perfectly straight, freeze rotation for XYZ on the ``Collision`` rigidbody (not the configurable joint), and set the X and Y motion on the ``Collision`` configurable joint as locked.
* This will make it so only Z-axis motion is possible.
## Performance stats
```c++
Audio Sources: 2
Colliders: 1
Constraints: 4
Constraint Depth: 4
Contact Receivers: 1
Contact Senders: 1
FX Animator Layers: 2
Lights: 1
Particle Systems: 1
Rigidbodies: 3
```
## Hierarchy layout
```html
Rigidbody Launcher
|-Container
| |-Cube
| | |-Point Light
| |-Collision Audio
| |-Fire Audio
|-Kinematic Rigidbody
| |-Collision
| | |-Box Collider
| | |-Contact
|-Rigidbody Launcher Target
```
## Contributors
* [lin](https://github.com/oofdesu)
## License
Rigidbody Launcher is available as-is under MIT. For more information see [LICENSE](https://github.com/VRLabs/Rigidbody-Launcher/blob/main/LICENSE).
[
](https://vrlabs.dev "VRLabs")
[
](https://discord.vrlabs.dev/ "VRLabs")
[
](https://patreon.vrlabs.dev/ "VRLabs")
[
](https://twitter.com/vrlabsdev "VRLabs")