Metadata-Version: 2.5
Name: mcbookshelf
Version: 5.0.0
Summary: A modular library datapack for Minecraft mapmakers.
Project-URL: Homepage, https://mcbookshelf.dev
Project-URL: Documentation, https://docs.mcbookshelf.dev
Project-URL: Repository, https://github.com/mcbookshelf/bookshelf
Author-email: Bookshelf Contributors <contact@gunivers.net>
License: MPL-2.0
License-File: LICENSE
Requires-Python: >=3.14
Requires-Dist: beet>=0.118.0
Description-Content-Type: text/markdown

<h1 align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" alt="Bookshelf" srcset="docs/_imgs/banner-dark.png" width="400px">
    <img alt="Bookshelf" src="docs/_imgs/banner-light.png" width="400px">
  </picture>
</h1>

<div align="center">
  <i>Bookshelf is a Minecraft datapack library. It provides performant modules that help you create complex systems more easily.</i>
</div>

<br/>

<div align="center">
  <a href="https://docs.mcbookshelf.dev/en/latest"><img src="https://img.shields.io/readthedocs/mc-bookshelf?logo=readthedocs&colorA=363a4f&colorB=a6da95&style=for-the-badge" alt="Documentation"></a>
  &nbsp;
  <a href="https://github.com/mcbookshelf/bookshelf/stargazers"><img src="https://img.shields.io/github/stars/mcbookshelf/bookshelf?colorA=363a4f&colorB=b7bdf8&style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNTYgMjU2Ij4KPHBhdGggZD0iTTIzNS4yNCw4NC4zOGwtMjguMDYsMjMuNjgsOC41NiwzNS4zOWExMy4zNCwxMy4zNCwwLDAsMS01LjA5LDEzLjkxLDEzLjU0LDEzLjU0LDAsMCwxLTE1LC42OUwxNjQsMTM5bC0zMS42NSwxOS4wNmExMy41MSwxMy41MSwwLDAsMS0xNS0uNjksMTMuMzIsMTMuMzIsMCwwLDEtNS4xLTEzLjkxbDguNTYtMzUuMzlMOTIuNzYsODQuMzhhMTMuMzksMTMuMzksMCwwLDEsNy42Ni0yMy41OGwzNi45NC0yLjkyLDE0LjIxLTMzLjY2YTEzLjUxLDEzLjUxLDAsMCwxLDI0Ljg2LDBsMTQuMjEsMzMuNjYsMzYuOTQsMi45MmExMy4zOSwxMy4zOSwwLDAsMSw3LjY2LDIzLjU4Wk04OC4xMSwxMTEuODlhOCw4LDAsMCwwLTExLjMyLDBMMTguMzQsMTcwLjM0YTgsOCwwLDAsMCwxMS4zMiwxMS4zMmw1OC40NS01OC40NUE4LDgsMCwwLDAsODguMTEsMTExLjg5Wm0tLjUsNjEuMTlMMzQuMzQsMjI2LjM0YTgsOCwwLDAsMCwxMS4zMiwxMS4zMmw1My4yNi01My4yN2E4LDgsMCwwLDAtMTEuMzEtMTEuMzFabTczLTEtNTQuMjksNTQuMjhhOCw4LDAsMCwwLDExLjMyLDExLjMybDU0LjI4LTU0LjI4YTgsOCwwLDAsMC0xMS4zMS0xMS4zMloiIHN0eWxlPSJmaWxsOiAjQ0FEM0Y1OyIvPgo8L3N2Zz4="></a>
  &nbsp;
  <a href="https://github.com/mcbookshelf/bookshelf/releases/latest"><img src="https://img.shields.io/github/v/release/mcbookshelf/bookshelf?colorA=363a4f&colorB=926bd1&style=for-the-badge&logo=github&logoColor=cad3f5"></a>
  &nbsp;
  <a href="https://discord.gg/MkXytNjmBt"><img src="https://img.shields.io/discord/1247513995376726116?style=for-the-badge&color=%237289DA&labelColor=363a4f&logo=discord&logoColor=cad3f5"></a>
</div>

<br/>

<h3 align="center">🌟 Featured modules</h3>

<div align="center">
  <a href="https://docs.mcbookshelf.dev/en/latest/modules/block/">
    <picture>
      <source media="(prefers-color-scheme: dark)" alt="block" srcset="docs/_imgs/readme/block-dark.svg">
      <img alt="block" src="docs/_imgs/readme/block.svg">
    </picture>
  </a>
  <a href="https://docs.mcbookshelf.dev/en/latest/modules/raycast/">
    <picture>
      <source media="(prefers-color-scheme: dark)" alt="raycast" srcset="docs/_imgs/readme/raycast-dark.svg">
      <img alt="raycast" src="docs/_imgs/readme/raycast.svg">
    </picture>
  </a>
  <a href="https://docs.mcbookshelf.dev/en/latest/modules/math/">
    <picture>
      <source media="(prefers-color-scheme: dark)" alt="math" srcset="docs/_imgs/readme/math-dark.svg">
      <img alt="math" src="docs/_imgs/readme/math.svg">
    </picture>
  </a>
  <a href="https://docs.mcbookshelf.dev/en/latest/modules/generation/">
    <picture>
      <source media="(prefers-color-scheme: dark)" alt="generation" srcset="docs/_imgs/readme/generation-dark.svg">
      <img alt="generation" src="docs/_imgs/readme/generation.svg">
    </picture>
  </a>
  <a href="https://docs.mcbookshelf.dev/en/latest/modules/random/">
    <picture>
      <source media="(prefers-color-scheme: dark)" alt="random" srcset="docs/_imgs/readme/random-dark.svg">
      <img alt="random" src="docs/_imgs/readme/random.svg">
    </picture>
  </a>
  <a href="https://docs.mcbookshelf.dev/en/latest/modules/health/">
    <picture>
      <source media="(prefers-color-scheme: dark)" alt="health" srcset="docs/_imgs/readme/health-dark.svg">
      <img alt="health" src="docs/_imgs/readme/health.svg">
    </picture>
  </a>
</div>
<p align="center">And much more!</p>

## 🔥 Motivation

Libraries save time and make systems easier to create. But many Minecraft mapmakers aren't used to them. Bookshelf exists to change that.
Bookshelf focuses on ease of use. Each module is simple, works for any skill level, and keeps performance in mind.

> *"I have seen further than others because I have stood on the shoulders of giants."*
>
> — Isaac Newton


## 🤝 Contribution

Have questions or want to talk about the project? Join the [Discord](https://discord.gg/MkXytNjmBt) server.

Want to help? See the [contribution](https://docs.mcbookshelf.dev/en/latest/contribute/index.html) section.
