Gluon Project

From GluonLogo

A Gluon project is a directory containing the following structure, each part of which is described below:

.directory
.DStore
desktop.ini
project.gluon
assets/<mimetype>/
levels/
prefabs/
scripts/

Contents 1 Folder Icon 2 Project File 3 Assets 4 Levels 5 Prefabs 6 Scripts

[edit] Folder Icon

The three first items (.directory, .DStore and desktop.ini) are simply used to give the gluon project a nice icon on the three main operating systems (most unix systems, MacOS X and Windows respectively).

[edit] Project File

The project.gluon file describes project-specific information (project name and other descriptive information, as well as the entry-point (i.e. the first level), so gluon knows what to launch).

[edit] Assets

The assets directory contains a number of sub-directories, which are all named after the mimetype of the data they contain (mimetypes are in the format "domain/type", and we only use the type, as we don't need the extra context). Each file has its asset name (as shown in the Assets pane in Gluon Creator), followed by a unique hash (for safety - we can potentially have multiple assets with the same name), and finally its file suffix (not all operating systems understand mimetypes). The directory structure of the assets directory in a hypothetical Gluon project might be:

assets/
  ogg/
    explosion.e1fdsa0f234239ad.ogg
    launch.ae54517c90ed34ef.ogg
  png/
    tank.523fd4e77acb3d3b.png

[edit] Levels

A Level is, in short, a collection of GameObjects. As the name suggests, it represents one level - that is, one logical and limited selection of connected GameObjects and the rules that are connected with those.

[edit] Prefabs

A Prefab is a GameObject stored as an Asset in your project rather than directly in a Level. As any other Asset, a Prefab can be inserted into any number of Levels any number of times, essentially copying the Prefab: This is called an Instance. And as with any other Asset, any changes made to the Prefab also happen on the Instance of the Prefab in all the scenes, with one important difference: Since a Prefab is a known type of data, Gluon Creator is able to force changes made to a Prefab into all the Instances (overwriting any local changes in an instance), and you can perform the same action the other way (forcing any changes made to an Instance back into the Prefab).

[edit] Scripts

Scripts are, like Prefabs, a special type of Asset. They all represent one Component.