.

One of the buildings of Hippo Campus, Edwards Hall, is a dormitory where almost anyone may build a room for herself, himself, or itself. The only people who are excluded from building there are guests.

This tutorial will guide you through the exercise of building such a room. Since you won't be able to read this tutorial while you're building, you may want to jot down some notes, or copy/paste this information into another window, before heading off to Edwards Hall.

The first thing that you should do before settling down to build is to find a place for your room to connect.

Go to Edwards Hall (either on foot or by the `@go edw' command as explained in the Basic MOO Commands module), and explore the Cutler and Burnett towers. If you find a numbered room in either tower with the description `Vacant', then you may build on that exit.

The command used to construct a new room is the @dig command. It has several forms, depending on how the new room is to be connected to the current room.

Syntax:

@dig <exit1,exit2,...>|<entrance1,entrance2,...> to <name>

Example

@dig west,w|east,e,out to Simon's Pie Shop

This form of the command does a number of things. First, it creates a new room (Simon's Pie Shop).

Next, it creates exits from the current room to the new room, and from the new room to the current room. These exits are attached to the current room only if you have permission to build from there.

The list of exits

<exit1,exit2,...>|<entrance1,entrance2,...>

specify the directions which can be typed to move between the current room and the newly-created room. For example,

west,w|east,e,out

means that the exit from the current room to Simon's Pie Shop can be accessed by typing `west' or just `w', and the return exit from Simon's Pie Shop to the current room can be accessed using `east' or `e' or `out'.

If you have permission to attach exits to the current room, you will see something like the following messages.

Simon's Pie Shop (#2723) created.

Exit from The Current Room (#1381) to Simon's Pie Shop (#2723) via

{"west", "w"} created with id #2144.

Exit from Simon's Pie Shop (#2723) to The Current Room (#1381) via

{"east", "e", "out"} created with id #2719.

If you *don't* have permission to attach exits to the current room, you will see something like the following messages.

Simon's Pie Shop (#1052) created.

Exit to Simon's Pie Shop (#1052) via {"west", "w"} created with id #1735.

However, I couldn't add #1735 as a legal exit from The Current Room.

Get its owner, Mike to add it for you.

Exit from Simon's Pie Shop (#1052) to The Current Room (#1249) via

{"east", "e", "out"} created with id #2769.

However, I couldn't add #2769 as a legal entrance to The Current Room.

You may have to get its owner, Mike to add it for you.

Note that even though the exit and entrance couldn't be attached to the current room, they still exist!

What happens if something went wrong, and you want to start over?

Whenever you no longer need one of your objects (including room and exit objects), it's a good idea to destroy it. This is done using the @recycle command.

Syntax: @recycle <object>

Examples: @recycle west

@recycle #1735

At Hippo, you will be asked to confirm that you really want to @recycle the object before it is destroyed. You can @recycle only those objects that you own.

What happens if you don't @recycle your unwanted objects, but just ignore them? Well, nothing at first. But if everyone managed their objects in the same way, the database of objects would eventually become too large for the host machine to handle efficiently.

For this reason, every user has a *quota* of objects, which under ordinary circumstances cannot be exceeded.

At Hippo Campus, both the number of objects you own, and the total size of the objects in bytes, is counted towards your quota.

To find out what your quota is, just type:

Syntax: @quota (to find out your own quota)

@quota <player> (to find out the player's quota)

Examples: @quota

@quota mike

@quota #720

To help manage your collection of objects, the @audit command can be used to get a listing of every object you own.

Syntax: @audit (to get a list of your own objects)

@audit <player> (to get a list of the player's objects)

Examples: @audit

@audit Fedi

@audit #141

Now that you know how to manage the objects you've created, let's take another look at the @dig command.

If you want to connect an existing room to the room you currently occupy, a variation of the @dig command can be used. The command creates only the exits linking the two rooms:

Syntax:

@dig <exit1,exit2,...>|<entrance1,entrance2,...> to <object-number>

Example:

@dig west,w|east,e,out to #1381

The room MUST be specified by its object number, otherwise the server will think that you want to create a new room instead of connecting to an existing room (#1381).

For each of the two main @dig variants --- building a new room and connecting to an existing room --- it is possible to omit the specification of a return exit:

Syntax: @dig <exit1,exit2,...> to <new-room-name>

@dig <exit1,exit2,...> to <object-number>

Examples: @dig west,w to Simon's Pie Shop

@dig west,w to #1381

In these examples, an exit is created from the current room to Simon's Pie Shop (or room object #1381) via `west' and `w'.

In fact, when building a new room it is not even necessary to specify any exits at all:

Syntax: @dig <new-room-name>

Example: @dig Limbo

This creates a new room called Limbo which cannot be accessed by any conventional means. Commands such as @go and @join which allow you to `jump' or `teleport' directly to a place will still allow you to go there.

Building rooms in Hippo Campus is a social act, and as such simple rules of etiquette apply. Here are some guidelines for building at Hippo:

* Rooms shouldn't just float in space, disconnected from the main campus.

Try to find an area where your room `fits', and if necessary ask for

it to be attached there.

* Your room should have an exit labeled `out'. One of the conventions

followed at Hippo is that by typing `out' repeatedly, one would

eventually end up back at the Orientation Centre. Please follow

this convention whenever it makes sense.

* You should list the exits of your room in the room description.

Unless there is a compelling reason for the exits to be kept secret,

it is common courtesy to inform others as to how to leave your room.

The next tutorial, `Adding Details to Rooms', explains how to set the descriptions of your rooms and exits.

You have just seen an overview of the most basic commands used for building rooms at Hippo Campus. To get a list of other commands related to building rooms (and creating objects in general), type

help builder-index

You can get more information about these commands by typing

help <command-name>

If you are interested in customising your rooms even further, I recommend that you investigate all the builder commands relating to `messages' and `pronouns'.

 

This site is best viewed in 800 x 600, or 1024 x 768. If you find any faults in our page on certain browsers, please report them so we may fix the problem.
Copyright © NJO 2001.
For problems or questions regarding our site, contact our [WebMaster].
Last updated: August 25, 2001.