I've been writing this Guide to SWR Building since April, 2000, off and on. If you add or change anything, which I would like to see, please follow the directions at the bottom of the screen in the credits section. Thanks.
Table of Contents:
I. What is Star Wars Reality Building?
A. SWR and Durga
B. The Difference between "done" and "prototype"
C. Committment-Why we build instead of play!
II. Tools of Building
A. Help files, help files, help files!
B. Redit. Redit is your friend
1. Redit Commands
2. Redits confusing flags
3. Redit exflags
C. Savearea
1. What is Savearea?
2. Why does Savearea not always work?
D. Mcreate, Mset and PURGE!
1. Mcreate
2. Mset
3. Purge!
E. Ocreate, Oset and those nasty little memory eaters.
1. Ocreate-Is this like mcreate?
2. Oset-Is this like mset?
3. Why you never ever ever ever use another zones items (or mobs)
III. What to do now
A. Mobile/Object/Room Programs
1. Programs at their worst!
IV. Building Tips
A. Descriptions
B. Mobiles
C. Objects
D. Building Ethics ***Very Important***
V. Credits
A. Thanks
B. Who has created/added to this building guide?
I. What is Star Wars Reality Building?
A. SWR and Durga
Durga was the "main" creator of Star Wars Reality, a derivative of Smaug and Diku. SWR basically opened up the Star Wars mudding experience for mere mortals like we all used to be. Before there were only a few muds that didn't follow Star Wars timelines very well or had lame immortals.
SWR Building is always online. It uses a set of commands that are contained within the MUD to create new areas and rooms, that are interconnected (usually through a space port, where ships can land and takeoff into space from) to other areas. Since the new area is created and saved online, there is no need to "upload" or "install" areas, other than a simple Implementor command.
B. The Difference between "Done" and "prototype"
Now, when an implementor first assigns you a set of vnums (VIRTUAL NUMBERS, which are the numbers that hold your new areas information, like rooms, mobiles, objects, ya know that stuff), the area is created with your name with .are at the end of it. So if I assigned myself some vnums, my new area would be called "Isaac.are" and the area would loadup everytime I logged in after a reboot or crash.
Since it's a new area, yet to be finished, it is a "prototype" area, meaning everything in it is new and isn't necessarily going into the finished product. Done is when you have everything essential for the players to live there (or if its a hostile environment they would only want to
visit for a short while, everything you need to fulfill the purpose of the area as a player is what you need to be done). No area should be installed until it is marked "Done" by the Head Builder or Game Administrator.
C. Committment-Why we build instead of play!
Ok, most old builders will tell you that building is no fun. That is, in part, true. Building takes a lot of effort and drains out a lot of your Real Life time. You'll usually have something fail on you and it will drive you nuts. But that's ok. Most things in life screw up once in a while and it takes a strong person to get back in there and start rolling.
What old builders don't tell you is the satisfaction you get when you hear some player yell how great the new Alderaan is or how much better this Coruscant is than from the one they were so used to. And the little hidden secrets you put in your area and the programs you install make everything worthwile. Exploring is for the kiddies. Creating is what the true of heart do. So get out there and start building!
II. Tools of Building
A. Help files, help files, help files!
Yes, most of the commands you will need do have help files. First off, try typing wizhelp. That shows all the immortal commands you have access to. Not all are building commands, but just start off with help and start from the top. Help files are good. Really good.
B. Redit
The most used command in SWR building is redit. Redit stands for Room Edit and it does just that. It edits the room you are in. You can change its title (name kinda), the room description, where the exits lead and a bajillion other things (well not that many, but a dozen at least!).
1. Redit commands
Ok now there are a few commands you're gonna need to know. Redit shows them just by typing redit. If you type Redit, you'll see:
Build: : redit
Syntax: redit value
Field being one of:
name desc ed rmed
exit bexit exdesc exflags exname exkey
flags sector teledelay televnum tunnel
rlist exdistance
Pretty complex stuff huh? Let's go over some of these terms.
name-This will change the "title" of the room. Easy as pie, its usually the actual room name, so no sweat.
desc-This will change the rooms description. Usually descriptions are fairly thorough and include a lot of detail. References to the word "you" are frowned upon by most builders however.
ed-This is just an extra description, using keywords. I don't use it, much.
rmed-This just removes the ed (extra description). Again, not too useful unless you like that sort of thing.
exit-This is usually used to remove an exit by typing redit exit north, which will remove the exit to the north.
bexit-This is what we usually use to create exits on both sides of rooms. Typing redit bexit n 2005 creates an exit from the room you're in leading north into room 2005.
exdesc-This writes a description for an exit. Good builders use this in important areas.
exflags-This command will make certain flags available on exits, like doors, closed, locked, broken, un-bashable, etc.
exname-Keywords for exits and stuff.
exkey-This is an exits key vnum. You set an areas object vnum as the key for that exit and it'll work! (dont forget to do the other side..)
flags-This will allow you to view the flags that are available for redit. We'll go into that more later.
sector-Makes the room a certain way, like dark, underwater, on top of water, etc. teledelay-This is the amount of seconds that a teleportable room will wait before teleporting a character in the room.
televnum-This is the room vnum a teleporting room will send a character to after its delay is set.
tunnel-this is the amount of people that can fit in this room. useful for caves and ships.
rlist-Gives a list of rooms in your area
exdistance-Set the distance between this room, and the destination room
Boy that was rough! Ok, now that you've read (and hopefully played around with) all of these commands, try taking a break. I like to have a bag of chips lying around, preferably BBQ, when I'm building. Go get some food, take a nap, whatever.
2. Redits confusing flags
Alright, now that you know the basics of redit, lets venture into redit flags!
Redit flags is fun, it gives you a bunch of useless options that you only use when you're feeling creative. Here is an example of what you see when you type redit flags.
Build: Isaac: redit flags
Toggle the room flags.
Usage: redit flags [flag]...
Possible Flags:
dark, nomob, indoors, nomagic, bank,
private, safe, petshop, norecall, donation, nodropall, silence,
logspeach, nodrop, clanstoreroom, plr_home, empty_home, teleport
nofloor, prototype, refinery, factory, republic_recruit, empire_recruit
spacecraft, auction, drive, can_land, can_fly, hotel
dark-Makes the room dark. Players need lights or really great vision!
nomob-Mobs can't get in this room.
indoors-Inside. No weather here!
nomagic-Sorry Forcers, your kind isn't wanted here! No magic for you!
bank-Players can withdraw/deposit money here (Obsolete if you have universal transfer allowed)
private-Private, no one else but the owner can enter.
safe-Safe room, no fighting.
petshop-I guess pets are bought here?
norecall-Can't recall out (leftover from smaug i guess, never used it)
donation-Can donate..what?
nodropall-You can't type "drop all" and get away with it.
nodrop-You can't drop a single item.
clanstoreroom-A clan can leave items here and they'll save through reboots and crashes, theoretically.
plr_home-Player owns this home (usually not used, use empty_home instead)
empty_home-A room that can be bought by a player.
teleport-Room will teleport a player after a certain amount of time.
nofloor-No floor here.
prototype-Prototype room.
refinery-Spice can be made here.
factory-Engineers can make stuff here.
republic_recruit-You can enlist in the republic in this room.
empire_recruit-Same as above for Empire.
spacecraft-This means that the room is in a spacecraft.
auction-People can auction in this room (if auction code is working)
drive-New flag! Speeders can drive in this room, regardless of what other flags say.
can_land-Ships can land here. Usually for landing pads.
can_fly-Ships can fly here. Usually for landing pads.
hotel-Players can quit out of the game here.
A very impressive list. If you ever feel like venturing into the actual SWR code, try looking at do_redit. The code that is required for this simple little command is ENORMOUS. Makes you appreciate the coders just a little bit more.
3. Redit exflags
Exflags means what it looks like: Extra Flags. These flags are stuff that you don't use often because they are more specific. Let's look at some of the options for Exflags.
Build: Isaac: redit exflags
Toggle or display exit flags.
Usage: redit exflags [flag]...
Exit flags:
isdoor, closed, locked, can_look, searchable, can_leave, can_climb,
nopassdoor, secret, pickproof, fly, climb, dig, window, auto, can_enter
hidden, no_mob, bashproof, bashed
isdoor-Using this flag means that the exit in the specified direction is a door.
closed-This flag says that the exit is closed, if it's a door.
locked-Using locked means that the exit is locked. Make sure to use isdoor and closed.
can_look-This flags simply means you can "look" in the direction.
searchable-A flag I haven't used often, means that you can search in that direction.
can_leave-Means the exit is leaveable
can_climb-Person can use the climb skill to climb up this direction.
nopassdoor-What it says, a door that you cannot pass.
secret-Secret from mortal eyes.
pickproof-A thief with pick lock cannot pick this lock.
fly-Direction can't be passed without the ability to fly.
climb-Must climb.
window-When a player "looks" the direction will be a window they can look through.
auto-Never used this before. Anyone know?
can_enter-Direction can be entered.
hidden-Hidden from mortal eyes.
no_mob-Mob cannot go this direction
bashproof-Bash skill will not work against this.
bashed-Appears to a mortal as if the door has already been bashed.
As you can see, these flags you won't use a whole lot but should be used a little in your areas. Windows are useful in buildings, if not only for just the reality issue. Buildings have windows. Also, dig and climb are good because you can't practice those skills often in most muds.
C. Savearea
Ok Savearea is the command you will want to use a LOT. It saves your area file, making it possible to actually make progress instead of having to go back and redo everything. This allows you to get everything done that you want done in days, weeks, months, years, instead of all at once. Useful eh?
Yes, it's true. Sometimes Savearea doesn't always work. Usually that's if the mud crashes. But there are times that it just apparently doesn't save something. It's probably your fault, but sometimes even I notice it and can't figure out why. Nothing is 100% bug-free.
D. Mcreate, Mset and Purge!
The following commands are tools you will use when creating Non-Player Characters, commonly referred to as mobs. NPCs are characters in the mud that you assign certain features and characteristics and then basically just let them go. They are basically used for by mortals for the following reasons: To kill, either to get money or lower a clans popular support, and to get things from, like items, in shops.
1. Mcreate
The mcreate command will show the following.
Build: Isaac: mcreate
Usage: mcreate [cvnum]
Now, I've only use vnum. Cvnum is something I've never encountered and I've never heard of anyone using it. That doesn't mean you should ignore it. Be more ambitious then I. You're only a builder, I'm an Implementer. So, the part is the vnum you want to use. It can be anything allotted in your area file. If you had Isaac.are and were assigned 5000-5100, you could use any of the numbers between 5000 and 5100. The is the name you want to give this mob.
2. Mset
Using the mset command will show the following.
Build: Isaac: mset
Syntax: mset
Field being one of:
str int wis dex con cha lck sex
credits hp force move align race
hitroll damroll armor affected level
thirst drunk full blood flags
pos defpos part (see BODYPARTS)
sav1 sav2 sav4 sav4 sav5 (see SAVINGTHROWS)
resistant immune susceptible (see RIS)
attack defense numattacks
speaking speaks (see LANGUAGES)
name short long description title spec spec2
clan vip wanted pillar rank
For editing index/prototype mobiles:
hitnumdie hitsizedie hitplus (hit points)
damnumdie damsizedie damplus (damage roll)
To toggle area flag: aloaded
There is a LOT to mset. It's probably the most valuable command when it comes to characters, mobs or morts. I'll try to be descriptive enough so that you can understand it all. I don't know everything in here, so I hope someone adds in what I do not know or I find out before I publish the guide. Also notice that your mset might have a few commands missing, like pillar and rank. Those are Dark Horizon custom fields and you probably won't have them.
str-The strength the character has. From 1-25 depending on the mud.
int-The intelligence the character has. From 1-25 depending on the mud.
wis-The wisdom the character has. From 1-25 depending on the mud.
dex-The dexterity the character has. From 1-25 depending on the mud.
con-The constitution the character has. From 1-25 depending on the mud.
cha-The charisma the character has. From 1-25 depending on the mud.
lck-The luck the character has. From 1-25 depending on the mud.
sex-Characters sex: Male, female, or neutral.
credits-Amount of credits a player has on hand.
hp-Hitpoints the character has.
force-Force mana the character has. (Usually only for forcers)
move-The movement points the character has. (Mobs usually don't need this).
align-A character's alignment, from -1000 to 1000.
race-Characters race. Varies on the mud, check with your Implementor to find out the races.
hitroll-Hitroll is the how often the character hits in an attack and succeeds.
damroll-Damroll is how hard the character hits when it succeeds in an attack.
armor-Armor ranges from 100 to -350. The lower your armor, the better off you are.
affected-This is what affects the character. Talk to your Implementor to find out this.
level-The toplevel of the character. I usually use this as it auto-sets many other settings.
thirst-How thirsty the character is at the moment.
drunk-How drunk the character is at the moment.
full-I think this is how hungry a character is at the moment, could be wrong.
pos-The characters position at the moment.
defpos-The characters default position.
part-Sets something about a characters parts, like head, foot, etc. Not sure what it all does.
sav1 through sav5-See help savingthrows for explainations for these.
resistant-What a character is resistant to.
immune-What a character is immune to.
susceptible-What a character is susceptible to.
attack-What the character will use for attack.
defense-What the character will use for defense.
numattacks-Number of attacks a character will have.
speaking-What a character is speaking.
speaks-What a character speaks.
name-Characters name.
short-Character's short description (when you look at it).
long-Character's long description (what you see when you type look).
description-Mortals description when you look at him/her.
title-Mortals title in "who".
spec1 and spec2-See help spec_funcs.
clan-Mortals clan.
vip-What planet a character is a citizen on.
wanted-What planet a character is wanted on.
pillar-What pillar a character belongs to (Dark Horizon only).
rank-Sets a players rank in "who" (Currently being recoded due to my crappy coding in the 1st place).
There are the numdie and stuff left, but I'm not going to go into detail about those. You can usually get by without even messing with those if you just set the characters level. It'll set the other stuff all by itself. Neat huh?
3. Purge
Purge is a command that basically gets rid of an item or mob. Never use slay on a mob, that's buggy and not meant for mobs. It's meant for players. Use purge. It's there for a reason.
E. Ocreate, Oset and those nasty little memory eaters.
1. Ocreate
Ocreate is like mcreate but creates items instead of mobs.
Build: Isaac: ocreate
Usage: ocreate [copy vnum]
Just like mcreate. Vnum is the vnum, item name is the items name.
2. Oset
Oset is like mset in that it defines a items properties and such in the game. It's a little nicer to look at though. Here we go!
Build: Isaac: oset
Syntax: oset