--- deliantra/arch/res/sound.conf.res	2007/08/12 13:10:00	1.12
+++ deliantra/arch/res/sound.conf.res	2007/08/28 03:50:34	1.17
@@ -1,4 +1,7 @@
 {
+   # compat sounds must stay in this order with exactly these keys (thats why it is
+   # an array. they are used to reverse-map sound names to gcfclient-comaptible sound indices.
+   # they are also inserted into the sound face map.
    "compat": [
       ["new_player"            , "cf/magic"],
       ["fire_arrow"            , "cf/fwoomp"],
@@ -24,6 +27,8 @@
       ["fall_hole"             , "cf/rocks-falling"],
       ["drink_poison"          , "cf/puke"]
    ],
+   # similar to compat, above, this is for mapping from spell faces to
+   # spell numbers as required by gcfclient.
    "spell_compat": [
       ["magic bullet"                , "cf/swish"],
       ["small fireball"              , "cf/swish"],
@@ -161,6 +166,12 @@
       ["banishment"                  , "cf/choir"],
       ["create missile"              , "cf/magic"]
    ],
+   # these are "event"-type mappings from event name to
+   # face path. events are simply inserted into the sound
+   # face map, and the rule of thumb is: face names
+   # containing "/" are sound files paths, otherwise
+   # they are event names either from here or the compat
+   # sections, above.
    "event": {
       "level_up"		: "fx/signature-01",
       "skill_up"		: "fx/signature-02",
@@ -176,6 +187,16 @@
       "inscribe_success"	: "wn/receive",
       "inscribe_fail"		: "cf/missed",
       "chest_open"              : "wn/open-chest",
-      "chest_close"             : "wn/open-chest"
-   }
+      "chest_close"             : "wn/open-chest",
+      "skill_learn"             : "fx/signature-22",
+      "generic_failure"		: "cf/missed",
+      "blocked_gate"		: "ss/puncher",
+      "trigger_gate"		: "misc/grate",
+      "trigger_hole"		: "misc/grate",
+      "god_intervention"	: "ss/churchbell",
+      #"trigger_altar"		: "",
+      #"quest_progress"          : "", # hypothetical "you made some progress" quest sound
+      #"quest_success"           : "", # you succeeded in a quest
+      #"quest_failure"           : "", # you failed a quest
+   },
 }