https://github.com/thombruce/hellorltk
https://github.com/thombruce/hellorltk
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/thombruce/hellorltk
- Owner: thombruce
- Created: 2022-06-03T10:47:31.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-06-17T03:59:40.000Z (almost 3 years ago)
- Last Synced: 2025-02-14T09:58:03.862Z (4 months ago)
- Language: Rust
- Size: 169 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hello, RLTK!
This is my learning project, following an excellent guide to creating a roguelike game using Rust. The brilliant tutorial, written by Herbert Wolverson, can be found here: https://bfnightly.bracketproductions.com/chapter_0.html
## A Note About WSL
Wolverson's tutorial is pretty amazing, and makes for an excellent introduction to Rust if you ask me... with only one minor snag so far: Windows Subsystem for Linux (WSL 2).
When it came time to run a windowed application, with `cargo run`, the process failed with something akin to the following error:
```
thread 'main' panicked at 'called `Option::unwrap()` on a `None` value'...
```
I searched for a solution and found the same error raised in an issue on the glutin repo, [here](https://github.com/rust-windowing/glutin/issues/1399).
The issue, I believe, is a lack of permission for the WSL instance to create windowed Linux applications... _I don't know this for a fact, but it seems about right._
The solution, then, is to build for Windows instead. We need to install a couple of build dependencies, and then run `cargo run` targeting the Windows environment instead:
```shell
# One time setup
sudo apt update && sudo apt install mingw-w64
rustup target add x86_64-pc-windows-gnu
# Run the application
cargo run --target x86_64-pc-windows-gnu
```
_You may need to tweak this for your particular machine. To obtain a list of available targets:_
```shell
rustc --print target-list
```
And hey presto! _It just works!_
## Criticism
~~_If I had one gripe with Wolverson's tutorial, it would not be the WSL issue (this is obscure and easily missed). It would be that by the beginning of chapter 5, he has refactored the code twice between chapters with little direction for the reader... One can argue, and I will, that this is a good thing. The reader is encouraged to review and refactor their own code to catch up with the starting state at the beginning of each chapter, though I think an early chapter or external reference offering a guiding hand for this would be of benefit._~~
_In a future update, I will remove the above criticism. The tutorial covers a lot of ground, and the subject matter is obviously quite difficult to handle succinctly. Wolverson does an excellent job, despite these occasions where there are the odd missed bit of info, the odd bug introduced or the odd refactor. Ultimately, the tutorial isn't meant for absolute beginners to programming, and the intermediate-to-experienced programmer will have little problem swinging with the punches._
_Note: By the end of the chapter on Ranged Scrolls and Targeting, a minor bug is left in the code Wolverson has written; confusion scrolls do not get deleted upon use. But as I've written above, I am unsure if this is a mistake or if it is a deliberate error left for the reader to fix._