Zita

# Print welcome message
p('Welcome to Zeqy, a simple (and short) text adventure demonstrating the \
possibilities of Zita, an even simpler Python text adventure engine. If you\'re \
completely lost, try asking the engine for help.\n')

# Include files
include(['functions', 'rooms', 'items', 'vars', 'commands', 'defaults'])

# Starting position
goto('grass1')

include(['stuff'])

room = {
'grass1': { # We start defining a room with the grass1 id
    'name': 'grassy field', # Its name (names are currently not used by Zita)
    'desc': 'You are standing on a grassy field covered with flowers. The wind \
almost blows you away.', # This is the description. The description of this
                         # room is shown when the user enters it.
    
    # Items are included in a list containing dictionaries. The 'id' property
    # should point to the id of an item, while the 'desc' property is optional
    # and can be used to describe the relationship between an item and the room
    # it is in.
    'items': [{
        'id': 'redflower',
        'desc': "'To the right is a ' + item[citem]['name'] + '.'"
        }, {
        'id': 'multic_flower',
        'desc': "'To the left is a ' + item[citem]['name'] + '.'"
    }],
    
    # Rooms includes directions in the 'dir' part. From the code below Zita
    # understands that walking north will take the user to the room with an
    # id of 'grass2', walking west will take the user to a swamp, going up
    # will result in a message telling the user going up is impossible, and
    # trying everything else will result in Zita giving the user a message.
    'dir': {
        'n': 'grass2',
        'w': 'swamp',
        'u': "!p('You can\\'t fly yet!')",
        '&rest': "!p('Going north or west should be possible.')"
    }
}
}

item = {
'redflower': { # This is the id. Rooms use ids like this.
    'name': 'red flower', # The name
    
    # Commands associated with the item and the code to execute on activation.
    # Apart from 'cmd', which reacts to an item no matter what state it is in,
    # there is also 'in' and 'out'. These are simply not needed in this case.
    
    # ┏━┓┏┓╻   ┏━╸╻ ╻┏━┓┏┳┓┏━┓╻  ┏━╸ 
    # ┣━┫┃┗┫   ┣╸ ┏╋┛┣━┫┃┃┃┣━┛┃  ┣╸ ╹
    # ╹ ╹╹ ╹   ┗━╸╹ ╹╹ ╹╹ ╹╹  ┗━╸┗━╸╹
    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    
    # A user types:
    # > eat red flower
    # Zita finds this item and executes the value of the 'eat' property in the
    # 'cmd' property. If there were no 'cmd' commands that matched the command,
    # Zita would move on to see if any 'in' or 'out' commands, depending on the
    # state of the item, matching the command existed.
    
    'cmd': {
        'eat': "p('It doesn\\'t seem edible.')",
        'look': "p('It\\'s pretty.')",
        'get': "p('The flower is stuck.')"
    }
}
}

item = {
'multic_flower': {
    'name': 'yellow flower',
    'cmd': {
        'smell':
# Using Python's multiline indicator (three quotes), one can write code that
# takes up more than one line. The code below prints a message and changes the
# color (in the name) of the current item. This happens when the flower is
# smelled to.
"""
flcolor = randelm(var['colors']) # Gets a random color. The 'var' variable is
                                 # explained later on.
p('You breathe in the fumes of the ' + item[citem]['name'] + '. In a matter of
picoseconds the flower changes its color to ' + flcolor + '.')
item[citem]['name'] = flcolor + ' flower'
""",
        'look': "p('It\\'s like the sun.')"
    }    
}
}

item = {
'wood': {
    'name': 'dry wood',
    'pref': 'some'
    # If 'some' wasn't specified as a prefix in this case, opening one's
    # inventory would read this:
    
    # You currently have:
    #   A dry wood
    
    # In this case, however, 'a wood' is not what we want to write. 'some wood'
    # is better. Setting 'pref' to 'some' solves this problem. Now it reads:
    
    # You currently have:
    #   Some dry wood

}
}

var = {
    # 'imposs' does not have to exist, though Zeqy needs it in the default
    # variable.
    'imposs': ['That\'s not an option.', 'I am unable to accomplish that \
particular feat.', 'That seems out of the question.', 'Are you stupid?', 'I \
could try, but I don\'t want to.', 'I\'m not doing that!', 'No way.'],
    
    # 'listoptions' MUST exist. If Zita prompts a user to choose between
    # several items, a list is created using characters from 'listoptions'.
    'listoptions': 'abcdefghijklmnopqrstuvwxyz',
    # Using these list letters would result in multiple-choice scenarios
    # looking like this:
    
    # > eat python
    # Which python?
    # a. dangerous python
    # b. Monty Python
    
    # 'which' MUST exist. It holds what to output when multiple items are
    # available. The variable what holds the current
    # object specified by the user. In the above example, what would be python.
    'which': "'Which ' + what + '?'",
    
    # 'invalidwhich' MUST exist. The value of this variable is output when
    # multiple items are available and the user attempts to get an item that
    # doesn't exist.
    'invalidwhich': "'Not a valid ' + what + '. Try again.'",
    #An example:
    
    # > c
    # Not a valid python. Try again.
    
    # 'steps' does not have to exist. It is self-explanatory.
    'steps': 0,
    
    # 'inventory' MUST exist. Normally it should be an empty list, but it is of
    # course also possible to have the user start with one or more items.
    'inventory': [],
    
    # 'location' MUST exist, though it isn't completely necessary to have it
    # defined here. Mostly, writing a goto function in the main file is better
    # than defining the room here. Defining the room here means that the user
    # will not see a startup message describing the current location.
    'location': None,
    
    # 'points' does not necessarily have to exist. Zita doesn't depend on it.
    'points': 0
}

command = {
    'steps': "p('You have taken ' + str(var['steps']) + ' steps.')"
}

command = {
    'go': # It's the common 'go' command!
"""
if len(cmd) == 1: # cmd is a list containing user input split with spaces.
    p('You can\\'t go nowhere.')
else:
    ltd = long2dir(cmd[1]) # Converts 'north' to 'n', etc.
    if not 'dir' in room[var['location']]:
        p('You are trapped!')
    elif cmd[1] != '&rest' and ltd in room[var['location']]['dir']:
        rname = room[var['location']]['dir'][ltd]
        if rname[0] == '!':
            exec(rname[1:]) # Only execute what's after the exclamation mark.
        else:
            goto(rname) # Use the goto function
    elif '&rest' in room[var['location']]['dir']: # Default action
        rname = room[var['location']]['dir']['&rest']
        if rname[0] == '!':
            exec(rname[1:])
        else:
            goto(rname)
    else:                               # Converts 'w' to 'west', etc.
        p('It is not possible to go ' + short2dir(txt[len(cmd[0])+1:]) + '.')
"""
}

command = {
    'n': # 'go n' shortcut
"""
txt = 'go ' + cmd[0] # Not really needed
cmd = ['go', cmd[0]] # Fools the 'go' command
exec(command['go']) # Acts as if the program was the user
""",
    # Applying more shortcuts are even easier:
    'ne': "exec(command['n'])"
}

default = {
'item': { # Default values for items
    'cmd': {                   # Either 'a', 'an', 'some', etc.
        'look': "p('It\\'s ' + getprefix(citem) + ' ' + item[citem]['name'] +
'.')",  # The exec_proper_command function will find the correct place to look
        # for a command. A hierachy is defined in Zeqy's defs.py.
        'lookat': "exec_proper_command('look', i, i_or_o, citem)",
        
        # The rest is simple shortcut-shortcuts.
        'examine': "exec(default['item']['cmd']['lookat'])",
        'e': "exec(default['item']['cmd']['lookat'])",
        'l': "exec(default['item']['cmd']['lookat'])"
    },
    'out': {
        'get': # All items should be gettable by default.
"""
p('You take the ' + item[citem]['name'] + '.')
inv(citem) # Adds item to inventory
""",
        'take': "exec_proper_command('get', i, i_or_o, citem)",
        'g': "exec(default['item']['out']['take'])",
        't': "exec(default['item']['out']['take'])"
    }
},

# 'item-substitutes' MUST exist. It is used as a reference to a previous item.
# This specific property could just as well have been placed in the var
# variable, but for now it must be in default.
'item-substitutes': ['it'],

# Zita will print a random messages of the list when there is no command match.
'command': "p(randelm(var['imposs']))",

# Code to execute when a load has been succesfully completed. Not strictly
# necessary, but quite useful.
'loaded': "p('Data succesfully loaded.\\n\\n')",

'room': { # Rooms can have default values too.
    # Will be shown if no room description exists.
    'desc': "'You have reached a ' + croom + '.'",
    
    # Will be shown if no item description exists.
    'item': "'You see ' + getprefix(citem) + ' ' + item[citem]['name'] + '.'"
}
}