--- deliantra/arch/res/sound.conf.res	2007/08/12 13:10:00	1.12
+++ deliantra/arch/res/sound.conf.res	2007/10/20 05:13:30	1.23
@@ -1,10 +1,13 @@
 {
+   # 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"],
       ["learn_spell"           , "fx/signature-22"],
-      ["fumble_spell"          , "cf/missed"],
-      ["wand_poof"             , "cf/missed"],
+      ["fumble_spell"          , "ss/silly-horn1"],
+      ["wand_poof"             , "ss/squeak"],
       ["open_door"             , "misc/woodimpact"],
       ["push_player"           , "cf/blip"],
       ["player_hits1"          , "cf/hit005"],
@@ -16,7 +19,7 @@
       ["player_is_hit2"        , "wn/human-hit-2"],
       ["player_kills"          , "cf/drip"],
       ["pet_is_killed"         , "cf/squish"],
-      ["player_dies"           , "cf/gong"],
+      ["player_dies"           , "ss/biggest_gong_ever2"],
       ["ob_evaporate"          , "cf/whoosh"],
       ["ob_explode"            , "cf/explosion"],
       ["sound_clock"           , "cf/towerclock"],
@@ -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,24 @@
       "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"		: "ss/squeak",
+      "blocked_gate"		: "ss/puncher",
+      "trigger_gate"		: "misc/grate",
+      "trigger_hole"		: "misc/grate",
+      "god_intervention"	: "ss/churchbell",
+      "spell_success"		: "ss/evilnote1",
+      "eat_food"		: "ss/biting-celery2",
+      #"eat_drink"		: "",
+      #"trigger_altar"		: "",
+      "quest_progress"          : "fx/signature-29", # hypothetical "you made some progress" quest sound
+      "quest_success"           : "fx/signature-30", # you succeeded in a quest
+      "quest_failure"           : "fx/signature-26", # you failed a quest
+      "msg_voice"               : "ss/swhistle",     # auto-apply sign, magic_ear etc.
+      "msg_tell"		: "wn/arrive",       # tell received
+      "msg_say"                 : "ss/swhistle",     # say received
+      "msg_chat"                : "ss/swhistle",     # chat received
+      "msg_shout"               : "ss/announce_bass",# shout received
+   },
 }