Boby's Planet Movement

Boby’s Planet Movement is a VRChat prefab that allows players to walk and platform around 3D planets using gravity fields. This system can be used to make space-like platforming worlds, 3D puzzles, and spacecraft multiplayer wars.

The unity package file contains the main planet movement controller prefab, world UI prefabs, gravity field example prefabs, gravbody for rigidbodies, and a sample scene to play in.

Requirements

This prefab requires the following:

VRChat SDK - Base

VRChat SDK - Worlds (Unity 2019 or 2022)

(Automatically inluded with the Worlds SDK):

UdonSharp 1.0+ (U#) - Tested with version 1.1.8

There are API functions for both Udon Sharp and Udon Graph!

(Optional) Recommended for testing:

VRChat - Client Simulator

You can get these packages through the VRChat Creator Companion.

Update Information

v1.5 - Added Slope & 2 Gravity Prefabs + Bug Fix

Added a Quarter-Circle Ramp Model.

Added Axis Corner & Axis Tube Prefab examples.

Moved UdonSharp C# Program assets to a new folder "UdonSharp Programs".

Fixed Gravbodies falling the wrong way with Revert To Normal Gravity on.

================================

v1.4 - Align Gravity with Ground & Ground Layers

Added Align Gravity with Ground setting:

- You can now have the controller apply gravity along the ground without gravity fields.

Exposed Ground Layers mask

- You can change what layers the controller sees as ground. This is useful for not stepping on walls!

The Planet Movement editor script has been organized.

Fixed Documentation missing some advanced setting descriptions.

Documentation has been updated to reflect changes.

================================

v1.3 - Gravity Groups & Code Docs + Bug Fixes

Added Gravity Field Groups to allow grouping gravity fields together as a single field.

- Multiple strength combine options: Set, Avg, Min, & Max.

Added code summaries to all functions and public variables that match the documentation. You can use the API and see the summaries with your IDE.

Fixed an issue where gravity fields with a strength of 0 were being completely ignored and not counted. The controller should be able to see them now.

Cleaned up some inconsistencies in the controller's movement and gravity calculations.

Fixed some gravity field editor help boxes not appearing when they should.

Documentation Page numbers have been grouped by headings instead of subheadings. Basically, the Table of Contents page numbers have been simplified to ease future edits.

Documentation has been updated to reflect changes.

================================

v1.2 - Seamless Auto Enter/Exit + Bug Fixes

Added Auto Enter to Gravity Fields:

- Players can automatically enter the controller when entering the trigger of a Gravity Field.

Added Auto Disable to Planet Movement:

- Can automatically disable the controller when parallel with normal VRC locomotion and not in any gravity fields. (Best with Revert To Normal Gravity)

Added extra warnings and info for Gravity Fields when the current settings aren't applicable.

Fixed _ExitPlanetMovementPlayer() not placing the player in the correct direction.

Fixed when Gravity Field arrows were attempting to draw when settings weren't applicable. This caused spammed warnings in the console.

Fixed Collider Type Gravity Field using disabled colliders. This would cause it to be ignored or use the wrong colliders. This was also fixed in the Planet Movement controller.

Exposed more values from BobysPlanetMovement for scripting API.

Documentation has been updated to reflect changes.

================================

v1.1 - Bug Fixes and Global Folder

Added the Global folder (forgotten in the first release).

Fixed "sliding" effect on slopes.

Added _ExitPlanetMovementPlayer() function. Akin to the Enter variant.

Documentation has been updated to reflect changes.

================================

v1.0 - Release!

Version History:

https://1drv.ms/f/s!At-eIpq8UHqQoz4bWep1lL9Ajj-7?e=FM2d7a