Beat Saber - PiShock Plugin
Getting a PiShock API Key
- Login to the site: https://www.pishock.com
- Choose the
PiShock
option - Click the Person icon (
Account
) in the bottom left corner - Click
Generate API Key
button - The API key is the value shown, Example:
abcd-1234555678-defg-12345
Getting a PiShock Share Code
- On the PiShock website:
- Create a share code ( or get one from another user )
- Click on the Share icon ( the 3 dots )
- Click
Generate Share Code
- Create a share code ( or get one from another user )
Installation
- Make sure you have Beat Saber installed
- Install Python using the attached
install_python.ps1
:- Right click
- Run with Powershell
- Setup Mod Assistant
- Launch ModAssistant.exe
- Click Agree
- Install the mod
HTTP Status
- If it isn't there, use the ModAssistant to install:
BSIPA
,BS Utils
, andwebsocket-sharp
. - Then you can find the latest version of
HTTP Status
here: https://github.com/opl-/beatsaber-http-status/releases- Drop the plugin folder in your
Beat Saber
install directory
- Drop the plugin folder in your
- If it isn't there, use the ModAssistant to install:
config.json
Update the -
Update the
Params
:- Add the
Username
(it needs to be the one of the person that made the API Key - Add the
Name
should be identical or can be something like: Beat Saber.
- Add the
-
Update the
Apikey
:- Under
Params:
- Update
Apikey:
( line 7 ) - Add your API Key From the PiShock website (See: Getting a PiShock API Key)
- Under
-
In the
Miss:
section:- Update the value for
code:
with the Share Code (on line 28)
- Update the value for
-
In the
Bomb:
section:- Update the value for
code:
with the Share Code (on line 52)
- Update the value for
-
(Optional) Buttplug.io
- Get the code of a buttplug.io share
- Enter it at line 62 (
Hit->Params->code
), - Toggle Active to
true
at line 58.
Running the Plugin
- Launch Beat Saber
- Launch the Plugin:
- Hold
shift
andright click
in the folder that holds thebeatsaber_pishock.py
- Click on
Open Powershell Window Here
- Inside the Powershell window:
- Type
python .\beatsaber_pishock.py
- Press
Enter
to launch the plugin
- Type