orb

the simple and open source origins datapack creator

simple

orb is both the file format and the resolver. the file format is just json, which you may be familiar with if you have created minecraft datapacks before. then what is different about orb? you dont need a whole folder structure for your datapack, just a single json file. just one. and it can have C style comments too! simple!

if you have your orb json file prepared, you just put it trough the resolver and boom: a new datapack is born! pre zipped with a markdown file list for ease of sharing!

{
    "format": 18,
    "namespace": "testpack",
    "description": "this is a test",
    "indent": 4,
    "do_powerlist": true,
    // list of origins to define
    "origins": [
        {
            "id": "test_origin",
            "powers": [
                "testpack:test_power"
            ],
            "name": "Test",
            "description": "Creatures made by a stupid python script.",
            "icon": "minecraft:stone",
            "impact": 1
        }
    ],
    // list of powers to define
    "powers": [
        {
            "id": "test_power",
            "category": "test",
            "name": "Test Power",
            "description": "Power made by a stupid python script.",
            "type": "origins:simple"
        }
    ],
    "tags": [
        {
            "id": "test_tag",
            "category": "item",
            "values": [
                "minecraft:stick"
            ]
        }
    ]
}
becomes
->
  • a zip file, valid datapack
  • an unzipped valid datapack
  • if set, a markdown formatted power list (discord compatible)

without having to

  • create multiple folders manually
  • go online
  • mess with the origin_layers/origin.json file

interested? try it now!


setup guide

  1. check if python 3.10.x or up is installed and set up (Microsoft Windows and macOS comes with python pre installed)
  2. you have a way to unzip zip files

  3. unzip the package you downloaded into an empty folder
  4. check if you have ./ orb.py and a folder named ./ docs /
  5. run the command $ python orb.py -h from your preferred command line

  6. if you get a help message, get datapacking! read the instructions at the orb json documentation, then transpile your orb file to a datapack!