The integration of the Clojure Programming Language with the Unity 3D game engine.
Arcadia is alpha-quality software, and shouldn't be used for anything important yet.
The contents of the repository should be copied to a folder named Arcadia in any Unity project's Assets folder to enable Clojure. In the future, this will be available from the Asset Store. Once copied, you have access to the REPL and the Clojure compiler.
There's a screencast on getting set up here.
- Create a subfolder of your Assets folder named Arcadia
- Download our zip file and extract its contents into Arcadia
cd path/to/unity/project/Assets
git clone https://github.com/arcadia-unity/Arcadia.git
Before doing anything, Arcadia requires that Unity be set to run in the background and use the full .NET API
Click Edit > Project Settings > Player, then in the Inspector under Resolution and Presentation make sure Run In Background is checked.
Click Edit > Project Settings > Player, then in the Inspector under Other Settings make sure Api Compatibility Level is set to .NET 2.0 and not .NET 2.0 Subset.
Arcadia ships with a simple networked REPL that is started automatically or from Arcadia > REPL > Start. You can connect to this REPL using Arcadia/Editor/repl-client.rb. This script is also the basis of our Sublime Text support (via SublimeREPL) and our Emacs support (via Inferior Lisp).
You can write components in pure Clojure using our defcomponent form. To be recognized by Unity these must be saved in Clojure files, not just defined in the REPL.
This project was originally named "clojure-unity", but was changed to "Arcadia" to avoid infinging on Clojure's trademarks. It was suggested to us by @ztellman at a bar during StrangeLoop 2014, and we are eternally grateful.
Copyright © 2014 Tims Gardner and Ramsey Nasser
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.