v0.x

UdonToolkit v0.x

Purpose-built Udon Behaviours and tools to make your own

Udon Toolkit is a project aimed at simplifying usage of Udon by providing a set of easy to use purpose-built behaviours, from generic triggers and actions, to more complete systems like Key Items, Cabinet Drawers, etc.

This also includes a system of attributes that allow you to utilize the same UI elements when building your own behaviours!

If you find that something is broken or works not as you would expect - please ping me in the discord server, or better - create a new issue.

Requirements

Installation

  • Grab the latest package from releases

  • Import it into the project

    • If you're upgrading from version prior to 0.4.0 - you'll need to close and open the scene again after import

  • Open your Project Settings -> UdonSharp and in the Default Behaviour Editor select UdonToolkit Editor

It is required to use the default path when importing as for now asset paths are hardcoded

How to use

  • Browse the list of available behaviours in the behaviours section

  • Select a Game Object you want to use (or make a new one)

  • Click Add Component and type the name of a Behaviour

  • A new component with all the corresponding UI and parameters should appear

  • If it is your first time using Udon Toolkit, you might want to click "Compile All Behaviours"

Tip: You can click on the ? icon in the Behaviour header to open the docs for that particular script

Known Issues

  • Prefabs are fundamentally broken in Udon as of August 2020. Toolkit will show a warning if you will try to use a prefab, it is highly recommended to unpack the prefab before editing anything, as values can just reset to whatever they were before when entering play mode

An alternative to that might be to utilize Unity Presets which allow you to save the values of the current behaviour into a file

Advanced

UI System

UdonToolkit is not just a set of prebuilt behaviours, but also a UI system built using Unity's Custom Property Drawers and Attributes that allows you to quickly create user-friendly UI. You can read more here.

Thanks ❤

  • To VRC Team for making Udon which actually made me learn C# and Unity Editor Tools development

  • To Merlin for making Udon Sharp without which none of this would've been possible

NextBehaviours Overview

Last updated