Oligo Academy Builders Collection

License

The education tools listed here are all free open source software, that can be used by teachers to host existing immersive 3D learning modules or enable students to design and share their own 3D learning modules.

Oligo Academy Builders Collection (OligoABC) is a set of self study videos for teaching basic 3D design in FireStorm viewer and script programming skills for young people age 13 or above.

Learning outcome

The OligoABC learning materials make it possible for students to make a project of their own with 3D designs and scripted actions. This is a fun way to learn some general skills in programming, design and problem analysis.

Teachers can host existing 3D learning modules on their laptop either developed by the Oligo Academy team or shared by students that have developed their own 3D learning module. The showcase EnergyMatters is a 3D learning module for teaching sustainable energy and climate change topics in an immersive virtual world.

Getting started

The Oligo Academy videos found on YouTube allows students to learn 3D design in FireStorm at their own pace and without any technical help from the teacher.

When hosting 3D learning modules the teaching style is flipped learning were students explore the virtual world in groups or watch videos and then the teacher facilitates group discussions on the class concerning what the students have learned.

The teachers role is to facilitate group discussions, to help students think critical about what they have learned.

Installation guide

Students must at least install the FireStorm virtual world viewer, this can be done manually or using the Oligo Desktop tray icon.

Teachers don’t have login to the virtual world using the FireStorm viewer, but they should install it for testing purposes.

Teachers and students that want to build or host a 3D learning module on their laptop must install the Docker virtual machine software and the Oligo Desktop tray icon, which will install the Python programming language.  

Windows installer

Download and execute the below self extracting ZIP file that will install the Oligo Academy tools in the users application data folder under a subfolder called Oligo. The installation will check if Python 3.7+ is installed and if not it will be installed together with any required Python packages.

OligoABC.exe

Mac installer – is work in progress

The Oligo Desktop tray icon is developed in Python and can therefore run on Mac, but we still need to create an installer for it.

The Docker software for running virtual machines on Mac can be installed from https://download.docker.com

First time installation task to host 3D learning modules

After installing the Docker software and the Oligo Desktop tray icon, you must build the OpenSim Docker image one time, which takes 30 minutes, before you can run 3D learning modules in the OpenSimulator Docker virtual machine container.

Click on the Oligo Desktop tray icon and select “Install Oligo ABC” to get a user interface for installing the FireStorm viewer, Docker software and to build the Docker OpenSim image once. Start by installing the FireStorm viewer that all students and teachers need. Then install Docker and finally build the Oligo Academy OpenSimulator Docker image – this step is performed only once, but it takes 30 minutes, so go get some coffee.

Start OpenSimulator and login with FireStorm viewer

The Oligo Desktop icon has a shortcut link to “Start OpenSimulator” or “Stop OpenSimulator” and to start the “FireStorm viewer”.

After starting the OpenSimulator the teacher can click the “My dashboard” menu, to get a user interface for loading or saving 3D learning modules in different regions.

Login to My Dashboard

Login to the region “Oligo” with username “Master Avatar” and the initial password “2222”.

The dashboard is used by the teacher to create user accounts for students, that allow them to login to any region on this OpenSimulator.

You can also create student groups, to make it easy for them write local chat together in the virtual world. You can load different 3D learning modules in the predefined regions of size 1024×1025, 512×512 or 256×256. The size 256×256 is the normal region size used in many free 3D virtual simulations (see zadaroo.com under OAR menu for examples, that can be converted to .oar files and uploaded in a region).

KNOWN ISSUES

On Windows Docker sometimes has a problem starting the OpenSimulator, but if that happens just click the Docker desktop icon and select “Restart…” and wait 3 minutes, then you should be able to start the OpenSimulator using the Oligo Desktop icon.

IMPORTANT NOTES ON BACKUP

If you build your own 3D learning module, always choose “Stop simulator” in the Oligo Desktop tray icon or you will lose your changes. To backup your own learning modules click “My dashboard” in Oligo Desktop tray icon and select “Save” on the region you where working on, then this will download a backup file in the OpenSimulator Archive format (.oar).

 

 

Links to 3D design and developer tools

If you want to install OpenSimulator on your local machine instead of in a Docker container or if you want to test some more advanced 3D design and developer toools, please look at the links below.

Follow the installation guide for Mac or Windows depending on your system. If you only want to use the learning modules available step 1 is all you need, but if you want to learn 3D design or coding please install step 2 and 3, that will make it easier for your students to learn the basics of 3D design and coding in different programming languages.

Mac installation
1. FireStorm viewer and OpenSimulator

2. 3D design tools

3. Coding tools

Windows installation
1. FireStorm viewer and OpenSimulator

2. 3D design tools

3. Coding tools

 

The Oligo Academy learning tools are supported on both Mac and Windows laptops, but not on iPads and tablets without a full Windows system. The FireStorm viewer used in Oligo Academy can run on tablets using a payed service like https://brightcanopy.com/#screenshots, but it is not supported by the Oligo Academy team.