WORK IN PROGRESS UNTIL END OF 2025, MAY NOT WORK
Makes you combustible in VRChat. Also get extinguished by water sprays.
- Installation instructions 👉
- VRCFury Unity Avatar drag-and-drop prefab to become combustible 📦
- Open source utility application (needed for automatic fire triggering!) 🛠️
🛑 NOT YET COMPATIBLE WITH QUEST 🛑
- Allow you to send fire
- Respawn afterwards
- Fires in worlds cannot make you catch on fire. Worlds cannot have contact senders :(
- SteamVR
- Windows (might work on linux)
- VRChat (ChilloutVR should also work, but is not documented and probably no longer needed. Resonite also does not need this addon.)
- Some knowledge about OSC
- Your custom avatar source code. Used in examples: TongueyToastacuga by 'a distraction'
- Unity editor for avatars
- VRCFury
These addons can extinguish you or make you catch on fire (be warned!)
- Spray Bottle for VRC (free)
- Fire-Breathing & Flame Sneeze
- Allow others to use voice command to make you catch on fire
TODO: Better fire particle addon
NOTE: Help improve the introductions by updating this readme
(Video help: Using VRCFury prefab assets in Unity)
Unity 🧊
-
Install Creator Companion and add VRCFury.
You also need your avatar as a project! -
In creator companion
- Add
vr_audience_fireby pressing "add to VCC" in this page. - Install the "VR Audience Fire" package to your avatar. (Remember to install VRCfury if not already installed!)
- Open the avatar in unity
- Add
-
Recommended: backup avatar now!
-
Find the "vr audience fire" package and the prefab inside it.
Drag and drop it into the avatar (note: the prefab must be put under avatar in the hierarchy but NOT inside armature/body, see picture):
-
To make the prefab's fire surround your avatar, you need to tell it which mesh should be used for fire emission.
Do this for both water and fire:
-
Optional: the prefab comes with an example sound effect, you may want to remove it (go under the prefab in hierarchy and remove the audio component from the fire game object)
-
Optional: test with gesture manager
-
Publish your avatar
-
Remember to enable OSC and to regenerate OSC config in VR (otherwise helper app will not work)!
- VRCFury will automatically add a new expression menu entry and you will be able to toggle the fire on and off there. Test it VRChat and see if it works.
Helper Application 🛠️ (required)
-
Download the latest
vr_audience_fire_helper.zipfrom releases -
There is no installer! Just extract the ZIP file somewhere where you don't remove/rename it accidentally.
-
IMPORTANT (Windows SmartScreen / Antivirus): Windows SmartScreen or your antivirus might show a warning about an unknown executable. This happens, because the helper application does not have a digital signature as it would cost too much. If downloaded from the official GitHub release, the helper application should be safe. SmartScreen Dialog: Click "More info" then "Run anyway". For antivirus, choose to "Allow" or "Trust" the application.
-
Start SteamVR and run
vr_audience_fire.exeonce in the extracted zip folder.
If unsure you can run it a second time and it will give an error about already running. If this does not happen the program is somehow crashing. -
Note: The program runs in background. Look in task manager for status.
-
Troubleshooting: In case of trouble, run
vr_audience_fire_console.exeto see debug output. You may also need to set debug to true inconfig.json -
Advanced: Look in
config.jsonfor additional settings. -
Note: The program quits when SteamVR quits
-
Optional: Enable helper autostart in SteamVR settings
-
Find someone to breathe fire on you or to use the spray bottle prefab on you to drip water
- Ensure you have Avatar Self Interact enabled in the VRChat settings menu:
- Enable OSC
- Use OSC Debug to see if are receiving any data
- Make sure your VRChat SDK is updated in the companion app! VRCFury usually requires the latest VRChat SDK.
- Check that antivirus 🛡️ and firewall 🔒👮 are not blocking the helper application!
HINT: The application generates a debug.log file on start if debug is enabled. This can provide clues on what is wrong. You should include this file with bug reports, thank you!
https://github.com/python1320/vr_audience_fire/issues
When someone uses a flame thrower, they have a contact sender with tag "fire". Your avatar then has a contact receiver (from this addon's prefab) with the same tag "fire" which sets an avatar parameter "fire" temporarily.
This is relayed via OSC to helper application, which sends another OSC message back to VRChat to turn on boolean avatar parameter named fire_effect, which stays on, and is networked to other players so they can see fire.
This networked status can then be used to turn on a fire gameobject (from the prefab), which has a fire particle effect. Extinguish works the same, but turns off fire effect, etc.
Additional ideas can be programmed to the helper application, like eventual random extinguishing, or PiShock support.
- Receiving fire:
- Sending fire
- Fire breathing asset has demo avatars in description
- Help by recommending public avatars
| path | type | Dir |
|---|---|---|
| /avatar/parameters/fire | bool | input |
| /avatar/parameters/fire_effect | bool | output/effect |
| /avatar/parameters/water | bool | input |
| /avatar/parameters/water_effect | bool | output/effect |
Networked/Synced: 2 bits
Contact names are in prefab.
- Combustible - find if someone might be combustible or get help testing
- Navigate to the prefab and into the fire and just replace the sound file with your own
After launching the helper exe successfully once, you should be able to enable autostart in SteamVR:
This is a hobby for me, paying only gives you access to the asset files. Payment does not give support. I may or may not have time to look at github issues but that's about it. No warranty of any kind! I cannot afford supporting you, and you cannot afford my support, sorry. Feel free to ask someone else to fix things for you.