README.md

Minecraft-Datapacks-Generator

How to use?

• First of all make sure you have Python 3.9.0 or above installed on your computer.
• Download this repository in the folder where the datapack should be generated.
• Create a new empty Python file.
• Import the library in your new Python file like this :

from minecraft_datapacks_generator import *

• Create and compile your own datapack.
• Once the datapack is generated, paste it in the datapacks folder of your Minecraft world.
• Type /reload to load the datapack.
• Have fun playing with your brand new handmade datapack!

Example:

from minecraft_datapacks_generator import *

my_datapack_title = 'My_Datapack'
subfolder_title = Datapack(my_datapack_title).subfolder_title

myDatapack = Datapack(
    title = my_datapack_title,
    path='~\\home\\Vianpyro\\.minecraft\\saves\\world_42\\datapacks',
    author = 'Vianpyro',
    pack_meta = {
        'minecraft_version': '1.16.4',
        'description': 'Have fun using my first datapack!'
    },
    content = {
        'advancements': {
            'root': {
                "display": {
                    "title": {
                        "text": "God",
                        "color": "red",
                        "bold": True,
                    },
                    "description": {
                        "text": "Vianpyro!",
                        "color": "white",
                        "italic": True
                    },
                    "icon": {
                        "item": "minecraft:grass_block"
                    },
                    "frame": "goal",
                    "show_toast": True,
                    "announce_to_chat": True,
                    "hidden": False,
                    "background": "minecraft:textures/gui/advancements/backgrounds/dirt.png"
                },
                "criteria": {
                    "c1": {
                        "trigger": "minecraft:slept_in_bed"
                    }
                }
            }
        },
        'functions': {
            'load': f'tellraw @a ["", {{"text": "{my_datapack_title} > Successfuly reloaded the datapack!", "color": "green"}}]',
            'raycast': Raycast(
                datapack_name=subfolder_title,
                function_name='raycast',
                distance=50,
                step=0.5,
                goal='execute if block ~ ~ ~ stone',
                output="say Stoned",
                display_particle='flame'
            ),
            'test': [
                'say test ok',
                'say test ko'
            ],
            'test2': import_from_file('resources/functions/silvathor_random')
        },
        'predicates': {
            'my_predict': {
                "condition": "minecraft:entity_properties",
                "entity": "this",
                "predicate": {
                    "type": "minecraft:player",
                    "flags": {
                        "is_sprinting": True
                    }
                }
            }
        }
    },
    auto_replace=True
)

myDatapack.content['functions']['main'] = [
    'scoreboard objectives add vianpyro_RAYCAST minecraft.used:minecraft.carrot_on_a_stick',
    f'execute as @a if score @s vianpyro_RAYCAST matches 1 at @s anchored eyes run function {subfolder_title}:raycast',
    'scoreboard players set @a[scores={vianpyro_RAYCAST=1}] vianpyro_RAYCAST 0'
]

myDatapack.compile()

• In this example, I start by importing the wmcpy "library", this line is required for the datapack to be generated!!
• I also create a variable containing the name of my datapack because I want to be able to change it in every file I mention it.
• Then I create another variable containing an instance of the class "Datapack" to start the creation of my datapack.
• The title is the name of the datapack I'll paste in the datapacks folder of my Minecraft world.
• The author is me, Vianpyro.
• The pack_meta is the informations I'll set in the pack.mcmeta file, this file is very important; it allows Minecraft to read your datapack.
• As you can see I use 2 reserved names: main - containing the functions I want to repeat every Minecraft tick - and load - once when the datapack is reloaded.
• Then I write whatever I want to be in my datapack ; one advancement, 4 functions and a predicate.
• I know that the new version of my datapack is better than the older so I want to replace it without being asked when I run the program.
• I also add another function - main - after the initialisation of my datapack because I want to be able to change it whenever I want without having to search for it in the big block of code above.
• Once I'm sure I don't have anything to add to my datapack I compile it.
• At last, when the datapack is successfuly generated I just paste it into my Minecraft world to enjoy the features I added.