Awesome
UnityConsole
Welcome to UnityConsole, an easy-to-use developer console for Unity 5!
Getting Started
- Import the UnityConsole package into your project (or clone the UnityConsole repository into your Assets folder)
- Add a UI canvas to your scene if you don't already have one (GameObject > UI > Canvas)
- Drag-and-Drop the
Console
prefab onto the canvas in the Hierarchy - Run your scene and press
TAB
to toggle the console
Logging
Anywhere in your code, simply use Console.Log()
to output to the console
Default Commands
The console comes with three commands by default.
HELP
- Display the list of available commands or details about a specific command.LOAD
- Load the specified scene by name. Before you can load a scene you have to add it to the list of levels used in the game. Use File->Build Settings... in Unity and add the levels you need to the level list there.QUIT
- Quit the application.
Extending the Console
Use the ConsoleCommandsDatabase.RegisterCommand()
method to register your own commands. Here's an example.
public class MyCommands : MonoBehaviour
{
void Start()
{
ConsoleCommandsDatabase.RegisterCommand("TAKE", MyCommands.Take,
description: "Partake in a great adventure alone.",
usage: "TAKE");
ConsoleCommandsDatabase.RegisterCommand("RANDOM", MyCommands.Random,
description: "Display a random number between a and b using an optional seed.",
usage: "RANDOM a b [seed]");
}
private static string Take(params string[] args)
{
return "It is dangerous to go alone! Take this."
}
private static string Random(params string[] args)
{
if (args.Length < 2)
{
return "Missing range bounds.";
}
if (args.Length >= 3)
{
int seed = 0;
if (int.TryParse(args[2], out seed))
{
UnityEngine.Random.seed = seed;
}
else
{
return "Invalid seed.";
}
}
float a = 0;
float b = 0;
if (float.TryParse(args[0], out a) &&
float.TryParse(args[1], out b) &&
a <= b)
{
return Convert.ToString(UnityEngine.Random.Range(a, b));
}
else
{
return "Invalid range bounds.";
}
}
Attaching this script to the console will extend it with the two commands at the start of the game. Registered commands can be overwritten and persist between scenes but don't persist between multiple application executions.
World space UI
You can use UnityConsole in world space. Simply set your canvas Render Mode
to World Space
and you're good to go. You may need to scale down the canvas.
Styling the Console
You can easily change the appearance of the console by changing the image sources, font styles and state transitions of the various UI components. It is also possible to anchor the console differently as needed.
Contributing
Feel free to create pull requests or report any issues you may find. I'll be taking your feedback!
Contact me
@Syncopath1 on Twitter