Summary

The Object Distributor (also known as the Vending Machine) was introduced in Sloodle 0.2, and can be rezzed from a Sloodle Set (versions 0.702 and later). It allows in-world distribution of objects to avatars, and can be controlled/used in several ways:


Compatibility

The Object Distributor is a sub-component of the Sloodle Set, so please check the Sloodle Set Compatibility information.


Setup

Automatic Configuration

The Object Distributor is distributed as part of the Sloodle Set. It is recommended that you use the official Sloodle.org Object Distributor to obtain an appropriate Set for your Sloodle version. Rez and configure the Sloodle Set, and click on the object vendor box (the tall one in the middle). Select the "Object Distributor" option from the dialog that appears, and an Object Distributor should be rezzed for you.

Click on the vending machine to start configuration as normal.

With SLOODLE 0.2 you can only use *one* Distributor with a Moodle site at any one time. If multiple distributors are rezzed, the most recently rezzed Distributor takes precedence. You need to manually reconnect an old Distributor if have rezzed another since then. From SLOODLE 0.3 onwards it is possible to create multiple distributors per course, though we would recommend having one distributor for each course that will be using one.

NOTE: SLOODLE 0.2 also includes a Sloodle Object Selector, which allows people access to the Distributor from multiple locations. This functionality was folded into the distributor from version 0.3.


Notecard Configuration

As with many Sloodle objects, if you prefer you can configure the Object Distributor manually using a notecard. It uses the same format as the 'sloodle_config' notecard for a Sloodle Set, so you can use the Sloodle notecard setup page on your Moodle site to generate one (if you are an administrator). The text from there should be placed into a notecard called "sloodle_config" in the Object Distributors's inventory.

You will need to reset the Distributor if you change the configuration notecard. This can be done by clicking it, and selecting "Reset" from the menu.

Notecard configuration is useful because:

  • it will not lose its configuration when it is reset
  • it does not require the use of a Sloodle Set every time
  • it can be slightly more secure than automatic configuration


Usage

Only the owner of the Object Distributor can interact directly with it in-world.

When you have rezzed an Object Distributor, it will try to connect automatically. However, you will probably need to add items to its inventory. To do so, right-click it, select "Edit", and click the "Contents" tab. You can click and drag items into its inventory. You can add any item and types you like (e.g. objects, notecard, scripts, textures etc.), so long as their names do not conflict with any of the standard scripts or the "sloodle_config" or "sloodle_config_sample" notecards.

When you have changed the inventory of the Distributor, you will need it to reconnect so that it will update the Moodle site with its list of inventory. Do this from the Distributor menu.

The Vending Machine uses the Object Distribution Linker script to communicate with Moodle.

Distributor Menu

If the owner of the Distributor touches it in-world, then a menu will be displayed, with the following options:

Reconnect

This option will keep the current configuration, but will re-establish the connection with the Moodle site, and send an update-to-date list of its inventory. This is useful if you have rezzed a second Distributor for the same site, but want to use the first one again. It is also useful if you have changed the inventory of the Distributor.

Reset

This will reset the whole object, which is useful if an error has occurred, or if you have changed the configuration notecard.


Shutdown

If you do not want anybody to use the Distributor, then you can make it shutdown. This means that it will not accept any requests for objects to be distributed until you click it again, and select "Reset" or "Reconnect".


This page is part of the SLOODLE documentation
Docs: Users | Administrators | Developers
Document Top Sloodle.org