onyx-mclib 1.0.1

A python library to create minecraft datapacks

Onyx - a python library to generate datapacks

Installation

The package can be installed with pip:

pip install onyx-mclib

Getting Started

First, you'll need to define your datapack object. This can be done with pack = pack(file_path). Now you can get started defining functions.

A basic function should look something like this:

from onyx import *
pack = pack(file_path)

main = pack.function("function/path", "function_name")
with main:
    say("Hello, World!")

You can make a function run every tick by using pack.function("function_path", "function_name", loop=True).

Selectors

Selectors are defined very similar to the normal game, and are done like so:

alive_players_in_arena = selector(at.all_players, tag="alive", y=0, dy=63)

Onyx will automatically convert types, so if you don't want to define a selector for something simple, you can just pass in "@a" instead of selector(at.all_players).

JSON Strings

JSON strings (also known as text-components) have a builder design. They can be chained too, to seperate components with differing elements.

text = json_string().component("Hello, ").component(text="World!", color=color.gold, bold=True, italic=True)
tellraw("@a", text)

See also

Discord: https://discord.gg/NcztW9T
PyPi: https://pypi.org/project/onyx-mclib
GitHub: https://github.com/Double-Felix/Onyx

Credits

Language Design:

• Arcensoth (Design Ideas and Feedback, Implementation Ideas)
• fizzy (Creator of nbtlib, which was used to implement SNBT, and mudkip, which was used to generate the docs)
• Lue (Design Feedback, Implementation Ideas)
• Not A2 (Design Feedback)
• nphhpn (Feature Suggestions, Design Feedback, Implementation Ideas)
• PeerHeer (Feature Suggestions, Design Ideas and Feedback, Implemetation Assistance)
• Princess (Design Feedback)
• Ravbug (Design Feedback, Implementation Ideas)
• rx (Feature Suggestions, Design Feedback and Ideas)
• SirBenet (Design Ideas and Feedback, Implementation Ideas)
• the der discohund (Design Ideas, Implementation Ideas)
• TheMrZZ (Design Ideas)
• vdvman1 (Design Feedback, Implementation Assistance, Creator of Phi, which was almost completely copied for use in the bitwise and rng libraries)