voxel/kubi

mirror of https://github.com/griffi-gh/kubi.git synced 2024-11-12 18:38:43 -06:00

Voxel engine written in Rust (backup/mirror)

ecs glium glium-crate minecraft multiplayer networking opengl opengl3 rust shipyard voxel-engine

Find a file

griffi-gh 777e0af4a4 introduce some terrible, unsafe, ub code 👍... oh and also some other stuff		2023-07-20 12:28:37 +02:00
.cargo	oops, avx2 is not as widely available as i thought	2023-05-27 18:54:00 +02:00
.github/workflows	use mold as linker on linux	2023-05-28 23:46:14 +02:00
.readme	Add touch controls, switch to tinymap for keyboard input	2023-06-04 18:39:55 +02:00
.vscode	disable lint	2023-03-08 01:47:46 +01:00
assets/blocks	improve worldgen	2023-02-18 00:37:17 +01:00
kubi	introduce some terrible, unsafe, ub code 👍... oh and also some other stuff	2023-07-20 12:28:37 +02:00
kubi-logging	make naga shut up	2023-07-17 12:44:00 +02:00
kubi-server	upgrade dependencies	2023-07-09 03:03:45 +02:00
kubi-shared	uniforms, bind groups and other nice stuff	2023-07-20 03:03:52 +02:00
.gitignore	add `generate_visualizer_data` feature	2023-03-09 00:56:46 +01:00
Cargo.lock	wip stuff	2023-07-13 02:11:19 +02:00
Cargo.toml	It compiles but obviously doesn't work yet	2023-07-17 00:25:19 +02:00
README.md	wip	2023-07-15 22:14:08 +02:00
Server.toml	Finish upgrading server to `uflow`	2023-03-09 03:30:37 +01:00

README.md

wgpu branch

Highly experimental very early work-in-progress wgpu version of Kubi!
(will also include the new gui system)

Status: doesn't even compile

If you want to play kubi, build the glium-based master branch instead (binary nightly releases).

Android is not supported

android builds need some significant changes to work with wgpu
but if you still want to try it latest git version of cargo-apk may be required:

cargo install --git https://github.com/rust-mobile/cargo-apk cargo-apk

Kubi

Voxel engine written in Rust

features

multithreaded procedural world generation
procedural structures
multithreaded mesh generation
cubic chunks (32x32x32)
low-level OpenGL renderer, targetting OpenGL ES 3.0
frustum culling
multiplayer support ^[1]
block placement system
basic gui^[5]
cross platform: windows, linux, osx ^[2], android ^[3]
universal input system: supports keyboard, mouse, gamepad and touch input ^[4]

`[1]` - multiplayer is work-in-progress
`[2]` - not tested on macos
`[3]` - android support is experimental
`[4]` - mouse/gamepad input is not supported on android
`[5]` - currently only used on the loading screen

download

Latest nightly release

build for windows/linux

build/run

cargo build --bin kubi
cargo run --bin kubi

build in release mode, with nightly optimizations

cargo +nightly build --bin kubi --features nightly --release

build for android

please note that android support is highly experimental!
gamepad, mouse input is currently borked, and proper touch controls are not available.
srgb and blending are broken too, which leads to many rendering issues

prerequisites: Android SDK, command line tools, NDK, platform-tools, latest JDK
(make sure that your $PATH variable is configured properly)

Setup:

cargo install cargo-apk
cargo target add aarch64-linux-android

Build:

--no-default-features is required for keyboard input!
(prefer-raw-events feature must be disabled on android)

Mouse input is not implemented, touch only!

cargo apk build -p kubi --no-default-features

Run:

cargo apk run -p kubi --no-default-features

touch controls

Left side: Movement
Rigth side: Camera controls
Bottom right corner:
- B (e.g. place blocks)
- A (e.g. break, attack)

mutiplayer

to join a multiplayer server, just pass the ip address as an argument

cargo run -p kubi -- 127.0.0.1:1234

server configuration

[server]
address = "0.0.0.0:12345"     # ip address to bind to
max_clients = 32              # max amount of connected clients
timeout_ms = 10000            # client timeout in ms

[world]
seed = 0xfeb_face_dead_cafe   # worldgen seed to use

[query]
name = "Kubi Server"          # server name