final

src/NetHack_3.7/src/decl.c

@@ -17,7 +17,7 @@ NEARDATA const struct c_color_names c_color_names = {
     "black",  "amber", "golden", "light blue", "red",   "green",
     "silver", "blue",  "purple", "white",      "orange"
 };
-const char *c_obj_colors[] = {   //这里定义了一些物品的颜色
+const char *c_obj_colors[] = {
     "black",          /* CLR_BLACK */
     "red",            /* CLR_RED */
     "green",          /* CLR_GREEN */
@@ -36,8 +36,8 @@ const char *c_obj_colors[] = {   //这里定义了一些物品的颜色
     "white",          /* CLR_WHITE */
 };
 
-const struct c_common_strings c_common_strings =  //结构体变量中包含了一些常见的字符串，用于文本输出
+const struct c_common_strings c_common_strings =
-    { "Nothing happens.",      //在游戏中提供反馈、描述情况，进行交互
+    { "Nothing happens.",
       "That's enough tries!",
       "That is a silly thing to %s.",
       "shudder for a moment.",
@@ -50,34 +50,33 @@ const struct c_common_strings c_common_strings =  //结构体变量中包含了
       { "mon", "you" }
 };
 
-const struct savefile_info default_sfinfo = {  //定义了保存文件的默认信息
+const struct savefile_info default_sfinfo = {
-#ifdef NHSTDC    //用于保存文件格式的标志位
+#ifdef NHSTDC
     0x00000000UL
 #else
     0x00000000L
 #endif
-#if defined(COMPRESS) || defined(ZLIB_COMP)   //用于外部压缩标志位
+#if defined(COMPRESS) || defined(ZLIB_COMP)
         | SFI1_EXTERNALCOMP
 #endif
 #if defined(ZEROCOMP)
-        | SFI1_ZEROCOMP   //零压缩标志位
+        | SFI1_ZEROCOMP
 #endif
 #if defined(RLECOMP)
-        | SFI1_RLECOMP    //RLE压缩标志
+        | SFI1_RLECOMP
 #endif
     ,
 #ifdef NHSTDC
-    0x00000000UL, 0x00000000UL   //保留字段
+    0x00000000UL, 0x00000000UL
 #else
     0x00000000L, 0x00000000L
 #endif
 };
 
-const char disclosure_options[] = "iavgco";  //是一个字符数组，包含了几个选项。这些选项用于控制信息的披露程度。
+const char disclosure_options[] = "iavgco";
-char emptystr[] = {0};       /* non-const */  //是一个字符数组，用于表示空字符串。它是非常量数组，可以被修改。
+char emptystr[] = {0};       /* non-const */
 
 NEARDATA struct flag flags;  /* extern declaration is in flag.h, not decl.h */
-//是一个结构体变量，用于存储游戏中的标志位。该变量在flag.h中有外部声明。
 
 /* Global windowing data, defined here for multi-window-system support */
 #ifdef WIN32
@@ -85,28 +84,25 @@ boolean fqn_prefix_locked[PREFIX_COUNT] = { FALSE, FALSE, FALSE,
                                             FALSE, FALSE, FALSE,
                                             FALSE, FALSE, FALSE,
                                             FALSE };
-                                            //是一个布尔数组，用于表示文件名前缀是否被锁定。在这段代码中，它被初始化为全为FALSE。
 #endif
 #ifdef PREFIXES_IN_USE
 const char *fqn_prefix_names[PREFIX_COUNT] = {
     "hackdir",  "leveldir", "savedir",    "bonesdir",  "datadir",
     "scoredir", "lockdir",  "sysconfdir", "configdir", "troubledir"
-};//是一个字符串指针数组，包含了一些文件名前缀的名称。这些名称用于指定不同类型文件的存储路径。
+};
 #endif
 
 /* x/y/z deltas for the 10 movement directions (8 compass pts, 2 down/up) */
 const schar xdir[N_DIRS_Z] = { -1, -1,  0,  1,  1,  1,  0, -1, 0,  0 };
 const schar ydir[N_DIRS_Z] = {  0, -1, -1, -1,  0,  1,  1,  1, 0,  0 };
 const schar zdir[N_DIRS_Z] = {  0,  0,  0,  0,  0,  0,  0,  0, 1, -1 };
-//是三个有符号字符数组，分别表示十个移动方向（包括八个主要方向和上下方向）的x、y和z轴的增量。
 /* redordered directions, cardinals first */
 const schar dirs_ord[N_DIRS] =
     { DIR_W, DIR_N, DIR_E, DIR_S, DIR_NW, DIR_NE, DIR_SE, DIR_SW };
-//是一个有符号字符数组，表示经过重新排序的移动方向。首先是四个基本方向，然后是四个对角线方向。
 
-NEARDATA boolean has_strong_rngseed = FALSE;  //是一个布尔变量，用于表示是否具有强随机种子。
+NEARDATA boolean has_strong_rngseed = FALSE;
 struct engr *head_engr;
-NEARDATA struct instance_flags iflags;  //是一个结构体变量，用于存储游戏实例的标志位。
+NEARDATA struct instance_flags iflags;
 /* NOTE: the order of these words exactly corresponds to the
    order of oc_material values #define'd in objclass.h. */
 const char *materialnm[] = { "mysterious", "liquid",  "wax",        "organic",
@@ -115,35 +111,29 @@ const char *materialnm[] = { "mysterious", "liquid",  "wax",        "organic",
                              "metal",      "copper",  "silver",     "gold",
                              "platinum",   "mithril", "plastic",    "glass",
                              "gemstone",   "stone" };
-                             //是一个字符串指针数组，包含了一些物品材质的名称。这些名称与objclass.h中定义的oc_material值的顺序完全对应。
+const char quitchars[] = " \r\n\033";
-
+NEARDATA struct savefile_info sfcap, sfrestinfo, sfsaveinfo;
-const char quitchars[] = " \r\n\033";//是一个包含一些表示退出字符的字符串，包括空格、回车、换行和转义字符。
+const int shield_static[SHIELD_COUNT] = {
-
-NEARDATA struct savefile_info sfcap, sfrestinfo, sfsaveinfo;  //结构体变量，用于保存文件的信息。
-
-const int shield_static[SHIELD_COUNT] = {//是一个整型数组，包含了一些盾牌的静态符号。
     S_ss1, S_ss2, S_ss3, S_ss2, S_ss1, S_ss2, S_ss4, /* 7 per row */
     S_ss1, S_ss2, S_ss3, S_ss2, S_ss1, S_ss2, S_ss4,
     S_ss1, S_ss2, S_ss3, S_ss2, S_ss1, S_ss2, S_ss4,
 };
-NEARDATA struct you u;//结构体变量，用于表示玩家角色的状态和属性。
+NEARDATA struct you u;
-NEARDATA time_t ubirthday;  //是一个time_t类型的变量，表示玩家角色的出生时间。
+NEARDATA time_t ubirthday;
-NEARDATA struct u_realtime urealtime;  //用于表示游戏时间的实时信息。
+NEARDATA struct u_realtime urealtime;
-NEARDATA struct obj *uwep, *uarm, *uswapwep,  //结构体的指针变量，用于表示玩家角色的装备和物品。
+NEARDATA struct obj *uwep, *uarm, *uswapwep,
     *uquiver, /* quiver */
     *uarmu, /* under-wear, so to speak */
     *uskin, /* dragon armor, if a dragon */
     *uarmc, *uarmh, *uarms, *uarmg,*uarmf, *uamul,
     *uright, *uleft, *ublindf, *uchain, *uball;
-const char vowels[] = "aeiouAEIOU"; //是一个包含元音字母的字符串，包括小写和大写的元音字母。
+const char vowels[] = "aeiouAEIOU";
-NEARDATA winid WIN_MESSAGE, WIN_STATUS, WIN_MAP, WIN_INVEN;//是窗口标识符（winid类型）变量，用于表示游戏中的不同窗口。
+NEARDATA winid WIN_MESSAGE, WIN_STATUS, WIN_MAP, WIN_INVEN;
-const char ynchars[] = "yn"; //是包含一些表示"yes"和"no"的字符的字符串。
+const char ynchars[] = "yn";
 const char ynqchars[] = "ynq";
 const char ynaqchars[] = "ynaq";
 const char ynNaqchars[] = "yn#aq";
 NEARDATA long yn_number = 0L;
-//这些变量的定义用于实现游戏的逻辑和界面显示等功能。
-//其中包括随机数种子、文本输出、文件操作、游戏状态、时间管理、玩家角色属性、装备和物品等。
 
 #ifdef PANICTRACE
 const char *ARGV0;

src/NetHack_3.7/src/pickup.c

@@ -6,7 +6,71 @@
 /*
  *      Contains code for picking objects up, and container use.
  */
+/*simple_look(struct obj *, boolean)：用于简单地查看物体的函数。
 
+query_classes(char *, boolean *, boolean *, const char *, struct obj *, boolean, int *)：用于查询物品类别的函数，根据指定的条件检查玩家是否拥有特定类别的物品。
+
+fatal_corpse_mistake(struct obj *, boolean)：用于处理致命错误的函数，当玩家犯下严重错误（如吃掉了致命的尸体）时会调用该函数。
+
+describe_decor(void)：用于描述装饰物的函数。
+
+check_here(boolean)：用于检查当前位置是否有物品的函数。
+
+n_or_more(struct obj *)：用于判断是否拥有指定数量以上的物品的函数。
+
+all_but_uchain(struct obj *)：用于判断除了链子以外的所有物品的函数。
+
+autopick(struct obj *, int, menu_item **)：用于自动选择物品的函数。
+
+count_categories(struct obj *, int)：用于计算物品类别数量的函数。
+
+delta_cwt(struct obj *, struct obj *)：用于计算重量差异的函数。
+
+carry_count(struct obj *, struct obj *, long, boolean, int *, int *)：用于计算携带物品数量的函数。
+
+lift_object(struct obj *, struct obj *, long *, boolean)：用于提起物品的函数。
+
+mbag_explodes(struct obj *, int)：用于判断魔法袋是否会爆炸的函数。
+
+is_boh_item_gone(void)：用于判断物品是否已经消失的函数。
+
+do_boh_explosion(struct obj *, boolean)：用于处理钥匙袋爆炸的函数。
+
+boh_loss(struct obj *, boolean)：用于计算钥匙袋损失的函数。
+
+in_container(struct obj *)：用于将物品放入容器的函数。
+
+out_container(struct obj *)：用于从容器中取出物品的函数。
+
+mbag_item_gone(boolean, struct obj *, boolean)：用于检查魔法袋中的物品是否已经消失的函数。
+
+stash_ok(struct obj *)：用于检查物品是否适合存放的函数。
+
+explain_container_prompt(boolean)：用于解释容器提示的函数。
+
+traditional_loot(boolean)：用于传统战利品的函数。
+
+menu_loot(int, boolean)：用于菜单式战利品的函数。
+
+tip_ok(struct obj *)：用于检查物品是否适合倾斜的函数。
+
+tipcontainer_gettarget(struct obj *, boolean *)：用于获取倾斜容器的目标物品的函数。
+
+tipcontainer_checks(struct obj *, struct obj *, boolean)：用于检查倾斜容器的函数。
+
+in_or_out_menu(const char *, struct obj *, boolean, boolean, boolean, boolean)：用于选择放入或取出物品的菜单的函数。
+
+able_to_loot(coordxy, coordxy, boolean)：用于判断是否能够战利品的函数。
+
+reverse_loot(void)：用于反转战利品顺序的函数。
+
+mon_beside(coordxy, coordxy)：用于判断怪物是否在旁边的函数。
+
+do_loot_cont(struct obj **, int, int)：用于执行战利品容器的函数。
+
+doloot_core(void)：用于执行战利品的核心函数。
+
+tipcontainer(struct obj *)：用于倾斜容器的函数。*/
 #include "hack.h"
 
 #define CONTAINED_SYM '>' /* from invent.c */

src/NetHack_3.7/src/pline.c

@@ -2,7 +2,21 @@
 /* Copyright (c) Stichting Mathematisch Centrum, Amsterdam, 1985. */
 /*-Copyright (c) Robert Patrick Rankin, 2018. */
 /* NetHack may be freely redistributed.  See license for details. */
+/*putmesg 函数：将消息输出到消息窗口，并且根据消息的紧急程度以及是否需要记录历史消息做相应的处理。
 
+pline 函数：格式化并输出消息到消息窗口，可以处理格式化字符串，并且支持不重复显示相同的消息内容。
+
+dumplogmsg 函数和 dumplogfreemessages 函数：用于记录和释放游戏日志消息，主要用于保存最近的消息记录。
+
+You、Your、You_feel 等一系列函数：用于输出与玩家角色相关的消息，比如 "You feel"、"Your sword" 等消息。
+
+verbalize 函数：用于以口头语输出消息，通常用于神明或特殊角色的对话。
+
+impossible 函数：用于输出在程序逻辑上不可能发生的消息，标志着程序出现了异常情况。
+
+raw_printf 函数：直接输出消息到屏幕，不经过消息窗口的处理。
+
+其他辅助函数：还有一些辅助函数用于记录错误、处理配置文件错误等*/
 #include "hack.h"
 
 #define BIGBUFSZ (5 * BUFSZ) /* big enough to format a 4*BUFSZ string (from

src/NetHack_3.7/src/polyself.c

@@ -18,7 +18,23 @@
  *
  *    polymon (called directly)             usually golem petrification
  */
+/*check_strangling 函数：用于检查角色是否处于被勒死状态，并采取相应的行动。
 
+polyman 函数：用于将玩家角色变形为另一个怪物，并更改相关属性。
+
+dropp 函数：用于让角色掉落一个物品，并处理相关逻辑。
+
+break_armor 函数：用于摧毁角色当前穿戴的盔甲。
+
+drop_weapon 函数：根据给定的参数，让角色掉落手中的武器。
+
+armor_to_dragon 函数：根据给定的参数，将角色当前穿戴的盔甲转化为龙鳞。
+
+newman 函数：用于生成一个新的怪物，并将其放置在游戏地图中。
+
+polysense 函数：用于检测并更新玩家角色的感知能力。
+
+no_longer_petrify_resistant 常量字符串：表示玩家角色不再具有石化抵抗能力。*/
 #include "hack.h"
 
 static void check_strangling(boolean);

src/NetHack_3.7/src/potion.c

@@ -2,7 +2,73 @@
 /* Copyright (c) Stichting Mathematisch Centrum, Amsterdam, 1985. */
 /*-Copyright (c) Robert Patrick Rankin, 2013. */
 /* NetHack may be freely redistributed.  See license for details. */
+/*itimeout 函数：用于处理角色的定时器，返回一个计时器的剩余时间。
 
+itimeout_incr 函数：用于增加角色的定时器，并返回增加后的时间。
+
+ghost_from_bottle 函数：用于释放一个被封印的幽灵。
+
+drink_ok 函数：检查给定的物品是否可以被玩家角色饮用。
+
+peffect_restore_ability 函数：恢复角色的能力值。
+
+peffect_hallucination 函数：使玩家角色产生幻觉效果。
+
+peffect_water 函数：使玩家角色感到口渴。
+
+peffect_booze 函数：使玩家角色醉酒。
+
+peffect_enlightenment 函数：使玩家角色获得启发和洞察力。
+
+peffect_invisibility 函数：使玩家角色隐形。
+
+peffect_see_invisible 函数：使玩家角色能够看见隐形物体。
+
+peffect_paralysis 函数：使玩家角色瘫痪无法行动。
+
+peffect_sleeping 函数：使玩家角色睡眠。
+
+peffect_monster_detection 函数：使玩家角色探测周围的怪物。
+
+peffect_object_detection 函数：使玩家角色探测周围的物品。
+
+peffect_sickness 函数：使玩家角色感到恶心。
+
+peffect_confusion 函数：使玩家角色混乱无法理解环境。
+
+peffect_gain_ability 函数：使玩家角色获得额外的能力。
+
+peffect_speed 函数：使玩家角色加快移动速度。
+
+peffect_blindness 函数：使玩家角色失明。
+
+peffect_gain_level 函数：使玩家角色提升一个等级。
+
+peffect_healing 函数：对玩家角色进行治疗。
+
+peffect_extra_healing 函数：对玩家角色进行更强力的治疗。
+
+peffect_full_healing 函数：对玩家角色进行完全的治疗。
+
+peffect_levitation 函数：使玩家角色悬浮在空中。
+
+peffect_gain_energy 函数：使玩家角色获得额外的能量。
+
+peffect_oil 函数：将玩家角色涂抹上油。
+
+peffect_acid 函数：使玩家角色受到酸性伤害。
+
+peffect_polymorph 函数：将玩家角色进行多形态变化。
+
+H2Opotion_dip 函数：处理将物品浸入水中的效果。
+
+mixtype 函数：确定两个物品混合的结果类型。
+
+dip_ok 函数：检查给定的物品是否可以被浸入其他物品。
+
+hold_potion 函数：处理持有药水的效果。
+
+potion_dip 函数：处理将物品浸入药水的效果。*/
 #include "hack.h"
 
 static long itimeout(long);

src/NetHack_3.7/src/spell.c

@@ -1,7 +1,68 @@
 /* NetHack 3.7	spell.c	$NHDT-Date: 1646838390 2022/03/09 15:06:30 $  $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.131 $ */
 /*      Copyright (c) M. Stephenson 1988                          */
 /* NetHack may be freely redistributed.  See license for details. */
+/*static int spell_let_to_idx(char)：
+将法术字符转换为法术索引。
 
+static boolean cursed_book(struct obj * bp)：
+检查书籍是否被诅咒。
+
+static boolean confused_book(struct obj *)：
+检查书籍是否混乱状态。
+
+static void deadbook_pacify_undead(struct monst *)：
+使亡灵怪物平静的函数。
+
+static void deadbook(struct obj *)：
+处理死亡之书的效果。
+
+static int learn(void)：
+学习新的法术。
+
+static boolean rejectcasting(void)：
+检查是否拒绝施法。
+
+static boolean getspell(int *)：
+获取选择的法术。
+
+static int QSORTCALLBACK spell_cmp(const genericptr, const genericptr)：
+法术比较函数。
+
+static void sortspells(void)：
+对法术进行排序。
+
+static boolean spellsortmenu(void)：
+法术排序菜单。
+
+static boolean dospellmenu(const char *, int, int *)：
+显示法术菜单。
+
+static int percent_success(int)：
+计算法术成功率。
+
+static char *spellretention(int, char *)：
+计算法术保留度。
+
+static int throwspell(void)：
+施放法术。
+
+static void cast_protection(void)：
+施放保护法术。
+
+static void spell_backfire(int)：
+施法反噬。
+
+static boolean spelleffects_check(int, int *, int *)：
+检查法术效果。
+
+static const char *spelltypemnemonic(int)：
+返回法术类型的助记符。
+
+static boolean can_center_spell_location(coordxy, coordxy)：
+检查法术是否可以施放在中心位置。
+
+static boolean spell_aim_step(genericptr_t, coordxy, coordxy)：
+处理法术瞄准的一步。*/
 #include "hack.h"
 
 /* spellmenu arguments; 0 thru n-1 used as gs.spl_book[] index when swapping */

src/NetHack_3.7/src/steal.c

@@ -2,7 +2,27 @@
 /* Copyright (c) Stichting Mathematisch Centrum, Amsterdam, 1985. */
 /*-Copyright (c) Robert Patrick Rankin, 2012. */
 /* NetHack may be freely redistributed.  See license for details. */
+/*stealgold函数：用于让怪物从玩家身上偷取金币，根据玩家是否拥有真金（gold）或者数量不同的金币来进行不同的处理。
 
+thiefdead函数：当偷窃物品的怪物死亡时调用，用于清除相关标记。
+
+unresponsive函数：检查玩家是否对诱惑尝试作出反应，包括检查玩家是否昏迷、晕倒或被麻痹的状态。
+
+unstolenarm函数：当怪物在偷窃玩家装备时死亡时调用，用于完成取下玩家装备的操作。
+
+stealarm函数：用于怪物执行偷窃玩家装备的动作，包括取下和偷取玩家的装备。
+
+remove_worn_item函数：用于怪物将玩家穿戴的物品取下，包括解除武器、防具和饰品等装备。
+
+somegold函数：根据玩家携带的金币数量，返回一定比例的金币数量。
+
+findgold函数：用于在怪物或容器的链表中找到第一个金币对象，并返回该对象。
+
+equipname函数：根据传入的物品对象，返回相应装备的名称。
+
+stealamulet函数：用于指定的怪物（例如巫师或任务敌人）偷取玩家身上的特殊物品，如护身符、祝福铃铛等。
+
+maybe_absorb_item函数：用于怪物吸收玩家用于触碰怪物的物品，例如注射器或武器*/
 #include "hack.h"
 
 static int stealarm(void);

src/NetHack_3.7/src/steed.c

@@ -1,7 +1,27 @@
 /* NetHack 3.7	steed.c	$NHDT-Date: 1671838909 2022/12/23 23:41:49 $  $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.108 $ */
 /* Copyright (c) Kevin Hugo, 1998-1999. */
 /* NetHack may be freely redistributed.  See license for details. */
+/*rider_cant_reach(void) - 当骑手无法到达某个位置时调用，用于通知玩家。
 
+can_saddle(struct monst* mtmp) - 检查怪物是否可以被骑乘。
+
+use_saddle(struct obj* otmp) - 用鞍装备怪物，玩家尝试给怪物戴鞍时调用。
+
+put_saddle_on_mon(struct obj* saddle, struct monst* mtmp) - 给怪物戴上鞍。
+
+can_ride(struct monst* mtmp) - 检查是否可以骑乘指定的怪物。
+
+doride(void) - 骑乘怪物的命令处理函数。
+
+mount_steed(struct monst *mtmp, boolean force) - 开始骑乘指定的怪物。
+
+exercise_steed(void) - 骑乘怪物后进行技能锻炼。
+
+kick_steed(void) - 玩家踢或鞭打坐骑。
+
+landing_spot(coord *spot, int reason, int forceit) - 尝试找到一个合适的下马位置。
+
+dismount_steed(int reason) - 停止骑乘当前的坐骑*/
 #include "hack.h"
 
 /* Monsters that might be ridden */

src/NetHack_3.7/src/symbols.c

@@ -1,7 +1,25 @@
 /* NetHack 3.7	symbols.c	$NHDT-Date: 1661295669 2022/08/23 23:01:09 $  $NHDT-Branch: NetHack-3.7 $:$NHDT-Revision: 1.90 $ */
 /* Copyright (c) NetHack Development Team 2020.                   */
 /* NetHack may be freely redistributed.  See license for details. */
+/*savedsym_add(const char *, const char *, int) - 添加保存的符号到缓存中，用于保存和恢复游戏中的特殊符号。
 
+savedsym_find(const char *, int) - 在缓存中查找特定的保存符号。
+
+purge_custom_entries(enum graphics_sets which_set) - 清除自定义符号库中的条目，用于删除特定符号集。
+
+def_r_oc_syms[MAXOCLASSES] - 定义了每个物品类别的默认符号。
+
+decgraphics_mode_callback - DEC图形模式的回调函数，在tty_start_screen()中设置。
+
+ibmgraphics_mode_callback - IBM图形模式的回调函数，在tty_start_screen()中设置（仅适用于PC9800平台）。
+
+ascgraphics_mode_callback - ASC图形模式的回调函数，在tty_start_screen()中设置（仅适用于PC9800平台）。
+
+cursesgraphics_mode_callback - Curses图形模式的回调函数，在tty_start_screen()中设置。
+
+ibmgraphics_mode_callback - IBM图形模式的回调函数，在tty_start_screen()中设置（仅适用于TTY图形模式和WIN32平台）。
+
+utf8graphics_mode_callback - UTF-8图形模式的回调函数，在tty_start_screen()中设置，并在unixtty、windtty等文件中找到（仅适用于增强符号功能）*/
 #include "hack.h"
 #include "tcap.h"