DevAuth Neo

模组

· 作者 litetex

在开发环境中验证 Minecraft 账户

0 本站下载 0 关注 更新于 2 个月前

最新 1.2.0 · 26.3 · Fabric

一键开服(送7天)

在开发环境中验证 Minecraft 账号。

这是 DevAuth 的“重生版”,经过改进和更新,并可直接作为 Fabric 模组使用。

使用方法

添加模组

通过 Maven Central(默认)

将以下内容添加到 build.gradle:

dependencies {
    localRuntime 'net.litetex.mcm:dev-auth-neo:<version>'
    // 更多文档:https://wiki.fabricmc.net/documentation:fabric_loom
}
通过 Modrinth

将以下内容添加到 build.gradle:

repositories {
    // https://support.modrinth.com/en/articles/8801191-modrinth-maven
    exclusiveContent {
        forRepository {
            maven {
                name = "Modrinth"
                url = "https://api.modrinth.com/maven"
            }
        }
        filter {
            includeGroup 'maven.modrinth'
        }
    }
}

dependencies {
    localRuntime 'maven.modrinth:dev-auth-neo:<version>'
    // 更多文档:https://wiki.fabricmc.net/documentation:fabric_loom
}

快速入门

重要:DevAuth 默认处于禁用状态,以避免造成干扰。
最简单的启用方式是设置相应的系统属性:-Ddevauth.enabled=1

  • 首次启动时,系统将提示您输入凭据
    • 在需要时,控制台/日志中也会提供操作提示
  • 认证成功后,生成的令牌将存储在 microsoft_accounts.json 中
    • 未来的登录尝试将尝试重用这些令牌
  • 随后,令牌将被委托给游戏,游戏将像往常一样启动

配置

配置动态加载自以下位置(按优先级从高到低排序)
  • 环境变量
    • 以 DEVAUTH_ 为前缀
    • 所有属性均为大写,并使用 _ 代替 . 或 -
  • 系统属性
    • 以 devauth. 为前缀
  • 位于 ~/.dev-auth-neo/config.json 的配置文件
完整的配置选项列表

常规

属性 类型 默认值 备注
enabled bool false
account String - 如果未设置:
将通过控制台提示输入
account-type String microsoft 目前仅支持 Microsoft
force-handle-all-tokens-as-expired bool false 将所有现有令牌视为已过期并进行刷新
state-dir String 自动确定
~/.dev-auth-neo)
保存提供商登录信息的目录
cache-profile-info-minutes int 360
6小时
获取到的个人资料信息(UUID 和名称)应缓存多长时间?

Microsoft Grant-Flow 选项

注意:所有 grant-flow 选项额外以 microsoft.oauth2. 为前缀
例如 predefined-provider 因此必须定义为 devauth.microsoft.oauth2.predefined-provider

属性 类型 默认值 备注
grant-flow String auth-code-embedded 见下文可用的流程
client-id String 自动确定 设计用于通用覆盖,例如自定义提供商
scopes List<String> 自动确定

auth-code-embedded 使用嵌入式浏览器的 Auth Code 流程

  • 此登录机制与 Minecraft 启动器使用的机制相同
    • 因此被选为默认值
  • 此工作流程使用 CEF (Chromium Embedded Framework) 下载并安装 Chromium 浏览器
    • 下载大小约为 150MB
    • 默认安装在 ~/.dev-auth-neo/jcef
属性 类型 默认值 备注
use-temporary-cache-dir bool true 创建并使用临时目录作为浏览器缓存。
如果设置为 false,所有浏览器信息(Cookie、缓存)以及可能的登录状态都将被持久化保存!
redirect-uri String 自动确定 设计用于通用覆盖,例如自定义提供商

auth-code-external 使用外部浏览器的 Auth Code 流程

  • 与 auth-code-embedded 相同,但可以使用系统浏览器完成
  • 启动集成 Web 服务器以在流程结束时获取令牌
  • ⚠ 此流程依赖于第三方客户端/启动器
    • 这些客户端完全依赖 Mojang 的明确批准,并且可能随时因任何原因被他们阻止(尽管这种情况不太可能发生)
    • 第三方可以在不警告的情况下更改或删除其客户端
    • 第三方可能会看到您的登录活动
    • 可用的第三方:
属性 类型 默认值 备注
predefined-provider String devauth
open-system-browser bool true 是否应自动打开系统浏览器以显示登录页面?
redirect-port int 自动确定 用于集成 Web 服务器的端口
redirect-uri String 自动确定 设计用于通用覆盖,例如自定义提供商

device-code 设备代码流程

  • 此流程会生成一个简短的代码,需要借助账号在线验证
  • ⚠ 此流程依赖于第三方客户端/启动器
    • 这些客户端完全依赖 Mojang 的明确批准,尽管不太可能发生,但它们仍可能随时以任何理由被封锁
    • 第三方可能会在未发出警告的情况下更改或删除其客户端
    • 第三方可能能够查看你的登录活动
    • 可用的第三方:
属性 类型 默认值 备注
predefined-provider String multimc

常见问题

如何删除登录信息?

删除 %USERPROFILE%\.dev-auth-neo(Windows)或 ~/.dev-auth-neo(Linux)

我想切换到另一个账号

最简单的方法是什么?

设置 -Ddevauth.account=otherAccountName

安全性?

令牌存储在上述指定文件夹中的磁盘文件里。 与电脑上的所有数据一样,用户需自行负责保护其安全。

你可以在 Microsoft 账户设置 中撤销令牌。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源