Building a Wherigo Graham Thomasfamily ZA Brendan Brends

Building a Wherigo Graham (Thomasfamily. ZA) Brendan (Brends. ZA) Nicole (Thomasfamily. ZA) GC 3 KEQY - 2012 Techno Event 3 30 June 2012 http: //www. thomasfamily. co. za/geocachingpresentations

Agenda Wherigo Players Wherigo Builders Planning Designing Building Testing Implementing Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 2

Agenda • Wherigo Players Wherigo Builders Planning Designing Building Testing Implementing Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 3

Wherigo players i. Pad/i. Phone official Groundspeak Wherigo app Garmin some Nuvis, Colorado and Oregon Pocket. PC devices Pocket. PC player Android/HTC Where. You. Go app Nokia Symbian phones Open. WIG Test your Wherigo player using the Wherigo Player Tutorial http: //www. wherigo. com/cartridge/details. aspx? CGUID=4 b 3 fa 42 a-26 af 4120 -97 ce-4333 dd 34 db 04 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 4

Agenda Wherigo Players • Wherigo Builders Planning Designing Building Testing Implementing Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 5

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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 6

Wherigo Builders Groundspeak Wherigo. Builder 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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 7

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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 8

Useful links - General http: //geocass. wordpress. com/2011/02/15/wherigocaches-%E 2%80%93 -part-2 -building-cartridges/ http: //www. earwigo. net/WWB/wiki/doku. php? Doku Wiki=75 ddf 31 e 0 c 2 b 71 bcc 7 d 8954 bd 9 fe 54 e 3 http: //wherigobuilder. wikispaces. com/ http: //www. wherigo. com/faq. aspx http: //www. cacheupnb. com/a-quick-guide-todesigning-wherigos/ 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 9

Useful links - Urwigo http: //forums. groundspeak. com/GC/index. php? s=b 69 6 a 7 ee 7185 e 77 e 63 eb 7 d 80 fadf 4 c 29&showforum=62 http: //forums. groundspeak. com/GC/index. php? showt opic=242148 http: //members. home. nl/huyzer. koens/ 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 10

Agenda Wherigo Players Wherigo Builders • Planning Designing Building Testing Implementing Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 11

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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 12

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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 13

Agenda Wherigo Players Wherigo Builders Planning • Designing Building Testing Implementing Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 14

Designing - objects Zones 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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 15

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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 16

Designing - logic Inputs 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 realtime questions Prevents players from playing whole cartridge on an emulator and just going to ground zero 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 17

Agenda Wherigo Players Wherigo Builders Planning Designing • Building Testing Implementing Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 18

Building Build Zones Build Characters Build Items Build Tasks Build Variables 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 19

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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 20

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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 21

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 32 x 32 pixels in jpg format Garmin software has problems with emulation protection so leave it off 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 22

Cartridge requirements On. Zone commands do not work on Garmin devices On. Click for characters do not work on Garmin devices On. Click for items do not work on Garmin devices On. Click for tasks do not work on Garmin devices Maximum of 5 active zones at a time 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 23

Agenda Wherigo Players Wherigo Builders Planning Designing Building • Testing Implementing Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 24

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 Try do things in the wrong order Don’t assume players will do things the way you do Check spelling 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 25

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 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 26

Agenda Wherigo Players Wherigo Builders Planning Designing Building Testing • Implementing Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 27

Implementation Listing on wherigo. com Listing on groundspeak. com Check downloads and links 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 28

Agenda Wherigo Players Wherigo Builders Planning Designing Building Testing Implementing • Examples 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 29

Some practical examples Taken from GC 326 H 6 Bezuidenhout Park Adventure Story Example 1 Zone setups Example 2 Basic character inputs & random events Example 3 Changing object details 30 June 2012 GC 3 KEQY - 2012 Techno Event 3 30