UnityREPL

UnityREPL copied to clipboard

h1. OVERVIEW

UnityREPL is a REPL (Read, Eval, Print, Loop) tool based on "Miguel's CSharpRepl":CSharpRepl but for "Unity":Unity.

What's a REPL? See the "Wikipedia article.":Wikipedia or the "demo videos":Wiki on the Wiki.

h1. INSTALLATION

Please note that this requires UnityGUIExtensions. The .unitypackage includes everything you need

h2. NON-GIT, OR UNITY-INDIE SETUP

• Grab the ".unitypackage":Package from the downloads page.
• Open your project.
• Click "Assets" -> "Import Package..." from the menu, and select the file.

h2. GIT SETUP IN A UNITY-PRO PROJECT THAT IS NOT VERSIONED WITH GIT

You must have External Version Control enabled to use these instructions. If not, please download the .unitypackage and use that.

bc. cd myproject/ mkdir -p Assets/Editor/ git clone git://github.com/MrJoy/UnityREPL.git Assets/Editor/UnityREPL git clone git://github.com/MrJoy/UnityGUIExtensions.git Assets/UnityGUIExtensions

By setting up this way, you can track updates using "git pull".

h2. GIT SETUP IN A UNITY-PRO PROJECT VERSIONED WITH GIT

You must have External Version Control enabled to use these instructions. If not, please download the .unitypackage and use that.

bc. cd myproject/ mkdir -p Assets/Editor git submodule add git://github.com/MrJoy/UnityREPL.git Assets/Editor/UnityREPL git submodule add git://github.com/MrJoy/UnityGUIExtensions.git Assets/UnityGUIExtensions git submodule init git submodule update

h1. USAGE

• Click "Window" -> "C# Shell"
• Dock the new tab wherever you wish, and enjoy!

From this window you can enter C# code and run it. You should have access to all classes you've defined in C#, JavaScript, or Boo in your project.

h1. COMPATIBILITY

Tested on Unity 5.3.1, but should work on slightly earlier versions down to, perhaps 5.0.

Will definitely not work on older versions of Unity (4.x and below).

h1. DOCUMENTATION

Full documentation is available from within UnityREPL by clicking the '?' button on the toolbar.

h1. LICENSE

All original/novel code is Copyright (c) 2009-2016 Jon Frisby. All other code is the property of the respective authors.

Dual licensed under the terms of the MIT X11 or GNU GPL, as per the original code.

The included Mono.CSharp.dll is a completely unmodified copy from "Mono 2.4.":Mono, please see the "Mono Project":Mono for details on obtaining source to it.

h1. TODO

• Undo functionality.
• Editing history support (Bash style).
• Smooth out some hiccups with assembly reloads. ** Local vars getting blown away. ** Make sure we're not leaking references to things.
• Add things to UnityBaseClass to help with Unity workflows.
• Lots of other little things; see the source code for more info.

[Mono]http://www.mono-project.com [Wiki]http://wiki.github.com/MrJoy/UnityREPL/ [Wikipedia]http://en.wikipedia.org/wiki/Read_Eval_Print_Loop [CSharpRepl]http://www.mono-project.com/CsharpRepl [Unity]http://Unity3D.com [Package]https://github.com/MrJoy/UnityREPL/releases/download/releases%2F2.0.1/UnityREPL_2.0.1.unitypackage