转录框架

创作者: DEFAU7LT

已更新:2026-04-07 07:44:31

353KB

下载

前置 MOD

使用转录框架时将自动安装

SKSE插件的地址库

2.3MB

天际脚本扩展器 (SKSE64)

914KB

关于此 MOD

转录框架是一个SKSE插件，在动态书籍框架之上提供可复用的谜题会话系统。

转录框架
《天际》书籍菜单的解谜环节

这是什么？

转录框架是一个SKSE插件，它在之上提供谜题会话系统。动态书籍框架.

自身具备：

谜题登记册： 其他插件按书名注册谜题定义
会话管理： 追踪当前谜题、已揭示字母及剩余尝试次数
答案验证： 将玩家输入与预期答案进行比对，支持部分匹配及逐步显示字母。
A PrismaUI文本输入覆盖层： 玩家输入的输入框，可通过可配置快捷键切换
信件精通追踪： 带精通通知的永久逐字母进度计数器

单独使用时不会增加谜题。谜题提供者（例如咒术刻印) 通过消息 API 注册其内容，框架则负责处理会话生命周期。

会话如何进行

玩家打开了一本书，书名与已登记的谜题相符。
框架发送中排除书籍致DBF核心及 kAddDynamicText 带有拼图显示HTML
A kSessionStarted 回调被分派给谜题提供方，以便其可以设置尝试次数、应用成本等。
玩家按下编辑模式快捷键，即可调出PrismaUI文本输入覆盖层。
提交时，答案会进行验证；正确的字母会逐步揭示，图书展示则通过DBF刷新。
解决时：谜题已解决回调。失败时：谜题失败。体力耗尽时：谜题已耗尽.
关闭书籍时：会话结束，文件监控停止，会话已结束回调

书信大师

当玩家解开谜题时，框架会追踪每一个正确输入的字母。每个字母都有一个进度计数器，一旦达到可配置的阈值，该字母就会 已掌握， 在未来的所有谜题中自动预填充。

一个北欧风格的PrismaUI通知庆祝每次精通事件：字母以其符文形式出现在六边形徽章中，渐变为可读的英文字母，其下进度条随之填满。

精通状态通过SKSE共存的存档回调（保存/加载/还原）进行持久化。

模组作者须知：API

沟通通过以下方式进行 SKSE::GetMessagingInterface()->Dispatch()。包括 TranscriptionFramework_API.h 在你的项目中。

示例；从你的插件中注册一个谜题：

剧透：

显示

#include "TranscriptionFramework_API.h"

void RegisterMyPuzzle() {
    auto* messaging = SKSE::GetMessagingInterface();
    if (!messaging) return;

    TranscriptionFramework_API::RegisterPuzzleMessage msg；
    msg.bookTitleKey = "远古烈焰典籍"；
    msg.displayHTML = "<font face='$DaedricFont' size='28'>地狱刻印</font>";
    msg.expectedAnswer = “地狱火符文”；
    msg.callbackPluginName = "MyPlugin";
    msg.puzzleFont = "$DaedricFont";
    msg.puzzleFontSize = 28;

    消息传递->分发(
        TranscriptionFramework_API::kRegisterPuzzle,
        &msg, sizeof(msg),
        TranscriptionFramework_API::PluginName);
}

然后监听插件名称上的回调：

void OnFrameworkCallback(SKSE::MessagingInterface::Message* a_msg) {
    using namespace TranscriptionFramework_API;
    自动类型 = 静态转换<APIMessageType>(a_msg->类型)；

    if (type == kSessionStarted) {
        auto* payload = static_cast<SessionStartedMessage*>(a_msg->data);
        // 设置尝试次数，应用魔法消耗等。
        SetAttemptCountMessage 设置消息；
        setMsg.bookTitleKey = payload->bookTitleKey;
        setMsg.attemptCount = 10；
        SKSE::GetMessagingInterface()->Dispatch(
            kSetAttemptCount, &setMsg, sizeof(setMsg), PluginName);
    }
    else if (type == kPuzzleSolved) {
        auto* payload = static_cast<PuzzleCallbackMessage*>(a_msg->data);
        // 为 payload->bookTitleKey 发放奖励
    }
    else if (type == kPuzzleExhausted) {
        auto* payload = static_cast<PuzzleCallbackMessage*>(a_msg->data);
        // 应用惩罚
    }
}

// 在 kPostLoad 中：
messaging->RegisterListener("TranscriptionFramework", OnFrameworkCallback);