DJ Schedule Board

Demo Version

The demo version does exactly the same as the regular version, but it shuts down at end of a cycle (every full hour) and clears the entire schedule. You can always restart to continue testing.

Configuration

The board is configured via a notecard called config in the Contents tab.

Each entry in the notecard looks like <keyword>=<value>. 

Lines that start with a # character are ignored and considered comments. ATTENTION: It's a common mistake to not remove the leading # when activating a setting. Make sure that settings you want to use are NOT preceded by the # character. Also, DO NOT remove the # character for lines that are simply explanatory comments!

Parameters to set:

• location_name - The name of your venue; it's used for example in instant message reminders.

• clock_type - Sets the timeline clock label. 12 = am/pm, 24 = 00:00 to 23:00. It's just a label, internally the board works on a 24h basis.

• admin - Adds an admin avatar. Use the avatar's SL name, for example "Lava Babii" or "madamelava Resident". The owner is automatically added as admin. Admins can perform certain actions like canceling an event or starting and resetting the board.

• allowed_agent - Adds a DJ with its SL name, its stage name, and a texture UUID. See below for more details.

• group_access - Only avatars in the same group as the board can schedule time slots. Only works if no allowed_agent entries are specified. 1= on, 0 = off, default: off.

• daylight_saving - Sets daylight saving mode, 1 = on, 0 = off.

• send_reminder - Send reminders about upcoming events to the respective DJ via instant message (1 = yes, 0 = no).

• use_message_board - Activates the use of the message board (1 = active, 0 = inactive).

• message_board_channel - The channel of the included full permission message board. If you change the default value -12, make sure you also change the channel in the message board's code (it's full permission).

Group-based DJ Access

The simplest way to get the board working is to invite all your DJs to a dedicated group, set the board to said group, and set the configuration option group_access:

group_access=1

Note that group access only works if no individual DJ configurations (allowed_agent) have been made. Once there is an individual entry for a DJ, the group_access option has no effect anymore.

While it's simple, this method also has some disadvantages: The DJ pictures are taken from their profile, which is determined by reading SL's website. It's laggy, and because SL may change the web page at any time, also unreliable. I recommend the individual configuration of your DJs.

How To Configured A DJ Avatar

A typical line in the config notecard to configure a DJ avatar looks similar to this:

allowed_agent=madamelava Resident,DJ Lavanda,5574dc27-9d81-a335-4af9-746a3e8f2f65

Data fields for allowed_agent are comma-separated:

1. This first field contains the SL name of the DJ avatar.

2. The second field contains the stage name of the DJ.

3. The third field contains a texture UUID for this DJ to be used on reserved time slots. While it's optional, it is highly recommended to specify a texture. Let the DJ give you a square (1:1 aspect ratio) texture and use the UUID of said texture.

How To Reserve/Cancel A Time Slot

Very simple: A DJ reserves a time slot by touching the slot button for longer than 3 seconds.

The slot will show the texture assigned to the DJ. If no texture is configured, it will try to determine the profile image of the DJ's avatar. If even that fails, it will show a default texture.

To cancel a time slot, the DJ or any admin has to touch the reserved slot button for more than 3 seconds.

Note that admins cannot reserve time slots on behalf of a DJ.

Dump & Load

Once you have a few scheduled events, touch the Dump Schedule button. You will receive an output similar to this in your local chat:

[00:10] ELLEN GEE's DJ Schedule Board 2.0 # copy below into a notecard

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → image,lava babii,92fa6d55-16bd-5de8-9e59-1a7798af7756

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → scheduled,20,5a856455-662d-4d49-94d6-ece783df3871,Lava Babii

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → scheduled,106,5a856455-662d-4d49-94d6-ece783df3871,Lava Babii

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → scheduled,222,5a856455-662d-4d49-94d6-ece783df3871,Lava Babii

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → scheduled,311,5a856455-662d-4d49-94d6-ece783df3871,Lava Babii

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → scheduled,414,5a856455-662d-4d49-94d6-ece783df3871,Lava Babii

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → scheduled,522,5a856455-662d-4d49-94d6-ece783df3871,Lava Babii

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → scheduled,611,5a856455-662d-4d49-94d6-ece783df3871,Lava Babii

[00:10] ELLEN GEE's DJ Schedule Board 2.0: → scheduled,619,5a856455-662d-4d49-94d6-ece783df3871,Lava Babii

[00:10] ELLEN GEE's DJ Schedule Board 2.0 # copy above into a notecard

Copy the this dump from your local chat window AS IT IS into a notecard named schedule. Anytime, you want to restore this schedule data in your board, simply drop this notecard into the Contents tab.

This dump is considered a backup. You can use it to re-configure the board when you receive an update, or when you move your board etc. Make a dump every time the schedule is modified.

Editing The schedule Notecard

Obviously, you can manually edit the schedule notecard if you know what you're doing. However, I will NOT provide support if you mess things up. So, just a little explanation about the format:

• To detect a valid line in the dump, the board looks for the unicode character → follow by a blank. Lines that do not contain that character are ignored.

• Data fields are separated by commas.

• The first data field contains the command (image or schedule).

• The command image must be followed by the SL name of the DJ avatar and a texture UUID.

• The command schedule must be followed by a time slot key, the DJ avatar's UUID and the DJ avatar's SL name. The time slot key consists of a weekday digit (0 = Monday, 1 = Tuesday, ..,. 6 = Sunday) and a 2-digit 24h time. Examples: Monday 18:00 has the key 018 (or 18); Thursday 8 pm has the key 320.

Changing The Background Texture

I've included full permission textures for the background of the DJ Schedule Board, one of which is a template. If you know a little Photoshop or Gimp, you can modify the background texture, add your logo, make a new title etc. Enjoy!