// Disclaimer: This HUB is provided to you as-is, it is meant as a tool to facilitate building PiShock integrations.
// You are responsible for your safety, be cautious. The creator of this product is in no way responsible for how you decide to use it.
// It is greatly recommended to set limits with your sharecodes, and to keep the web panel open to pause your shockers at any time
// Also, this is not an official plugin
This attachment is a HUB worn by the wearer/owner of PiShock devices. It acts as a bridge to simplify Pishock plugins and integrations.
With this, other avatars and objects are able to send commands to the wearer's avatar to request a Beep, Vibration or Shock without having to deal with API requests and authentication. As the owner of a pishock, all you need is to configure your settings in the HUB's notecard. This enables centralization of your configuration (configure once, use with as many scripts/toys as you like), and the use of your pishock by others without requiring them to make a pishock account. Only the owner of the pishocks needs an account and an ApiKey
It does not provide any functionality beyond what is described below. If you are getting this, it should be because a toy you own requires it, or because you will be doing some modding&scripting of your own:
- Easy integration:
- Any scripts on any avatar or in any object (provided they are authorized) are able to use the command syntax of this hub to send a simple shock request. With little editing required, it allows you to modify any of your toys (or enables creators to integrate with PiShock with ease).
- Using limits set in your share code, the HUB will never be able to trigger a shock beyond your limit. (This is a PiShock API feature)
- Messages are sent on channel -36879, the syntax of messages are SHOCKERLABELNAME|MODE|DURATION|INTENSITY
- Valid values are <string>|<shock/vibrate/beep>|<0-15>|<1-100>
- Multishocker use:
- Define one or multiple shockers to have one or multiple shocker commands fire at once.
- Reuse the same sharecode to enable both individual and group control of your shockers.
- Privacy modes:
- Private: Only yourself and defined users can send a shock
- Ask: Users defined in the notecard are allowed. You will be prompted to temporarily grant consent to any other user who tries to use your pishock.
- Public: Anyone can send a shock request, except users banned in the notecard config.
IM trishace resident in-world if you need assistance configuring the hub, want help creating plugins, or have feature requests.
Sidenote: If you have a PiShock account and access to someone else's shockers, it is possible to use this HUB on your avatar and send command to their PiShock via this HUB. This is frowned upon as you would be handling their own consent. Please be cautious when using this HUB and PiShocks in general.
