cobble

A basic Minecraft-esque voxel building game written in Rust based on the Bevy engine

More screenshots

Features

Block placement and destruction
Basic physics based movement and collisions
Procedural world generation
Nine types of blocks

Limitations

No world persistence
No async and/or parallel chunk loading and generation
Movement can occasionally be a bit weird

Running cobble

Run just like any other project with cargo

cargo run --release

For development, it might be beneficial to use the nightly toolchain with a special config, as detailed in the official bevy documentation, to drastically reduce the compile time.

Moreover, runtime options can be set in the cobble.yaml-file, like this

video:
  vsync: false
game: 
  creative: false
# ...

Full schema (except for bindings, see defaults)

debug:
  log_diagnostics: bool # default = false
  print_default_config: bool # default = false
  show_colliders: bool # default = false
  show_fps: bool # default = true
  show_selection: bool # default = true
  show_selection_normal: bool # default = false
game: 
  breakable_bedrock: false # default = false
  creative: true # default = true
input:
  bindings:
    # omitted, see default values for inspiration
  initial_cursor_grab: bool # default = true
  sensitivity: f32 # default = 1.0
video:
  msaa_samples: u32 # Any power of two, default = 4
  show_interface: bool # default = true
  vsync: bool # default = true
  window_mode: Windowed | Borderless | Fullscreen # default = Windowed

Default configuration

debug: 
  log_diagnostics: false
  print_default_config: false
  show_colliders: false
  show_fps: true
  show_selection: true
  show_selection_normal: false
game: 
  breakable_bedrock: false
  creative: true
input: 
  bindings: 
    DeadZone: {}
    EventPhase: 
      BREAK: OnBegin
      FULLSCREEN_TOGGLE: OnBegin
      PLACE: OnBegin
    GamepadAxis: {}
    GamepadButtons: {}
    KeyboardKeys: 
      A: MOVE_LEFT
      D: MOVE_RIGHT
      F3: FULLSCREEN_TOGGLE
      Key1: SLOT_1
      Key2: SLOT_2
      Key3: SLOT_3
      Key4: SLOT_4
      Key5: SLOT_5
      Key6: SLOT_6
      Key7: SLOT_7
      Key8: SLOT_8
      Key9: SLOT_9
      LControl: MOVE_MOD_FAST
      LShift: MOVE_MOD_SLOW_DESC
      S: MOVE_BACKWARD
      Space: MOVE_JUMP
      Tab: FLY_TOGGLE
      W: MOVE_FORWARD
    MouseButtons: 
      Left: BREAK
      Middle: PICK_BLOCK
      Right: PLACE
    MouseMove: {}
  initial_cursor_grab: true
  sensitivity: 1.0
video: 
  msaa_samples: 4
  show_interface: true
  vsync: true
  window_mode: Windowed

Default key-bindings

Action	Binding	Note
Movement	`W`/`A`/ `S`/`D`
Jump/Ascend	`Space`	Alternative action only in flight
Sneak/Descend	`L-Shift`	Alternative action only in flight
Sprint	`L-Control`
Toggle fly	`Tab`	Creative-mode only
Pause	`ESC`
Place block	`Right Mouse Button`
Break block	`Left Mouse Button`
Pick block to inventory	`Middle Mouse Button`	Creative-mode only
Switch active toolbar/inventory slot	`1` - `9`

Cobble should run on most platforms, including WASM, but might require optimizations and adjustments to be usable on non-x86/x64 platforms or without keyboard- and mouse-input.

License

Licensed under MIT, see LICENSE. The licenses of the utilized code and assets are located under LICENSES.

References

License

offdroid/cobble

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages