chanty 0.3.0

Tool for creating cool Minecraft datapacks

Chanty

Write Minecraft datapacks easely with Python

chanty is a Python DSL for writing Minecraft datapacks as if they were real code.
No more messy .mcfunction files - just cliean, structured logic.

Install

pip install chanty

CLI Usage

Creating Project

chanty create test-project

cd test-project

Build Datapack

You should use

chanty build MAIN_FILE:PACK_VARIABLE --ARGS

for default .minecraft folder destionation:

chanty build main:pack --world_name="New World"

for ModrinthApp:

chanty build main:pack --modrinth="ProfileName:New World"

for other destination:

chanty build main:pack --to="./builds/datapack"

export to ./builds/<datapack_name> folder:

chanty build main:pack --output="./builds"

Development Mode

You can start dev mode to export your datapack in live mode after any .py file changes.

There are --save_folder, --world_name and --modrinth arguments.

chanty dev main:pack --modrinth="ProfileName:New World"

Up Project

After changing chanty version you can use chanty up to sync your project structure with actual chanty version

Usage

Simple example

from chanty import Datapack, Namespace, CommandBuilder

pack = DataPack('my_awesome_datapack')
namespace = Namespace('main')

@namespace.on_load
def handle_on_load() -> str:
    with CommandBuilder() as cmd:
        cmd.tellraw('Hello world from chanty datapack!')
    return cmd.build()


# Export into folder
if __name__ == '__main__':
    pack.export('./my_datapack')

Custom Items

from chanty import DataPack Namespace, CommandBuilder, CustomItem, Item


pack = DataPack('my_awesome_datapack')
namespace = Namespace('main')

my_cool_item = CustomItem(Item.STICK)
my_cool_item.set_name('§6§l[Chanty]§f§r Debugger')
my_cool_item.set_lore(
    'This is a not just stick ...',
    'This is a §6§l[Chanty]§f§r Debugger!',
)
my_cool_item.glint(True)
@my_cool_item.on_right_click
def handle_right_click():
    with CommandBuilder() as cmd:
        cmd.say('Hello!')
    return cmd.build()

namespace.register(my_cool_item)

if __name__ == '__main__':
    pack.export('./my_datapack')

In The Future ...

• Assets
• Translations
• More built-in event handlers
• CLI improvement