= CubeShuffle
image:https://img.shields.io/github/workflow/status/philipborg/CubeShuffle/Rust%20build%20&%20test[GitHub Workflow Status] image:https://img.shields.io/badge/status-beta-green[Status] link:LICENSE[image:https://img.shields.io/github/license/philipborg/CubeShuffle[GitHub]] image:https://img.shields.io/badge/platform-Linux--x64%20%7C%20macOS--x64%20%7C%20Windows--x64%20%7C%20Android%20%7C%20Web%2FWasm32-informational[Platforms]
link:https://github.com/philipborg/CubeShuffle/subscription[image:https://img.shields.io/github/watchers/philipborg/CubeShuffle?style=social[GitHub watchers]] image:https://img.shields.io/github/stars/philipborg/CubeShuffle?style=social[GitHub Repo stars] image:https://img.shields.io/github/followers/philipborg?style=social[GitHub followers]
:toc:
== Introduction to CubeShuffle
CubeShuffle improves card game cube shuffling by offering more control over distribution, randomness and/or shuffling speed. It does this by combining digital and manual shuffling. CubeShuffle is designed to be generic for all card games with a cube format.
== Installation
CubeShuffle is currently available on three different platforms:
Please note that there are currently no automatic updates operational on any platform.
== Distribution Shuffle
This is a quick and easy shuffling method for cubes, where cards can be assigned and distributed based on groups. It offers control over predictability as card shuffling can be controlled from being completely random to evenly distributed. Instructions on how to use Distribution Shuffle are available link:docs/distribution_shuffle.adoc[here]. Use Distribution Shuffle with 100% randomness for all piles to speed up a completely random cube shuffle significantly.
== Predictability and randomness
You may be asking why anyone would want to control the randomness. Shouldn't the draft be completely random? If you want to, and it suits your cube, you can, as CubeShuffle can use Distribution Shuffle to achieve 100% randomness.
Most cubes don't want complete randomness. You want to ensure the deck archetypes are playable and have a low chance of being ruined by chance, or worse, bad shuffling (bad shuffling is significantly less likely when using CubeShuffle). This is why you never see sealed booster packs in MTG with just one card color as they are far from completely random but rather have controlled randomness. It lends itself to a significantly better drafting experience.