Subscribe to download
Genkidama (Spirit Bomb) VR nonVR DBZ

This addon adds the ability for VR AND non-VR users to charge a genkidama above their head, to then obliterate whatever the genkidama is thrown at. Other players can give you energy to charge the genkidama even more! If you want to use this addon in VR you will need the VRMod addon.
This addon is intended for the TTT and sandbox gamemodes. If you want to play TTT in VR, I recommend also installing the TTT VR addon.
The "Genkidama" can be purchased as a detective in TTT!

1. Switch to the "Genkidama" weapon.
   
2. Then press and HOLD right click to charge the attack,
   
3. The genkidama should now appear and grow larger, until the player has given all their energy to charge the attack. (Other players can lend energy too.)
   
4. The attack can be thrown at any point with a left click.
   
5. The attack is launched in the direction you are currently looking.
   
6. The trajectory can be changed mid-flight, by holding left-click and then looking in the direction the attack should fly towards.
   
7. After the genkidama has detonated, there is a short cooldown timer, until the next attack can be created. (Can be changed with a ConVar)

The VRMod addon must be installed.

1. Switch weapon to holstered, empty hands or to the "Genkidama" weapon.
   
2. Hold your hands above you head (above the headset position) AND point your hands towards the sky.
   
3. Then press and HOLD primary fire + reload. (On oculus controllers that's the left- and right-hand triggers)
   
4. The genkidama should now appear and grow larger, until the player has given all their energy to charge the attack. (Other players can lend energy too.)
   
5. The attack can be thrown at any point, by still holding both primary fire + reload and then doing a "throw gesture".
   The throw gesture is: Put your hands above your head and then quickly move them forwards and downwards, while both buttons are pressed.
   
6. The attack is launched in the direction you are currently looking.
   
7. The trajectory can be changed mid-flight, by holding primary fire and/or reload and by then pointing the controller in the direction, where the attack should fly towards.
   
8. After the genkidama has detonated, there is a short cooldown timer, until the next attack can be created. (Can be changed with a ConVar)

Other players can contribute to your genkidama by lending their energy!
If one person gives you energy, the genkidama doubles in size, if another player gives you energy as well, it will triple in size and so on. The players that give you energy will also emit energy particles and have a glowing outline.
In the sandbox gamemode, select the "Give Energy" weapon and hold right-click, while someone is charging an attack.
In the TTT gamemode, select holstered and hold right-click. If you are a fan of T-Posing, you can optionally use Neeve's TTT T-Pose addon to give energy while T-Posing.
Just raise your hands towards the sky while having selected either empty hands, holstered or "Give Energy"!

Sandbox mode: The settings can be changed in the options tab of the "q" menu.
If you are on a dedicated server or a different game mode, you can change the following ConVars (server side) directly:

• genkidamaCooldown: Attack cooldown after an explosion in seconds. (Integer) Default: 5
  
• genkidamaSpeed: Attack projectile movement speed. (Float) Default: 15
  
• genkidamaSteeringSpeed: How fast the projectile can change its direction when it's controlled by a player. (Float) Default: 0.005
  
• genkidamaPlayerEnergyCapacity: How much energy each player can give to an attack. (Integer) Default: 1000
  
• genkidamaUserEnergyFraction: How much energy the user of the attack can give to an attack as a multiple of the genkidamaPlayerEnergyCapacity. (Float) Default: 1.0
  
• genkidamaChargingSpeed: How much energy each player can give each iteration. (Integer) Default: 2
  
• genkidamaExplosionDmgMult: Explosion damage multiplier. (Integer) Default: 25
  
• genkidamaExplosionRangeMult: Explosion range multiplier. (Integer) Default: 50
  
• genkidamaIdleShrinkTime: Time in seconds, after which the projectile starts to shrink if it is not held. (Integer) Default: 5
  
• genkidamaDissolveProps: If the projectile is large enough, props dissolve on contact. (Bool) Default: 1
  
• genkidamaDissolvePeople: Living things are dissolved. (Bool) Default: 1
  
• genkidamaInstakillPlayers: Players are killed instantly. (Bool) Default: 0
  
• genkidamaInstakillNPCs: NPCs are killed instantly. (Bool) Default: 0
  
• genkidamaInstakillNextBots: NextBots are killed instantly. (Bool) Default: 0
  
• genkidamaAllowEmptyHandsAsWeapon: Determines if empty hands or holsterd, can be used to create a genkidama. If false, genkidamas can only work with the dedicated genkidama weapon. (Bool) Default: 1
  
• genkidamaColor: Sets the color of the attack. (String) Available: default, red, green, orange, purple, rose, white, yellow
  
• genkidamaLightRadiusMult: Multiplies the radius of the emitted light. Reduce this value if there are performance issues. (Float) Default: 1.0
  
• genkidamaLightRadiusLimitMult: The maximum brightness limit. At 1.0 the light won't increase beyond a 100% charge (at default energy capacity). At 2.0, 200%. Reduce this value if there are performance issues. (Float) Default: 1.0
  
• genkidamaVRforceButtonsActive: The addon thinks that the left- and right-hand triggers are always pressed. (Bool) Default: 0
  
• genkidamaVRdebugButtons: Shows which buttons are pressed, in the chat. (Bool) Default: 0

For example, if you want your genkidama to be 5 times larger, then the ConVar genkidamaPlayerEnergyCapacity should be increased from 1000 to 5000. If the charging time takes too long, you can set the genkidamaChargingSpeed from 2 to 10, to charge it 5 times faster.
If only the detective in TTT should be allowed to use the genkidama, set the ConVar genkidamaAllowEmptyHandsAsWeapon to 0.

All sound effects are from:
https://soundsverse.com/dragon-ball-super
https://www.sounds-resource.com

This is my first addon and it was quite fun to make. If I have the time, I might do more dragon ball style attacks or expand some functionality! :D