【以撒的结合】外部道具描述（EID）mod介绍（2022年1月版）
前前言：这篇专栏本来是发在贴吧的，但贴吧发不出来，去申请恢复把贴子恢复没了，我也不知道哪有问题，于是就先发B站上了。删除线内容表示是在贴吧用到的
建议使用网页阅读
链接总结：
1. EID创意工坊页：https://steamcommunity.com/sharedfiles/filedetails/?id=836319872
2. GitHub页：https://github.com/wofsauge/External-Item-Descriptions
3. 文档说明：https://github.com/wofsauge/External-Item-Descriptions/wiki
4. 重生胎衣的EID英文版：https://moddingofisaac.com/mod/1079/external-item-descriptions
5. MCM中文版创意工坊页：https://steamcommunity.com/sharedfiles/filedetails/?id=2494192799
6. MCM英文版创意工坊页：https://steamcommunity.com/sharedfiles/filedetails/?id=2487535818
目录
一、前言
二、EID mod简介
三、MCM配置
四、手动配置
五、其他mod的兼容与描述格式
六、常见通用问题
以及后续的更新/补充说明
一、前言
1. 最近发生什么事？
前一阵子EID的韩语版本完成了合并工作，效果不错，之后EID作者也找到我们商量合并的事，我的想法是，能少用一个mod当然更好，所以我去帮忙检查文本了，顺便把之前留下的坑填完了。目前合并工作已基本完成，所以EID汉化mod不再单独开放了
2. 为什么要重开一贴介绍？
贴吧无法对贴子进行“颠覆性”的变更，也就是发出去就改不了了，况且补充说明大家不一定都能看到，所以我觉得重新开一贴效果更好
3. 不想看重复内容，现在要做什么？
一般玩家使用MCM mod将语言改成中文即可，其他相关功能会在下文介绍
其他兼容原汉化mod的mod作者得麻烦更改一下兼容方式了
4. 后续如何反馈？
中文相关的反馈最好不要去创意工坊页反馈，而是在本贴反馈，若要去创意工坊反馈请使用英文
二、EID mod简介
外部道具描述mod（External Item Descriptions，EID）的作者是Wofsauge，简单来说，这个mod的功能就是将对应道具、饰品、卡牌等的作用显示出来
至于为什么叫这个名字，是因为在拿道具前或使用物品前就能看到这些描述了，不过（可能）大多数人更习惯于叫内置图鉴
以下是创意工坊页的功能介绍：
1. 兼容胎衣+和忏悔，且两者的描述文件是分开的
2. 显示所有道具、饰品、卡牌、符文、胶囊、大胶囊和房间的信息
3. 显示额外信息，比如道具的类型、充能、套装、计数二十面骰的结果、合成宝袋、错误技道具的效果（该功能的详细信息需要添加--luadebug启动选项）
4. 有四种指示器可供选择
5. 兼容性很强，几乎支持所有mod
6. 易于使用的程序接口（API）
7. 大量的自定义选项，比如：指示器，字体类型，语言，和其他视觉选项
三、MCM配置
Mod配置菜单mod（Mod Config Menu，MCM）的原作者是piber，由于不再维护，后续版本由其他人完成，其中文版由frto027制作
这个mod的功能是给其他mod一个配置的环境，方便玩家对mod配置进行更改，如果不使用这个mod，则需要手动进行更改，详见四
MCM中EID的中文选项在之前的汉化mod中做过，但原EID mod尚未支持，需要等待后续更新
以下大量的选项是EID的功能，其中默认值一般是不破坏正常游戏体验的设置，需要调整的话自行调整
False/Disabled：关/禁用
True/Enabled：开/启用
1. General 常规
Language：语言，目前支持12种语言，包括中文，自行更改为所需要的
Name Language：项目名语言，使用当前语言/当前语言+英文/英文
Toggle：总开关，默认F2，第二个为手柄按键，如果已隐藏，则会在info选项卡中给出提示
Position：描述信息显示的位置
Line Height：每行高度，英文默认11，中文默认14
Textbox Width：文本框宽度，控制一行能显示多少内容，英文默认115，中文默认150
Is Initially Hidden：初始隐藏，默认关，若开则进入游戏需要按F2才能开启描述信息
Start of Run Warnings：开局警告，默认启用
Show on "Curse of Blind"：在致盲诅咒中显示，默认关
Show on April Fools Challenge：在愚人节挑战中显示，默认关
Show Hidden Alt-Path Item：在分支路线中显示，默认关
Show Unidentified Pill Effects：显示未鉴别的胶囊，默认关
Hide in Battle：战斗时隐藏，默认关
Indicator：指示器，默认无
Max Distance：最大检测距离，默认5格，grid指一个格子，即岩石或便便之类的物体所占的空间
RESET CONFIG TO DEFAULT：在此按下重置设置为默认值
2. Display 显示
Collectible Infos：道具信息，默认开
Trinket Infos：饰品信息，默认开
Card Infos：卡牌信息，默认开
Pill Infos：胶囊信息，默认开
Glitched Item Infos：故障道具信息，默认开
Sacrifice Room Infos：献祭房信息，默认开
Dice Room Infos：骰子房信息，默认开
Crane Game Infos：娃娃机信息，默认开
Spindown Dice：计数二十面骰的结果数，默认3
Skip Locked Items：计数二十面骰的结果跳过未解锁的道具，默认关
Display Infos when Obstructed 受阻时的信息显示
Show again when having flight：当有飞行能力时再次显示，默认开
Card Infos：受阻时的卡牌信息，默认关
Soulstone Infos：受阻时的魂石信息，默认开
Pill Infos：受阻时的胶囊信息，默认关
Display Infos in Shops 商店的信息显示
Card Infos：商店的卡牌信息，默认关
Pill Infos：商店的胶囊信息，默认开
Soulstone Infos：商店的魂石信息，默认开
Interaction with 'Options?' 与“选择？”的互动
Card Infos when spawned by 'Options?'：由“选择？”生成的卡牌的信息，默认关
Pill Infos when spawned by 'Options?'：由“选择？”生成的胶囊的信息，默认开
3. Visuals 视觉
Font Type：字体类型，中文目前只有一种
Display Mode：显示模式，local是描述显示在道具旁的模式
Text Size：文字大小，默认1，local模式默认0.5，注：除了0.5、1、1.5外，其他大小会导致文字不清晰
Toggle Scale：键盘控制的文字大小缩放，默认F5，按住进行无级调节，按下则在0.5、1、1.5切换
Local Mode Centered：local模式下居中，默认开
Transparency：不透明度，0完全透明，1完全不透明，默认0.75
Display Item Name：显示道具名称，默认开
Display Item Type：显示道具类型，默认开
Display Item Icon：显示道具图标，默认开
Display Transformation Name：显示套装名称，默认开
Display Transformation Icon：显示套装图标，默认开
Display Quality Info：显示品质信息，默认开
Mod Indicator Displayed：mod指示器，默认无
Display Object ID：显示物品ID，默认关
4. Crafting 合成袋
Show Display：显示方式，hold指举起袋子时显示
Display Mode：显示模式，Recipe List显示具体配方，Preview Only只显示将要合成的道具，No Recipes只显示可能合成的道具的种类与品质，Pickups Only只显示掉落物数量，默认为Recipe List
Hide in Battle：战斗时隐藏，默认开
Show Recipes/Best Bag as：以何种形式显示配方，成组或8图标
Recipe List Options 配方列表选项
Displayed Results：显示结果数
Thorough Calculations：探索深度，越高越容易造成卡顿
Random Calculations：随机探索步数，越高越容易造成卡顿
Show Item Names：显示道具名称，默认关
Toggle：开关，默认F3，下一个是手柄按键
Result Toggle：结果切换，按下切换到即将合成的道具的描述，默认F4，下一个是手柄按键
Clear Bag Content：在此按下清除袋中的记录
Clear Floor Item List：在此按下清除地上物品列表
5. Mouse 鼠标
注：这项功能处于早期版本，有不少bug，建议不要开启
Enable Mouse Controls：启用鼠标控制，默认关
Show Cursor：显示鼠标，默认关
6. Colors 颜色
Descriptions：描述文本的颜色
Names：名称的颜色
Transformations：套装的颜色
Errors：错误文本的颜色
Mod Indicator：mod指示器的颜色
四、手动配置
手动配置较MCM配置复杂，所以如果不是特殊情况建议使用MCM配置
1. 找到以下目录：
忏悔：[游戏根目录]\mods\external item descriptions_836319872\
胎衣+（Windows）：我的文档（文档）\My Games\Binding of Isaac Afterbirth+ Mods\External item descriptions\
2. 用文本编辑器打开“eid_config.lua”，编辑需要更改的配置，保存文件
对于具体的选项如何更改以及有哪些参数，该文件中有说明（英文），且名字和上文类似，此处不再赘述
如果需要重置配置，则删除以下目录中的文件
忏悔：[游戏根目录]\data\external item descriptions\
胎衣+（Windows）：我的文档（文档）\My Games\Binding of Isaac Afterbirth+ Mods\External item descriptions\
五、其他mod的兼容与描述格式
EID只对原版游戏中的道具有描述说明，毕竟所有描述都不是自动生成的，所以其他mod道具一般没有描述，如果有，则为该mod的作者或其他mod作者在其发布的mod中所写
这部分详见原作者在GitHub上给出的API文档说明，这里只是简单翻译了一些内容，建议看一遍文档
1. 描述的格式要求
描述尽量短而准确
不要当谜语人或写轶事
重要的效果放前，其他的放后
善用标记
中文：使用半角括号，用语分清角色和玩家
2. 标记
EID有自己制作的一套标记方式，每个标记由2个左花括号、描述文本和2个右花括号组成，比如{{Heart}}，这个标记在显示时会被替换为一个红心的图标
以下是常用的标记：
\1 或 ↑ = {{ArrowUp}} = 绿色向上的箭头图标
\2 或 ↓ = {{ArrowDown}} = 红色向下的箭头图标
\3 或 !!! = {{Warning}} = 黄色警告感叹号图标
{{CR}} = {{ColorReset}} = 颜色重置，即颜色标记的结束标记
\7 或 \007 = 在正文中使用的句点符
ǂ = {{Hashtag}} = 井号，不换行
{{Blank}} = 隐形图标
其他标记参见作者的文档说明，也可以去eid_data.lua文件中寻找
3. 句点符
每行描述由句点符开头，换行使用“#”
例："Test description#A second line#A third line"
如果不想由句点符开头，则在行开头使用标记，标记后跟一个空格
例："Some text#↑ Some text#↓Some text#{{Heart}} Some text#{{Blank}}#{{Blank}} Some text"
解释：
第一行，默认句点符
第二行，↑且有空格，以↑的图标作为句点符
第三行，↓但无空格，显示默认句点符，↓的图标作为正文内容显示
第四行，{{Heart}}自定义图标作为句点符，与第二行一样，但使用其他图标作为句点符
第五行，{{Blank}}作为句点符且没有正文，即没有句点符的空行
第六行，{{Blank}}作为句点符，即没有句点符
4. 添加其他描述/修改描述
在调用EID函数前，确保有if语句判断EID是否开启：
if EID then
-- EID函数调用
end
以下是常用的函数
EID:addCollectible(id, description, itemName, language) -- 道具
EID:addTrinket(id, description, itemName, language) -- 饰品
EID:addCard(id, description, itemName, language) -- 卡牌/符文
EID:addPill(id, description, itemName, language) -- 胶囊
EID:addBirthright(characterId, description, playerName, language) -- 长子名分
id/characterId：物品/角色的ID，胶囊指效果的ID
description：描述文本，字符串
itemName/playerName：可选的自定义名字，字符串
language：可选的语言选项，字符串，中文为"zh_cn"
关于添加标记图标、药丸颜色图标、卡面图标、套装等内容，参见作者的文档说明
六、常见通用问题（大部分摘自EID的创意工坊页）
1. 使用这个mod的版本有哪些？
胎衣+和忏悔，这是一个创意工坊mod，只有这两个版本支持创意工坊
2. 有重生和胎衣的版本吗？
有英文版，但不再更新了
196⑨大佬曾做过此版本的中文版，但链接似乎已经失效了，需要的话自行寻找吧
重生和胎衣版本的mod安装比较复杂，且作者也不再更新这两个版本的mod了，个人建议直接去玩新版本
3. mod会使成就失效吗？
只要你所用的存档打败过妈腿（深牢II的Boss），mod就不会禁用成就和进度，但在挑战或每日挑战中打败过不算
4. 如何安装mod？
1) Steam正版
在创意工坊页按“订阅”就会自动下载并安装mod，然后重启游戏，在主菜单的mod菜单中激活即可
2) 手动下载
寻找一款Steam创意工坊mod下载器进行下载，或者你会在GitHub上下载也行，找到mod目录
忏悔mod目录：[游戏根目录]\mods
胎衣+mod目录（Windows）：我的文档（文档）\My Games\Binding of Isaac Afterbirth+ Mods
将下载的mod放到mod目录，如果是压缩包先解压，如果是一堆文件而非文件夹则先创建纯英文字符的文件夹，然后再把文件放入文件夹中
总之，最后结构应该是：[mod目录]\external item descriptions（自定义名称的文件夹）\[各种文件]
此外，如果mod识别不到或者创意工坊订阅后没有mod出现，对应版本地检查以上mod目录中是否只含有英文字符，不是则自行找办法改掉
