Touch PiShock
Developer Notice March 24, 2025.
Gumroad has flagged this listing for violating a guideline, with no statement as to what.
> Update: At the time of writing this, the listing was re-published. Happen to notice this on the Products page before Saving Changes here.
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.
YOU determine the intensity, duration and cooldown.*
*Pending use of...
"Just show me how to install!" Merry Christmas! https://youtu.be/LquMvNO-Le8
Released about 1 week before VRCOSC v2 came out. Video is still 90% accurate, file structure has changed.
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 Feb 2025:
I'm going to keep this short, a lot...has happened over the last few months IRL. 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. (Updated Feb 11, 2025)
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, Hot Potatoe
- 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...
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 the same Shocking experience! - 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... 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.
- Visual Edition: Blinks Green=Shock, Blue=Vibrate
- 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 inmindtesting, but oddly mixed results.
- 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.
Solo Touch-PiShock (Visual) as Main Menu, with Accessories sub-menu for Accessories Grabby and Randomizer.
Parameters:
- Core/Plain PiShock Edition:
- 1 Parameter Point! (Toggle On/Off) That's Right! All actions are All Local!
Per PiShock/Multi-Point Contact. Up to 8 Parameter Points for a full 8PiShock setup.
- 1 Parameter Point! (Toggle On/Off) That's Right! All actions are All Local!
- Visual Editions:
- 12 Parameter points per Touch-PiShock.
Necessary for others to see the Visual animations. (11 in Parameters file, 1 for toggle).
- 12 Parameter points per Touch-PiShock.
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.
- Sir Gwa's Shock Collar, https://sirgwah.gumroad.com/l/GwahShock, is the next prop coming up, in due time.
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...
- Import VRCFury. https://vrcfury.com/
I may make a non-VRCFury version in the future, setup without is otherwise simple to adapt. - Import Poiyomi v9+
- (Suggested) Import Lolatron's model, preferably first.
Core/Plain Edition: No special shaders required.- 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.
- Dev Note - If Prop Appears Pink:
- Import Touch-PiShock.
Then...
- If using more than one PiShock:
Drag the "Touch-PiShock Central Command (VRCFury)" to the root of your avatar.
This grants quicker controls to adjust 2 or more PiShocks at the same time, using the same settings across them all. - Add each Touch-PiShock Prefab to your avatar armature.
Each numbered based on VRCOSC Group. PiShock SOLO/00 is Group 0. - Resize, shift, and rotate 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. Includes use/placement of Accessories Grabby and Randomizer
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.
- Log into PiShock, 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
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: How do you change the Cooldown time?
- As of Version 4, the Cooldown options are now in their own menu. Currently 1 to 15 seconds. No 0seconds due to limitation of animator hops using VRC Avatar Parameter Drivers.
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!
- Example: Shock Intensity
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!)
- v4.01 - NeKoob Solo Touch-PiShock (VISUAL) + Accessories: https://vrchat.com/home/avatar/avtr_6073fa38-70f1-4d30-a2c9-af1b1e011337
NeKoob Solo Touch-PiShock (CORE): https://vrchat.com/home/avatar/avtr_2e6fd8fa-5ec7-43b6-901b-99adabf64aba - NeKoob Multiple Touch-PiShocks: 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.
- March 1, 2025 - Update VE 4.1.1 / CE 4.5.1 - VRCOSC v2
- This is a mixed update, as I'm mid feature add. Core Edition has Noseboop accessory. Details on the downloads page. In short, no different, just no prop, and adjusted to better use with other Touch-PiShocks. Only on Core Edition at this time, Visual Edition soon to come, just a tad more complicated.
- Bug Fix: I renamed "PiShock/SetAllBoth" to "PiShock/SetothIntDur", and the animator didn't catch the memo, entirely. One of the Parameter Drivers didn't know, and the field was left "blank". Resolved.
- Adjusted "button" menu options as Toggles, to better show when the change request has started (circle arrows spinning), and completed (circle arrows vanish).
- Renamed the IntDurCooldown menu files to just IntDur, as Cooldown has its own menu.
- Feb 24, 2025 - Update 4.1 - VRCOSC v2
- Important: Bug fix for Central Command prefab. This was forgotten during the initial Cooldown menu revamp. Fixed, and syncs across 2-8 PiShocks.
- Re-Revamped the MENUS for Cooldown. No longer 2 pages of 15 options. Now you can Increase/Decrease on the fly.
- Re-done the forced OSC Intensity sync on Avatar Load. Local tests appear to be working, and it's fast enough to not cause any issues. Included a "Red/Cooldown" on start, in the event some of you decide to have the PiShock enabled by default when the Avatar Loads.
- Feb 15, 2025 - Update 4.01 - VRCOSC v2
- Updated menus to move Beep into a static Accessories sub-menu. Resolves the random "Next" sub-menu appearing upon adding an Accessory.
- Multi-Point prefab menus updated to match current (and currently released) menu arrangement, and cooldown selection menus.
- Some images above have been updated!
Multiple-Touch-PiShocks and Multi-Point images to be updated soon! - Visual and Core (Solo) NeKoob Public Avatars updated.
Visual Edition public avatar has Grabby and Randomizer Accessories. - Russian Roulette accessory has been temporarily set aside for a time I can focus, and live test, more effectively.
- Feb 11, 2025 - Update 4.0 - VRCOSC v2
- Quick change to allow the new (not just yet released, testing) accessory, Grabby.
- Cooldown customization, while in VRChat, is now here! Clunky, testing one menu idea, before diving into testing a second.
- Cleared out the confusing "solo" prefab, with no "00" in the name. A first accessory concept I yet to finish, due to game mechanic limitations in VRChat. May return to Ranged PiShock another time, when I can better understand use of "ammo" without using particles.
- Included Readme has been updated! Finally, right? The last 2-3 months, IRL, has been busy and stressful. I hope this update, and the new accessory, does well for everyone.
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
The PiShock Touch without the links.