There are various different ways that ded and xg definitions can be included with your map. You can either supply them seperately in a mywad.ded (pure text file editable in any text editor), embed the data into the dd_defns lump in your wad or put all the data files for your wad into a pk3 file. If you use purely XG (no DED's) you also have another option of compiling your XG data into a special lump called dd_xgdata.
The method I'm going to describe here deals with using DoomBuilder to include your DED with your j_doom map. This is achieved by including your DED into a special lump called DD_DEFNS.
This might look a bit long winded, it really isn't, I've just tried to cover it as thoroughly as I can.
For the sake of this HOWTO I have already created a one level wad, saved in the MAP01 slot. It's a simple square room with a couple of sectors and a player start (if you need help on getting this far then check out Dr Sleep's excellent manual available at DoomBuilder.com).
doomsday DEDs do NOT need to be compiled, in fact they can be edited while Doomsday is running and then re-read at any time. The disadvantage of this method is that in order to make changes to your DED you will need to close Doomsday, open DoomBuilder, edit your DED then save and start Doomsday again.
For information on a more flexible method to use whilest building your wad check the editing_deds_at_runtime HOWTO.
The next dialog box you'll see will ask you to Select Map from mywad.wad.
You'll also see a selection box with the label Game (this tells Doom Builder what game we are editing for).
Now we're ready to start writing our DED. Let's do something cool like getting our name to show up at the start of the level and giving a sector some neat red lighting. This will show you two things:
A) How to write a DED
B) How to use XG to add red lighting to a sector
This menu contains all the jDoom specific lumps that can be edited in Doom Builder (dd_xgdata has to be compiled so doesn't appear in this list).
You should now see DoomBuilder's Script window. Now because we haven't yet created a dd_defns lump you will now need to:
This is where you can insert all your DED definitions and your XG line/sector classes. The first thing we are going to do is add the header. This isn't compulsory but I'm going to do it anyway:
Header { Version = 6 }
Now lets add the name of the map and our name, so they appear at the start of the level! The following code might look alien to you but don't worry about that at the moment ( check out map_info_ded_ for more information on this class ).
Map Info {
ID = "MAP01" Name = "This is the name of the level" Author = "This is MY name" Sky Layer 1 { Flags = enable Texture = "SKY1" } }
Now lets make that sector with the red lighting I mentioned earlier. This is a two stage process, we need to create a new SectorType then we need to attach it to our sector. Note the line that says ID = 8000, this is the number we'll use to attach our SectorType to our sector, so remember it for latter.
Again this will look totally alien but don't worry about that atm (check out the XG reference for more information on XG Line and Sector types).
Sector Type { # My Red Light.
ID = 8000 Red fn = "z" Green fn = "a" Blue fn = "a" }
Thats it. We've now finished creating our DD_DEFNS lump so we can now close the script editor:
Now we need to attach our sector_type to a sector. Choose a sector you want your red light in.
Remember the ID of our new sector_type? It's 8000 in case you've forgotten.
That's it. We've now finished setting our map up so all we need to do now is save our map and load up Doomsday.
Now load up Doomsday and revel in the glory of your name appearing at the start of the map and our cool red lighting.