15个版本

0.8.7	2022年10月4日
0.8.1	2020年4月29日
0.7.0	2020年2月22日
0.6.2	2020年1月31日
0.5.14	2019年12月31日

#217 in 游戏开发

2,006 每月下载量

MIT 许可证

3MB
2K SLoC

欢迎来到RLTK_RS，RLTK的Rust实现

您可以在以下位置找到原始的C++项目：https://github.com/thebracket/rltk.

重大变更警告：如果您直接使用 bracket-terminal，则 crossterm 功能现在是 cross_term。对于 bracket-lib 和 rltk，它仍然是 crossterm。

重要：如果您正在运行 webgpu 后端，您需要将 resolver = 2 添加到您的 Cargo.toml 文件中。WGPU需要它来进行平台选择。

注意：rltk_rs 现在是 bracket-lib 的包装器。它将所有命名空间映射到与旧的 rltk 和 rltk::prelude 命名空间一起工作，包括为您重命名 BTerm 和 BTermBuilder。Roguelike教程编译后无变化。

您可以在以下位置阅读关于使用此库编写Roguelike的教程系列：https://bfnightly.bracketproductions.com/rustbook/

运行示例

这些示例使用Cargo内置的示例代码支持。例如，要运行示例1，请输入：cargo run --example ex01-helloworld。

在您的项目中使用RLTK

在您的 Cargo.toml 文件中，包含以下内容

[dependencies]
rltk = "0.6.2"

注意：我们在示例文件中不这样做，我们使用相对路径 - 以避免嵌套git仓库。

将RLTK中 resources 目录下的所有文件复制到您自己的 resources 文件夹中。RLTK需要能够加载字体文件和OpenGL着色器。

对于最简单的 你好世界，您的源代码（main.rs）可以看起来像这样

extern crate rltk;
use rltk::{Rltk, GameState, Console};

struct State {}
impl GameState for State {
    fn tick(&mut self, ctx : &mut Rltk) {
        ctx.cls();
        ctx.print(1, 1, "Hello RLTK World");
    }
}

fn main() {
    let context = Rltk::init_simple8x8(80, 50, "Hello RLTK World", "resources");
    let gs = State{ };
    rltk::main_loop(context, gs);
}

高级用法：多个后端

RLTK支持许多 功能标志，让您可以按照自己的意愿使用它。

如果您移除了默认功能，则会进入“哑”模式。游戏状态和渲染功能将被禁用，但所有库功能都是可用的（并且库变得非常小 - 去掉了大部分依赖）。
默认情况下，opengl 功能将使用 WebGL 或本地 OpenGL 来通过伪终端渲染您的控制台。
您可以通过禁用 opengl 并启用 curses 来渲染到 ncurses 或 pdcurses（具体取决于您的平台）。现在所有演示都可以作为控制台程序运行，通过以下命令：cargo run --example curses14-dwarfmap --features curses --no-default-features（在示例名称中将 curses 替换为 ex，并指定功能集）。
您可以通过禁用 opengl 并启用 crossterm 来通过 crossterm 库将渲染到本地控制台（示例使用 crossterm 前缀）。例如，cargo run --example crossterm18-textsprites --no-default-features --features="crossterm"
您可以通过禁用 opengl 并启用 webgpu。示例以 wgpu 为前缀。例如，cargo run --example av13-textblock --no-default-features --features wgpu 将在 WebGPU 上运行示例 13（选择 Vulkan/Metal/WebGPU）。

示例

示例 1：反弹的 Hello World

Animated GIF

示例 1 - Hello World 是一个小示例，展示了简单的 8x8 控制台以及使 RLTK 运行所需的基本代码。

从克隆仓库的根目录运行此示例：cargo run --example 1

15个版本

欢迎来到RLTK_RS，RLTK的Rust实现

运行示例

在您的项目中使用RLTK

高级用法：多个后端

示例

示例 1：反弹的 Hello World

示例 2：多个控制台层

示例 3：四处走动

示例 4：视野

示例 5：使用迪杰斯特拉流图自动探索

示例 6：A* 路径和鼠标控制

示例 7：分层瓦片

示例 8：REX Paint 支持

示例 9：图层偏移

示例 10：后期处理效果

示例 11：掷骰子

示例 12：Simplex 噪音

示例 13：格式化块

示例 14：矮人要塞风格的 3D

示例 15：获取键码

示例16（仅限Web Assembly）：绑定HTML按钮

示例17：多图块精灵

使用WASM构建

依赖关系