Menu
Instructions for comparing monsters in GnollHackWiki with the GnollHack C code data structures (permonst) to spot mistakes in the documentation.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Instructions and conventions for editing the GnollHack Wiki Markdown pages and handling images.
Instructions for comparing spells and spellbooks in GnollHackWiki with the GnollHack C code data structures (objclass and SPELL macro) to spot mistakes in the documentation.
Instructions for comparing artifacts in GnollHackWiki with the GnollHack C code data structures (artifact) to spot mistakes in the documentation.
Instructions for comparing regular object items (weapons, armor, tools, etc.) in GnollHackWiki with the GnollHack C code data structures (objclass) to spot mistakes in the documentation.
| name | wiki_verify_monsters |
| description | Instructions for comparing monsters in GnollHackWiki with the GnollHack C code data structures (permonst) to spot mistakes in the documentation. |
When verifying monsters on the GnollHackWiki against the GnollHack C code, compare the monster's documentation with the MON macro entries in src/monst.c. These macros populate the struct permonst defined in include/permonst.h.
cwt) or any other weight on the wiki. Weights in the code might be in different units than weights on the wiki.MON(). Many arguments are wrapped in LVL(), SIZ(), STATS(), and ATTK(). You must expand these manually in your head to match fields correctly.MON() Macro StructureEach monster in src/monst.c is defined using:
MON(nam, title, desc, femalename, commonname, sym, lvl, gen, atk, siz, stats, mr1, mr2, mc1, flg1, flg2, flg3, flg4, flg5, flg6, flg7, flg8, d, col, soundset, female_soundset, soundset_subtype)
nam, title, desc, femalename, commonname, sym)sym): The class symbol (e.g., S_ANT, S_DRAGON).LVL() MacroThe lvl argument is formatted as LVL(mlevel, mmove, ac, mc, mr, maligntyp).
mlevel): The base monster level.mmove): The monster's movement speed.ac): The base AC.mc): The base MC against touch attacks.mr): The base MR against magic.maligntyp): The basic alignment (negative is chaotic/evil, positive is lawful/good, zero is neutral).gen)This argument defines where and how often the monster spawns.
G_FREQ: Common frequency.G_HELL, G_NOHELL: Spawns in Gehennom / never in Gehennom.G_UNIQ: Is a unique monster.ATTK() and A() MacrosThe atk argument is wrapped in an A(...) macro, consisting of up to 8 ATTK() entries.
Each ATTK(aatyp, adtyp, damn, damd, ...) dictates:
aatyp: Attack type (e.g., AT_BITE, AT_CLAW).adtyp: Damage type (e.g., AD_PHYS, AD_FIRE).damn d damd: The damage dice (e.g., 2d4).ATTK(AT_MAGC, AD_CLRC, ...) maps to Spell casting, clerical (NOT "celestial").ATTK(AT_MAGC, AD_SPEL, ...) maps to Spell casting, magic.SIZ() MacroThe siz argument is formatted as SIZ(cwt, cnutrit, msound, msize, heads, lightrange, body_material_type).
cwt): DO NOT VERIFY.cnutrit): The nutritional value of the corpse.msound): The type of noise made (e.g., MS_ROAR).msize): Physical size (e.g., MZ_SMALL, MZ_LARGE).body_material_type): The material of the creature (e.g., FLESH, IRON).STATS() MacroThe stats argument is formatted as STATS(str, dex, con, intl, wis, cha).
str stat in STATS() may contain integer values, mathematical expressions, or macros. Pay close attention to the following calculation rules:
18).18 + X): If you see an expression like 18 + 31, it represents an AD&D-style percentile strength and is displayed as 18/31 on the wiki.18/X, where X is the value minus 18 (e.g., 49 becomes 18/31).STR18(x) Macro: Equals 18 + x. It represents percentile strengths. For example, STR18(100) equals 118 and displays as 18/** or 18/100. Note that STR18(0) or STR18(00) are written simply as 18 and not 18/0.STR19(x) Macro: Equals 100 + x. It represents linear strength values from 19 to 25. For example, STR19(25) equals 125 and displays directly as 25.mr1, mr2, mc1)mr1 / mr2: Monster resistances (MR_FIRE, MR_COLD, MR_POISON, etc.).mc1: What the corpse conveys when eaten.flg1 through flg8)These boolean bitflags describe the monster's traits, which are heavily documented on the wiki:
M2_CARNIVORE, M2_HERBIVORE, M2_METALLIVORE.M1_FLY (Flying), M1_SWIM (Swimming), M1_AMPHIBIOUS, M1_WALLWALK.M1_NOEYES (No eyes), M1_NOLIMBS (No limbs), M1_NOTAKE (Cannot pick up items).M2_HOSTILE (Hostile), M2_PEACEFUL (Peaceful), M2_STALK (Stalker).src/monst.c.LVL(), SIZ(), ATTK(), and STATS().flg1-flg8) for specific biological or behavioral traits.