联动

LoginView 模块通过 EventBus、信号派发、Capability 等机制与宿主及其他模块联动。

EventBus 事件

LoginView 模块通过 EventBusCapability 发布登录成功事件，其他模块可通过 EventBus 监听。

发布的事件

Payload 字段

事件发布机制

事件通过 EventBusCapability 发布，由 LoginView 在 LoginViewService 中延迟查找：

service.setEventBusProvider(() -> getCapability(EventBusCapability.class));

private void publishLoginEvent(Player player) {
    if (eventBusProvider == null) return;
    EventBusCapability eventBus = eventBusProvider.get();
    if (eventBus == null) return;
    Map<String, String> payload = new HashMap<>();
    payload.put("auth_mode", configuration.authMode().configKey());
    payload.put("account_type", accountType(player).id());
    eventBus.publish("axs.loginview.login_success", player, payload);
}

publishedTopics 声明

LoginView 在模块入口声明了发布的事件 Topic：

@Override
protected List<String> publishedTopics() {
    return List.of("axs.loginview.login_success");
}

信号派发

LoginView 还通过 SignalDispatchable 派发信号，可供 QuestGPS、条件触发器等模块监听。

信号变量

Capability 注册

LoginView 模块注册了以下 Capability，供宿主及其他模块调用：

LoginViewQueryable（公开）

认证状态查询与登录界面打开能力（@PublicCapability），外部插件经 AxsCapabilities.get(LoginViewQueryable.class) 获取；LoginView 未启用时返回 null。查询方法可从任意线程调用（冷路径可能产生一次数据库查询，高频路径请异步或缓存）；openFor 须在 Bukkit 主线程调用。

DatabaseMigratable

支持数据库迁移，供本体存储管理模块在切换存储后端时调用。

registerCapability(DatabaseMigratable.class, new DatabaseMigratable() {
    @Override public String moduleId() { return "loginview"; }
    @Override public MigrationResult migrateDatabase(StorageDescriptor target, boolean overwrite) {
        return lvRepo.migrateData(target, overwrite);
    }
    @Override public StorageDescriptor currentDescriptor() {
        return lvRepo.getDescriptor();
    }
});

PlayerDataPurgeable

支持玩家数据清理，供宿主管理面板或 GDPR 合规工具调用。

宿主能力依赖

LoginView 运行时通过 getCapability 延迟查找以下宿主能力：

宿主服务依赖

LoginView 依赖以下宿主服务，在 startService 中注入：

跨服与存储

共享存储模式

storage.shared: true（推荐）时，LoginView 使用本体统一数据源，各模块共用 config.yml 的 storage 节配置。数据库连接由宿主 StorageManager 统一管控，性能更好。

自建存储模式

storage.shared: false 时，LoginView 自建独立 HikariCP 连接池，支持 SQLite 或 MySQL。适用于需要独立数据库隔离的场景。

跨服 Session

standalone 模式下，登录 session 持久化到数据库 sessions 表。多服架构下，若各服共享同一数据库，玩家在 A 服登录后切换到 B 服可直接读取 session 免登录（需 session-strict-ip: false 或两服出口 IP 一致）。

数据库表结构

LoginView 使用两张表存储账户和会话数据，表名前缀由 storage.mysql.table-prefix（默认 AXS_loginview_）控制。

accounts 表

存储玩家登录账户信息。

sessions 表

存储登录会话，用于免密自动登录。

模块集成

qqbot 模块

LoginView 通过 QqBindCapable 能力与 qqbot 模块集成，实现正版/LittleSkin 玩家强制绑定 QQ：

• qq-binding.enabled: true 启用绑定流程
• microsoft-require-bind / littleskin-require-bind 控制各账号类型是否强制绑定
• 未绑定时登录界面显示 bind-prompt 提示与验证码输入框
• 玩家在 QQ 群发送 #绑定 {name} 获取验证码，在 UI 中输入确认

AuthMe 插件

LoginView 通过 AuthMeBridge 桥接 AuthMe 插件：

• auth.mode: authme 时，注册/登录/改密委托 AuthMe 的 AuthMeApi 处理
• auth.mode: standalone 时，可通过 migrate-authme 命令从 AuthMe 数据库导入历史账户
• AuthMe 缺失时桥接自动降级为不可用，authme 模式下模块不加载

AccountTypeService

LoginView 依赖宿主 AccountTypeService 判定玩家账号类型：

玩家进服后，LoginView 异步预热账号类型缓存（resolveBlocking），完成后在主线程打开 UI 并发送 init 包。正版玩家显示免密进入界面，离线玩家显示密码登录/注册界面。

条件触发器

LoginView 派发的信号可被条件触发器监听，实现登录后触发逻辑：

• login_success — 密码登录成功后触发
• first_register — 首次注册成功后触发
• premium_bypass — 正版免密进入后触发

信号变量包含 auth_mode、account_type、account_type_display，可用于条件判断。详见 Conditions 指南。

物品来源

LoginView 不直接使用物品来源系统，但其 UI 文件中的服规面板等组件可引用 Item Sources 定义的物品作为装饰。