信件与任务日志增强

信封配置

这些属性可让你优化信件在收件箱菜单左侧列表中的显示效果。

env_sender_sprite: 
替换信封中寄件人（NPC）的图标。
可以是任何精灵，推荐精灵尺寸：11x11。
有关示例，请参见 animations\UI NEW\Generic\Icons\NPC Small\spr_ui_generic_icon_npc_small_balor.png。

环境任务类别：
替换寄件人图标旁的小图标，该小图标通常根据与信件关联的任务推断得出。
可能的值：festival、fetch、heart、renown、stillwell_mission、story 或 taliferro。
也可以是以“spr_”开头的自定义精灵，建议精灵尺寸：10x11。
有关示例，请参见 animations\UI NEW\Journal\Quests\spr_ui_journal_quests_heart_subicon.png。

已启用精灵环境：
指定用于信封背板的精灵图，采用九宫格切片格式。
有关示例，请参见 animations\UI NEW\Generic\Box\spr_ui_generic_box_main.png。

环境文本查找索引：
指示信封文本应应用哪种颜色（COMMON_LUT 位置）。
可能的值（忽略空格）：source、standard、header、green、blue、red、dark、blackonyellow、blackonbeige、spring、……
……夏、秋、冬、纯黑配白、红底白字、绿底白字、深色替代、深紫、金底灰黑、红底黑字。

身体配置

这些属性可用于增强信件正文的显示效果，正文会出现在收件箱菜单右侧区域，即信件实际内容的展示位置。

body_attached_image: 正文附有图片：
随信附上一张图片。
图像宽度应为 159 像素，否则将被缩放以填充字母区域。

body_attached_image_where:
指示放置所附图像的位置。
可为“above”或“below”，分别表示位于信件正文上方或下方，默认为“above”。

身体附带的图像弹出窗口：
拥有此物将使上一张图片可点击。
点击后，此图像将作为弹窗显示。

附着图像弹出窗口最大缩放：
图像将根据屏幕分辨率自动放大（或缩小）。
以下表示应用于图像弹窗的最大缩放级别（设为 1 表示完全不放大）。

body_sender_name & body_sender_name_key :
替换发件人名称（会自动添加在信件末尾）。如果不想显示，请设置为空字符串。
如果希望发送名称本地化，请使用后者。推荐。

身体启用精灵图：
指定用于字母主体背板的精灵图，使用九宫格切片格式。
有关示例，请参见 animations\UI NEW\Generic\Box\spr_ui_generic_box_main.png。
也将应用于所附的图片底板（如有）。

body_text_lut_index:
指示应应用于正文的颜色（COMMON_LUT 位置）（可能的值请参见 env_text_lut_index）。

身体装饰精灵：
在后板上加入一张图片作为装饰，它会显示在信件文字的下方。
如果精灵图太大，就会溢出。

身体装饰对齐：
指示应添加装饰的位置。
可能的值（忽略空格）：顶部、底部、左侧、右侧、居中、左上、右上、左下、右下。

身体装饰边距：
在装饰与背板边缘之间留出边距。

身体装饰动画速度：
定义装饰的动画速度（如果有）。

钩子

这些属性允许你定义自定义钩子，用来在玩家打开信件时触发各种事件。播放音效、改变世界中的某些事物、让信件爆炸并杀死玩家……诸如此类。

首次打开：
设置一个自定义钩子，在信件首次被打开时触发。
“my_letter_first_open”将解析为“mod.lyhs_letters_enhanced.hooks.my_letter_first_open”钩子。
附加到该钩子的回调函数将接收一个包含 `menu` 和 `letter_name` 作为参数的结构体。

钩子_打开：
设置一个自定义钩子，在信件每次被打开时触发。
“my_letter_open”将解析为“mod.lyhs_letters_enhanced.hooks.my_letter_open”钩子。
挂接到该钩子的回调将接收一个包含 `menu` 和 `letter_name` 作为参数的结构体。

信封配置

这些属性可用于增强任务在任务日志左侧列表中的显示效果（包括日志和任务面板中）。

环境_发送者_精灵: 
替换信封中的发件人（NPC）图标。
可以是任意精灵，推荐精灵尺寸：11x11。
有关示例，请参见 animations\UI NEW\Generic\Icons\NPC Small\spr_ui_generic_icon_npc_small_balor.png。

环境任务分类：
替换任务分类图标，请注意，日志会按分类对任务进行排序。
建议直接使用实际任务类别图标的变体，即相同的图标但不同颜色。
可能的值：festival、fetch、heart、renown、stillwell_mission、story 或 taliferro。
它也可以是以“spr_”开头的自定义精灵，建议精灵尺寸：14x14。
有关示例，请参见 animations\UI NEW\Journal\Quests\spr_ui_journal_quests_fetch_header_icon.png。

环境已启用精灵：
指定用于信封背板的精灵图，使用九宫格格式。
有关示例，请参见 animations\UI NEW\Generic\Box\spr_ui_generic_box_main.png。

环境文本查找索引：
指示应应用于信封文本的颜色（COMMON_LUT 位置）。
可能的值（空格忽略）：source、standard、header、green、blue、red、dark、blackonyellow、blackonbeige、spring、……
……夏、秋、冬、白纯黑、红底白、绿底白、暗色替代、暗紫、金底灰黑、红底黑。