2019-01-11 23:41:19 -05:00
|
|
|
# Stevenarella
|
2019-05-31 12:30:04 -04:00
|
|
|
[![builds.sr.ht status](https://builds.sr.ht/~iceiix/stevenarella.svg)](https://builds.sr.ht/~iceiix/stevenarella?)
|
2019-01-11 23:41:19 -05:00
|
|
|
|
|
|
|
Multi-protocol Minecraft-compatible client written in Rust
|
2016-03-31 17:20:10 -04:00
|
|
|
|
|
|
|
Don't expect it to go anywhere, just doing this for fun.
|
|
|
|
|
|
|
|
## Images
|
|
|
|
|
2016-04-21 07:01:20 -04:00
|
|
|
![Steven on Hypixel](https://i.imgur.com/PM5fLuu.png)
|
2016-04-01 15:06:24 -04:00
|
|
|
![Steven](https://i.imgur.com/RRspOQF.png)
|
|
|
|
|
2016-03-31 17:20:10 -04:00
|
|
|
|
|
|
|
In action: http://gfycat.com/NeedyElaborateGypsymoth
|
|
|
|
|
2019-03-02 10:04:12 -05:00
|
|
|
## Community chatroom
|
|
|
|
|
|
|
|
We have a chatroom on [EsperNet](https://esper.net): `irc.esper.net` server, `#stevenarella` channel.
|
|
|
|
|
|
|
|
Join with your favorite IRC client or [Matrix](https://matrix.to/#/#_espernet_#stevenarella:matrix.org).
|
|
|
|
|
2019-01-11 23:41:19 -05:00
|
|
|
## Protocol support
|
|
|
|
|
|
|
|
| Game version | Protocol version | Supported? |
|
|
|
|
| ------ | --- | --- |
|
2019-12-29 18:55:19 -05:00
|
|
|
| 1.15.1 | 575 | ✓ |
|
2019-08-11 20:26:20 -04:00
|
|
|
| 1.14.4 | 498 | ✓ |
|
2019-07-07 17:58:49 -04:00
|
|
|
| 1.14.3 | 490 | ✓ |
|
2019-05-29 11:22:45 -04:00
|
|
|
| 1.14.2 | 485 | ✓ |
|
2019-05-13 19:44:31 -04:00
|
|
|
| 1.14.1 | 480 | ✓ |
|
2019-05-04 19:01:28 -04:00
|
|
|
| 1.14 | 477 | ✓ |
|
2019-01-11 23:41:19 -05:00
|
|
|
| 19w02a | 452 | ✓ |
|
|
|
|
| 18w50a | 451 | ✓ |
|
|
|
|
| 1.13.2 | 404 | ✓ |
|
|
|
|
| 1.12.2 | 340 | ✓ |
|
|
|
|
| 1.11.2 | 316 | ✓ |
|
|
|
|
| 1.11 | 315 | ✓ |
|
|
|
|
| 1.10.2 | 210 | ✓ |
|
|
|
|
| 1.9.2 | 109 | ✓ |
|
|
|
|
| 1.9 | 107 | ✓ |
|
|
|
|
| 15w39c | 74 | ✓ |
|
|
|
|
| 1.8.9 | 47 | ✓ |
|
2019-05-13 19:44:31 -04:00
|
|
|
| 1.7.10 | 5 | ✓ |
|
2019-01-11 23:41:19 -05:00
|
|
|
|
|
|
|
Stevenarella is designed to support multiple protocol versions, so that client
|
|
|
|
development is not in lock-step with the server version. The level of
|
|
|
|
support varies, but the goal is to support major versions from 1.7.10
|
|
|
|
up to the current latest major version. Occasionally, snapshots are also supported.
|
|
|
|
|
2019-05-13 19:44:31 -04:00
|
|
|
Forge servers are currently supported on 1.7.10 - 1.12.2.
|
|
|
|
|
2019-01-11 23:41:19 -05:00
|
|
|
Support for older protocols will _not_ be dropped as newer protocols are added.
|
2016-03-31 17:20:10 -04:00
|
|
|
|
2019-01-11 23:41:19 -05:00
|
|
|
## Credits
|
|
|
|
|
|
|
|
Thanks to [@thinkofname](https://github.com/thinkofname/) for
|
|
|
|
the original [Steven (Rust)](https://github.com/thinkofname/steven),
|
|
|
|
which Stevenarella is an updated and enhanced version of.
|
2016-03-31 17:20:10 -04:00
|
|
|
|
2018-11-18 11:11:23 -05:00
|
|
|
## Downloads
|
|
|
|
|
2019-01-11 23:41:19 -05:00
|
|
|
Windows users can download pre-compiled builds from here: https://ci.appveyor.com/project/iceiix/stevenarella
|
2018-11-18 11:11:23 -05:00
|
|
|
(Select your platform, Click the artifacts tab and download Steven.zip)
|
|
|
|
|
2018-11-20 10:06:31 -05:00
|
|
|
The Visual Studio 2017 Redistributable is required to run these builds.
|
2018-11-18 11:11:23 -05:00
|
|
|
|
2016-03-31 17:20:10 -04:00
|
|
|
## Building
|
|
|
|
|
blocks: split macro into multiple functions, fast! (#267)
Improves fix for #184, whereas #255 reduced optimizations,
we now address the underlying compiler limitation and split out
the one massive lazy_static! initialization function, into
one function per block in the block_registration_functions module.
Previous build time, with opt-level=1:
% time cargo build --release
Compiling steven_blocks v0.0.1
Finished release [optimized] target(s) in 21.24s
cargo build --release 31.80s user 0.71s system 152% cpu 21.276 total
With this change, opt-level=3 and the function splitting fix:
% time cargo build --release
Compiling steven_blocks v0.0.1
Finished release [optimized] target(s) in 30.80s
cargo build --release 40.26s user 0.86s system 133% cpu 30.850 total
Full optimizations are expectedly slightly slower, but this is still
much much _much_ faster than before this refactoring, where this crate
would take up to an unbelievable 5 hours (and tens of GB of RAM). Long
story short, we're now back to full optimizations and stable Rust.
Thanks to dtolnay on the Rust programming language forum for suggesting
this technique, https://users.rust-lang.org/t/5-hours-to-compile-macro-what-can-i-do/36508/2
2020-01-09 23:08:28 -05:00
|
|
|
Requires Rust stable version 1.40.0 or newer to build.
|
2016-03-31 17:20:10 -04:00
|
|
|
|
2018-11-18 11:11:23 -05:00
|
|
|
Compile and run:
|
|
|
|
```bash
|
|
|
|
cargo run --release
|
|
|
|
```
|
|
|
|
Just compile:
|
|
|
|
```bash
|
|
|
|
cargo build --release
|
|
|
|
```
|
2016-03-31 17:20:10 -04:00
|
|
|
|
Add support for compiling WebAssembly wasm32-unknown-unknown target (#92)
Note this only is the first step in web support, although the project compiles, it doesn't run!
Merging now to avoid branch divergence, until dependencies can be updated for wasm support.
* Add instructions to build for wasm32-unknown-unknown with wasm-pack in www/
* Update to rust-clipboard fork to compile with emscripten
https://github.com/aweinstock314/rust-clipboard/pull/62
* Exclude reqwest dependency in wasm32
* Exclude compiling clipboard pasting on wasm32
* Exclude reqwest-using code from wasm32
* Install wasm target with rustup in Travis CI
* Update to collision 0.19.0
Fixes wasm incompatibility in deprecated rustc-serialize crate: https://github.com/rustgd/collision-rs/issues/106
error[E0046]: not all trait items implemented, missing: `encode`
--> github.com-1ecc6299db9ec823/rustc-serialize-0.3.24/src/serialize.rs:1358:1
* Increase travis_wait time even further, try 120 minutes
* Set RUST_BACKTRACE=1 in main
* Remove unused unneeded bzip2 features in zip crate
To fix wasm32-unknown-unknown target compile error:
error[E0432]: unresolved imports `libc::c_int`, `libc::c_uint`, `libc::c_void`, `libc::c_char`
--> src/github.com-1ecc6299db9ec823/bzip2-sys-0.1.7/lib.rs:5:12
|
5 | use libc::{c_int, c_uint, c_void, c_char};
| ^^^^^ ^^^^^^ ^^^^^^ ^^^^^^ no `c_char` in the root
| | | |
| | | no `c_void` in the root
| | no `c_uint` in the root
| no `c_int` in the root
* flate2 use Rust backend
* Add console_error_panic_hook module for wasm backtraces
* Build using wasm-pack, wasm-bindgen, run with wasm-app
* Update to miniz_oxide 0.2.1, remove patch for https://github.com/Frommi/miniz_oxide/issues/42
* Update to official clipboard crate since https://github.com/aweinstock314/rust-clipboard/pull/62 was merged, but git revision pending release
* Update to branch of glutin attempting to build for wasm
https://github.com/iceiix/glutin/pull/1
* Update winit dependency of glutin to git master
https://github.com/iceiix/winit/pull/2
* Update to glutin branch with working (compiles, doesn't run) wasm_stub
* Add app name in title on web page
* Add wasm to Travis-CI test matrix
* Update glutin to fix Windows EGL compilation on AppVeyor
https://github.com/iceiix/glutin/pull/1/commits/97797352b5242436cb82d8ecfb44242b69766e4c
2019-03-03 11:32:36 -05:00
|
|
|
For progress on web support, see [www/](./www).
|
|
|
|
|
2016-03-31 17:20:10 -04:00
|
|
|
## Running
|
|
|
|
|
|
|
|
### Standalone
|
|
|
|
|
2019-01-11 23:41:19 -05:00
|
|
|
Just running Stevenarella via a double click (Windows) or `./stevenarella` (everything else)
|
2016-03-31 17:20:10 -04:00
|
|
|
will bring up a login screen followed by a server list which you can select a server
|
|
|
|
from.
|
2019-01-11 23:41:19 -05:00
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
Dual-licensed MIT and ApacheV2
|