Chunk Stories is a fully-featured voxel game engine written in Java, aiming to replace Minecraft/MCP as a modding framework to build mods and total conversions on. It features almost everything the original game could do, but is built in a modular and open fashion : everything is either engine or content. Mods are, by design, first-class citizens, and multiple of them can be loaded at the same time, without requiring a game restart. A server can host it's own custom mods and have the clients download them upon connection. It's basically gmod for Minecraft.

The project consists of an API, an implementation of that API in the form of client and server executables and everything else is merely mods loaded at runtime. A base mod called "chunkstories-core" or just "core" is bundled with executables to give content creators a solid base upon which to build the gamemode of their dreams. It comes with most basic bloc types a Minecraft clone is expected to have: dirt, stone, wood, glass, chests, doors etc.

It may have occured to you that a while ago, some company of the name 'Microsoft' spent more than what a few countries GDP to aquire the rights to the videogame 'Minecraft', to the astonishment of observers and fears of some faitfull players. More recently their strategy has become increasingly clear: they are using the brand to promote their other products, and are phasing out the relativly open, and beloved so-called "Java Edition". Replacing it is effectively a port of the C++/C# console remake, exclusive to the platforms Microsoft wants you to use.

Chunk Stories is free software and runs on any platform someone can be bothered to port the implementation to.

For the author, Chunk Stories is and always has been a side project, made for fun and to become a better programmer. This is the main quest. The author also has the smug belief that other clones are flawed in some way, and he can do better, especially in the mods handling department. ( Yes, that )

To this end, Chunk Stories borrows heavily from one of two best things about the Minecraft modding ecosystem: The Bukkit-style of plugins, and the server-downloadable "resource packs", mixing the two into the idea of a "Mod".

• Configuration files allow to redefine almost anything using a simplistic syntax
• Customizable network packets, world generation, inputs, GUI*, fonts, localization, ...
• Support for basically loading everything at runtime, including downloading on server connection
• You only deal with named definitions, voxels|items|entities|whatever IDs are allocated automatically and dynamically
• Up to 65535 voxel types, with 8-bit metadata and optional support for even more data
• Component-based entity system
• Heightmap representation for unloaded terrain, rendering up to 1km
• Modern-ish renderer in GL3.3 core, supporting deffered rendering, reloading shaders, instanced rendering, particles, SSR, bloom, you name it
• Built-in support for AABB physics, skeletal animation with hitscan hit detection and more
• Works on Windows and Linux ( OSX may work but unsupported )

* some stuff might not be quite done right now

This is for building chunkstories-core, the core content. If you are only looking to write mods, you do not have to mess with this at all and should rather follow the mods creation guide on the project Wiki !

First you need to clone chunkstories-api as it is needed to compile this. You can try to build from the artifacts in the repo, but only those used in released versions of the games are guaranteed to be present.

• git clone the chunkstories-api repo
• in the chunkstories-api folder: ./gradlew install or gradlew.exe installon Windows

The local maven repository on your computer (.m2 folder) now contains a copy of the api the core content interfaces with. It is not automatically rebuilt when building this, so keep that in mind.

• ./gradlew install builds the core content pack ( core_content.zip ) and installs it to the local maven repository.

• To lean how to play the game and register an account, please visit http://chunkstories.xyz
• You can find a lot more information on the game wiki, including guides to writing mods, at http://chunkstories.xyz/wiki/
• You can find videos and dev logs on the lead developper youtube channel: http://youtube.com/Hugobros3
• We have a discord where anyone can discuss with the devs: https://discord.gg/wudd4pe
• You can get support either by opening a issue on this project or by visiting the subreddit over at https://reddit.com/r/chunkstories

The chunkstories-core Java Code is released under LGPL, see LICENSE.MD

The chunkstories-core assets (the rest) that aren't specified otherwise in ATTRIBUTION.md are released under Creative Commons NON-COMMERCIAL ATTRIBUTION REDISTRIBUABLE, meaning you can use them with your mods, hack them up and have fun, but you can't use them in commercial projects nor claim you made them.