Go to file
iceiix c7bdb60d85
CI enhancements: .app bundling, build .wasm (#486)
Updates to enhance GitHub Actions continuous integration:

* ci: add macOS app bundle packaging using cargo-bundle, closes #352 
based on https://github.com/EndlessSkyCommunity/ESLauncher2/blob/master/Cargo.toml
* ci: add web target, building using wasm-pack (for #446) 
* ci: refactor and cleanup targets, split out instead of using matrix

* main: save config in consistent OS-specific dirs::config_dir()
Instead of storing and loading in the current working directory, change
to a consistent dedicated configuration directory. This is necessary for
.app launching since cwd is set to /. To preserve compatibility with
existing installations, if conf.cfg exists in cwd then it will be used instead,
but otherwise we will use the operating system specific config dirs:
// Lin: Some(/home/alice/.config)
// Win: Some(C:\Users\Alice\AppData\Roaming)
// Mac: Some(/Users/Alice/Library/Application Support)

* macos: add icons based on screenshotted logo
* macos: add Cmd-Q to quit
2021-01-18 19:05:29 -08:00
.cargo Enable static CRT (in git), closes #318 2020-07-05 11:20:34 -07:00
.github/workflows CI enhancements: .app bundling, build .wasm (#486) 2021-01-18 19:05:29 -08:00
blocks blocks: add 1.16.1/2+ new blocks/states (#474) 2021-01-14 16:47:41 -08:00
protocol 1.16.5 protocol is the same as 1.16.4 (#480) 2021-01-17 17:13:23 -08:00
resources CI enhancements: .app bundling, build .wasm (#486) 2021-01-18 19:05:29 -08:00
shared Reformat all source with cargo fmt (#335) 2020-06-21 12:17:24 -07:00
src CI enhancements: .app bundling, build .wasm (#486) 2021-01-18 19:05:29 -08:00
std_or_web WebGL fixes after disabling threaded chunk builder (#451) 2020-12-31 14:35:30 -08:00
www www: bundle resources statically (#483) 2021-01-18 09:48:38 -08:00
.gitignore Add rustfmt backup files to .gitignore, from #337 2020-06-21 12:32:11 -07:00
.travis.yml Add support for compiling WebAssembly wasm32-unknown-unknown target (#92) 2019-03-03 08:32:36 -08:00
Cargo.lock CI enhancements: .app bundling, build .wasm (#486) 2021-01-18 19:05:29 -08:00
Cargo.toml CI enhancements: .app bundling, build .wasm (#486) 2021-01-18 19:05:29 -08:00
LICENSE-APACHE Duel license under MIT and ApacheV2 2016-03-26 17:34:47 +00:00
LICENSE-MIT Duel license under MIT and ApacheV2 2016-03-26 17:34:47 +00:00
README.md 1.16.5 protocol is the same as 1.16.4 (#480) 2021-01-17 17:13:23 -08:00

README.md

Stevenarella

Build Status

Multi-protocol Minecraft-compatible client written in Rust.

Don't expect it to go anywhere, just doing this for fun.

Images

Steven on Hypixel Steven

In action: http://gfycat.com/NeedyElaborateGypsymoth

Community

IRC channels: #stevenarella on irc.freenode.net, or #stevenarella on irc.esper.net.

Discussion forum: https://github.com/iceiix/stevenarella/discussions.

Protocol support

Game version Protocol version Supported?
1.16.5 754
1.16.4 754
1.16.3 753
1.16.2 751
1.16.1 736
1.16 735
1.15.2 578
1.15.1 575
1.14.4 498
1.14.3 490
1.14.2 485
1.14.1 480
1.14 477
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
1.7.10 5

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.

Forge servers are currently supported on 1.7.10 - 1.12.2.

Support for older protocols will not be dropped as newer protocols are added.

Downloads

Windows, Ubuntu Linux, and macOS users can download pre-compiled builds from GitHub Actions. (Click the artifacts drop-down and select your platform.)

Dependencies

Requires Rust stable version 1.49.0 or newer.

Debian/Ubuntu

sudo apt-get install libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev libxcb-composite0-dev

Alpine Linux

sudo apk add openssl-dev xcb-util-dev

Building

Compile and run:

cargo run --release

Just compile:

cargo build --release

For progress on web support, see www/.

Running

Standalone

Just running Stevenarella via a double click (Windows) or ./stevenarella (everything else) will bring up a login screen followed by a server list which you can select a server from.

Contributions

Stevenarella is an OPEN Open Source Project:

Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is more like an open wiki than a standard guarded open source project.

Rules

There are a few basic ground-rules for contributors:

  1. No --force pushes or modifying the Git history on the master branch.
  2. Non-master branches ought to be used for ongoing work.
  3. External API changes and significant modifications ought to be subject to an internal pull-request to solicit feedback from other contributors.
  4. Internal pull-requests to solicit feedback are encouraged for any other non-trivial contribution but left to the discretion of the contributor.
  5. Contributors should attempt to adhere to the prevailing code-style. Please install and run cargo fmt before merging any changes.

Changes to this arrangement

This is an experiment and feedback is welcome! This document may also be subject to pull-requests or changes by contributors where you believe you have something valuable to add or change.

Credits

Thanks to @thinkofname for the original Steven (Rust), which Stevenarella is an updated and enhanced version of.

License

Dual-licensed MIT and ApacheV2