No More Sharing Links!

(Most) Everyone in the instance can shock you!

Don't want specific people touching? Turn their Avatar Interactions off.

Downside? They can't choose how Intense or the Duration of the shock, you do!

"Just show me how to install!" Merry Christmas! https://youtu.be/LquMvNO-Le8

VRCOSC v2 - Dec 8, 2024 Release

Hey PiShock Users! Hope everyone's Christmas celebrations are coming together smoothly?
VolvanicArts released v2 of VRCOSC, at this time, some changes had been implemented since I first began testing v2 back in Aug. As my work-life balance has had a big change, I haven't had the luxury of time to branch out Touch-PiShock for v2. I will be working on this through Dec (I'd love to say this week, but as my track record hasn't been all that great).
For now, this only works on V1 of VRCOSC.

Update Dec 10, Touch PiShock 3.3 BETA01, for Visual Edition, is out.
As it's only beta, not detailing changes here, check the download page.
NeKoob Solo Touch-PiShock: https://vrchat.com/home/avatar/avtr_6073fa38-70f1-4d30-a2c9-af1b1e011337
NeKoob Multiple Touch-PiShock: https://vrchat.com/home/avatar/avtr_fcf48f32-8698-4d4d-ae79-9c9283de00d8
NeKoob Multi-Point Touch-PiShock: https://vrchat.com/home/avatar/avtr_edd400fb-f93e-4a7b-b37c-d0c6066d0d2a

Lolatron PiShock Prop - Nov 20, 24:

I've recently become aware the Lolatron model is no longer available to be downloaded, from their store page.
They are moving off Gumroad. They have given me permission to host their PiShock, it is available for download (free) after purchase of the Touch-PiShock (Free or Paid).

Dev Update Dec 9, 2024:

I'm going to keep this short, a lot...has happened over the last few months. I'm not going to go over my life story, like many in (USA???) society, work-life had to take an abrupt change. I'm still kicking, but hard to look more than a month out at a time. I'm working, I'm not without a job, just not nearly as steady of an income, so, more time for projects? Lol, Adulting and Parenthood.
Anyways...

• Support is still fully available, please do keep in mind I work full time, parent, and time zones can be a pain.
  I'm looking for someone to assist with the Discord server, a mod with experience on the permissions. I've got things setup, however user stress-free use of the server isn't going well. lol

Please be patient and I'll respond to you as soon as I can.

I'm not going to give any ETA on anything.
Things to come, more details on the Discord server's To-Do list channel.

• New prop in the works from SirGwah. He's added in the ability for others to "pull" and set the Intensity, before shocking.
  In progress: It's in, been using it myself, however the Shock_IsGrabbed and Shock_Stretch are "not working" ingame. Once these work, it's ready.
• Update to VRCOSC v2, and OpenShock
  Thanks VoltanicArts!
• "Laser Tag", ranged zapping.
  It's "functional", but otherwise janky. It's more of a gimmick toy at this point. Might include in the next update as "testing".
  Included Oct 26, 2024 3.2.1 update. Though, no ranged weapon supplied, still looking. All gun like props I've found, use particles, which cannot have contact receivers attached...
• Video Tutorials. "In Progress".
  Basic Unity install is made, released Doc 8, 2024.
  I'm my own worst critique, I'm not giving up, but eventually I'll have something out soon enough...I just need to kick Porky Pig out of my verbal speech...
• Not to forget updating the pictures on here. Yuck...

Flexibility for Your use and style!

Doesn't matter if you have 1 PiShock, or the max of 8 PiShocks!

• Solo PiShock with one Contact Point...
  One Prop, One Contact Point, all Shock!
• Multiple Touch-PiShocks, one for each PiShock on your person.
  Or mix it up with multiple PiShocks on each Touch-PiShock Group!
  Equal Props to Contact Points, each with their own control/cooldown.
• Or... (NEW!) Solo PiShock with multiple Contact Points!
  One PiShock, Multiple Contact Points, all share cooldown.

Two tiers to pick from. Core Function only, or Function + Visual Animations.

• Core Edition is great for use with your choice of props, or no prop!
  No harm to the setup for using your choice prop, or none.
  Custom button? Noseboops? Frayed wiring on your robotic arm?
• Visual Edition is a little different. Setup is 99% identical.
  Per prop pre-setup animations and material files. (More choices to come!)

Each PiShock's Menu:

*Dev Update Note Aug '24:
New menu arrangement incoming, easier to manage multiple PiShocks, easier on the eyes.
Credit to VRCFury's menu priority arrangement!

Main Menu

• Controls for Intensity and Duration of all PiShocks (VRCOSC Limitation). (Saved)
  • Bug Note: Recently found out, VRCOSC sees the default 1% of Intensity/Duration on first launch, you will have to change and return your Intensity/Duration hand radials for VRCOSC to accurately know.
    I have a fix in mind testing, introduced in July 28's update, v3.12.
• Multi PiShocks: Select which Touch-PiShock to adjust.

Secondary Menus - Selection of Touch-PiShock 00-07:
If only one (Solo) PiShock, below options are merged with the Main Menu.

• Toggle On/Off (Show/Hide). (Default: Off on avatar load)
• Toggle between Shock or Vibrate, for when touched. (Saved)
  • Visual Edition: Blinks Green=Shock, Blue=Vibrate
    Adjustable in Material Shader Options.
• Toggle 10second Cooldown. (Saved)
  • Adjustable within the animation layer. Looking into control within game or easier in Unity.
    Remember to reduce by 1.5Seconds for best accuracy.
• Touch and Beep options to confirm OSC Communication/Functionality.
• Blinker control. (Visual Edition Only) (Saved)
  • Don't let the Blue/Green flashes be a distraction, freely turn them off!
  • Red cooldown display will continue to show when activated and on cool down.

Radial Menu text, "Vibrate=Off - Shock=On" formatted better in VRChat.

Note: Placement of 00-07 depends on which and how many prefabs are added. Update version 3.2 resolves the arrangement.

Parameters:

• Core/Plain PiShock Edition:
  • 1 Parameter Point! (Toggle On/Off) That's Right! It's All Local!
    Per PiShock/Multi-Point Contact. Up to 8 Parameter Points for a full 8PiShock setup.
• Visual Editions:
  • 12 Parameter points per Touch-PiShock.
    Necessary for others to see the Visual animations. (11 in Parameters file, 1 for toggle).

Multi-purpose, any Avatar or Prop can be used.

Initially designed around, and suggested to use, Lolatron's PiShock model, found
https://lolatron.gumroad.com/l/PISHOCK (Also Free!).
Edit: Lolatron is moving off Gumroad. Prop uploaded on download page with their permission.

• If you enjoy Lolatron's Pishock Model, please consider paying for it!
  Looks great, and has far more prop accessories available than what's used/seen here.
  Prop's strap not used with this prefab, just the PiShock and Spacer. Blender required to add in Strap.
• Planned:
  • Sir Gwa's Shock Collar, https://sirgwah.gumroad.com/l/GwahShock, is the next prop coming up, in due time.
    Sir Gwa is revamping/making a better prop.
  • Push Button (Ex: Easy Button)
  • Holographic "panels" to place near any prop you decide.

More props additions to come. Working on the functional concepts first.

Visual Editions!

Yes, there's a bit more than meets the eye! Anyways, visual ques to show the state of the PiShock. Either it being Shock or Vibrate, now you they can't lie which mode it's in, and a Activation/Cooldown signaling.

Familiar with Poiyomi? I can't stop you, but go crazy changing it up how you want! All texture and the material files are shared, pending supported props. At this time, only Lolatron's PiShock model is in use. Material with Poiyomi v9+ setup included, just drag onto the Lolatron PiShock and Spacer.

• You must have the prop already in your project for these files to work.
• You must drop the provided, respective to prop, Material onto the prop for the Visual aspect to take hold.

Better quality pictures to come. Unity render view isn't the best... Green/Blue are "held" for photo reasons, normally blink their color once every few seconds. Red only appears when activated, and fades when the cooldown clears.

Planned down the road, floating "hologram" emissions to be more compatible with what ever prop you so choose to use.

As Always: Backup your project before making changes.

Mistakes happen. Not all things that break can be explained, not all things can be as easily repaired. Backups are like game checkpoints.
I'm not responsible if somehow your avatar is broken. With or without VRCFury, these templates do not alter your avatar outside of adding more features.

Duplicate your avatar, disable the original, and import the prefabs on the cloned avatar. OR, backup your project entirely!

Installation:

Instructions included with download. Updated PDF with images to come. Video tutorials in the works.

Video: https://youtu.be/LquMvNO-Le8
Well, this is embarrassing. As soon as I released the video, VRCOSC v2 came out. Instructions are otherwise the same. No Int-Dur (or CommandCentral) menu prefab for the Solo PiShock use, CommandCentral took its place and necessary for 2-8 PiShock Setups.

Can be used anywhere on the avatar. Just...

1. Import VRCFury. https://vrcfury.com/
   I may make a non-VRCFury version in the future, setup without is otherwise simple to adapt.
2. Import Poiyomi v9+
3. (Suggested) Import Lolatron's model, preferably first.
   Core/Plain Edition: No special shaders required.
   1. Dev Note - If Prop Appears Pink:
      Core/Plain: Use Lolatron's included "PIShockMat 1.mat", drag on top the PiShcok and Spacer
      Visual Editions: I've included my own "PIShockMat BlinkStatus.mat" for the emission animations.
4. Import Touch-PiShock.

Then...

1. Drag the "Touch-PiShock Int-Dur (VRCFury)" to the root of your avatar.
   Without it, you will have NO Duration or Intensity controls. Defaults to 1second for 1%.
2. Add each Touch-PiShock Prefab to your avatar root (FIRST!) to roughly adjust size.
   Each numbered based on VRCOSC Group. PiShock SOLO is Group 0.
3. THEN... Drag each Touch-PiShock## to your preferred locations on the armature.
4. Resize, shift, and rotate as you see fit.

(Editor Note: Use the included instructions for Multiple-Point Solo Touch-PiShock, setup is different.)

Image slightly dated, concept still exactly the same.

Setup to use along side VRCOSC:

https://github.com/VolcanicArts/VRCOSC to communicate OSC from VRChat, to PiShock, using the PiShock Module.

• Note: Please follow their wiki for best use. You must hit the Play button on the left bar, and again at the bottom, on VRCOSC Launch.

Also works as a great central OSC Router for other routers to connect through! Example: Haptics and Face-tracking.

• Avatar not talking to VRCOSC? Follow their documentations to clear the OSC Cache in VRChat.
  https://github.com/VolcanicArts/VRCOSC/wiki/FAQ#things-to-try-first
• Credit to VRCOSC of their own menu setup. My design formed off theirs.
  If you have conflicts with both VRCOSC's Menu Prefab and Touch-PiShock imported, contact me.
  Resolved in Touch-Pishock V3.12.

VRCOSC PiShock Module "Sharecode":

Some users have had some confusion with pulling the Share Code from their PiShock account to place into VRCOSC.

1. Log into PiShock, access your PiShock share settings (1).
2. Create a Code (2). Your choice of limits, VRCOSC will cap out with what you place, or, leave it open and control it in VRCOSC and the hand menus. Think of it like the volume knob on your physical speakers, as well as your PC's volume control.
3. Copy the Code (3), paste the link into Notepad or otherwise, and trim it down to the last segment after "="

   

Example Link: https://pishock.com/#/Control?sharecode=2D49EF05555

This is what you want(EXAMPLE!): 2D49EF05555

Questions:

Most of the below will be included in a tutorial video in the near future. (In Progress)

Q: Discord?

• Yes! Now released, though excuse the dust and adjustments to bring it up to speed. I bet it's not perfect, lol.
  https://discord.gg/gFARtjx2UT
  Forum support is "locked" behind Role approval. Agree to Rules channel.

Q: Don't like the prop? Want to use your own? No Problem! (Core/Plain Only!)

• While within Touch-PiShock Prefab, remove the objects under "Props Here", then add what you want, and adjust as needed.

Q: The touch area, the Contact Receiver, too small/big for the new prop?

1. Under the root of the Prefab, select "Touch-PiShock## (VRCFury)"
2. Under "VRC Contact Receiver (Script)" adjust the Shape area as you see fit.
   You will manually decide Sphere or Capsule of the "Shape Type", and adjust the floats of the Radius, Position, and Rotation. (Green Marks)

Green marks for question above, Red marks for question below.

Q: Need other Collision Detections, besides Finger/Hand?

• I've seen people want Mouth (not easy, but possible) and Feet to activate it, you can...
• Under the Red area (image above), select the drop downs to swap, or select the area near the drop downs to then select Delete, or Add to include other areas.

Q: How do you change the Cooldown time?

• Dev Note: I'm working through an easier, per Touch-PiShock, Radial Control for the time.

1. Within the respective FX file (Animation Layer file), select the line with three Arrows pointing to "Start" from "Reset.
2. Select the Second listing to the right under Transitions. Below that, Expand "Settings" if needed, and change 10 to how many seconds you wish.
   • Dev Note: Recently discovered the animator is adding more time, was closer to 12seconds. Exit Time is now 8.5seconds.
     Arrows pointing away from Shock/Vibrate are 0.5 due to occasional VRCOSC not catching the change before reset.
3. (Optional) though suggested for QoL, update the respective Menu file, Menu-Touch-PiShock##_Controls, rename "10Second Cooldown" menu listing, Only the Name of the menu listing, to show the seconds, or just rename to "Cooldown".
   Do not rename the Parameters themselves, unless you know what you are doing!

Image slightly dated, concept is still identical.

Q: Prefab is on the avatar, it's displaying, but Beep/Vibrate/Shock doesn't work?

• A number of things to try. Welcome to reach out. Please first check over https://github.com/VolcanicArts/VRCOSC/wiki/FAQ#things-to-try-first, namely clearing your OSC Cache in VRChat.

Q: VRCFury error about one or more parameter issue?

• Remember Each Touch-PiShock require Parameters. Visual=12, Core=1.
  Keep track of your parameter count. All 8 Visual Edition PiShocks can take 96 Parameter points, plus the two floats for Intensity and Duration.
• Public Test Squeak Warrior had to be trimmed down to accept all 8.

Q: Radial and VRCOSC Percentages don't line up? (WARNING! Math!)
> > > Know Your Limits! < < <

I do NOT take any responsibility for your mistakes of improper limit setup. No different than the PiShock Web Interface.

• Short: If you wish the in-game radials to be more accurate, set VRCOSC (PiShock Module) Max Intensity to 100%.
  Your radial dials for Intensity will line right up 1-for-1. 23% radial will then equal 23% Intensity Shock.
  • Comes at a risk, setting VRCOSC Max Duration and Shock to full can cause very unwanted effects if not managed ingame properly. Set your hard limits in VRCOSC, It's there for a Reason!
• The hand radials work as Percentages of what Max Allowed on VRCOSC.
  • Example: Shock Intensity
    If VRCOSC is set to Max 50%, and the in-game radial is set to 10%, that lands at 5% when you're shocked.
    VRCOSC left menu logs what intensity and duration hit you, this will give you an idea of what you're actually hit with.
  • Duration, like Intensity, I would recommend keeping a low limit for your safety, please!

Q: Public test avatar?

Public Avatars going through major updates. As VRCOSC v2 is released, OSC related compatibility issues.
Below are considered Beta Use, and to expect bugs! (Detail breakdowns to come soon!)

• NeKoob Solo Touch-PiShock: https://vrchat.com/home/avatar/avtr_6073fa38-70f1-4d30-a2c9-af1b1e011337
• NeKoob Multiple Touch-PiShock: https://vrchat.com/home/avatar/avtr_fcf48f32-8698-4d4d-ae79-9c9283de00d8
• NeKoob Multi-Point Touch-PiShock: https://vrchat.com/home/avatar/avtr_edd400fb-f93e-4a7b-b37c-d0c6066d0d2a

Play Safe.
Do Not Place Your Real Life PiShock Anywhere on your Real Life body that Can cause harm.

Other Notes:

OSC Parameters:

• VRCOSC/PiShock/Duration/*
• VRCOSC/PiShock/Intensity/*
• VRCOSC/PiShock/Shock/*
• VRCOSC/PiShock/Vibrate/*
• VRCOSC/PiShock/Beep/*

(Image preview removed, well out of date.)

Updates:

Older update logs included in the product download pages.

• Oct 26, 2024 - Update 3.2.1 (Visual Edition only)
  • Bug Fix: Red outline of Lolatron's PiShock edited emission was not changing (appearing and disappearing), was stuck on Red. Resolved.
  • Beta Testing: Ranged Solo. Though many here will not be able to put it to use, nor any instructions included, those who can poke at it for a few minutes and figure it out, I ask one thing. Can you find a ranged weapon that doesn't use just emitters/particles for the fired ammo? Best I've been able to do, is an "invisible" laser that appears when the weapon, say Liindy's Revolver, is fired.

• July 28, 2024:
  • Added: Multi-Point Solo Touch-PiShock. Multiple touch points, one PiShock.
  • Added: Duplicated Touch-PiShock 00 for SOLO use. Identical, merged the main and secondary menus.
  • Bug Fix(?), Still in testing: Forced update of the Intensity and Duration percentages on avatar load. Otherwise it falls back to 1% on both, requiring manual update of the radial choices, even though they appear to be fine, VRCOSC otherwise sees 1%.
  • Bug Fix: Menu/Parameters file overlap with PiShock OSC project, as I used it as a baseline way back in the beginning. If you happen to have said project, and import this, the two files would conflict. Should be resolved, per my tests. Only one person reported this odd bug.
• July 11th, 2024: Bug Fix. Visual Edition had a material issue which I cannot reproduce on my end, but is a consistency setup issue I should have caught before. Not everyone has this issue, one person reported. The Red Emission was not animating, nor toggled to animate while locked. The other two emissions are, hence the consistency bit.
• July 9th, 2024: Bug Fix. Core/Plain edition had a bug with the Int-Dur prefab, where the Menu and Parameter files didn't properly link into the VRCFury Full Controller module. If you're comfortable resolving this yourself, no need to update to this. Just open the prefab, select the root to see the VRCFury Full Controller component, clear Menu and Parameter listings, then add in the Menu and Parameters file from the Core Menus sub folder.

  

  
  

Refunds? None. Purely digital content. Very little is Unique/Special to warrant refunds.

Your misunderstanding of OSC is not a mistake of myself or of the project itself.
This was created with knowledge and experience, mind the learning, troubleshooting, and time spent.
I take no responsibility if this, some how, cause damage to your project, avatar, or a PiShock mishap. Backup your project, and practice safe PiShock habits.

Avatars in screenshots:

• NeKoob by Kuby: https://kuby.gumroad.com/l/Nekoob
• SqueakWarrior by Emperor of Mars - https://emperorofmars.gumroad.com/l/squeak_warrior