Star Warships for Quest v1.30

This is a fun little project I threw together as a Star Wars fan.  It allows you to view several warship models from the films on Meta Quest mixed-reality headsets!

You can fly a scale model of each ship around your room, grab, and throw them.  Alternately, you can toggle them to "full scale" and fly around them in space.

To install, you will need to sideload StarWarships.apk.  Search the web for "quest sideload" if you need help.  (I've included an "install.cmd" that copies StarWarships.apk to your headset once it's properly connected to your PC.)

Check out the other cool stuff I made: https://vroom.space

CONTROLS:
	A/X button = warp to next ship (hold for ship selection menu)
	B/Y button = toggle ship guns (also: toggle back to model/passthrough view)
	Model Scale:
		Index trigger = ship forward throttle
		Hand trigger = pull ship toward hand and grab
		Thumbstick = ship pitch/yaw
		Thumbstick button = ship reverse throttle
	Full Scale: 
		Index trigger = move player forward relative to controller
		Thumbstick = move player forward/back relative to controller, snap turn left/right
	Notes:
		Designed to be played with a single controller.
		You can move/rotate up to twice as fast using a second controller!

VERSION HISTORY:
- v1.30 Fixed broken player movement at full-scale.
	More accurate R2D2 head material.
	Added normal maps to X-Wing.
	Tantive IV's radar now turns again.
- v1.28 Fixed the elusive bug that caused headset tracking to degrade after playing for several minutes.
	First launch should no longer have a black reflection texture if permissions are granted.
	You can now long-press B or Y too toggle scale.
- v1.27	Added a pop-up radial menu to more quickly select ships.
	Moved "toggle scale" button to the pop-up menu.
	Moved "fire guns" button to B/Y so it's more discoverable.
	Thumbstick button now adds reverse thrust once again.
	Improved passthrough reflection-grab convolution method and lighting calculations.
	Fixed ship collision sounds not working.
	"Keep Upright" no longer applies pitch; just roll.
	Flight physics revamped for all ships.  Please let me know if you prefer the old or new style.
	Improved an elusive issue that causes headset tracking to degrade after playing for several minutes.
	Ships now aim at laser-designated asteroids faster.
	X-Wing and B-Wing S-Foils now stay open while firing, and close when not (if throttle is zero).
	Fixed a Tantive IV normal map, improved its rendering performance, and added ambient occlusion to highlight details.
	Tweaked Millennium Falcon engine flames.
	Reduced cockpit material counts substantially on A-Wing, B-Wing, and Y-Wing.
	Added mesh culling to the Venator-class model to improve performance (it's better but still a little slow.)
	Fixed modeling issues on A-Wing, X-Wing, Y-Wing, TIE Advanced, and Delta-7.
	Adjusted TIE Fighter and TIE Advanced colors to match filming models.
	Adjusted/improved textures and materials on nearly everything.
	Gave Naboo Royal Starship belly turrets, because why not?
	Artoo's head looks more like stainless steel.
	Fixed an inverted collider on Naboo Royal Starship.
	Asteroids now explode in the direction they're hit.
- v1.26 Made Millennium Falcon whiter to more closely match filming model.
	Added flicker to engine plasmas.
	Turrets now reset their rotations when disabled.
	Turrets are less likely to shoot their own ship. :)
	Imperial Shuttle's tail-gun is now active.
	Added gun recoil to Falcon, Imperial Shuttle, and Venator.
	Fixed lasers still hitting room walls.
	Fixed an X-Wing window mesh problem.
	Fixed some modeling issues in A-Wing cockpit.
	Increased Imperial Shuttle pitch control.
	Controllers now collide with asteroids; you can swat them away!
	Improved X-Wing and Imperial Star Destroyer texturing.
	Asteroids no longer spawn at startup; they appear once you begin firing.
	The time taken to clear Asteroids now begins with destruction of the first asteroid.
- v1.25 Fixed a problem where restarts often hanged on HorizonOS v79.
	Increased turn speed when targeting an asteroid.
- v1.24 Added laser-pointer target-designator for asteroids; ship autorotates to face them.
	Stationary guns now have a small degree of aim-assist.
	Naboo Royal Starship is slightly less "white" and its lasers slightly more "purple".
	Added a Death Star to space background.
	Lasers and ships no longer impact walls.  (It's more fun having them fly into the distance.)
	After you clear all asteroids, guns stops firing, and asteroids don't respawn until they fire again.
- v1.23 Added cockpits to: A-Wing, Y-Wing, and B-Wing.
	Y-Wing's turret now tracks and fires.
	Reduced size of default room, so asteroids are closer.
	Fixed clipping and star particles not scaling properly for all ships.
	Fixed gun targets occasionally appearing at full scale.
	Fixed a pop during Delta-7 engine sound.
	Slightly better B-Wing engine glow.
- v1.22 Added asteroids to your passthrough environment!
	Asteroids are confined to a default cube if you have not scanned your room in Settings > Space Setup.
	Turrets now track asteroids instead of your head.
	Guns are now toggled on/off using the thumbstick button.
	Most guns now fire individually instead of as a sequence.
	Corrected N-1 guns to be green-colored.
	Made Royal Naboo Starship guns fire purple, despite her not having guns, because where's the fun in that?
	Improved X-Wing, TIE Fighter, and TIE Advanced models plus added cockpits!
	Added interior reflections and audio muffling to all ships with cockpits.
	Reduced startup lag/stuttering.
- v1.21 Added Jedi Starfighter: Delta-7 Aethersprite-class Light Interceptor!
	Added Jedi Starfighter: Eta-2 Actis-class Light Interceptor!
	Fire lasers now survive for up to 8 seconds.
- v1.20 All ships now fire guns while at full throttle!
	Improved A-Wing, Y-Wing, and Naboo Royal Starship models.
- v1.14 New ship: B-Wing!
	Increased pitch input on TIE Fighter and Imperial Shuttle.
	Added atmospheric hum to Tantive IV.
- v1.13 Added spatialized audio and overhauled settings.
	Improved Naboo N1 and Royal engine sounds.
	Fixed a ship positioning bug when returning to model-scale.
- v1.12 Increased dynamic resolution maximums!
	Added a hint of blue to the TIE Fighter.
	Rounded TIE Advanced windows.
	Reduced Venator-class polygoncount a little.
- v1.11 Fixed a passthrough texture problem that limited reflection brightness. :)
	Fixed pixelation on Naboo Royal Starship surface.
	Fixed angular damping being repeatedly reduced with successive throws.
	Reduced "keep upright" force so smaller ships can perform loops.
	Fixed bug where A-Wing engine flame could appear at certain viewing angles.
	Increased X-Wing angular drag slightly so it's more controllable.
	Ships shake less when held.
	Fixed X-Wing engine-flame z-fighting.
- v1.10 New ship: Venator-class Star Destroyer!
	Better environmental lighting and color-matching via passthrough reflection-texture grab.
	Improved Tantive IV rendering performance.
	At full-scale ship engine power is set to 100% throttle. (Model-scale starts at 0%.)
	Moved center-of-gravity forward on X-Wing, making turns more stable.
	Reset center-of-gravity on Star Destroyer that had changed somehow.
	Improved A-Wing engine outlet texture.
	Improved model visuals by tweaking texture and material settings for all models.
	Fixed wonky normals on Y-Wing and ISD.
	Reduced thrust back to previous level (i.e. -25%), since lots of users have small rooms.
	Fixed some Z-fighting on the belly of Imperial Star Destroyer.
- v1.06 X-Wing S-Foils now open/close based on throttle.
	Fixed a visible seam on TIE Advanced panels.
	Fixed some normals on N-1 chrome, added a little AO.
	Increase ship thrust by 25%; use less throttle if your room is small!
	Added engine flame to N-1 and Royal Starship.
	Added startup logo.
	N-1 flight dynamics are smoother.
	Increased Y-Wing engine flame size.
	Improved textures on R2D2.
	Reduced ambient occlusion on Imperial Star Destroyer.
	Fixed an audio-pop when Star Destroyer hyperspaced.
	Updated to v77 Oculus plugin.
- v1.05 Added new ship: Tantive IV.
	R2D2 can now speak!
	Increased hyperspace jump-out distance.
	Added engine flame to X-Wing and Y-Wing.
	Fixed ambient occlusion on Imperial Star Destroyer.
- v1.04 Improved Falcon engine sound.
	Fixed TIE Fighter engine glow and reduced its mass by 20%.
	Fixed A-Wing engine particle leakage at some view-angles.
	Switched back to Oculus XR plugin as it seems a little faster.
- v1.03 Improved fake bloom on Falcon's engines.
	Added fake bloom and ambient occlusion to Star Destroyer engines.
	Thrown ships now tumble for two seconds before "keep upright" activates.
	A-Wing thrust animations are now centered.
	Controllers now disappear properly in passthrough mode.
- v1.02 Tweaked flight dynamics on most ships.
	Added fake bloom to Falcon's engines.
	Fixed Y-Wing thrust emission leaking through model.
- v1.01 Increased ship thrust by 50%.
	Improved most model materials and shaders.
	Gave the A-Wing some engine plasma.
	Fixed ship positioning relative to camera after warp-in.
	Fixed audio distance-fading.
	No more occasional audio-pops during hyperspace.
- v1.00 Initial relase.

CREDITS
Created by William Palmer (vroomspace@gmail.com)

Star Wars, and all related characters, names, and indicia are trademarks of and © Lucasfilm Ltd. LLC.  This content is not affiliated with, authorized, sponsored, or endorsed by Lucasfilm Ltd., The Walt Disney Company, or any of their respective affiliates or subsidiaries. 