Touch-PiShock

Product Description

Jinxxy is my secondary store. Gumroad, for now, is my main store, for now for pre-release/beta updates.
Jinxxy, unless otherwise changed, will be my go-to store in the event Gumroad decides a PiShock is too adult for their store guidelines.
Gumroad search results (sort by new) are flooded with AI jank and spam. My store page has been taken down at least 3 times at this point.

Editor Note: As V5.5 has rearranged some menus, the images below are a "tad out of date", but otherwise the same.

Quick Project Updates:

Update July 29, 2025: Version 5.5 released. Due to the growing complexity, and trouble reports from users, I've split the download into Two Options.
- SOLO (single PiShock, or single PiShock Group).
- 00-11 PiShocks (for multiple PiShocks/Groups up to 12).
Both can be imported and not conflict with one-another.
Core/Plain edition not, yet, updated. Currently in progress. Taking it slow this week, as I anticipate last minute bug reports.
Aiming for this weekend for the Core/Plain update release.

No More Sharing Links!

When (most) everyone is just an arm length, and a touch, away?

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!" https://www.youtube.com/watch?v=DWyyiR6LZmA
Updated May 14, 2025. From Import to VRCOSCv2 PiShock Module Setup.

Requirements:

VCC and Unity basic knowledge.
Uploaded avatar without errors.
VRCFury (Free!) and Poiyomi Toon (Free!)
VRCOSC v2 (Application, Free!)
With the PiShock Module setup with your account and working.

Flexibility for Your use and style!

Doesn't matter if you have 1 PiShock, or the max of 8* PiShocks!
*Note: PiShock Hub capped at 8 Physical PiShocks

Solo PiShock with Three Contact Points...
One Prop, One Contact Point, all the same Shocking experience!
On PiShock 00/Solo:
Optional Two additional Contact Receivers for Touch-PiShock accessories of other players to interact with.
Multiple Touch-PiShocks, one for each Physical PiShock on your person.
Or mix it up with multiple PiShocks on each individual (VRCOSC v2) PiShock Group!
Equal Props to Contact Points, each with their own control/cooldown.
Or... Solo PiShock with multiple Contact Points! Multi-Point.
One PiShock, Multiple Contact Points.

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:

Main Menu

Controls for either...
- Solo PiShock. Intensity, duration, toggle between shock/vibrate, Cooldown in Seconds menu, beep, and self touch activation, and toggle said PiShock on/off.
- If multiple PiShocks (2 or more), Central Command to control all PiShocks with the same setting, as well as a disable-all safe off button.
Multi PiShocks: Select which Touch-PiShock to adjust.

Solo Touch-PiShock (Visual) Main Menu. - Becomes Sub-Menu, per Touch-PiShock, if 2+ Touch-PiShocks prefabs in use.

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.
Cooldown Menu of 1-15seconds cooldown. (Saved)
- 1second minimum is an Animator (not me, in Unity) limitation. Any animator hops with VRC Avatar Parameter Driver, each have their own delay which I cannot reduce, though set to 0 on each.
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.
Controls for Intensity and Duration of each PiShock individually.
- 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, but oddly mixed results.
  June 26: Version 5.5 has this resolved, and confirmed. Release pending at time of writing.

Solo Touch-PiShock (Visual) as Main Menu, with Accessories sub-menu for Accessories Grabby and Randomizer.

Parameters:

Core/Plain PiShock Edition:
- 1 (PiShock 00/Solo through 07) Synced Parameter Points!
  That's Right! Other than toggles for interaction, all actions are All Local!
  Per PiShock/Multi-Point Contact. Up to 8 Parameter Points for a full 8PiShock setup.
Visual Editions:
- 14 (PiShock 00/Solo) or 13 (PiShock 01-07) Synced Parameter points per Touch-PiShock.
  Necessary for others to see the Visual animations, in accurately synced time.
Note: Hitting the Parameter Count Cap?
VRCFury's Parameter Compressor Component has worked well for my avatars. Worth trying yourself. Mileage may vary.

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, but discontinued).
Edit: Lolatron is moving off Gumroad. Used .blend parts exported as (included) .fbx for this project.

Planned:
- Push Button (Ex: Easy Button)
- Holographic "panels" to place near any prop you decide.
- Activation Particles

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.

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://www.youtube.com/watch?v=DWyyiR6LZmA
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...

Import VRCFury. https://vrcfury.com/ (VCC Friendly)
I may make a non-VRCFury version in the future, setup without is otherwise simple to adapt.
Import Poiyomi Toon v9+ (Free!) (VCC Friendly)
Import Touch-PiShock.

Then...

Drag the preferred prefabs for your use case.
- If only one Physical PiShock - Use the SOLO prefab.
  - PiShock 00 SOLO is Group 0
- If using Two or More Physical PiShocks:
- 1. Within Subfolder "More-Than-1-Physical-PiShock", each numbered based on each VRCOSC Group.
    - PiShock 00 is Group 0. PiShock 01 group 01, and so on...
  2. Drag the "Touch-PiShock Central Command (VRCFury)" prefab to the Root of your avatar (menu management)
    - This grants quicker controls to adjust 2 or more PiShocks at the same time, using the same settings across them all.
    - Two preference styles of the Central Command, menu listings as Clockwise or Counter-Clockwise.
Resize, shift, and rotate the prefabs as you see fit.

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

Touch-PiShock Visual Solo placement, identical for Core Solo, example. In image also includes use/placement of Accessories "Grabby" and "Randomizer".

Setup to use along side VRCOSC:

https://github.com/VolcanicArts/VRCOSC
Communicates OSC from VRChat, to your PiShock Hub, 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.
Avatar not talking to VRCOSC? Follow their documentations to clear the OSC Cache in VRChat.
https://vrcosc.com/docs/faq
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":

You're not alone, some confusion with pulling the Share Code from their PiShock.com account, to place into VRCOSC v2.

Dev note May 2025 - Does not appear to be any guide on setting up the PiShock Module in VRCOSC v2.
I'll look into making one sometime...

Log into PiShock.com, access your PiShock share settings (1).
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.
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

Dev Update Feb 2025:

I'm going to keep this short, a lot...has happened over the last half a year. Major work-life change, I'm still on my feet, and still not out of the woods.

Support is still fully available, please do keep in mind I work full time, parent, and time zones can be a pain.
Please be patient and I'll respond to you as soon as I can (usually same day).

Side goal updates to come. 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.
Add support for OpenShock
Accessories: LaserTag, Russian Roulette (WiP), Hot Potato
Done: Grabby, Randomizer, Multi-Point Touch (Revising)
Video Tutorials. "In Progress".
Basic Unity install is made, released Doc 8, 2024. Limited "Out of date" shortly later after VRCOSC v2 came out. Most is still current file structure has changed.
Not to forget updating the pictures on here. Yuck...

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?

Under the root of the Prefab, select "Touch-PiShock## (VRCFury)"
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: 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://vrcosc.com/docs/faq, 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.
Use of VRCFury's Parameter Compressor Component, placed on the root of your avatar
This has resolved uploading the NeKoob Multi-PiShock to have 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!)

v5 - NeKoob Solo Touch-PiShock (VISUAL) + Accessories: https://vrchat.com/home/avatar/avtr_6073fa38-70f1-4d30-a2c9-af1b1e011337
v5 - NeKoob Multiple Touch-PiShocks: https://vrchat.com/home/avatar/avtr_fcf48f32-8698-4d4d-ae79-9c9283de00d 8
NeKoob (Works, v4.1) Multi-Point Touch-PiShock: https://vrchat.com/home/avatar/avtr_edd400fb-f93e-4a7b-b37c-d0c6066d0d2 a

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

Other Notes:

Default OSC Parameters in VRCOSC v2 PiShock Module:

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.

July 21, 2025 - Touch-PiShock v5.5 PreRelease01

This update took longer than anticipated, due to personal life events and personal health (nothing major, just work/parenthood draining me down before personal time).

PreRelease 01 Changelog:

- Duration Selection menu has been the main focus. Similar to Cooldown.
  Most of the time spent troubleshooting, only to realize I forgot, when it comes to most programming situations, counting starts at 0, not 1. So, in the event of the VRCOSC PiShock Module having 1-15 seconds, I had to think, in %/FLOAT with 0% = 1second, and 100% - 15seconds.
  Yea, I'm still laughing about this simple overlook.
- Side Note: These menu additions create no additional to (saved) parameter count. All are local, and does not increase your use.
  IF in the event you find having one too many PiShocks push your avatar beyond the Parameter Count limit, VRCFury's Parameter Compressor is recommended (test!!!, might break something else).
- Fixed: Props sometimes appearing on avatar, while menu is displaying Disabled.
  Though the prop was displayed, the asset is otherwise "disabled". Touching does nothing until Enabled.
- Fixed: PiShock 06 not setup correctly during a prior update. Coding/setup errors on my part.
- All Group PiShocks, 00/Solo through 11, have been updated with the same selection menu.
  Central Command has been updated to reflect this.
- Central Command menus have been redone. Not likely my final arrangement.
  Side note: I should really begin looking into Menu Icons...
- PiShock groups upped from 8 Groups (00-07) to 12 Groups (00-11).
  Visual Edition will have 12 Groups, while Core will be limited to 8.
- Typos in various cosmetic names, namely menus.

PreRelease 02 Changelog:

- Corrected overlooked updates to Central Command's parameters. Now it syncs the Display Duration across the PiShocks, which will update their Duration parameters on their own.
- Adjusted Central Command and all PiShock prefab's VRCFury's "Global Parameters", to help keep everything in line.
- Addition: From my personal avatar work, I've included a fun features.
- - Visual PiShocks and Central Command now show and interact with Audiolink. On/Off per PiShock or All.
    On by default. Saved.
  - Blink Status has been overhauled. Instead of the Poiyomi Shader running the Blink animation, this has been moved entirely to Animation files.
    - One Emission layer color is adjusted, instead of two.
    - Easier to customize to your color preferences.
    - Allows adjusting the Blink Pattern. In this setup, 3 "rapid blinks" every 10 seconds.
- With the above Blink additions and changes, Blink has been moved to Accessories. As most users don't interact with this often, it's moved out of the main menu, making room and de-cluttering.
- Central Command's Pre-Set values for Intensity, Duration, and Cooldown are now saved to the avatar.
  (Not synced, doesn't count against the Parameter Count limit.)
- - Allows for pre-defining what All Groups should be ready to sync to, in the event all need to be moved back to one level at a moment's notice. A few asked for this, and doesn't harm anything.

NOTE: Randomizer Update has not been uploaded. Current release will conflict on Play/Upload!
When this is fully released, Randomizer's update will be uploaded.

Release July 29, 2025

No changes. Exporting as two different files now, to simplify user import and setup.
- Solo: Best for using One PiShock, OR, One Group of PiShocks.
  Has one VRCFury Prefab at the root of the folder. Drag onto your avatar, size/rotate/shift as needed. Upload. Off to the races.
- Pi00-11: Multiple Touch PiShocks. Using two or more PiShocks/Groups of PiShocks.
  In anticipation of users merging the two together, file structure has not changed. In the root folder has "More-Than-1-Physical-PiShock Prefabs Here" folder of Prefabs, for PiShocks 00-11 (12 total).
Core/Plain edition will be updated and released soon. Began this weekend, taking it slow and planning by this weekend. Anticipating last minute bug reports.

May 8, 2025 - Update v5 - The Rebuilt Update

- This update has had the Animations redone, and FX files rebuilt, mostly from scratch.
- Biggest difference? If you watch your VRCOSCv2 Log while the Touch-PiShock is activated, the Log updates Immediately now. The remainder of delay is with the internet and PiShock servers. Nothing more I can do.
  ...Until I make a OpenPiShock edition...
- Might just be me... Upon first use after launching VRChat and VRCOSCv2, it feels like there's a longer delay of activation, and noticeably shorter delay hence after.
- On-Load OSC sync for Intensity!
  Meaning, if you just logged into VRChat, and launched VRCOSCv2, the Intensity in VRCOSCv2 doesn't stay at 1% by default. When the Touch-PiShock FX first runs, it will Decrease-then-Increase 1%, forcing VRCOSCv2 to sync to your "saved" Intensity of that avatar.
  No more needing to move the Intensity Radial when you first log into VRChat, just to feel something the first time someone does touch your Touch-PiShock.
  (Soon, Duration will mimic the same!)
- Accessories Grabby and Randomizer has been updated to follow along with the changes.
- Refer to store page for Parameter count changes. Due to improvements for activation and timing, parameter count has increased. Core edition (once released) will have a single Parameter point increase, due to two sets of Toggles, one for the Prop (technically the whole prefab), and the Contact Receiver as it disables itself during the Cooldown phase.
- Cooldown can be reduced to 0. Will activate as fast as VRCOSCv2 can respond.
  >>> Careful! Anyone with multiple fingers and a fast waving hand, can spam you heavily! <<<
- PiShock 00/Solo "Accessory" related Contacts are now their own toggle.
  These Accessory Contacts are available for other people to create interactions. Personal projects related to this will soon to come. "Russion PiShock Roulette" has not been forgotten.

May 2, 2025 - Update 4.5Beta02

- I apologize to all, the first beta release was not listed normally, and created some rather unwanted confusion and headaches.
- For a Clean and Headache Free Update:
- - Please delete your current "Touch PiShock - Visual - LigerXT5)" folder, and reimport this.
  - Importing on top shouldn't cause issues, however as changes are made and old files linger, no conflicts should come up but a visual mess.
  - If you still have Lolatron's PiShock Unity Project folder in your project, this is now safe to delete.
- Beta2 has some adjustments, and cleanup of the, now considered, rush job of the last update release.
- - The Lolatron FBX export is now as it's own Prefab, to simplify standardized changes across the board. One change within the prefab will carry over to the Solo and Multiple
  - Quality Of Life (QOL) Change: Scale and Placement has been reset to default (0 or 1) on all Game Objects, including the Lolatron FBX Prefab, to 1, 0 placement and rotation.
    >>> NOTE: This will require redoing your Rotation and Size on your avatar.
    This is to simplify the arrangement of assets, including in the event a user replaced the Prefab with something else, and should not result in scaling confusion.
  - For this release, I've excluded the Multi-Point Touch-PiShock setup. I haven't dived in to update it yet.
  - The changes made to SOLO has been replicated to the Multiple PiShocks 00-07.
    Overlooked in the last update, Sorry!
  - Public Avatar for Solo has been updated accordingly, Multi-PiShock version of the public avatar will follow in a short while.
- ReUpload Beta02.1 - Fixed visual animations. When I moved Lolatron's Prop into a Prefab, it broke the Visual Animation. Solo and Multi-PiShock public avatars updated along side.

April 28, 2025 - Update 4.5Beta01

- A series of updates have been made, and trial testing yet another pre-set parameter for avatar loading the correct Intensity, instead of what VRCOSC (v2) last had, or default of 1% on VRCOSC's launch. This will likely be an ongoing issue. For now, anticipate the first shock from your avatar, after avatar-load, to either be 1%, or something different from a prior avatar load.
- For a Clean and Headache Free Update:
- - Please delete your current "Touch PiShock - Visual - LigerXT5)" folder, and reimport this.
  - Importing on top shouldn't cause issues, however as changes are made and old files linger, no conflicts should come up but a visual mess.
  - If you still have Lolatron's PiShock Unity Project folder in your project, this is now safe to delete.
Change Log:
- Fixed the missing menus for Cooldown on PiShocks 1-7. No idea how that file didn't copy over into each. Solo/00 was unaffected.
- Related to the Cooldown menu, fixed PiShocks 1-7 (Solo/00 was unaffected, again) not having a Cooldown Status or Minimum/1second Cooldown button.
- Multi-Point side-project has been moved to Accessories. No further changes at this time, shouldn't need any changes. Updated instructions to come!
- File Structure cleanup, as well as instructions updated and reduced.
  Due to a series of repeat questions and confusion, I've simplified the file structure of the import. 95% of users are using only 1 PiShock (at least, that's my observation!). Yet the SOLO named prefab wasn't utilized as intended. As well as the Central Command menu prefab when only SOLO is used.
- (MAJOR) Due to issues with the .blend file from Lolatron's project (store page no longer listing a download), I've exported the two pieces of the .blend file as a .fbx file. Long time needed, been waiting for Lolatron to re-release on Jinxxy or otherwise before making any adjustments to their own asset.
  Issue: If you didn't have Blender installed, the .blend file wasn't rendered, and used, in Unity.
- Project updated to adapt to the change to use Lolatron's PiShock as a .fbx, including Animator file updated (prior animations still in place, will later be cleared out). Reused the same Material and Image/Texture files as nothing changed otherwise.

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