Skip to content

OSC Application to interact with games implementing OSC like VRChat and ChilloutVR

License

Notifications You must be signed in to change notification settings

OpenShock/ShockOSC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenShock Logo

ShockOSC

Release Version Downloads Discord

ShockOsc

Used as an interface for OpenShock to communicate with applications that support OSC and OscQuery like VRChat.

Setup

Wiki

Avatar contacts setup for VRC

  1. Add a new bool parameter to your avatars (animator & params file). Name template ShockOsc/{GroupName} e.g. ShockOsc/Leg
  2. Configure one or more contact receivers on your avatar
  3. Set it to constant and have it drive the designated parameter you have just created
  4. Upload
  5. Reset & Enable OSC

Avatar PhysBone setup for VRC

You can use physbones to trigger shocks with verifying intensity based on the distance the bone is stretched once it's released.

  1. Add a new parameter to a physbone component on your avatar with the same name as your shocker, e.g. ShockOsc/Leg
  2. Add a new float parameter called ShockOsc/{GroupName}_Stretch to your avatars animator & do NOT add to params file
  3. Add a new bool parameter called ShockOsc/{ShockerName}_IsGrabbed to your avatars animator & do NOT add to params file
  4. Edit IntensityRange in the configuration file to your liking

Visual parameters

You can add some optional parameters to your avatar to visualize when the shocker is active or on cooldown. Add these parameters to your avatars animator & params file.

  • bool ShockOsc/{GroupName}_Active enabled only while the shocker is active
  • bool ShockOsc/{GroupName}_Cooldown enabled only while the shocker isn't active and on cooldown
  • float ShockOsc/{GroupName}_CooldownPercentage 0f = shocker isn't on cooldown, 1f = shocker on cooldown (0f while shocker is active)
  • float ShockOsc/{GroupName}_Intensity 0..1f percentage value that represents how close the shock was to maximum intensity from IntensityRange (except for FixedIntensity)

Virtual Groups

You can use the virtual, or pseudo, shockers with the name _Any and _All for some limited actions. Read more below.

_Any
  • ShockOsc/_Any_Active is true whenever there is any shocker currently shocking
  • ShockOsc/_Any_Cooldown is true whenever there is any shocker currently on cooldown
_All

This one can be used to make all shockers configured go off at the same time or with the same trigger.
This virtual shocker behaves just like another configured shockers, except it relays its actions to all others.

Instant Shocker Action

You may append _IShock to a shocker parameter if u want a shock to trigger instantly when this bool parameter jumps to true. This is useful when working with an animator setup or have contact receivers trigger immediately.

E.g. ShockOsc/_All_IShock

Credits

ShockOsc Contributors