Bevy TUI

一个插件，用于使用 TUI 而不是图形界面创建交互式 Bevy 应用程序。

此插件大部分可使用，由于我的工作优先级较高，我对它的更新有些间断。尽管如此，它已经相当稳定且可用，尽管还有很大的改进空间和提升开发者体验的空间。

快速入门

默认的 "MinimalPlugins" 仍然包含大量不兼容在无头环境中运行的可视化插件。此软件包提供了一组替代插件，它们可以替换最小插件，并主要提供对 Bevy 核心的访问。

这个非标准的最小核心以及控制台环境有一些权衡，这些权衡可能是 Bevy 开发者不熟悉的。有关更多信息，请参阅权衡部分。

use bevy::prelude::*;
use bevy_tui::prelude::*;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    initialize_terminal()?;

    App::new()
        .add_plugins(MinimalTuiPlugins)
        .run();

    teardown_terminal()?;

    Ok(())
}

有一些示例演示了如何使用此软件包的某些部分。

背景

该项目最初是为了创建一个管理客户端来监控游戏服务器的健康和状态，而不会对它们造成显著的负载。我想到，如果适当完善，这将有助于其他项目，例如基于终端的 rogue 类型和文字冒险游戏的环境。

权衡

键盘事件

从终端接收的键盘事件不是键盘的扫描码，也不会区分键盘的左右侧。Bevy 希望使用物理键来表示所有键盘交互，而终端在很大程度上并不关心这些。

为了与现有代码库在一定程度上兼容，手动将键盘事件转换为基于美国键盘布局的bevy::input::KeyCode实例。大写字母和带Shift的符号键转换为两个按键，优先选择键盘的左侧。例如，A变成了两个键码，KeyCode::KeyA和KeyCode::ShiftLeft，类似地，%变成了KeyCode::Key5和KeyCode::ShiftLeft。如果需要用于文本输入等场景的原始输入字符，建议使用RawConsoleEvent类型来提取适当的输入字符。这对于Unicode代码点和非美国键盘布局也是适用的。

cargo run -p ci -- default