A user has suggested improving this page or section as follows:
"Could use more details on the placement of generated monsters, the timing seems to be mostly covered. Could also stand to flesh out what levels employ special rules and link to the dedicated pages, as well as what governs other forms of monster creation."
Monster creation is the process by which NetHack determines when, where and how a particular monster is generated - whether it is randomly placing an unspecified creature somewhere on the floor, or else populating a freshly created level as soon as the player enters.
Normal monster generation takes place during level creation and at the end of each turn. Monster creation code is also invoked when the player or another monster makes use of an item that generates a monster, such as a scroll of create monster or a bag of tricks.
Normal monster selection
When a monster is generated, NetHack first determines which of the monsters in its database is eligible. Unique monsters and any monster marked with the flag
G_NOGEN cannot be randomly generated; genocided and extinct monsters are excluded as well.
From there, a monster is generally eligible if:
- Its difficulty is less than or equal to the average of the level's difficulty and the player level.
- Its difficulty is at least one-sixth of the current level's difficulty.
- If you are on the Rogue level, then monsters represented by glyphs with lower-case letters (e.g., a, b, c) are excluded from eligibility.
- If you are in Gehennom, lawful monsters and those marked with the flag
G_NOHELL(e.g., winter wolf) are excluded; conversely, monsters with the flag
G_HELL) (e.g., hell hounds) are made eligible to be randomly generated only in Gehennom, and ineligible elsewhere.
- On the Elemental Planes:
- If you are on the Plane of Water, only swimmers are eligible for random generation.
- If you are on the Plane of Fire, only monsters with fire resistance are eligible.
- If you are on the Plane of Air, only monsters that are capable of flying or floating, and are whirly, amorphous, or unsolid are eligible. The trapper or lurker above monster class is explicitly excluded, as both monsters rely on matching the surroundings of the dungeon walls, floor and ceiling to hide.
Each monster remaining on this list that meets the above conditions, has a probability to be generated equal to its effective monster frequency divided by the sum of the monster frequencies of every eligible monster. This can be visualized as a hat full of labeled slips of paper, with each one bearing the name of a monster - each creature's monster frequency determines how many slips of paper in the hat have its name, and the game then selects a name out of the hat at random.
Where this mechanism is used
At the end of each turn, or if an item that generates a monster is used, the possibility of creating a monster depends on the following:
- If the demigod flag is set - done by either killing the Wizard of Yendor at least once or performing the Invocation - there is a 1⁄25 chance of at least one monster being generated.
- If the demigod flag is not set, but the player is in Gehennom, monster generation will occur with a 1⁄50 chance each turn.
- Otherwise, normal monster generation takes place with a 1⁄70 chance each turn.
The following items or spells that create monsters are subject to this rule:
Selection by monster class
Where a class of monster is specified, such as during the creation of certain levels (including the Gnomish Mines) or random generation in the Quest, a different monster generation algorithm is used, and monsters may be generated with probabilities different from the normal mechanism.
Monster selection follows this procedure:
- Monsters of the same class are assumed to be contiguously defined in the mons array, and in the order of their difficulty.
- Quest guardians and player monsters are not eligible because they are defined separately from the rest of the @.
- If an alignment is specified, only monsters of that alignment are eligible.
- Unique monsters, monsters with the G_NOGEN flag, extinct, and genocided monsters are not eligible.
- Imagine a bag that is initially empty. For each eligible monster starting with the first defined monster of the class, monsters are added to the bag:
- If the difficulty level of the current monster is more than twice the level difficulty, there is a 1⁄2 chance that we stop adding any more monsters to the bag; the current monster is not added and we go directly to the final step of selecting a monster from the bag. However, if the current monster's difficulty is the same as the previous monster's, or if there is no monster in the bag yet, we instead continue the process (thus, monsters of the same difficulty are always added to the bag together, and the bag is never empty if there are any eligible monsters).
- Let k be the monster's monster frequency. If k is greater than 0, k+1 copies of that monster are added to the bag, except that only k copies are added if the adjusted monster level is greater than twice the player's experience level.
- Finally, a random monster is selected from the bag.
Note that this process ignores some restrictions that are normally in place, such as monsters that normally would not generate outside of Gehennom. In addition, monsters that are too difficult to be generated via the normal mechanism may be generated by this process (this is how minesflayers generate).
The following information pertains to an upcoming version (NetHack 3.7.0). If this version is now released, please verify that it is still accurate, then update the page to incorporate this information.As of commit c29ffe1d, this mechanism no longer generates master- and arch-liches outside of Gehennom. For other monsters that normally generate only inside or outside of Gehennom, this mechanism respects that 8⁄9 of the time.
Where this mechanism is used
|Ringing a cursed bell||n||1⁄4 chance; not generated with inventory; if any nymph is genocided or extinct, none of them are generated.|
|Digging a grave||ZM||1⁄5 chance each of Z or M.|
|Demon summoning by demons; summon nasties in Gehennom (1⁄10 chance); chaotic or unaligned minion generation||&||Same alignment as summoner, or any alignment if summoner is unaligned.|
|Summoning a lawful minion||A|
|Summon insects||aS||Snakes are generated only if all insects are gone.|
|1⁄5 of the time when attempting to generate a trapped secret door when level difficulty is at least 9||m||The mimic is generated instead of a secret door.|
|Inaccessible closet corpse||@||It's a corpse, not a living monster.|
|Graveyard room creation; cursed charged Bell of Opening or cursed Book of the Dead||&VZ||Other monsters may also be selected by a non-mkclass() mechanism.|
|Swamp creation||F||Some ; are also generated in swamps, but mkclass() is explicitly not used for them here to avoid generating kraken.|
|Throne room creation||DHTCoGk||Bugbear and hobgoblin may also be selected.|
|Random monster generation in the Quest||specified Quest monster classes||See Quest#Quest leaders and nemeses for monster classes.|
|Special level creation||specified monster classes|
Notable monster class selection in special levels
- Normal Gnomish Mines levels and the first two Mines' End variants contain one random h, which may be a mind flayer.
- The Castle places 27 random monsters from the list LNEHMORTXZ (2–3 of each class) in the central room. Prior to 3.7, the L may be master- or arch-liches.
- The Astral Plane also contains 3 L, which may be master- or arch-liches prior to 3.7.
The following steps are used to place monsters around the level upon its initial creation.
- In normal room-and-corridor levels, there is a 33% chance of generating a monster (or group) per room.
- In mazes, there is a 33% chance of generating 7-11 monsters + 0-2 minotaurs.
Other levels and branches follow various special rules for initial monster placement that are generally unique to each area and detailed on their respective articles.
- src/makemon.c in NetHack 3.6.6, line 1468
- src/makemon.c in NetHack 3.6.6, line 1546
- src/makemon.c in NetHack 3.6.6, line 1473
- src/makemon.c in NetHack 3.6.6, line 1568
- src/makemon.c in NetHack 3.6.6, line 51
- src/allmain.c in NetHack 3.6.6, line 121
- src/makemon.c in NetHack 3.6.6, line 1639
- src/apply.c in NetHack 3.6.6, line 1042
- src/dig.c in NetHack 3.6.6, line 939
- src/minion.c in NetHack 3.6.6, line 406
- src/minion.c in NetHack 3.6.6, line 51
- src/minion.c in NetHack 3.6.6, line 396
- src/mcastu.c in NetHack 3.6.6, line 584
- src/mklev.c in NetHack 3.6.6, line 431
- src/mklev.c in NetHack 3.6.6, line 533
- src/mkroom.c in NetHack 3.6.6, line 459
- src/mkroom.c in NetHack 3.6.6, line 542
- src/mkroom.c in NetHack 3.6.6, line 735
- src/shknam.c in NetHack 3.6.6, line 471
- src/questpgr.c in NetHack 3.6.6, line 655
- src/sp_lev.c in NetHack 3.6.6, line 1621
- dat/mines.des in NetHack 3.6.6, line 37