Difference between revisions of "Modding:Documentation"

From DoomRL Wiki

Jump to: navigation, search
m (removed 0994 warning)
(Main Objects)
 
(7 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
== Getting Started ==
 
== Getting Started ==
 +
As of right now the best place to learn about modding DoomRL is to view the source code of current mods and, if you can't find what you need there, to ask for advice on the Chaosforge IRC channel, #chaosforge. Mods and their sources can be found in the modding section of the Chaosforge forums. IRC, if you are not familiar with it already, can be accessed quickly by using a free web based IRC client like the one found [http://en.irc2go.com/webchat/?net=QuakeNet&room=Chaosforge here]. Unfortunately BOTH sources are filled with obsolete information, as is this wiki. It will get better over time.
  
No tutorial is available yet. To get started, look at modules that others have created. Modules are written in a programming language called [http://www.lua.org/manual/5.1/manual.html Lua]. If you don't already know Lua, you may be able to pick it up as you go along, but it is still recommended to look at dedicated Lua documentation eventually in case there is anything you missed.
+
Although currently very out of date there is a [[Modding:Tutorial|series of tutorials]] in place to help with some of the basics of modding (as well as some advanced tricks for more experienced modders). It is suggested that you read through these if you want to understand most of the documentation. If you want to learn only enough to build a quick map, head to the tutorial [[Modding:Tutorial/Constructing a Map|Constructing a Map]] for guidelines and an example.
  
== Documentation ==
+
If you're just here to figure out how to play modules, it is a very simple process:
  
 +
*Download either a folder with the .module extension (this is a "raw" module) or a file with the .WAD extension.
 +
*Place the folder or file into your "modules" directory, located in your DoomRL folder.
 +
*Start DoomRL, then select the "Custom Game" option.
 +
*Select from any of the modules in the menu, at which point the normal game startup procedure will begin.
 +
 +
== Documentation ==
 
This section is documents the DoomRL modding system including the various objects and libraries available to modders.
 
This section is documents the DoomRL modding system including the various objects and libraries available to modders.
  
Line 22: Line 29:
 
* [[Modding:Missile|Missiles]]
 
* [[Modding:Missile|Missiles]]
 
* [[Modding:Cell|Cells]]
 
* [[Modding:Cell|Cells]]
* [[Modding:Being|Beings]]
+
* [[Modding:being|Beings]] ([[Modding:being blueprint|b]] [[Modding:being API|a]] [[Modding:being object|o]])
* [[Modding:Player|Player]]
+
* [[Modding:player|Player]] ([[Modding:player API|a]] [[Modding:player object|o]])
* [[Modding:Level|Levels]]
+
* [[Modding:level|Levels]] ([[Modding:level blueprint|b]] [[Modding:level API|a]] [[Modding:level object|o]])
  
 
==== Secondary Objects ====
 
==== Secondary Objects ====

Latest revision as of 02:01, 22 April 2013

Players are allowed to load custom game content into the DoomRL engine using the Custom Game menu option. These packages (called modules, mods, or wads) of new content are created by various members of the DoomRL community; look for modules on the modding forum.

Contents

Getting Started

As of right now the best place to learn about modding DoomRL is to view the source code of current mods and, if you can't find what you need there, to ask for advice on the Chaosforge IRC channel, #chaosforge. Mods and their sources can be found in the modding section of the Chaosforge forums. IRC, if you are not familiar with it already, can be accessed quickly by using a free web based IRC client like the one found here. Unfortunately BOTH sources are filled with obsolete information, as is this wiki. It will get better over time.

Although currently very out of date there is a series of tutorials in place to help with some of the basics of modding (as well as some advanced tricks for more experienced modders). It is suggested that you read through these if you want to understand most of the documentation. If you want to learn only enough to build a quick map, head to the tutorial Constructing a Map for guidelines and an example.

If you're just here to figure out how to play modules, it is a very simple process:

  • Download either a folder with the .module extension (this is a "raw" module) or a file with the .WAD extension.
  • Place the folder or file into your "modules" directory, located in your DoomRL folder.
  • Start DoomRL, then select the "Custom Game" option.
  • Select from any of the modules in the menu, at which point the normal game startup procedure will begin.

Documentation

This section is documents the DoomRL modding system including the various objects and libraries available to modders.

Modules

Base Object

Main Objects

Secondary Objects

Other

Constants

Personal tools