Weapon Slash

A movement based weapon effect trigger system

⬇️ Download Latest Version

📦 Add to VRChat Creator Companion

---

How it works

• A polar-limited PhysBone creates an offset for a Contact system to play animations when a slashing motion is done with your arm.
• A networking layer animates a separate PhysBone hierarchy to account for IK smoothing.

Install guide

https://github.com/VRLabs/Weapon-Slash/assets/76777936/129c37e9-101d-4a30-854e-00c03a01016c

• Download and import Cancerspace shader.
• Merge the Animator Controller Weapon Slash FX to your own FX Controller, using the Avatars 3.0 Manager tool.
• Merge the Expression Parameter List Weapon Slash Parameters to your own Expression Parameter List, using the Avatars 3.0 Manager tool.
• Drag & drop the Weapon Slash prefab into the base of your Hierarchy.
• Right click and unpack the prefab, then drag & drop it onto your avatar.
• Expand the prefab hierarchy and find Weapon Slash -> Weapon
• Move Weapon outside of Weapon Slash and place it on the left or right wrist of your avatar.
  • Adjust the position and rotation of Weapon to fit into your hand.
  • You can replace Weapon -> キューブソード with your own prop. Keep your prop in the same placement and facing the same way as the default prop.

Note

When building for Quest, you will have to remove unsupported components and shaders. The particle systems provided in the package rely on shaders not supported by VRChat, so you will have to create your own effects.

How to use

• WeaponSlash/Control parameter must be True for the system to be active.
• WeaponSlash/HeavyActive parameter must be True for the Heavy Slash to be enabled.
• Under the Weapon Slash/Effects/(Light or Heavy) Slash hierarchy are Containers. Place custom effects within these Containers. Weapon/(Light or Heavy) Effect Target is where these effects will appear.
• You can edit Weapon Slash/Dynamics/PhysBone to change the force required for the slash. For further adjustment you can also change the radius of Weapon Slash/Dynamics/Receiver.

Performance stats

System:

Constraints:        12
Constraint Depth:   5
Contact Receivers:  2
Contact Senders:    2
FX Animator Layers: 4
Parameter Memory:   3 
Phys Bones:         2

Default Weapon:

Material slots:     2
Mesh Renderers:     2

Default Effects:

Audio Sources:      7
Particle Systems:   11

Hierarchy layout

Weapon Slash
|-Dynamics
|  |-PhysBone
|  |-Receiver
|  |-Remote
|  |  |-PhysBone
|  |  |-Receiver
|-Effects
|  |-Light Slash
|  |  |-A
|  |  |  |-Container
|  |  |  |  |-Particle System
|  |  |  |  |-Audio
|  |  |-B
|  |  |  |-Container
|  |  |  |  |-Particle System
|  |  |  |  |-Audio
|  |  |-C
|  |  |  |-Container
|  |  |  |  |-Particle System
|  |  |  |  |-Audio
|  |-Heavy Slash
|  |  |-Weak
|  |  |  |-A
|  |  |  |  |-Container
|  |  |  |  |  |-Particle System
|  |  |  |  |  |  |-Particle System
|  |  |  |  |  |-Audio
|  |  |  |-B
|  |  |  |  |-Container
|  |  |  |  |  |-Particle System
|  |  |  |  |  |  |-Particle System
|  |  |  |  |  |-Audio
|  |  |  |-C
|  |  |  |  |-Container
|  |  |  |  |  |-Particle System
|  |  |  |  |  |  |-Particle System
|  |  |  |  |  |-Audio
|  |  |-Strong
|  |  |  |-Container
|  |  |  |  |-Particle System
|  |  |  |  |  |-Particle System
|  |  |  |  |-Audio
|-Weapon
|  |-キューブソード
|  |  |-Blade
|  |  |-Hilt
|  |-Light Effect Target
|  |-Heavy Effect Target

Contributors

• lin

License

Weapon Slash is available as-is under MIT. For more information see LICENSE.

​