# Live2D

本指南将引导您完成为 SillyTavern 设置和自定义 Live2D 扩展的过程。此扩展允许您为角色使用 Live2D 动画模型，为您的虚拟角色提供动态和互动元素。

# 先决条件

在开始之前，请确保您已满足以下先决条件：

1. 分支选择：确保您使用的是最新版本的 SillyTavern 以访问最新功能和更新。

2. 扩展安装：从扩展面板（以堆叠块图标表示）的"下载扩展和资产"菜单中安装"Live2D"扩展。

3. 模型文件夹放置：将您的 Live2D 模型文件夹放入 /data/<用户标识>/assets/live2d 目录。一个组织良好的 live2d 资产文件夹可能如下所示：

   

   • Live2D 模型文件夹应包含 Live2D 模型的所有必要组件，如表情、动作、纹理、声音和设置文件。特别是 ***.model.json 文件必须位于 Live2D 模型文件夹的根目录中，以便扩展检测到该模型。在此示例中，shizuku live2d 模型文件夹可能如下所示：

   

   • 注意：模型也可以放置在角色特定的文件夹中，如 /data/<用户标识>/characters/Shizuku/live2d/。但是，角色文件夹中的模型只能供该特定角色访问。

# 扩展设置

Live2D 扩展提供各种设置来自定义动画模型的行为。以下是关键设置：

# 全局设置

1. 启用：

   • 选中此复选框以激活扩展，允许您的 Live2D 模型在 SillyTavern 中进行交互。
   • 如果您只想使用普通精灵，可以禁用此扩展。
   • 当您想在群聊中移动普通精灵时可以禁用此扩展，并在准备好使用 Live2D 模型时再次启用它。

2. 跟随光标：

   • 选中此复选框使 Live2D 模型跟随您的光标，前提是模型支持此功能。

3. 自动发送交互：

   • 选中此复选框可在点击具有映射消息的区域时自动触发角色交互（有关详细信息，请参阅点击区域部分）。

# 调试设置

这些设置帮助您控制 Live2D 模型的行为和可见性以进行调试。

1. 动画前重置模型：

   • 选中此复选框可在任何动画之前重新加载模型。这会强制动画开始，并在必要时允许您 spam 点击。某些模型可能需要此操作以确保动画从兼容状态开始。

2. 显示模型框架：

   • 选中此复选框可显示模型框架，更容易识别点击位置以拖动模型。它还会显示点击区域（如果可用）。悬停在点击区域上将显示其名称。

3. 重新加载按钮

   • 点击此按钮可重新加载每个 live2d 模型。如果出现故障，请使用它。

# 角色选择

这些设置允许您管理角色并为它们分配 Live2D 模型。

1. 刷新按钮：

   • 点击刷新按钮可更新当前聊天中的角色列表。

2. 选择角色：

   • 使用下拉列表选择要为其分配 Live2D 模型的角色。

3. 删除按钮：

   • 点击此按钮可删除角色的所有分配模型。将出现确认提示以确认删除。

# 模型选择

1. 刷新按钮：

   • 如果您的 Live2D 模型未出现在列表中，请点击刷新按钮。

2. 选择模型：

   • 从列表中选择一个模型分配给选定的角色。
   • 模型可以位于资产文件夹或当前角色的文件夹中。
   • 列表显示模型文件夹名称、其来源（资产或角色）以及检测到的模型设置文件名称。
   • 请注意，某些模型文件夹可能包含同一模型的不同版本。您可以尝试不同的模型文件，看看哪个效果最好。
   • 选择"无"将使用普通精灵（如果有）
   • 设置按角色和模型保存

# 模型设置

1. 模型缩放：

   • 使用滑块调整模型大小，使其更大或更小。

2. 模型中心 X 偏移：

   • 使用滑块更改模型相对于窗口中心的水平位置。

3. 模型中心 Y 偏移：

   • 使用滑块调整模型相对于窗口中心的垂直位置。

# 备注

• 设置会保存并延续到不同的聊天中。
• 您也可以用鼠标拖动模型，这些设置将被更新和保存。
• 如果您不小心将模型移出视图，请使用这些 UI 设置将模型带回屏幕上。还要选中"显示框架"复选框以清楚地看到可以点击拖动模型的位置。

# 模型说话

1. 嘴部张开 Y 参数 ID

   • 从列表中选择对应于模型嘴部 Y 值的参数 ID。并非所有模型都有这个参数，名称可能因模型而异。通常是类似"PARAM_MOUTH_OPEN_Y"或"ParamMouthOpenY"的名称。从列表中选择元素时检查模型；它将尝试运行说话动画。如果嘴巴移动，您就成功了！

2. 嘴部移动速度

   • 调整滑块以改变嘴部动画的移动速度。

3. 每个字符的时间

   • 设置每个字符的时间持续时间。说话动画的持续时间将是此时间乘以消息的字符数。

# 备注

• 此嘴部动画并非在每个模型和每个动画上都有效。即使您的模型有嘴巴移动的动画，也不意味着嘴部动画可以由此扩展控制。如果参数列表中没有显示任何内容，您的模型可能是用太旧版本的 Live2D 制作的，无法正确访问参数。

# 模型动画

1. 起始动画

   • 从列表中选择将在与角色开始聊天时播放的表情和动作。如果您需要隐藏角色一段时间以达到完美效果，还可以添加模型将不可见的延迟。

2. 默认动画

   • 从列表中选择当角色发送消息时将播放的表情和动作。使用使用分类表情扩展时的回退动画。

# 备注

• 当您在列表中选择一个时，动画将会播放。
• 使用重播按钮重播选定的动画。
• 某些模型的表情被定义为动作。
• 如果列表中没有显示任何内容，可能是您的模型设置文件中没有定义表情/动作。

# 点击区域映射

1. 默认点击动画

   • 从列表中选择当您点击模型时将播放的表情和动作。您还可以设置将作为用户消息发送的消息。

2. 点击区域

   • 如果模型有点击区域，它们将被列出，您可以为每个区域分配动画/消息。

# 备注

• 某些模型没有点击区域，但默认点击会为所有模型检测到。
• 如果您点击了没有映射任何内容的点击区域或点击了任何点击区域之外，将触发默认点击。
• 点击区域具有模型中定义的优先级；例如，"嘴"在"头"内部。如果行为不正确，可能是由于模型文件的原因。
• 对于某些模型，需要先完成一个动画才能开始另一个动画。如果您想强制刷新和 spam 动画，请使用调试复选框。

# 分类表情映射

1. 要求

   • 需要使用分类表情扩展；否则，它将回退到默认动画。

2. 映射

   • 对于分类扩展检测到的每种情绪，您可以分配表情/动作动画。

# 备注

• 如果在收到新消息时上一个动画尚未完成，则新动画可能不会播放。此行为取决于 Live2D 模型。如果您想强制播放动画，请使用调试复选框。

感谢您遵循本指南！您的 SillyTavern 体验现在通过动画和互动的 Live2D 模型得到了丰富。