1. Building a Wherigo ThomasfamilyZA & BrendsZA
GC4XMNH– 2014 Techno Event 1: Where u going?
15 March 2014

2. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

3. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

4. Wherigo players iPad/iPhone Garmin PocketPC devices Android/HTC
official Groundspeak Wherigo app
Garmin
some Nuvis, Colorado and Oregon
PocketPC devices
PocketPC player
Android/HTC
WhereYouGo app
Nokia Symbian phones
OpenWIG
Test your Wherigo player using the Wherigo Player Tutorial
15 March 2014
GC4XMNH Techno Event 1: Where u going?

5. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

6. Wherigo Builders Wherigo cartridges are written in Lua
Powerful light-weight scripting language
Used in Sim City 4 to customise rewards & some content
Used in World of Warcraft for interface customisation
Used in Adobe Photoshop Lightroom for user interface
Wherigo Builders help create Wherigo cartridges
Without knowing any Lua programming code
Using essentially plain English to set the actions
15 March 2014
GC4XMNH Techno Event 1: Where u going?

7. Wherigo Builders Groundspeak WherigoBuilder Earwigo
Still Alpha software
Last updated 2008
Mixed reviews about using it
Earwigo
Online only
Reviews seem good
Active forum on groundspeak forums
We didn’t try it out due to online designing only
15 March 2014
GC4XMNH Techno Event 1: Where u going?

8. Wherigo Builders Urwigo http://www.wherigo.cz/urwigo/#en
Active forum on groundspeak forums
Logic is flowchart driven
We learnt to use it in a few days
Active error trapping tells you about
Missing information
Program interface logic errors
Works offline, other than:
When you design zones
When you test the cartridge
15 March 2014
GC4XMNH Techno Event 1: Where u going?

9. Useful links - General
15 March 2014
GC4XMNH Techno Event 1: Where u going?

10. Useful links - Urwigo
15 March 2014
GC4XMNH Techno Event 1: Where u going?

11. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

12. Planning Spend time in the area you will use Explore it properly
Look at the landmarks and structures
Note the zones you want to use
Make sure that zones are:
Large enough for player to enter it, especially smartphone user
Far apart enough that the GPS won’t get confused
Not where muggles will get in the way
Find final location
Check availability with reviewer
15 March 2014
GC4XMNH Techno Event 1: Where u going?

13. Planning Plan the Wherigo Plan the concept Plan the story line
Align the story line with the area
Understand the distances to be travelled and time required
Plan the detailed logic to get through the cartridge
15 March 2014
GC4XMNH Techno Event 1: Where u going?

14. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

15. Designing - objects Zones Characters Items Tasks
Places the player needs to go to
Characters
People or animals that the player interacts with
Placed in zones
Items
Things that the player interacts with
Placed in zones or in player inventory
Tasks
Things that the player must do
15 March 2014
GC4XMNH Techno Event 1: Where u going?

16. Designing - logic Variables
Programming items to store logic or information
Counters
Values you use repeatedly
True/False indicators
Track progress
Timers to do/check time based tasks
15 March 2014
GC4XMNH Techno Event 1: Where u going?

17. Designing - logic Inputs Random events
Player responses from message boxes
Can be text input or choices
Random events
Can be used to create different stories each time
Consider asking some realworld questions
Prevents players from playing whole cartridge on an emulator and just going to ground zero
15 March 2014
GC4XMNH Techno Event 1: Where u going?

18. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

19. Building Build Zones Build Characters Build Items Build Tasks
Build Variables
15 March 2014
GC4XMNH Techno Event 1: Where u going?

20. Building Create Media and link to objects Place Characters and Items
Put them in starting zones
Have images and descriptions for all objects
Check that display starting status is correct
Check that active starting status is correct
15 March 2014
GC4XMNH Techno Event 1: Where u going?

21. Programming Build events Zone activations Character activations
Item activations
Interactions
Between player and Characters
Between player and Items
Between Characters and Items
Between Items
Message inputs
All player responses need to be allowed for
15 March 2014
GC4XMNH Techno Event 1: Where u going?

22. Cartridge requirements
With all the different players and screens, for the cartridge to be universal, must design for lowest common denominator
Images
Must be jpg format
Suggested to be 230 x 130 pixels
Icons must be 32x32 pixels in jpg format
Sound only works on Pocket PC devices
Create sound as mp3 files smaller than 512KB
Adjust sampling to get balance between size and quality
We used Audacity (free open-source sound editor)
15 March 2014
GC4XMNH Techno Event 1: Where u going?

23. Cartridge requirements
OnZone commands do not work on Garmin devices
OnClick for characters do not work on Garmin devices
OnClick for items do not work on Garmin devices
OnClick for tasks do not work on Garmin devices
Maximum of 5 active zones at a time
Garmin software has problems with emulation protection so leave it off
15 March 2014
GC4XMNH Techno Event 1: Where u going?

24. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

25. Testing the logic - emulator
Play all options repeatedly
Check it doesn’t crash or get stuck
Check zones and logic all work
Try stuff in an illogical order
Enter and leave zones partway through interactions
Try do things in the wrong order
Don’t assume players will do things the way you do
Check spelling
15 March 2014
GC4XMNH Techno Event 1: Where u going?

26. Testing the cartridge – real world
Download to as many devices as you can
Test them in the field as you did the logic
Play different options
Do it several times
Confirm the time taken
Check the distance involved
15 March 2014
GC4XMNH Techno Event 1: Where u going?

27. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

28. Implementation Listing on wherigo.com Listing on groundspeak.com
Check downloads and links
15 March 2014
GC4XMNH Techno Event 1: Where u going?

29. Agenda Wherigo Players Wherigo Builders Planning Designing Building
Testing
Implementing
Examples
15 March 2014
GC4XMNH Techno Event 1: Where u going?

30. Practical example 15 March 2014
GC4XMNH Techno Event 1: Where u going?