Skip to main content

Beet plugin to generate Minecraft worldgen files

Project description

gaia-beet

GitHub Actions PyPI PyPI - Python Version Code style: black Discord

Beet plugin to generate Minecraft worldgen files

Introduction

Writing density functions in JSON by hand can be tiring and confusing. This package allows you to write them as natural looking expressions.

gaia.df("basic:foo", abs(const(4) ** 3) + ref("basic:bar"))

Installation

The package can be installed with pip.

$ pip install gaia-beet

Getting started

When using with beet, a simple beet.yml is enough:

output: out
pipeline:
  - main

This references a main.py plugin file where the density functions will be defined:

from beet import Context
from gaia_beet import Gaia
from gaia_beet.density_functions import *

def beet_default(ctx: Context):
    gaia = ctx.inject(Gaia)

    blah = slide(const(2))

    foo = gaia.df("basic:foo", abs(const(4) ** 3) + blah)

    gaia.df("basic:bar", blah * foo)

Then install beet and run the watch command:

$ pip install beet
$ beet watch

Contributing

Contributions are welcome. Make sure to first open an issue discussing the problem or the new feature before creating a pull request. The project uses poetry.

$ poetry install

You can run the tests with poetry run pytest.

$ poetry run pytest

The project must type-check with pyright. If you're using VSCode the pylance extension should report diagnostics automatically. You can also install the type-checker locally with npm install and run it from the command-line.

$ npm run watch
$ npm run check

The code follows the black code style. Import statements are sorted with isort.

$ poetry run isort gaia_beet examples tests
$ poetry run black gaia_beet examples tests
$ poetry run black --check gaia_beet examples tests

License - MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gaia-beet-0.5.1.tar.gz (7.0 kB view hashes)

Uploaded Source

Built Distribution

gaia_beet-0.5.1-py3-none-any.whl (6.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page