Get Started (C#)
Table of contents
For an overview of what Alloverse and alloapps are, please see the first chapters of the Get Started (Lua) guide.
Note that Lua is the preferred alloapp language, and C# language support is in beta.
To write Alloverse apps in C#, you’ll need the following:
- The Alloverse app.
- Either Visual Studio Community >= 2019 (on a Mac or Windows machine)…
- Or a plain text editor for code (We recommend Visual Studio Code), together with a command line terminal.
Personally, I’m more of a Linux/Mac with command line kind of person, so this guide will primarily be using the
dotnet. I’ll try to include the equivalent Visual Studio screenshots so that you can follow along without using a Terminal.
Creating your project
Let’s create a new C# project:
Add AlloUI as a dependency:
You remember how I said at the top that this is a beta? There’s one really terrible hack you’ll have to do until I figure out how to properly package native code in a nuget package.
You have to manually download
liballonet.so, and put it at
/home/nevyn/Dev/allonet/build/liballonet.so. This unfortunately means that this’ll only work on Linux for now.
Setting up the basics
Program.cs. The most basic setup for an alloapp is one which:
- Creates an AlloClient and connects to the specified alloplace server,
- and creates some basic UI elements,
- and starts the runloop which will serve requests.
Modify your file to look something like this, adjusting to taste;
Trying your app out
That’s it! You should now be able to start your project and see it appear in an Alloplace. If you don’t have one already, you can use our sandbox alloplace://sandbox.places.alloverse.com, or be ambitious and boot one on your own (
docker run -e ALLOPLACE_NAME="my place" -p 21337:21337/udp -it alloverse/alloplace2). I’m gonna do the former:
If it all checks out, you should be able to jump into that place on your VR headset or computer and press the button it has created.
Download the Visor app for your VR or desktop platform of choice, and then click “Connect”, “Sandbox” (or click the alloplace link of the place you’ve rented or started yourself).
Our app running in Sandbox place. I’ve clicked our simple app’s white button button three times, and the laws of causality held up, printing “Hello” thrice to our terminal.
At this point, you could go off, do your own thing, read the documentation as you go. Or you could keep reading, and be guided through the development of a simple but functional todo list app, which will help establish the fundamentals and make it much easier for you to build real, complex apps.
This is also a good point at which to remind you: if you get stuck, or have questions or feedback, please hop on Discord and give it to us straight.
This is where one would expect the tutorial to really get started, teaching the deeper concepts and doing something more advanced. But alas, the number of hours in a day are finite, and the docs are left unwritten.
Maybe see it as a challenge? “Left as an exercise to the reader” and all that. Who knows, maybe you end up sending us a docs improvement PR? ;)
And again, if you have any questions, hop on Discord!