Skip to content

Bixilon/Minosoft

Repository files navigation

Minosoft

Minosoft is an open source minecraft client, written from scratch in kotlin (and java). It aims to bring more functionality and stability.
(This is not a classical clone of minecraft, it completely re implements it!)
(This software is not affiliated with Mojang AB, the original developer of Minecraft)

New: There is an minimal education edition available, just check out the education branch.

Notice: I am *not* responsible for anti cheat banned accounts, this project is still in development!

I am semi actively developing this project at the moment. That means I am working on it if I am bored or got some spare time (or sitting in the subway). I am not really adding a lot of features (that time is over), but improving performance, refactoring and improving code (and sometimes new features land). Sometimes trying new things. I am not adding support for new protocol version, I am bored of if. Vanilla updates get larger and larger and I honestly can't keep up. Don't expect too much from me. I am still happy to receive feedback and contributions are always welcome. Feel free to join the matrix chat to say hello.

Feature overview

  • Rendering
  • Connect with any version to any server (1.7 - 1.20.4)
  • Bleeding edge performance (e.g. incredible start time)
  • Free (as far as we consider original minecraft as free) and open source
  • Easy use of multiple accounts
  • Multiple connections to servers in one process
  • Multithreading and asynchronous loading
  • Original physics
  • Debugging on protocol layer
  • LAN servers
  • Multiple profiles (i.e. settings for servers or minosoft in general)
  • Modding
  • Independent, I will probably accept almost all patches
  • Headless mode
  • Way more stuff

(some technical explanation about the render system is here). You can find information about the architecture design here

System requirements

  • OS: Windows/Linux/macOS (x86/x64 or arm64/aarch64)
  • CPU: Multiple (4+) cores, high clock speed (2+ GHz)
  • RAM: Minimum 500 MiB, 1 GiB recommended
  • Disk space: 80 MiB + assets (~ 300 MiB per version)
  • GPU: OpenGL 3.3+. Every modern GPU works and is recommended.
  • Java 11+ (Java 8 is not supported).
  • A minecraft server (local or online) (there is a flat world single player for testing purposes)

Rendering

Features

  • Blocks
  • Entities
  • Block entities (e.g. signs, chests)
  • HUD and GUI (inventory, menus, ...)
  • Particles
  • Block and skylight (custom light engine)
  • World interactions (e.g. place, break, mining)
  • A lot more, only listing major things here, see the screenshots

You can actually use this as a complete vanilla replacement (and speedrun minecraft), but a lot is still missing.

Rendering
A world, with a ton of hud features exposed

Rendering
The Hypixel skyblock hub (don't try to make such a screenshot)

Rendering
AFK Pooling, Hit boxes, particles, ...

Hypixel Lobby
Lobby of hypixel.net with entities.

Rendering
A beautiful sunset

Eros
Eros is the main gui. You can select your account/favorite server and then connect to it. Once everything is prepared, the rendering will start.

Some screenshots are years old, try the latest version to see how it actually looks.

Version support

Almost all versions (and snapshots!) between 1.7 and the latest one (1.20.4 as of writing this) are supported. My initial goal was to support up to 1.20, that is done. 1.21.X is not supported at the moment, see the issue. See Version support for more details.

Modding

Works, still missing some features to make modding super easy (see e.g. #12)

Botting

Will be improved in the future.

Contribution or helping out

Please do it if you are interested in it. Grab pretty much whatever you want and start developing. (But before please take a look at Contributing.md)

Credits and thanking words

See Credits.

Releases and beta

No clue. Don't wait for it :)

I invested many thousands of hours in this project to make it "work". A lot of vanillas features are actually implemented, but soo much is missing. A release normally means, that it is stable, has few (known) bugs and won't change that much in the near future. All those "requirements" are currently not fulfilled at all. It is just way to alpha atm. The current goal always was to play bedwars with this client and it actually worked on hypixel (#42).

Feel free to join the matrix channel to get notified when new features arrive.

Downloads / Installation

Linux, Windows, macOS

The latest x64 and arm64 build gets uploaded to github actions. See github actions

Arch

Thanks to @jugendhacker you can get minosoft directly from the arch user repository (AUR): https://aur.archlinux.org/packages/minosoft-git/

Building

  1. Install Java 11+ (e.g. sudo apt install openjdk-11-jdk). Windows users download and install java.
  2. Clone this repository (git clone --depth=1 https://gitlab.bixilon.de/bixilon/minosoft.git) or click on download master and extract the archive.
  3. Change directory (cd minosoft)
  4. Optional: Checkout a current feature branch (Warning: might be unstable; might not even build) (git checkout <branch>)
  5. Build and run Minosoft with ./gradlew run (or on windows ./gradlew.bat run). Alternatively just click on run.cmd. If any errors occur, feel free to contact me or open an issue

Code mirrors

This project/readme is work in progress, things may change over time.

About

An open source Minecraft reimplementation written from scratch. Mirror of https://gitlab.bixilon.de/bixilon/minosoft

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 6