# chunkstories-api **Repository Path**: mouse0w0/chunkstories-api ## Basic Information - **Project Name**: chunkstories-api - **Description**: No description available - **Primary Language**: Unknown - **License**: LGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2018-07-02 - **Last Updated**: 2024-06-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Chunk Stories ![alt text](http://chunkstories.xyz/img/github_header3.png "Header screenshot") [![Build Status](https://travis-ci.com/Hugobros3/chunkstories-api.svg?branch=master)](https://travis-ci.com/Hugobros3/chunkstories-api) ### A Voxel Games Framework 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. ### Why yet another Minecraft clone ? 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. #### You didn't answer the question. There already are multiple open minecraft clones! 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](https://xkcd.com/927/) ) 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". ### Engine Features * 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](http://chunkstories.xyz/wiki) * 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 ### Building chunkstories-api *This is for building `chunkstories-api`, the game's API. 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](http://chunkstories.xyz/wiki/doku.php?id=mod_setup) on the project Wiki !* #### Setup Nothing in particular to do. Gradle handles the dependencies for you. [Enklume](https://github.com/Hugobros3/Enklume) is our homegrown Minecraft Anvil file format library. Artifacts are in our repository, you don't have to worry about it. #### Gradle Tasks * `./gradlew install` builds the API and installs it to the local maven repository. ### Links * 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 ### License `chunkstories-api`'s **implementation** is released under LGPL, see LICENSE.MD