README.md

Custom Commands

custom command aliases for vanillish servers written in kdl

custom commands lets server owners write a file at static_data/commands.kdl to add aliases or shorthands for special commands or triggers

currently requires adding a built jar of kdl4j 0.1.0 at libs/kdl4j-0.1.0.jar because github package registry is broken

current supported nodes:

• literal <name> - keyword command node
• requires [requirements] - requirements for parent node, properties determine requirements:
  • opLevel - required op level to run command (permissionLevel will work but is considered deprecated)
  • permission - fabric permissions api permission key required to run command
• executes <command> - sets what command the parent node executes

to do:

• allow arbitrary arguments instead of just keywords
• add more properties for requirements
  • vanilla op level
  • fabric permissions api

sample configuration:

literal "afk" { //shorthand for afk data pack https://www.planetminecraft.com/data-pack/afk-pack/
    executes "trigger afk"
}
literal "giveall" { //give preset items to everyone on the server
    requires opLevel=4
    literal "diamonds" { //escaped quotes
        executes "give @a diamond{display:{Name:'[{\"text\":\"happy diamond\",\"italic\":false}]'}} 64"
    }
    literal "magicsword" { //kdl raw strings
        requires permission="mymod.permission.magicsword"
        executes r#"give @p netherite_sword{Unbreakable:1,display:{Name:'[{"text":"magic sword","italic":false}]',Lore:['[{"text":"a sword passed down","italic":false}]','[{"text":"through the ages","italic":false}]','[{"text":"from hero to hero","italic":false}]']},Enchantments:[{id:fire_aspect,lvl:2},{id:knockback,lvl:2},{id:looting,lvl:3},{id:sharpness,lvl:5}]} 64"#
    }
}