1个不稳定版本

0.8.7	2022年10月5日

#1975 在游戏开发中

1,317 星 & 23 关注者

MIT 许可证

100KB
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。Rogue-like教程在不更改的情况下编译。

您可以在以下位置阅读关于使用此库编写Rogue-like游戏的教程系列： 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着色器。

对于最简单的Hello World示例，您的源代码（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

1个不稳定版本

欢迎来到RLTK_RS，RLTK的Rust实现

运行示例

在项目中使用RLTK

高级使用：多个后端

示例

示例1：弹跳Hello World

示例2：多个控制台层

示例 3：四处走动

示例 4：视野

示例 5：使用Dijkstra流图自动探索

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

示例 7：分层瓦片

示例 8：REX Paint 支持

示例 9：层偏移

示例 10：后期处理效果

示例 11：掷骰子

示例 12：Simplex Noise

示例 13：格式化块

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

示例 15：获取按键码

示例 16（仅 WebAssembly）：绑定 HTML 按钮

示例 17：多瓦片精灵

使用 WASM 构建

依赖关系