Metadata-Version: 2.1
Name: lightning-rod
Version: 0.2.5
Summary: Function library for the Bolt scripting language.
Home-page: https://github.com/reapermc/lightning-rod
License: MIT
Keywords: beet,bolt,minecraft,datapack,minecraft-commands,mcfunction,library,reapermc
Author: ArcticYeti
Author-email: arcticyeti1@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: beet (>=0.89.1)
Requires-Dist: bolt (>=0.36.0)
Requires-Dist: mecha (>=0.73.0)
Requires-Dist: wicked-expressions (>=0.8.1)
Description-Content-Type: text/markdown

# lightning-rod

[![GitHub Actions](https://github.com/reapermc/lightning-rod/workflows/CI/badge.svg)](https://github.com/reapermc/lightning-rod/actions)

> Function library for the Bolt scripting language.


## Introduction

**Minecraft version: `1.19.4`**

This library features an API for the minecraft commands, usually improved by adding dynamic support or even adding new abstract functions.

```py
from lightning_rod:api import Bossbar, set_level, random

# example of OOP bossbars ^^
bb = Bossbar()

bb.name = 'gas prices'
bb.color = 'red'

bb.show()

# example of dynamic level setting at runtime ^^
set_level(random(5, 20))
```

## Installation

```bash
pip install lightning_rod
```

## Getting started

The library is designed to be used within any `bolt` script (either a `.mcfunction` or `bolt` file) inside a `bolt` enabled project.

```yaml
require:
    - bolt
    - lightning_rod

pipeline:
    - mecha
```

Once you've required `bolt` and `lightning_rod`, you are able to import the package's `api` module directly inside your bolt script.

Most of the imports come from the `lightning_rod:api` module as shown below.

```py
from lightning_rod:api import random, sqrt
```

Now you're free to use the API!


## Documentation

Coming soon...
<!-- Docs available [here](./docs/home.md). -->

---

License - [MIT](https://github.com/reapermc/lightning-rod/blob/main/LICENSE)

