Skip to content

Language adapter and wrapper libraries for Groovy mods on Quilt

License

Notifications You must be signed in to change notification settings

GroovyMC/GroovyDuvet

Repository files navigation

GroovyDuvet

Version VersionCore

GroovyDuvet is a Quilt language adapter for mods written in Groovy. It allows the use of scripts, classes, fields, or methods as entrypoints, provides mappings at runtime for dynamically compiled code, and provides wrappers and DSLs around Minecraft and QSL code for ease of development.

Using

To use, add the following to your build.gradle:

repositories {
    mavenCentral()
}

configurations {
	localImplementation
	runtimeClasspath.extendsFrom localImplementation
	compileOnly.extendsFrom localImplementation
}

dependencies {
    modImplementation 'org.groovymc.groovyduvet:groovyduvet:<version>'
    localImplementation 'org.groovymc.groovyduvet:groovyduvet-core:<groovymc-core-version>'
}

The localImplementation configuration and dependency on groovyduvet-core is necessary so that the groovy runtime will be loaded on the same classloader at runtime in the development environment as it will be at runtime in production; the configuration, as set up above, ensures that the dependency will be marked properly within the generated module and pom files during publishing.

Then, use the groovyduvet language adapter for your groovy entrypoints. Entrypoints can target classes, static fields, or static methods that extend the entrypoint type just like usual; GroovyDuvet can also target local variables inside of scripts. The script will be run, and the variable will be extracted; for this to work, the local variable must have the @Field annotation. If the entrypoint class has exactly one abstract method, GroovyDuvet can also target closures, through any of the previous methods, or entire scripts, where the method arguments are fed into the script as local variables going arg0, arg1, etc.

For a template mod using GroovyDuvet, see: quilt-template-mod-groovy. For an example of using GroovyDuvet in a multiloader project, see: Multiloader-Groovy-Template

Included Groovy Modules

  • stdlib
  • contracts
  • datetime
  • nio
  • macro
  • macro-library
  • templates
  • typecheckers
  • dateutil
  • ginq
  • toml
  • json
  • xml

Support

If you are having issues using GroovyDuvet or wish to discuss contributions to the project, you may either open an issue or PR on this repo or go to the groovy-mc channel here: https://discord.gg/Em7b3dv4Nk

About

Language adapter and wrapper libraries for Groovy mods on Quilt

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages