You are on page 1of 7

WWTBAM Three.

js Super Controller

About This Controller


This application is meant to be run under a web server environment such as IIS, Apache, etc…
You can run the application without a webserver but this requires you to alter security flags in
your web browser which you must do at your own discretion.

This program is built in WebGL using the Three.JS framework which means that it should run
virtually the same in any modern major web browser that supports WebGL, except Internet
Explorer (which you should not be using anymore anyway). A modest PC with good processing
capabilities is recommended. Base test shows that the application uses around 190 to 240
megabytes of memory.

If you refresh the web page to start a new instance it is best to perform a hard refresh which
is usually done by pressing and holding CTRL (CMD on Mac) and the F5 key. If the application
starts to lag you may need to check the memory usage in your web browser by pressing the
F12 key and going to the “Memory” tab (terminology may be different in other browsers,
Chrome is used in this example). Once the memory usage gets around 500 megabytes and a
hard refresh does not work, you may start to notice lag. If this happens, it is advised to just
close the browser and open a new instance.
The controller was built around a standard PC keyboard layout. Other keyboard variations
may not work or may require you to alter the “keyCode” values in the “keyboardControl.js”
file to make it work but you must know what you are doing.

Controller Setup
Settings

There are a number of settings that you can control that are defined in the
“customizableVariables.js” file inside the scripts folder. The details of each variable that you
can control should either be self-explanatory or will be noted with a comment detail
explaining what it does. Unless you know what you are doing, you are advised to stay out of
the other files.

Installation

The process of setting up the controller in a web server environment is the same as the
original HTML5 controllers, so you can follow the original documentation on how to setup the
original HTML5 controllers. However… there is going to be a slight difference with the setup
of this and future WWTBAM Three.js controllers. As you will see in the image below, there
will be a host of “SharedResources” that will be common to this and future controllers built in
Three.JS, such as sounds, APIs, graphics, etc. The game plan is that when the newer Three.JS
controllers come into play (super, clocked, shuffle, 2016, UK, etc…), all you will need to do is
drop the newer controllers into this corresponding folder called “Millionaire3D” and go from
there. All future contents should merge with existing folders without issue.

Controller Keyboard Mapping


All possible functions that this controller can perform are done so by using a standard PC
keyboard. Each animation is controlled by a repetitive press of a key (albeit a few cross each
other depending on what animation is taking action at the current stage in the controller).
The keyboard mappings are defined on the next page…
 Spacebar Key – When the game has loaded and rendered all graphics, press this Key to
begin the game. This key is only enabled if everything loaded correctly.
 Key A - This key animates all of the Ask The Audience functions. When a question is
active and all answers have been revealed, press the key repeatedly for each
animation until the voting graph leaves the screen. Once the graph leaves the screen,
each press hereafter toggles the audience results side-straps that appear next to each
answer. If the money tree is showing and the lifeline hasn't been used yet, pressing it
once will pulse it on the money tree.
 Key C – This key is used to go into and come out of a commercial break. This key can
ONLY be used when there are no other graphics on the screen and the current question
is resolved.
 Key D – This key animates all of the Double Dip functions. If the super money tree is
showing and the lifeline hasn't been used yet, pressing it once will pulse it on the
money tree. When a question is active and all answers have been revealed, perform
the double dip sequence in the following order:
o 1st Press - Starts the double dip sequence (sound plays, lifeline appears in the
center of the answers). At this point you will use the number 1 through 4 keys
to lock in an answer. Once an answer is locked in, continue to the 2nd press.
o 2nd Press – Once the first final answer is determine, the 2nd press will play the
corresponding sound and animations depending on if the answer is right or
wrong.
 If the answer is right, you no longer need to use this key and you may
take back over with the “Right Arrow” key to play out the remaining
question sequence.
 Else, if the first answer was wrong, proceed to lock in another answer
using the number 1 through 4 keys and then move on to the 3rd and final
press.
o 3rd and Final Press – Once a 2nd attempt an answer the question has been
made, the final press of this key will animate the appropriate content and
sounds. After the 3rd press, this key is no longer used and you may take back
over with the “Right Arrow” key to play out the remaining question sequence.
o Once double dip has begun, access to other lifelines are cut off for the duration
of the remaining question.
 Key E - This key plays the explain rules sound. The explain rules sound loops about 4
times before stopping. Replace the cues with a longer version if you have one to avoid
this sound from stopping to soon.
 Key F - This key animates all of the Fifty-Fifty functions. When a question is active
and all answers have been revealed, press the key once to remove two wrong answers.
If the money tree is showing and the lifeline hasn't been used yet, pressing it once will
pulse it on the money tree.
 Key G - This key is used to play the time up sound followed by the closing theme.
When there are no graphics being displayed and no question is in progress, press this
key to end the game. This key no longer “pauses” the game. To resume, update the
appropriate variables and then perform a refresh.
 Key L - This key is used to show / hide what lifelines are left when a question is in
progress. When a question is active and all answers are revealed, press this key to
show or hide the lifelines remaining for use.
 Key M - This key is used to show what a contestant is playing for in the upper right
corner of the screen. When a question is active and all answers are revealed, press
this key to show or hide what the contestant is playing for.
 Key N - This key is used to show / hide the contestant name and location. When no
other graphics are showing on the screen press the key to show or hide the contestants
name and location info.
 Key P - This key is used for all of the Phone a Friend functions. When a question is
active and all answers are revealed, press this key repeatedly to animate the phone
calling sequence. You may end the clock early by using this key as well but if the timer
runs out the clock with automatically remove itself, thus you will not have to press the
key anymore. If the money tree is showing and the lifeline hasn't been used yet,
pressing it once will pulse it on the money tree.
 Key Q - This key is used for playing the game resume sound after returning from a
commercial break. When no graphics, except for the money tree, are showing press
this key to play the question resume sound.
 Key T – This key is used to animate multiple Three Wise Men functions.
o 1st - If the super money tree is showing and the lifeline has not been used yet,
pressing it once will pulse it on the super money tree.
o 2nd - If the super money tree is not showing and no question is currently in
play, each press hereafter plays the “Reveal” sound and the “End Reveal”
sound. Once the “End Reveal” sound is played, use the either the “Q” or “E”
keys play a new ambience or explain rules sound (your choice).
o 3rd – If a question is active and all answers have been revealed then each press
will animate the Three Wise Men sequence. You may end the clock early by
using this key as well but if the timer runs out the clock with automatically
remove itself, thus you will not have to press the key anymore.
 Key U - This key is used to undo a final answer as long as double dip is not currently
being used (though technically it was final-ed ). It also plays a new instance of the
current background cue if it previously ended (except from questions 1 to 5, for that
one you’ll have to press the “X” key and then press the “U” key to get a new instance
going). You may replace the cues with longer versions if you have them to prevent the
sound from stopping to soon.
 Key W - This key is used for all of the walk away functions. When all answers are
revealed or when a contestant either gets the question wrong or answers the last
question correctly and the question and millionaire title graphics are no longer on the
screen, press this key to begin the walk away sequence. If the contestant is walking
away without answering the question then after the first press you may press 1, 2, 3 or
4 to lock in a "guess" as to what the answer the contestant thought the answer would
have been. Each press thereafter runs out the sequence until the total prize money
won has been taken back off the screen.
 Key X – This key calls a stop to all sounds currently playing. It however will not stop
overlapping sounds if you pressed a key that triggers the same sound multiple times
too quickly (say for instance, you pressed and held the “Q” key too long to play the
game resume sound and it plays more than one instance.) It only stops the most
recently played sound that has been mapped to a sound instance. This key does not
participate in the keyboard timeout function. This means that if you press this key,
you can immediately press another key to perform a function without having to wait
for the keyboard delay to resolve. This is a very useful key for adding audio breaks in
certain sequences for dramatic effect (i.e. pressing it right before locking in a final
answer so the final answer sound seems more blunt)
*** The next four keys CANNOT be performed using the numeric keypad located on the
right side of the standard keyboard. You must use the ones located above the main letters
Q W E R. ***

 Keys 1 through 4 – These keys lock in answer A through D respectively. When all
answers have been revealed press any one of these keys to lock in a corresponding
answer. If an answer has been removed by the fifty-fifty lifeline, you will not be able
to lock it in.

*** The next set of keys CANNOT be performed using the arrow controls sometimes
located on A, S, D, and W keys OR the arrows located in the numeric keypad on the right
of the keyboard (2, 4, 6, and 8). You must use the arrow keys located below the "Home,
End, Insert, Delete etc." keys on the standard keyboard. ***

 Left Arrow Key - This key has a dual purpose. It is used for all functions related to
fastest finger and the money tree. If you use the fastest finger mode, all fastest finger
animations are done first followed by the money tree animations. Else, the money tree
animations take over by default.
o Fastest Finger – All presses animate through the fastest finger sequence from
lights down to the contestant taking a seat in the hot seat.
o Money Tree – All presses animate through the run through of the money tree.
Once the tree is toggled off, each press thereafter toggles it back on or off.
The tree automatically updates as a contestant progresses through the game.
 Up Arrow Key – This key is only used once you have reached question 11 and is to be
used before you continue on into the next question. There are 3 totals actions
associated on each press. They are:
o 1st Press – Plays the new dimension stinger sound.
o 2nd Press - Plays the new dimension sound.
o 3rd and Final Press – Plays the drum roll sound. Once the drum roll sound is
played, use the either the “Q” or “E” keys play a new ambience or explain
rules super sound (your choice).

 Right Arrow Key - This key is used for all functions from the point where the lights
down sound plays to the correct answer being shown and hidden. Pressing this key
repeatedly navigates the question and answer animations. After the fourth answer is
revealed this key becomes unresponsive until a final answer is given. Then resume
pressing this key until the correct answer is revealed and hidden and any money won is
revealed and hidden. If an incorrect answer was given, once the question leaves the
screen, take over with the “W” key to finish out the walk away sequence.
o Also, as an added shortcut, if the money tree is toggled on after a previous
question is answered correctly, you can press this key with the tree still
showing after the lights down sound has been played to take the money tree of
and go straight into the question. This will eliminate having to manually turn
the money tree back off before beginning a new question.
 Down Arrow Key – Not used in this controller edition.

You might also like