// tag::main-block[]
plugins {
    id 'java-gradle-plugin'
}

gradlePlugin {
    plugins {
        myPlugins {
            id = 'my-plugin'
            implementationClass = 'my.MyPlugin'
        }
    }
}

// tag::main-block[]
plugins {
    `java-gradle-plugin`
}

gradlePlugin {
    plugins {
        create("myPlugins") {
            id = "my-plugin"
            implementationClass = "my.MyPlugin"
        }
    }
}

    @Unroll
    def "fully qualified or shortened plugins"() {
        expect:
        new VersionCatalogDependencyRegistry(fullyQualify).registerPlugin(module, "42") == alias

        where:
        fullyQualify | module || alias
        true | "bundles.a" | "libs.plugins.bundles.a"
        false | "bundles.a" | "libs.plugins.a"
        true | "com.example.group.artifact" | "libs.plugins.com.example.group.artifact"

            reservedAliasPrefix('bundles', 'plugins', 'versions')
        })

        where:
        name          | prefix
        "bundles"     | "bundles"
        "versions"    | "versions"
        "plugins"     | "plugins"
        "bundles-my"  | "bundles"
        "versions_my" | "versions"
        "plugins.my"  | "plugins"
    }

    @VersionCatalogProblemTestFor(

     | provides a specific path to the Tomcat instance. To use this, your plugin configuration might
     | hypothetically look like:
     |
     | ...
     | <plugin>
     |   <groupId>org.myco.myplugins</groupId>
     |   <artifactId>myplugin</artifactId>
     |
     |   <configuration>
     |     <tomcatLocation>${tomcatPath}</tomcatLocation>
     |   </configuration>
     | </plugin>
     | ...
     |

package my;

import org.gradle.api.*;
import org.gradle.api.plugins.BasePlugin;

public class MyPlugin implements Plugin<Project> {
    @Override
    public void apply(Project project) {
        project.getPluginManager().apply(BasePlugin.class);
    }

package my;

import org.gradle.api.*;
import org.gradle.api.plugins.BasePlugin;

public class MyPlugin implements Plugin<Project> {
    @Override
    public void apply(Project project) {
        project.getPluginManager().apply(BasePlugin.class);
    }

[[sec:types_of_plugins]]
== Types of plugins

Plugins can be implemented as *binary plugins*, *precompiled script plugins*, or *script plugins*:

Binary Plugins :: Binary plugins are compiled plugins typically written in Java or Kotlin DSL that are packaged as JAR files.
They are applied to a project using the `plugins {}` block.

import org.gradle.api.Plugin;
import org.gradle.api.Project;

public class MyPlugin implements Plugin<Project> {
    public void apply(Project project) {
        project.getPlugins().apply(MyBasePlugin.class);

        // define conventions
    }

package org.example

import org.gradle.api.Plugin
import org.gradle.api.Project

class MyPlugin implements Plugin<Project> {

    @Override
    void apply(Project project) {
        project.tasks.register("myTask", MyTask)
    }