// TADS3 Example File
// Source: https://www.tads.org/t3doc/doc/t3QuickStart.htm

#charset "us-ascii"
#include
#include

versionInfo: GameID
IFID = '558c20af-6559-477a-9f98-b7b4274cd304'
name = 'The Best Burglar'
byline = 'by Eric Eve'
htmlByline = 'by
Eric Eve'
version = '3'
authorEmail = 'Eric Eve '
desc = 'You are the world\'s best burglar faced with the greatest challenge
of your felonious career.'
htmlDesc = 'You are the world\'s best burglar faced with the greatest
challenge of your felonious career.'
;

gameMain: GameMainDef
/* the initial player character is 'me' */
initialPlayerChar = me

showIntro()
{
"The Best Burglar\nWell, you've got this far. Now it's just a
quick nip inside the house and out again carrying the Orb of Ultimate
Satisfaction, an object that no burglar has ever managed to steal
before. If you can pull it off you're sure to win the Burglar of the
Year Award, putting you at the pinnacle of your profession.\b";
}

showGoodbye()
{
"Thanks for playing! ";
}
;

startRoom: OutdoorRoom 'Driveway'
"The large red-brick Tudor house stands immediately to the north of this end
of the driveway, while the drive back to the road where you left your
getaway vehicle runs off though a belt of trees to the southwest."

roomFirstDesc = "Here you are in the drive of Number 305 Erehwon Avenue,
with the great house you've come to burgle standing just before you to
the north. The drive back to the road where you left your getaway
vehicle runs off though a belt of trees to the southwest."

north = frontDoor
in asExit(north)
southwest = drive
;

+ me: Actor
pcDesc = "You're Alexis Lightfinger, burglar extraordinaire, the most
professional thief in the known universe; but you're on a job now, so
you don't have time for the narcissistic indulgence of admiring your own
appearance. You're far too professional not to have come fully prepared,
so there's no practical need to look yourself over again. "
;

++ Container 'large white swag bag*bags' 'swag bag'
"It's a large white bag with SWAG printed on it in very large
letters. Everyone knows that no real burglar would ever carry such a thing,
so by carrying it you know no one will take you for a real burglar. Cunning,
eh? "
;

+ frontDoor: LockableWithKey, Door 'solid oak front door*doors' 'front door'
"The lintel above the front door is carved with the date 1589, presumably
the date the house was built. The door itself is made of solid oak. "
keyList = [brassKey]

makeOpen(stat)
{
inherited(stat);
if(stat)
achievement.awardPointsOnce();
}

achievement: Achievement { +10 "opening the front door" }

;

+ flowerPot: ComplexContainer 'terracotta small flower flowerpot/pot*pots'
'flower pot'
"It's a perfectly ordinary small terracota pot, though it looks like no
one's got round to putting a plant in it yet. "
subContainer: ComplexComponent, Container { bulkCapacity = 3}
subUnderside: ComplexComponent, Underside { }

initSpecialDesc = "A small flower pot rests on the ground not far from the
front door. "

bulk = 3
bulkCapacity = 3
;

++ brassKey: Hidden, Key 'small brass key*keys' 'small brass key'
"It's an ordinary enough small brass key. "
subLocation = &subUnderside
;

+ Enterable -> frontDoor 'large red red-brick tudor house/mansion/front
*houses*buildings' 'house'
"It's a large red-brick Tudor house with mullioned windows, climbing
creepers and the date 1589 carved over the door. "
;

++ Component '(door) carved lintel' 'lintel'
"Its most noteworthy feature is the date 1589 carved into it. "
;

+ Decoration 'mullioned windows' 'windows'
"They're architecturally attractive, no doubt, but not especially helpful to
burglars. "

notImportantMsg = 'It\'s a matter of professional pride with you never to
mess with windows. '
isPlural = true
;

+ Decoration 'green climbing ivy/creepers/creeper' 'creepers'
"The front of the house is festooned with green creepers -- ivy, perhaps,
but botany was never your strong point since in the main plants aren't
worth burgling. "

notImportantMsg = 'The creepers can\'t help you burgle the house -- they\'re
certainly not strong enough to climb and they\'re certainly not worth
stealing -- so you may as well leave them alone. '
isPlural = true
;

+ drive: PathPassage 'drive/path/avenue' 'drive'
"The drive leading back to the road runs off through a belt of trees to the
southwest. "

dobjFor(TravelVia)
{
action()
{
"You retrace your steps back to the road, where your trusty unmarked
burglarmobile is still parked, ready for your quick getaway. ";

if(orb.isIn(me))
{
"Congratulations! You have got away with the Orb of Ultimate
Satisfaction, a feat never before performed. As you slip the orb
onto the back seat of your car and climb into the driver's seat
you tell yourself that you're now absolutely certain to win
the Burglar of the Year Award!\b";

achievement.awardPointsOnce();

finishGameMsg(ftVictory, [finishOptionUndo,
finishOptionFullScore]);
}
else
{
"It's a shame you didn't manage to steal the orb, though.
Without it you'll never win the Burglar of the Year Award
now.\b";

finishGameMsg(ftFailure, [finishOptionUndo]);
}
}
}

okayRubMsg = 'What -- all of it? That may take a while! '
achievement: Achievement { +10 "getting away with the orb" }
;

+ Decoration 'belt/trees' 'trees'
"The trees are in full leaf, which is good, because they hide what you're
doing from the road. "

notImportantMsg = 'The trees are doing a good job of hiding you from the
road, so you may as well leave them alone. It\'s not as if they\'re
something you could steal, after all. '
;

hallway: Room 'Hallway'
"This hall is or grand proportions but pretty bare. The front door lies to
the south and other exits lead east, north and west. "

south = hallDoor
out asExit(south)
west = study
north: FakeConnector { "You're pretty sure that only leads to the kitchen,
and you haven't come here to cook a meal. " }

east: DeadEndConnector { 'the living room' "You <>walk through the
doorway and find yourself in<>return to<> the living room
where you take <> a <>another<> quick look around,
but <><> once again<> failing to find anything of
interest you quickly return to the hall. "}
;

+ hallDoor: Lockable, Door -> frontDoor 'front door*doors' 'front door'
;

+ table:Surface 'small wooden mahogany side table/legs*tables' 'small table'
"It's a small mahogany table standing on four thin legs. "
initSpecialDesc = "A small table rests by the east wall. "
bulk = 5

dobjFor(Take)
{
check()
{
if(contents.length > 0)
failCheck('It\'s probably not a very good idea to try picking
up the table while <> still on it. ');
}
}
;

++ vase: Container 'cheap china floral vase/pattern' 'vase'
"It's only a cheap thing, made of china but painted in a tasteless floral
pattern using far too many primary colours. "

bulk = 3
bulkCapacity = 3
;

+++ silverKey: Hidden, Key 'small silver key*keys' 'small silver key'
;

study: Room 'Study'
"This study is much as you would expect: somewhat spartan. A desk stands in
the middle of the room with a chair placed just behind it. A <
picture.moved>>safe is built into <> rather bland painting hangs on
<> the west wall. The way out is to the east. "
east = hallway
out asExit(east)
;

+ desk: Heavy, Platform 'plain wooden desk' 'desk'
"It's a plain wooden desk with a single drawer. "
dobjFor(Open) remapTo(Open, drawer)
dobjFor(Close) remapTo(Close, drawer)
dobjFor(LookIn) remapTo(LookIn, drawer)
dobjFor(UnlockWith) remapTo(UnlockWith, drawer, IndirectObject)
dobjFor(LockWith) remapTo(LockWith, drawer, IndirectObject)
dobjFor(Lock) remapTo(Lock, drawer)
dobjFor(Unlock) remapTo(Unlock, drawer)
;

++ drawer: KeyedContainer, Component '(desk) drawer*drawers' 'drawer'
"It's an ordinary desk drawer with a small silver lock. "
keyList = [silverKey]
;

+++ notebook: Readable 'small bright red notebook/book/cover/pages'
'small red notebook'
"It's a small notebook with a bright red cover. "

readDesc = "You open the notebook and flick through its pages. The only
thing you find of any interest is a page with SAFE DATE scrawled
across it. After satisfying yourself that the notebook contains nothing
else of any potential relevance you snap it shut again. <.reveal
safe-date>"

dobjFor(Open) asDobjFor(Read)
dobjFor(LookIn) asDobjFor(Read)

dobjFor(Read)
{
action()
{
inherited;
achievement.awardPointsOnce();
}
}

cannotCloseMsg = 'It\'s already closed. '
achievement: Achievement { +5 "reading the notebook" }
;

+ CustomImmovable, Chair 'red office swivel chair' 'chair'
"It's a typical office swivel chair, covered in red fabric. "

cannotTakeMsg = 'You see no reason to burden yourself with such a useless
object; that would be quite unprofessional. '

;

+ picture: RoomPartItem, Thing 'rather bland picture/painting/landscape'
'picture'
"It's a landscape, pleasantly executed enough, but of no great distinction
and definitely not worth the bother of stealing. "

initNominalRoomPartLocation = defaultWestWall
initSpecialDesc = "A rather bland painting hangs on the west wall. "
isListed = (moved)

bulk = 8

dobjFor(LookBehind)
{
action()
{
if(moved)
inherited;
else
{
safe.discover();
"Behind the picture is a safe built into the wall. ";
}
}
}

moveInto(newDest)
{
if(!safe.discovered)
{
"Removing the painting from the wall reveals a safe behind. ";
safe.discover();
}
inherited(newDest);
}
;

+ safe: RoomPartItem, Hidden, CustomFixture, ComplexContainer
'sturdy steel safe' 'safe'
"It's a sturdy steel safe with a single dial on its door. "

subContainer: ComplexComponent, IndirectLockable, OpenableContainer
{
bulkCapacity = 5
makeOpen(stat)
{
inherited(stat);
if(stat)
achievement.awardPointsOnce();
}

achievement: Achievement { +10 "opening the safe" }
}

specialDesc = "A safe is built into the west wall. "
specialNominalRoomPartLocation = defaultWestWall
cannotTakeMsg = 'It's firmly built into the wall; you can't budge it. '

discover()
{
if(!discovered)
{
foreach(local cur in allContents)
cur.discover();

achievement.awardPointsOnce();
}
inherited();
}

achievement: Achievement { +5 "finding the safe" }
;

++ safeDoor: Hidden, ContainerDoor '(safe) door' 'safe door'
"It has a circular dial attached to its centre. "
;

+++ safeDial: Hidden, Component, NumberedDial 'circular dial*dials' 'dial'
"The dial can be turned to any number between <> and
<>. It's currently at <>. "

minSetting = 0
maxSetting = 99
curSetting = '35'

num1 = 0
num2 = 0
correctCombination = 1589

makeSetting(val)
{
inherited(val);
num2 = num1;
num1 = toInteger(val);
if(100 * num2 + num1 == correctCombination)
{
"You hear a slight click come from the safe door. ";
safe.makeLocked(nil);
}
else if(!safe.isOpen)
safe.makeLocked(true);
}
;

++ orb: Thing 'ultimate battered dull metal orb/sphere/ball/satisfaction'
'Orb of Ultimate Satisfaction'
"It doesn't look much be honest, just a battered sphere made of some dull
metal, but you've been told it's the most valuable and desirable object
in the known universe! "

aName = (theName)

subLocation = &subContainer

okayRubMsg = 'As {you/he} rub{s} {the dobj/him} a shimmering djiin suddenly
appears in the air before you!\b
Hello, you have reached the automated holographic answering service
of Jeannie the Genie, she announces. I\'m sorry I\'m not
available to respond to your rub in person right now, but my hours of
activity have been heavily curtailed by the European Working Time
Directive. Before making a wish, please make sure that you have
conducted a full risk assessment in line with the latest Health and
Safety Guidelines. Also, please note that before any wish can be granted
you must sign a Form P45/PDQ/LOL indemnifying this wish-granting agency
against any consequential loss or damage arising from the fulfilment of
your desires. Thank you for rubbing. Have a nice day!\b
Her message complete, the holographic djiin fades away into
non-existence. '

moveInto(dest)
{
inherited(dest);
if(dest.isOrIsIn(me))
achievement.awardPointsOnce();
}

achievement: Achievement { +10 "taking the orb" }
;

//------------------------------------------------------------------------------

/* DEFINE A NEW VERB */

DefineTAction(Rub)
;

VerbRule(Rub)
'rub' dobjList
: RubAction
verbPhrase = 'rub/rubbing (what)'
;

/* When creating a new verb, you'll want to modify the Thing class so as to provide
default handling for the command. The defaults specified here will be used except
on objects for which you define explicit handling of the command. */

modify Thing
dobjFor(Rub)
{
preCond = [touchObj]
action() { mainReport(okayRubMsg); }
}

okayRubMsg = '{You/he} rub{s} {the dobj/him} but not much happens as a
result. '

shouldNotBreakMsg = 'Only amateurs go round breaking things unnecessarily. '
;

//------------------------------------------------------------------------------

/* HINTS */

TopHintMenu;

+ Goal -> (frontDoor.achievement)
'How do I get into the house?'
[
'Well, the windows don\'t seem a good way in. ',
'So perhaps you\'d better try the front door. ',
'Could someone have left a key around somewhere? ',
'Is there anything lying around where someone could have hidden a key? ',
'What about that flowerpot? ',
'Try looking under the flowerpot. '
]

goalState = OpenGoal
;

/* The closeWhenSeen property of the following Goal object is an example of how to
make your hint menu respond dynamically to the player's current situation. */

+ Goal 'Where can I find the orb? '
[
'Something like that is bound to be kept safe. ',
'So it\'s probably inside the house. '
]

goalState = OpenGoal
closeWhenSeen = hallway
;

+ Goal 'Where can I find the orb?'
[
'It\'s sure to be kept somewhere safe. ',
'You\'d better hunt around. ',
'Somewhere in the study seems the most likely place. ',
deskHint,
'But it should be safely locked in a safe ',
'Where might someone hide a safe in this study? ',
'What could be behind that picture on the wall? ',
'Try looking behind the picture (or simply taking the picture). '
]

openWhenSeen = hallway
closeWhenSeen = orb
;

++ deskHint: Hint 'Have you tried looking in the desk drawer? '
[deskGoal]
;

+ deskGoal: Goal 'How do I get the desk drawer open?'
[
'Have you examined the drawer? ',
'What might you need to unlock it? ',
'Where might you find such a thing? ',
'What have you seen that a small key might be hidden in? ',
'How carefully have you searched the hall? ',
'What is (or was) on the hall table? ',
'What might that vase be for? ',
'Try looking in the vase. '
]
closeWhenSeen = notebook
;

+ Goal 'How do I get the safe open?'
[
'How carefully have you examined the safe? ',
'Where might someone leave a clue to the combination? ',
deskHint,
'Make sure you read the notebook. ',
'Once you\'ve found the combination you need to use the dial. ',
'If the combination is a number larger than 99 you\'ll need to enter it
in stages. ',
'For example, if the combination were 1234 you\'d first need to turn the
dial to 12 and then turn it to 34. '
]

openWhenSeen = safe
closeWhenAchieved = (safe.subContainer.achievement)
;

+ Goal 'What does the clue in the notebook mean?'
[
'Well, SAFE might refer to something you want to open. ',
'Have you seen a date round here? ',
'When was this house built? ',
'Where might you find the year in which this house was built? ',
'How carefully have you looked at the front of the house? ',
'Did you examine the door? '
]

openWhenRevealed = 'safe-date'
closeWhenAchieved = (safe.subContainer.achievement)
;


+ Goal 'What do I do with the orb now I\'ve got it?'
[
'Well, you could try rubbing it. ',
'But the main thing to do now is to escape with it. '
]
openWhenSeen = orb
;