commit d70e22c86c05a0f715db706d6c406ed09b5f4082 · kokirigla.de/soulbinding

+101

.checkstyle/checkstyle.xml

···

       1
       1
       +
       <?xml version="1.0"?>

     

       2
       2
       +
       <!DOCTYPE module PUBLIC

     

       3
       3
       +
           "-//Puppy Crawl//DTD Check Configuration 1.3//EN"

     

       4
       4
       +
           "https://checkstyle.org/dtds/configuration_1_3.dtd">

     

       5
       5
       +
       

     

       6
       6
       +
       <module name="Checker">

     

       7
       7
       +
       

     

       8
       8
       +
           <property name="charset" value="UTF-8"/>

     

       9
       9
       +
           <property name="fileExtensions" value="java, properties, xml"/>

     

       10
       10
       +
           <property name="severity" value="error"/>

     

       11
       11
       +
       

     

       12
       12
       +
           <!-- https://checkstyle.org/filefilters/beforeexecutionexclusionfilefilter.html -->

     

       13
       13
       +
           <module name="BeforeExecutionExclusionFileFilter">

     

       14
       14
       +
               <property name="fileNamePattern" value="module\-info\.java$"/>

     

       15
       15
       +
           </module>

     

       16
       16
       +
       

     

       17
       17
       +
           <!-- https://checkstyle.org/checks/whitespace/filetabcharacter.html -->

     

       18
       18
       +
           <module name="FileTabCharacter">

     

       19
       19
       +
               <property name="eachLine" value="true"/>

     

       20
       20
       +
           </module>

     

       21
       21
       +
       

     

       22
       22
       +
           <!-- https://checkstyle.org/checks/misc/newlineatendoffile.html -->

     

       23
       23
       +
           <module name="NewlineAtEndOfFile"/>

     

       24
       24
       +
       

     

       25
       25
       +
           <!-- https://checkstyle.org/filters/suppressionfilter.html -->

     

       26
       26
       +
           <module name="SuppressionFilter">

     

       27
       27
       +
               <property name="file" value="${configDirectory}/suppressions.xml"/>

     

       28
       28
       +
           </module>

     

       29
       29
       +
       

     

       30
       30
       +
           <!-- https://checkstyle.org/filters/suppresswarningsfilter.html -->

     

       31
       31
       +
           <module name="SuppressWarningsFilter"/>

     

       32
       32
       +
       

     

       33
       33
       +
           <module name="TreeWalker">

     

       34
       34
       +
       

     

       35
       35
       +
               <!-- https://checkstyle.org/checks/misc/arraytypestyle.html -->

     

       36
       36
       +
               <module name="ArrayTypeStyle"/>

     

       37
       37
       +
       

     

       38
       38
       +
               <!-- https://checkstyle.org/checks/imports/avoidstarimport.html -->

     

       39
       39
       +
               <module name="AvoidStarImport"/>

     

       40
       40
       +
       

     

       41
       41
       +
               <!-- https://checkstyle.org/checks/design/finalclass.html -->

     

       42
       42
       +
               <module name="FinalClass"/>

     

       43
       43
       +
       

     

       44
       44
       +
               <!-- https://checkstyle.org/checks/coding/finallocalvariable.html -->

     

       45
       45
       +
               <module name="FinalLocalVariable">

     

       46
       46
       +
                   <property name="tokens" value="PARAMETER_DEF, VARIABLE_DEF"/> <!-- add PARAMETER_DEF -->

     

       47
       47
       +
                   <property name="validateEnhancedForLoopVariable" value="true"/>

     

       48
       48
       +
               </module>

     

       49
       49
       +
       

     

       50
       50
       +
               <!-- https://checkstyle.org/checks/imports/illegalimport.html -->

     

       51
       51
       +
               <module name="IllegalImport">

     

       52
       52
       +
                   <property name="illegalPkgs"

     

       53
       53
       +
                             value="sun, jdk, com.sun, org.jetbrains.annotations.Nullable, org.jetbrains.annotations.NotNull"/>

     

       54
       54
       +
               </module>

     

       55
       55
       +
       

     

       56
       56
       +
               <!-- https://checkstyle.org/checks/javadoc/invalidjavadocposition.html -->

     

       57
       57
       +
               <module name="InvalidJavadocPosition"/>

     

       58
       58
       +
       

     

       59
       59
       +
               <!-- https://checkstyle.org/checks/javadoc/javadoccontentlocation.html -->

     

       60
       60
       +
               <module name="JavadocContentLocation"/>

     

       61
       61
       +
       

     

       62
       62
       +
               <!-- https://checkstyle.org/checks/javadoc/javadocmethod.html -->

     

       63
       63
       +
               <module name="JavadocMethod"/>

     

       64
       64
       +
       

     

       65
       65
       +
               <!-- https://checkstyle.org/checks/javadoc/javadocmissingwhitespaceafterasterisk.html -->

     

       66
       66
       +
               <module name="JavadocMissingWhitespaceAfterAsterisk"/>

     

       67
       67
       +
       

     

       68
       68
       +
               <!-- https://checkstyle.org/checks/javadoc/javadocparagraph.html -->

     

       69
       69
       +
               <module name="JavadocParagraph"/>

     

       70
       70
       +
       

     

       71
       71
       +
               <!-- https://checkstyle.org/checks/javadoc/javadoctagcontinuationindentation.html -->

     

       72
       72
       +
               <module name="JavadocTagContinuationIndentation"/>

     

       73
       73
       +
       

     

       74
       74
       +
               <!-- https://checkstyle.org/checks/blocks/leftcurly.html -->

     

       75
       75
       +
               <module name="LeftCurly"/>

     

       76
       76
       +
       

     

       77
       77
       +
               <!-- https://checkstyle.org/checks/coding/matchxpath.html -->

     

       78
       78
       +
               <module name="MatchXpath">

     

       79
       79
       +
                   <property name="query" value="//ANNOTATION[./IDENT[@text='NotNull']]"/>

     

       80
       80
       +
                   <message key="matchxpath.match"

     

       81
       81
       +
                            value="Avoid using @NotNull annotation. Use @NonNull instead."/>

     

       82
       82
       +
               </module>

     

       83
       83
       +
       

     

       84
       84
       +
               <!-- https://checkstyle.org/config_naming.html#MethodName -->

     

       85
       85
       +
               <module name="MethodName">

     

       86
       86
       +
                   <property name="format"

     

       87
       87
       +
                             value="^(?:(?:.{1,3})|(?:[gs]et[^A-Z].*)|(?:(?:[^gsA-Z]..|.[^e].|..[^t]).+))$"/>

     

       88
       88
       +
               </module>

     

       89
       89
       +
       

     

       90
       90
       +
               <!-- https://checkstyle.org/checks/coding/requirethis.html -->

     

       91
       91
       +
               <module name="RequireThis"/>

     

       92
       92
       +
       

     

       93
       93
       +
               <!-- https://checkstyle.org/filters/suppresswarningsfilter.html -->

     

       94
       94
       +
               <module name="SuppressWarningsHolder"/>

     

       95
       95
       +
       

     

       96
       96
       +
               <!-- https://checkstyle.org/filters/suppressioncommentfilter.html -->

     

       97
       97
       +
               <module name="SuppressionCommentFilter"/>

     

       98
       98
       +
       

     

       99
       99
       +
           </module>

     

       100
       100
       +
       

     

       101
       101
       +
       </module>

.checkstyle/suppressions.xml

···

       1
       1
       +
       <?xml version="1.0" encoding="UTF-8"?>

     

       2
       2
       +
       <!DOCTYPE suppressions PUBLIC "-//Checkstyle//DTD SuppressionFilter Configuration 1.2//EN"

     

       3
       3
       +
           "http://checkstyle.org/dtds/suppressions_1_2.dtd">

     

       4
       4
       +
       <suppressions>

     

       5
       5
       +
       

     

       6
       6
       +
       </suppressions>

+10

.editorconfig

···

       1
       1
       +
       [*]

     

       2
       2
       +
       charset = utf-8

     

       3
       3
       +
       end_of_line = lf

     

       4
       4
       +
       indent_size = 4

     

       5
       5
       +
       indent_style = space

     

       6
       6
       +
       insert_final_newline = true

     

       7
       7
       +
       max_line_length = 100

     

       8
       8
       +
       tab_width = 4

     

       9
       9
       +
       ij_continuation_indent_size = 4

     

       10
       10
       +
       ij_smart_tabs = false

.gitignore

api/build.gradle.kts

···

       1
       1
       +
       plugins {

     

       2
       2
       +
           id("publishing-conventions")

     

       3
       3
       +
       }

     

       4
       4
       +
       

     

       5
       5
       +
       dependencies {

     

       6
       6
       +
           compileOnlyApi(libs.paper)

     

       7
       7
       +
       }

api/src/main/java/com/example/template/api/.gitkeep

This is a binary file and will not be displayed.

+18

build-logic/build.gradle.kts

···

       1
       1
       +
       plugins {

     

       2
       2
       +
           `kotlin-dsl`

     

       3
       3
       +
       }

     

       4
       4
       +
       

     

       5
       5
       +
       repositories {

     

       6
       6
       +
           gradlePluginPortal()

     

       7
       7
       +
       }

     

       8
       8
       +
       

     

       9
       9
       +
       dependencies {

     

       10
       10
       +
           implementation(libs.shadow)

     

       11
       11
       +
           implementation(libs.gremlin.gradle)

     

       12
       12
       +
           implementation(libs.indra.common)

     

       13
       13
       +
           implementation(libs.indra.licenseHeader)

     

       14
       14
       +
           implementation(libs.indra.git)

     

       15
       15
       +
       

     

       16
       16
       +
           // https://github.com/gradle/gradle/issues/15383#issuecomment-779893192

     

       17
       17
       +
           implementation(files(libs.javaClass.superclass.protectionDomain.codeSource.location))

     

       18
       18
       +
       }

build-logic/settings.gradle.kts

···

       1
       1
       +
       dependencyResolutionManagement {

     

       2
       2
       +
           versionCatalogs {

     

       3
       3
       +
               create("libs") {

     

       4
       4
       +
                   from(files("../gradle/libs.versions.toml"))

     

       5
       5
       +
               }

     

       6
       6
       +
           }

     

       7
       7
       +
       }

+18

build-logic/src/main/kotlin/FileCopyTask.kt

···

       1
       1
       +
       import org.gradle.api.DefaultTask

     

       2
       2
       +
       import org.gradle.api.tasks.InputFile

     

       3
       3
       +
       import org.gradle.api.tasks.OutputFile

     

       4
       4
       +
       import org.gradle.api.tasks.TaskAction

     

       5
       5
       +
       

     

       6
       6
       +
       abstract class FileCopyTask : DefaultTask() {

     

       7
       7
       +
           @InputFile

     

       8
       8
       +
           val fileToCopy = project.objects.fileProperty()

     

       9
       9
       +
       

     

       10
       10
       +
           @OutputFile

     

       11
       11
       +
           val destination = project.objects.fileProperty()

     

       12
       12
       +
       

     

       13
       13
       +
           @TaskAction

     

       14
       14
       +
           private fun copyFile() {

     

       15
       15
       +
               destination.get().asFile.parentFile.mkdirs()

     

       16
       16
       +
               fileToCopy.get().asFile.copyTo(destination.get().asFile, overwrite = true)

     

       17
       17
       +
           }

     

       18
       18
       +
       }

build-logic/src/main/kotlin/PlatformExtension.kt

···

       1
       1
       +
       import org.gradle.api.file.RegularFileProperty

     

       2
       2
       +
       

     

       3
       3
       +
       abstract class PlatformExtension {

     

       4
       4
       +
           abstract val productionJar: RegularFileProperty

     

       5
       5
       +
       }

+37

build-logic/src/main/kotlin/base-conventions.gradle.kts

···

       1
       1
       +
       plugins {

     

       2
       2
       +
           idea

     

       3
       3
       +
           id("net.kyori.indra")

     

       4
       4
       +
           id("net.kyori.indra.checkstyle")

     

       5
       5
       +
           id("net.kyori.indra.licenser.spotless")

     

       6
       6
       +
       }

     

       7
       7
       +
       

     

       8
       8
       +
       version = rootProject.version

     

       9
       9
       +
       

     

       10
       10
       +
       indra {

     

       11
       11
       +
           gpl3OrLaterLicense()

     

       12
       12
       +
       

     

       13
       13
       +
           javaVersions {

     

       14
       14
       +
               target(21)

     

       15
       15
       +
           }

     

       16
       16
       +
       }

     

       17
       17
       +
       

     

       18
       18
       +
       indraSpotlessLicenser {

     

       19
       19
       +
           licenseHeaderFile(rootProject.file("license_header.txt"))

     

       20
       20
       +
       }

     

       21
       21
       +
       

     

       22
       22
       +
       dependencies {

     

       23
       23
       +
           checkstyle(libs.stylecheck)

     

       24
       24
       +
       }

     

       25
       25
       +
       

     

       26
       26
       +
       tasks {

     

       27
       27
       +
           jar {

     

       28
       28
       +
               dependsOn(check)

     

       29
       29
       +
           }

     

       30
       30
       +
       }

     

       31
       31
       +
       

     

       32
       32
       +
       idea {

     

       33
       33
       +
           module {

     

       34
       34
       +
               isDownloadJavadoc = true

     

       35
       35
       +
               isDownloadSources = true

     

       36
       36
       +
           }

     

       37
       37
       +
       }

+16

build-logic/src/main/kotlin/extensions.kt

···

       1
       1
       +
       import org.gradle.accessors.dm.LibrariesForLibs

     

       2
       2
       +
       import org.gradle.api.Project

     

       3
       3
       +
       import org.gradle.api.Task

     

       4
       4
       +
       import org.gradle.kotlin.dsl.the

     

       5
       5
       +
       import xyz.jpenilla.gremlin.gradle.ShadowGremlin

     

       6
       6
       +
       

     

       7
       7
       +
       // https://github.com/gradle/gradle/issues/15383#issuecomment-779893192

     

       8
       8
       +
       val Project.libs: LibrariesForLibs

     

       9
       9
       +
           get() = the()

     

       10
       10
       +
       

     

       11
       11
       +
       /**

     

       12
       12
       +
        * Relocate a package into the `com.example.template.libs` namespace.

     

       13
       13
       +
        */

     

       14
       14
       +
       fun Task.relocateDependency(pkg: String) {

     

       15
       15
       +
           ShadowGremlin.relocate(this, pkg, "com.example.template.libs.$pkg")

     

       16
       16
       +
       }

+17

build-logic/src/main/kotlin/platform-conventions.gradle.kts

···

       1
       1
       +
       plugins {

     

       2
       2
       +
           id("base-conventions")

     

       3
       3
       +
       }

     

       4
       4
       +
       

     

       5
       5
       +
       val platformExtension = extensions.create<PlatformExtension>("platform")

     

       6
       6
       +
       

     

       7
       7
       +
       tasks {

     

       8
       8
       +
           val copyJar = register<FileCopyTask>("copyJar") {

     

       9
       9
       +
               fileToCopy = platformExtension.productionJar

     

       10
       10
       +
               destination = rootProject.layout.buildDirectory.dir("libs").flatMap {

     

       11
       11
       +
                   it.file(fileToCopy.map { file -> file.asFile.name })

     

       12
       12
       +
               }

     

       13
       13
       +
           }

     

       14
       14
       +
           build {

     

       15
       15
       +
               dependsOn(copyJar)

     

       16
       16
       +
           }

     

       17
       17
       +
       }

+34

build-logic/src/main/kotlin/publishing-conventions.gradle.kts

···

       1
       1
       +
       plugins {

     

       2
       2
       +
           id("base-conventions")

     

       3
       3
       +
           `maven-publish`

     

       4
       4
       +
       }

     

       5
       5
       +
       

     

       6
       6
       +
       tasks {

     

       7
       7
       +
           javadoc {

     

       8
       8
       +
               dependsOn(check)

     

       9
       9
       +
               options {

     

       10
       10
       +
                   (this as StandardJavadocDocletOptions).apply {

     

       11
       11
       +
                       encoding = Charsets.UTF_8.name()

     

       12
       12
       +
                       addStringOption("tag", "implNote:a:Implementation Note")

     

       13
       13
       +
                       links(

     

       14
       14
       +
                           "https://jd.papermc.io/paper/${libs.versions.paper.get().split("-R0.1-SNAPSHOT")[0]}/",

     

       15
       15
       +
                           "https://jd.advntr.dev/api/4.17.0/",

     

       16
       16
       +
                           "https://jd.advntr.dev/nbt/4.17.0/",

     

       17
       17
       +
                           "https://jd.advntr.dev/text-minimessage/4.17.0/",

     

       18
       18
       +
                           "https://jd.advntr.dev/key/4.17.0/",

     

       19
       19
       +
                       )

     

       20
       20
       +
                   }

     

       21
       21
       +
               }

     

       22
       22
       +
           }

     

       23
       23
       +
       }

     

       24
       24
       +
       

     

       25
       25
       +
       configure<PublishingExtension> {

     

       26
       26
       +
           publications {

     

       27
       27
       +
               register<MavenPublication>("maven") {

     

       28
       28
       +
                   from(components["java"])

     

       29
       29
       +
               }

     

       30
       30
       +
           }

     

       31
       31
       +
           repositories {

     

       32
       32
       +
               mavenLocal()

     

       33
       33
       +
           }

     

       34
       34
       +
       }

+24

build-logic/src/main/kotlin/shadow-platform.gradle.kts

···

       1
       1
       +
       plugins {

     

       2
       2
       +
           id("platform-conventions")

     

       3
       3
       +
           id("com.gradleup.shadow")

     

       4
       4
       +
           id("xyz.jpenilla.gremlin-gradle")

     

       5
       5
       +
       }

     

       6
       6
       +
       

     

       7
       7
       +
       tasks {

     

       8
       8
       +
           jar {

     

       9
       9
       +
               archiveClassifier = "unshaded"

     

       10
       10
       +
               dependsOn(check)

     

       11
       11
       +
           }

     

       12
       12
       +
       

     

       13
       13
       +
           shadowJar {

     

       14
       14
       +
               archiveClassifier.set(null as String?)

     

       15
       15
       +
               relocateDependency("xyz.jpenilla.gremlin")

     

       16
       16
       +
           }

     

       17
       17
       +
       

     

       18
       18
       +
           writeDependencies {

     

       19
       19
       +
           }

     

       20
       20
       +
       }

     

       21
       21
       +
       

     

       22
       22
       +
       extensions.configure<PlatformExtension> {

     

       23
       23
       +
           productionJar = tasks.shadowJar.flatMap { it.archiveFile }

     

       24
       24
       +
       }

build.gradle.kts

···

       1
       1
       +
       group = "com.example"

     

       2
       2
       +
       version = "1.0.0"

+21

gradle/libs.versions.toml

···

       1
       1
       +
       [versions]

     

       2
       2
       +
       indra = "3.1.3"

     

       3
       3
       +
       stylecheck = "0.2.1"

     

       4
       4
       +
       shadow = "8.3.0"

     

       5
       5
       +
       gremlin = "0.0.6"

     

       6
       6
       +
       

     

       7
       7
       +
       paper = "1.21.4-R0.1-SNAPSHOT"

     

       8
       8
       +
       

     

       9
       9
       +
       [libraries]

     

       10
       10
       +
       # build logic

     

       11
       11
       +
       indra-common = { group = "net.kyori", name = "indra-common", version.ref = "indra" }

     

       12
       12
       +
       indra-licenseHeader = { group = "net.kyori", name = "indra-licenser-spotless", version.ref = "indra" }

     

       13
       13
       +
       indra-git = { group = "net.kyori", name = "indra-git", version.ref = "indra" }

     

       14
       14
       +
       gremlin-gradle = { group = "xyz.jpenilla", name = "gremlin-gradle", version.ref = "gremlin" }

     

       15
       15
       +
       shadow = { group = "com.gradleup.shadow", name = "shadow-gradle-plugin", version.ref = "shadow" }

     

       16
       16
       +
       

     

       17
       17
       +
       # development tools (code quality, annotations)

     

       18
       18
       +
       stylecheck = { group = "ca.stellardrift", name = "stylecheck", version.ref = "stylecheck" }

     

       19
       19
       +
       

     

       20
       20
       +
       # libraries

     

       21
       21
       +
       paper = { group = "io.papermc.paper", name = "paper-api", version.ref = "paper" }

gradle/wrapper/gradle-wrapper.jar

This is a binary file and will not be displayed.

gradle/wrapper/gradle-wrapper.properties

···

       1
       1
       +
       distributionBase=GRADLE_USER_HOME

     

       2
       2
       +
       distributionPath=wrapper/dists

     

       3
       3
       +
       distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip

     

       4
       4
       +
       networkTimeout=10000

     

       5
       5
       +
       validateDistributionUrl=true

     

       6
       6
       +
       zipStoreBase=GRADLE_USER_HOME

     

       7
       7
       +
       zipStorePath=wrapper/dists

+252

gradlew

···

       1
       1
       +
       #!/bin/sh

     

       2
       2
       +
       

     

       3
       3
       +
       #

     

       4
       4
       +
       # Copyright © 2015-2021 the original authors.

     

       5
       5
       +
       #

     

       6
       6
       +
       # Licensed under the Apache License, Version 2.0 (the "License");

     

       7
       7
       +
       # you may not use this file except in compliance with the License.

     

       8
       8
       +
       # You may obtain a copy of the License at

     

       9
       9
       +
       #

     

       10
       10
       +
       #      https://www.apache.org/licenses/LICENSE-2.0

     

       11
       11
       +
       #

     

       12
       12
       +
       # Unless required by applicable law or agreed to in writing, software

     

       13
       13
       +
       # distributed under the License is distributed on an "AS IS" BASIS,

     

       14
       14
       +
       # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

     

       15
       15
       +
       # See the License for the specific language governing permissions and

     

       16
       16
       +
       # limitations under the License.

     

       17
       17
       +
       #

     

       18
       18
       +
       # SPDX-License-Identifier: Apache-2.0

     

       19
       19
       +
       #

     

       20
       20
       +
       

     

       21
       21
       +
       ##############################################################################

     

       22
       22
       +
       #

     

       23
       23
       +
       #   Gradle start up script for POSIX generated by Gradle.

     

       24
       24
       +
       #

     

       25
       25
       +
       #   Important for running:

     

       26
       26
       +
       #

     

       27
       27
       +
       #   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is

     

       28
       28
       +
       #       noncompliant, but you have some other compliant shell such as ksh or

     

       29
       29
       +
       #       bash, then to run this script, type that shell name before the whole

     

       30
       30
       +
       #       command line, like:

     

       31
       31
       +
       #

     

       32
       32
       +
       #           ksh Gradle

     

       33
       33
       +
       #

     

       34
       34
       +
       #       Busybox and similar reduced shells will NOT work, because this script

     

       35
       35
       +
       #       requires all of these POSIX shell features:

     

       36
       36
       +
       #         * functions;

     

       37
       37
       +
       #         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,

     

       38
       38
       +
       #           «${var#prefix}», «${var%suffix}», and «$( cmd )»;

     

       39
       39
       +
       #         * compound commands having a testable exit status, especially «case»;

     

       40
       40
       +
       #         * various built-in commands including «command», «set», and «ulimit».

     

       41
       41
       +
       #

     

       42
       42
       +
       #   Important for patching:

     

       43
       43
       +
       #

     

       44
       44
       +
       #   (2) This script targets any POSIX shell, so it avoids extensions provided

     

       45
       45
       +
       #       by Bash, Ksh, etc; in particular arrays are avoided.

     

       46
       46
       +
       #

     

       47
       47
       +
       #       The "traditional" practice of packing multiple parameters into a

     

       48
       48
       +
       #       space-separated string is a well documented source of bugs and security

     

       49
       49
       +
       #       problems, so this is (mostly) avoided, by progressively accumulating

     

       50
       50
       +
       #       options in "$@", and eventually passing that to Java.

     

       51
       51
       +
       #

     

       52
       52
       +
       #       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,

     

       53
       53
       +
       #       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;

     

       54
       54
       +
       #       see the in-line comments for details.

     

       55
       55
       +
       #

     

       56
       56
       +
       #       There are tweaks for specific operating systems such as AIX, CygWin,

     

       57
       57
       +
       #       Darwin, MinGW, and NonStop.

     

       58
       58
       +
       #

     

       59
       59
       +
       #   (3) This script is generated from the Groovy template

     

       60
       60
       +
       #       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt

     

       61
       61
       +
       #       within the Gradle project.

     

       62
       62
       +
       #

     

       63
       63
       +
       #       You can find Gradle at https://github.com/gradle/gradle/.

     

       64
       64
       +
       #

     

       65
       65
       +
       ##############################################################################

     

       66
       66
       +
       

     

       67
       67
       +
       # Attempt to set APP_HOME

     

       68
       68
       +
       

     

       69
       69
       +
       # Resolve links: $0 may be a link

     

       70
       70
       +
       app_path=$0

     

       71
       71
       +
       

     

       72
       72
       +
       # Need this for daisy-chained symlinks.

     

       73
       73
       +
       while

     

       74
       74
       +
           APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path

     

       75
       75
       +
           [ -h "$app_path" ]

     

       76
       76
       +
       do

     

       77
       77
       +
           ls=$( ls -ld "$app_path" )

     

       78
       78
       +
           link=${ls#*' -> '}

     

       79
       79
       +
           case $link in             #(

     

       80
       80
       +
             /*)   app_path=$link ;; #(

     

       81
       81
       +
             *)    app_path=$APP_HOME$link ;;

     

       82
       82
       +
           esac

     

       83
       83
       +
       done

     

       84
       84
       +
       

     

       85
       85
       +
       # This is normally unused

     

       86
       86
       +
       # shellcheck disable=SC2034

     

       87
       87
       +
       APP_BASE_NAME=${0##*/}

     

       88
       88
       +
       # Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)

     

       89
       89
       +
       APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s

     

       90
       90
       +
       ' "$PWD" ) || exit

     

       91
       91
       +
       

     

       92
       92
       +
       # Use the maximum available, or set MAX_FD != -1 to use that value.

     

       93
       93
       +
       MAX_FD=maximum

     

       94
       94
       +
       

     

       95
       95
       +
       warn () {

     

       96
       96
       +
           echo "$*"

     

       97
       97
       +
       } >&2

     

       98
       98
       +
       

     

       99
       99
       +
       die () {

     

       100
       100
       +
           echo

     

       101
       101
       +
           echo "$*"

     

       102
       102
       +
           echo

     

       103
       103
       +
           exit 1

     

       104
       104
       +
       } >&2

     

       105
       105
       +
       

     

       106
       106
       +
       # OS specific support (must be 'true' or 'false').

     

       107
       107
       +
       cygwin=false

     

       108
       108
       +
       msys=false

     

       109
       109
       +
       darwin=false

     

       110
       110
       +
       nonstop=false

     

       111
       111
       +
       case "$( uname )" in                #(

     

       112
       112
       +
         CYGWIN* )         cygwin=true  ;; #(

     

       113
       113
       +
         Darwin* )         darwin=true  ;; #(

     

       114
       114
       +
         MSYS* | MINGW* )  msys=true    ;; #(

     

       115
       115
       +
         NONSTOP* )        nonstop=true ;;

     

       116
       116
       +
       esac

     

       117
       117
       +
       

     

       118
       118
       +
       CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar

     

       119
       119
       +
       

     

       120
       120
       +
       

     

       121
       121
       +
       # Determine the Java command to use to start the JVM.

     

       122
       122
       +
       if [ -n "$JAVA_HOME" ] ; then

     

       123
       123
       +
           if [ -x "$JAVA_HOME/jre/sh/java" ] ; then

     

       124
       124
       +
               # IBM's JDK on AIX uses strange locations for the executables

     

       125
       125
       +
               JAVACMD=$JAVA_HOME/jre/sh/java

     

       126
       126
       +
           else

     

       127
       127
       +
               JAVACMD=$JAVA_HOME/bin/java

     

       128
       128
       +
           fi

     

       129
       129
       +
           if [ ! -x "$JAVACMD" ] ; then

     

       130
       130
       +
               die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME

     

       131
       131
       +
       

     

       132
       132
       +
       Please set the JAVA_HOME variable in your environment to match the

     

       133
       133
       +
       location of your Java installation."

     

       134
       134
       +
           fi

     

       135
       135
       +
       else

     

       136
       136
       +
           JAVACMD=java

     

       137
       137
       +
           if ! command -v java >/dev/null 2>&1

     

       138
       138
       +
           then

     

       139
       139
       +
               die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.

     

       140
       140
       +
       

     

       141
       141
       +
       Please set the JAVA_HOME variable in your environment to match the

     

       142
       142
       +
       location of your Java installation."

     

       143
       143
       +
           fi

     

       144
       144
       +
       fi

     

       145
       145
       +
       

     

       146
       146
       +
       # Increase the maximum file descriptors if we can.

     

       147
       147
       +
       if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then

     

       148
       148
       +
           case $MAX_FD in #(

     

       149
       149
       +
             max*)

     

       150
       150
       +
               # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.

     

       151
       151
       +
               # shellcheck disable=SC2039,SC3045

     

       152
       152
       +
               MAX_FD=$( ulimit -H -n ) ||

     

       153
       153
       +
                   warn "Could not query maximum file descriptor limit"

     

       154
       154
       +
           esac

     

       155
       155
       +
           case $MAX_FD in  #(

     

       156
       156
       +
             '' | soft) :;; #(

     

       157
       157
       +
             *)

     

       158
       158
       +
               # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.

     

       159
       159
       +
               # shellcheck disable=SC2039,SC3045

     

       160
       160
       +
               ulimit -n "$MAX_FD" ||

     

       161
       161
       +
                   warn "Could not set maximum file descriptor limit to $MAX_FD"

     

       162
       162
       +
           esac

     

       163
       163
       +
       fi

     

       164
       164
       +
       

     

       165
       165
       +
       # Collect all arguments for the java command, stacking in reverse order:

     

       166
       166
       +
       #   * args from the command line

     

       167
       167
       +
       #   * the main class name

     

       168
       168
       +
       #   * -classpath

     

       169
       169
       +
       #   * -D...appname settings

     

       170
       170
       +
       #   * --module-path (only if needed)

     

       171
       171
       +
       #   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.

     

       172
       172
       +
       

     

       173
       173
       +
       # For Cygwin or MSYS, switch paths to Windows format before running java

     

       174
       174
       +
       if "$cygwin" || "$msys" ; then

     

       175
       175
       +
           APP_HOME=$( cygpath --path --mixed "$APP_HOME" )

     

       176
       176
       +
           CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )

     

       177
       177
       +
       

     

       178
       178
       +
           JAVACMD=$( cygpath --unix "$JAVACMD" )

     

       179
       179
       +
       

     

       180
       180
       +
           # Now convert the arguments - kludge to limit ourselves to /bin/sh

     

       181
       181
       +
           for arg do

     

       182
       182
       +
               if

     

       183
       183
       +
                   case $arg in                                #(

     

       184
       184
       +
                     -*)   false ;;                            # don't mess with options #(

     

       185
       185
       +
                     /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath

     

       186
       186
       +
                           [ -e "$t" ] ;;                      #(

     

       187
       187
       +
                     *)    false ;;

     

       188
       188
       +
                   esac

     

       189
       189
       +
               then

     

       190
       190
       +
                   arg=$( cygpath --path --ignore --mixed "$arg" )

     

       191
       191
       +
               fi

     

       192
       192
       +
               # Roll the args list around exactly as many times as the number of

     

       193
       193
       +
               # args, so each arg winds up back in the position where it started, but

     

       194
       194
       +
               # possibly modified.

     

       195
       195
       +
               #

     

       196
       196
       +
               # NB: a `for` loop captures its iteration list before it begins, so

     

       197
       197
       +
               # changing the positional parameters here affects neither the number of

     

       198
       198
       +
               # iterations, nor the values presented in `arg`.

     

       199
       199
       +
               shift                   # remove old arg

     

       200
       200
       +
               set -- "$@" "$arg"      # push replacement arg

     

       201
       201
       +
           done

     

       202
       202
       +
       fi

     

       203
       203
       +
       

     

       204
       204
       +
       

     

       205
       205
       +
       # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.

     

       206
       206
       +
       DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'

     

       207
       207
       +
       

     

       208
       208
       +
       # Collect all arguments for the java command:

     

       209
       209
       +
       #   * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,

     

       210
       210
       +
       #     and any embedded shellness will be escaped.

     

       211
       211
       +
       #   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be

     

       212
       212
       +
       #     treated as '${Hostname}' itself on the command line.

     

       213
       213
       +
       

     

       214
       214
       +
       set -- \

     

       215
       215
       +
               "-Dorg.gradle.appname=$APP_BASE_NAME" \

     

       216
       216
       +
               -classpath "$CLASSPATH" \

     

       217
       217
       +
               org.gradle.wrapper.GradleWrapperMain \

     

       218
       218
       +
               "$@"

     

       219
       219
       +
       

     

       220
       220
       +
       # Stop when "xargs" is not available.

     

       221
       221
       +
       if ! command -v xargs >/dev/null 2>&1

     

       222
       222
       +
       then

     

       223
       223
       +
           die "xargs is not available"

     

       224
       224
       +
       fi

     

       225
       225
       +
       

     

       226
       226
       +
       # Use "xargs" to parse quoted args.

     

       227
       227
       +
       #

     

       228
       228
       +
       # With -n1 it outputs one arg per line, with the quotes and backslashes removed.

     

       229
       229
       +
       #

     

       230
       230
       +
       # In Bash we could simply go:

     

       231
       231
       +
       #

     

       232
       232
       +
       #   readarray ARGS < <( xargs -n1 <<<"$var" ) &&

     

       233
       233
       +
       #   set -- "${ARGS[@]}" "$@"

     

       234
       234
       +
       #

     

       235
       235
       +
       # but POSIX shell has neither arrays nor command substitution, so instead we

     

       236
       236
       +
       # post-process each arg (as a line of input to sed) to backslash-escape any

     

       237
       237
       +
       # character that might be a shell metacharacter, then use eval to reverse

     

       238
       238
       +
       # that process (while maintaining the separation between arguments), and wrap

     

       239
       239
       +
       # the whole thing up as a single "set" statement.

     

       240
       240
       +
       #

     

       241
       241
       +
       # This will of course break if any of these variables contains a newline or

     

       242
       242
       +
       # an unmatched quote.

     

       243
       243
       +
       #

     

       244
       244
       +
       

     

       245
       245
       +
       eval "set -- $(

     

       246
       246
       +
               printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |

     

       247
       247
       +
               xargs -n1 |

     

       248
       248
       +
               sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |

     

       249
       249
       +
               tr '\n' ' '

     

       250
       250
       +
           )" '"$@"'

     

       251
       251
       +
       

     

       252
       252
       +
       exec "$JAVACMD" "$@"

+94

gradlew.bat

···

       1
       1
       +
       @rem

     

       2
       2
       +
       @rem Copyright 2015 the original author or authors.

     

       3
       3
       +
       @rem

     

       4
       4
       +
       @rem Licensed under the Apache License, Version 2.0 (the "License");

     

       5
       5
       +
       @rem you may not use this file except in compliance with the License.

     

       6
       6
       +
       @rem You may obtain a copy of the License at

     

       7
       7
       +
       @rem

     

       8
       8
       +
       @rem      https://www.apache.org/licenses/LICENSE-2.0

     

       9
       9
       +
       @rem

     

       10
       10
       +
       @rem Unless required by applicable law or agreed to in writing, software

     

       11
       11
       +
       @rem distributed under the License is distributed on an "AS IS" BASIS,

     

       12
       12
       +
       @rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

     

       13
       13
       +
       @rem See the License for the specific language governing permissions and

     

       14
       14
       +
       @rem limitations under the License.

     

       15
       15
       +
       @rem

     

       16
       16
       +
       @rem SPDX-License-Identifier: Apache-2.0

     

       17
       17
       +
       @rem

     

       18
       18
       +
       

     

       19
       19
       +
       @if "%DEBUG%"=="" @echo off

     

       20
       20
       +
       @rem ##########################################################################

     

       21
       21
       +
       @rem

     

       22
       22
       +
       @rem  Gradle startup script for Windows

     

       23
       23
       +
       @rem

     

       24
       24
       +
       @rem ##########################################################################

     

       25
       25
       +
       

     

       26
       26
       +
       @rem Set local scope for the variables with windows NT shell

     

       27
       27
       +
       if "%OS%"=="Windows_NT" setlocal

     

       28
       28
       +
       

     

       29
       29
       +
       set DIRNAME=%~dp0

     

       30
       30
       +
       if "%DIRNAME%"=="" set DIRNAME=.

     

       31
       31
       +
       @rem This is normally unused

     

       32
       32
       +
       set APP_BASE_NAME=%~n0

     

       33
       33
       +
       set APP_HOME=%DIRNAME%

     

       34
       34
       +
       

     

       35
       35
       +
       @rem Resolve any "." and ".." in APP_HOME to make it shorter.

     

       36
       36
       +
       for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi

     

       37
       37
       +
       

     

       38
       38
       +
       @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.

     

       39
       39
       +
       set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"

     

       40
       40
       +
       

     

       41
       41
       +
       @rem Find java.exe

     

       42
       42
       +
       if defined JAVA_HOME goto findJavaFromJavaHome

     

       43
       43
       +
       

     

       44
       44
       +
       set JAVA_EXE=java.exe

     

       45
       45
       +
       %JAVA_EXE% -version >NUL 2>&1

     

       46
       46
       +
       if %ERRORLEVEL% equ 0 goto execute

     

       47
       47
       +
       

     

       48
       48
       +
       echo. 1>&2

     

       49
       49
       +
       echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2

     

       50
       50
       +
       echo. 1>&2

     

       51
       51
       +
       echo Please set the JAVA_HOME variable in your environment to match the 1>&2

     

       52
       52
       +
       echo location of your Java installation. 1>&2

     

       53
       53
       +
       

     

       54
       54
       +
       goto fail

     

       55
       55
       +
       

     

       56
       56
       +
       :findJavaFromJavaHome

     

       57
       57
       +
       set JAVA_HOME=%JAVA_HOME:"=%

     

       58
       58
       +
       set JAVA_EXE=%JAVA_HOME%/bin/java.exe

     

       59
       59
       +
       

     

       60
       60
       +
       if exist "%JAVA_EXE%" goto execute

     

       61
       61
       +
       

     

       62
       62
       +
       echo. 1>&2

     

       63
       63
       +
       echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2

     

       64
       64
       +
       echo. 1>&2

     

       65
       65
       +
       echo Please set the JAVA_HOME variable in your environment to match the 1>&2

     

       66
       66
       +
       echo location of your Java installation. 1>&2

     

       67
       67
       +
       

     

       68
       68
       +
       goto fail

     

       69
       69
       +
       

     

       70
       70
       +
       :execute

     

       71
       71
       +
       @rem Setup the command line

     

       72
       72
       +
       

     

       73
       73
       +
       set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar

     

       74
       74
       +
       

     

       75
       75
       +
       

     

       76
       76
       +
       @rem Execute Gradle

     

       77
       77
       +
       "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*

     

       78
       78
       +
       

     

       79
       79
       +
       :end

     

       80
       80
       +
       @rem End local scope for the variables with windows NT shell

     

       81
       81
       +
       if %ERRORLEVEL% equ 0 goto mainEnd

     

       82
       82
       +
       

     

       83
       83
       +
       :fail

     

       84
       84
       +
       rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of

     

       85
       85
       +
       rem the _cmd.exe /c_ return code!

     

       86
       86
       +
       set EXIT_CODE=%ERRORLEVEL%

     

       87
       87
       +
       if %EXIT_CODE% equ 0 set EXIT_CODE=1

     

       88
       88
       +
       if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%

     

       89
       89
       +
       exit /b %EXIT_CODE%

     

       90
       90
       +
       

     

       91
       91
       +
       :mainEnd

     

       92
       92
       +
       if "%OS%"=="Windows_NT" endlocal

     

       93
       93
       +
       

     

       94
       94
       +
       :omega

+674

license.txt

···

       1
       1
       +
                           GNU GENERAL PUBLIC LICENSE

     

       2
       2
       +
                              Version 3, 29 June 2007

     

       3
       3
       +
       

     

       4
       4
       +
        Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>

     

       5
       5
       +
        Everyone is permitted to copy and distribute verbatim copies

     

       6
       6
       +
        of this license document, but changing it is not allowed.

     

       7
       7
       +
       

     

       8
       8
       +
                                   Preamble

     

       9
       9
       +
       

     

       10
       10
       +
         The GNU General Public License is a free, copyleft license for

     

       11
       11
       +
       software and other kinds of works.

     

       12
       12
       +
       

     

       13
       13
       +
         The licenses for most software and other practical works are designed

     

       14
       14
       +
       to take away your freedom to share and change the works.  By contrast,

     

       15
       15
       +
       the GNU General Public License is intended to guarantee your freedom to

     

       16
       16
       +
       share and change all versions of a program--to make sure it remains free

     

       17
       17
       +
       software for all its users.  We, the Free Software Foundation, use the

     

       18
       18
       +
       GNU General Public License for most of our software; it applies also to

     

       19
       19
       +
       any other work released this way by its authors.  You can apply it to

     

       20
       20
       +
       your programs, too.

     

       21
       21
       +
       

     

       22
       22
       +
         When we speak of free software, we are referring to freedom, not

     

       23
       23
       +
       price.  Our General Public Licenses are designed to make sure that you

     

       24
       24
       +
       have the freedom to distribute copies of free software (and charge for

     

       25
       25
       +
       them if you wish), that you receive source code or can get it if you

     

       26
       26
       +
       want it, that you can change the software or use pieces of it in new

     

       27
       27
       +
       free programs, and that you know you can do these things.

     

       28
       28
       +
       

     

       29
       29
       +
         To protect your rights, we need to prevent others from denying you

     

       30
       30
       +
       these rights or asking you to surrender the rights.  Therefore, you have

     

       31
       31
       +
       certain responsibilities if you distribute copies of the software, or if

     

       32
       32
       +
       you modify it: responsibilities to respect the freedom of others.

     

       33
       33
       +
       

     

       34
       34
       +
         For example, if you distribute copies of such a program, whether

     

       35
       35
       +
       gratis or for a fee, you must pass on to the recipients the same

     

       36
       36
       +
       freedoms that you received.  You must make sure that they, too, receive

     

       37
       37
       +
       or can get the source code.  And you must show them these terms so they

     

       38
       38
       +
       know their rights.

     

       39
       39
       +
       

     

       40
       40
       +
         Developers that use the GNU GPL protect your rights with two steps:

     

       41
       41
       +
       (1) assert copyright on the software, and (2) offer you this License

     

       42
       42
       +
       giving you legal permission to copy, distribute and/or modify it.

     

       43
       43
       +
       

     

       44
       44
       +
         For the developers' and authors' protection, the GPL clearly explains

     

       45
       45
       +
       that there is no warranty for this free software.  For both users' and

     

       46
       46
       +
       authors' sake, the GPL requires that modified versions be marked as

     

       47
       47
       +
       changed, so that their problems will not be attributed erroneously to

     

       48
       48
       +
       authors of previous versions.

     

       49
       49
       +
       

     

       50
       50
       +
         Some devices are designed to deny users access to install or run

     

       51
       51
       +
       modified versions of the software inside them, although the manufacturer

     

       52
       52
       +
       can do so.  This is fundamentally incompatible with the aim of

     

       53
       53
       +
       protecting users' freedom to change the software.  The systematic

     

       54
       54
       +
       pattern of such abuse occurs in the area of products for individuals to

     

       55
       55
       +
       use, which is precisely where it is most unacceptable.  Therefore, we

     

       56
       56
       +
       have designed this version of the GPL to prohibit the practice for those

     

       57
       57
       +
       products.  If such problems arise substantially in other domains, we

     

       58
       58
       +
       stand ready to extend this provision to those domains in future versions

     

       59
       59
       +
       of the GPL, as needed to protect the freedom of users.

     

       60
       60
       +
       

     

       61
       61
       +
         Finally, every program is threatened constantly by software patents.

     

       62
       62
       +
       States should not allow patents to restrict development and use of

     

       63
       63
       +
       software on general-purpose computers, but in those that do, we wish to

     

       64
       64
       +
       avoid the special danger that patents applied to a free program could

     

       65
       65
       +
       make it effectively proprietary.  To prevent this, the GPL assures that

     

       66
       66
       +
       patents cannot be used to render the program non-free.

     

       67
       67
       +
       

     

       68
       68
       +
         The precise terms and conditions for copying, distribution and

     

       69
       69
       +
       modification follow.

     

       70
       70
       +
       

     

       71
       71
       +
                              TERMS AND CONDITIONS

     

       72
       72
       +
       

     

       73
       73
       +
         0. Definitions.

     

       74
       74
       +
       

     

       75
       75
       +
         "This License" refers to version 3 of the GNU General Public License.

     

       76
       76
       +
       

     

       77
       77
       +
         "Copyright" also means copyright-like laws that apply to other kinds of

     

       78
       78
       +
       works, such as semiconductor masks.

     

       79
       79
       +
       

     

       80
       80
       +
         "The Program" refers to any copyrightable work licensed under this

     

       81
       81
       +
       License.  Each licensee is addressed as "you".  "Licensees" and

     

       82
       82
       +
       "recipients" may be individuals or organizations.

     

       83
       83
       +
       

     

       84
       84
       +
         To "modify" a work means to copy from or adapt all or part of the work

     

       85
       85
       +
       in a fashion requiring copyright permission, other than the making of an

     

       86
       86
       +
       exact copy.  The resulting work is called a "modified version" of the

     

       87
       87
       +
       earlier work or a work "based on" the earlier work.

     

       88
       88
       +
       

     

       89
       89
       +
         A "covered work" means either the unmodified Program or a work based

     

       90
       90
       +
       on the Program.

     

       91
       91
       +
       

     

       92
       92
       +
         To "propagate" a work means to do anything with it that, without

     

       93
       93
       +
       permission, would make you directly or secondarily liable for

     

       94
       94
       +
       infringement under applicable copyright law, except executing it on a

     

       95
       95
       +
       computer or modifying a private copy.  Propagation includes copying,

     

       96
       96
       +
       distribution (with or without modification), making available to the

     

       97
       97
       +
       public, and in some countries other activities as well.

     

       98
       98
       +
       

     

       99
       99
       +
         To "convey" a work means any kind of propagation that enables other

     

       100
       100
       +
       parties to make or receive copies.  Mere interaction with a user through

     

       101
       101
       +
       a computer network, with no transfer of a copy, is not conveying.

     

       102
       102
       +
       

     

       103
       103
       +
         An interactive user interface displays "Appropriate Legal Notices"

     

       104
       104
       +
       to the extent that it includes a convenient and prominently visible

     

       105
       105
       +
       feature that (1) displays an appropriate copyright notice, and (2)

     

       106
       106
       +
       tells the user that there is no warranty for the work (except to the

     

       107
       107
       +
       extent that warranties are provided), that licensees may convey the

     

       108
       108
       +
       work under this License, and how to view a copy of this License.  If

     

       109
       109
       +
       the interface presents a list of user commands or options, such as a

     

       110
       110
       +
       menu, a prominent item in the list meets this criterion.

     

       111
       111
       +
       

     

       112
       112
       +
         1. Source Code.

     

       113
       113
       +
       

     

       114
       114
       +
         The "source code" for a work means the preferred form of the work

     

       115
       115
       +
       for making modifications to it.  "Object code" means any non-source

     

       116
       116
       +
       form of a work.

     

       117
       117
       +
       

     

       118
       118
       +
         A "Standard Interface" means an interface that either is an official

     

       119
       119
       +
       standard defined by a recognized standards body, or, in the case of

     

       120
       120
       +
       interfaces specified for a particular programming language, one that

     

       121
       121
       +
       is widely used among developers working in that language.

     

       122
       122
       +
       

     

       123
       123
       +
         The "System Libraries" of an executable work include anything, other

     

       124
       124
       +
       than the work as a whole, that (a) is included in the normal form of

     

       125
       125
       +
       packaging a Major Component, but which is not part of that Major

     

       126
       126
       +
       Component, and (b) serves only to enable use of the work with that

     

       127
       127
       +
       Major Component, or to implement a Standard Interface for which an

     

       128
       128
       +
       implementation is available to the public in source code form.  A

     

       129
       129
       +
       "Major Component", in this context, means a major essential component

     

       130
       130
       +
       (kernel, window system, and so on) of the specific operating system

     

       131
       131
       +
       (if any) on which the executable work runs, or a compiler used to

     

       132
       132
       +
       produce the work, or an object code interpreter used to run it.

     

       133
       133
       +
       

     

       134
       134
       +
         The "Corresponding Source" for a work in object code form means all

     

       135
       135
       +
       the source code needed to generate, install, and (for an executable

     

       136
       136
       +
       work) run the object code and to modify the work, including scripts to

     

       137
       137
       +
       control those activities.  However, it does not include the work's

     

       138
       138
       +
       System Libraries, or general-purpose tools or generally available free

     

       139
       139
       +
       programs which are used unmodified in performing those activities but

     

       140
       140
       +
       which are not part of the work.  For example, Corresponding Source

     

       141
       141
       +
       includes interface definition files associated with source files for

     

       142
       142
       +
       the work, and the source code for shared libraries and dynamically

     

       143
       143
       +
       linked subprograms that the work is specifically designed to require,

     

       144
       144
       +
       such as by intimate data communication or control flow between those

     

       145
       145
       +
       subprograms and other parts of the work.

     

       146
       146
       +
       

     

       147
       147
       +
         The Corresponding Source need not include anything that users

     

       148
       148
       +
       can regenerate automatically from other parts of the Corresponding

     

       149
       149
       +
       Source.

     

       150
       150
       +
       

     

       151
       151
       +
         The Corresponding Source for a work in source code form is that

     

       152
       152
       +
       same work.

     

       153
       153
       +
       

     

       154
       154
       +
         2. Basic Permissions.

     

       155
       155
       +
       

     

       156
       156
       +
         All rights granted under this License are granted for the term of

     

       157
       157
       +
       copyright on the Program, and are irrevocable provided the stated

     

       158
       158
       +
       conditions are met.  This License explicitly affirms your unlimited

     

       159
       159
       +
       permission to run the unmodified Program.  The output from running a

     

       160
       160
       +
       covered work is covered by this License only if the output, given its

     

       161
       161
       +
       content, constitutes a covered work.  This License acknowledges your

     

       162
       162
       +
       rights of fair use or other equivalent, as provided by copyright law.

     

       163
       163
       +
       

     

       164
       164
       +
         You may make, run and propagate covered works that you do not

     

       165
       165
       +
       convey, without conditions so long as your license otherwise remains

     

       166
       166
       +
       in force.  You may convey covered works to others for the sole purpose

     

       167
       167
       +
       of having them make modifications exclusively for you, or provide you

     

       168
       168
       +
       with facilities for running those works, provided that you comply with

     

       169
       169
       +
       the terms of this License in conveying all material for which you do

     

       170
       170
       +
       not control copyright.  Those thus making or running the covered works

     

       171
       171
       +
       for you must do so exclusively on your behalf, under your direction

     

       172
       172
       +
       and control, on terms that prohibit them from making any copies of

     

       173
       173
       +
       your copyrighted material outside their relationship with you.

     

       174
       174
       +
       

     

       175
       175
       +
         Conveying under any other circumstances is permitted solely under

     

       176
       176
       +
       the conditions stated below.  Sublicensing is not allowed; section 10

     

       177
       177
       +
       makes it unnecessary.

     

       178
       178
       +
       

     

       179
       179
       +
         3. Protecting Users' Legal Rights From Anti-Circumvention Law.

     

       180
       180
       +
       

     

       181
       181
       +
         No covered work shall be deemed part of an effective technological

     

       182
       182
       +
       measure under any applicable law fulfilling obligations under article

     

       183
       183
       +
       11 of the WIPO copyright treaty adopted on 20 December 1996, or

     

       184
       184
       +
       similar laws prohibiting or restricting circumvention of such

     

       185
       185
       +
       measures.

     

       186
       186
       +
       

     

       187
       187
       +
         When you convey a covered work, you waive any legal power to forbid

     

       188
       188
       +
       circumvention of technological measures to the extent such circumvention

     

       189
       189
       +
       is effected by exercising rights under this License with respect to

     

       190
       190
       +
       the covered work, and you disclaim any intention to limit operation or

     

       191
       191
       +
       modification of the work as a means of enforcing, against the work's

     

       192
       192
       +
       users, your or third parties' legal rights to forbid circumvention of

     

       193
       193
       +
       technological measures.

     

       194
       194
       +
       

     

       195
       195
       +
         4. Conveying Verbatim Copies.

     

       196
       196
       +
       

     

       197
       197
       +
         You may convey verbatim copies of the Program's source code as you

     

       198
       198
       +
       receive it, in any medium, provided that you conspicuously and

     

       199
       199
       +
       appropriately publish on each copy an appropriate copyright notice;

     

       200
       200
       +
       keep intact all notices stating that this License and any

     

       201
       201
       +
       non-permissive terms added in accord with section 7 apply to the code;

     

       202
       202
       +
       keep intact all notices of the absence of any warranty; and give all

     

       203
       203
       +
       recipients a copy of this License along with the Program.

     

       204
       204
       +
       

     

       205
       205
       +
         You may charge any price or no price for each copy that you convey,

     

       206
       206
       +
       and you may offer support or warranty protection for a fee.

     

       207
       207
       +
       

     

       208
       208
       +
         5. Conveying Modified Source Versions.

     

       209
       209
       +
       

     

       210
       210
       +
         You may convey a work based on the Program, or the modifications to

     

       211
       211
       +
       produce it from the Program, in the form of source code under the

     

       212
       212
       +
       terms of section 4, provided that you also meet all of these conditions:

     

       213
       213
       +
       

     

       214
       214
       +
           a) The work must carry prominent notices stating that you modified

     

       215
       215
       +
           it, and giving a relevant date.

     

       216
       216
       +
       

     

       217
       217
       +
           b) The work must carry prominent notices stating that it is

     

       218
       218
       +
           released under this License and any conditions added under section

     

       219
       219
       +
           7.  This requirement modifies the requirement in section 4 to

     

       220
       220
       +
           "keep intact all notices".

     

       221
       221
       +
       

     

       222
       222
       +
           c) You must license the entire work, as a whole, under this

     

       223
       223
       +
           License to anyone who comes into possession of a copy.  This

     

       224
       224
       +
           License will therefore apply, along with any applicable section 7

     

       225
       225
       +
           additional terms, to the whole of the work, and all its parts,

     

       226
       226
       +
           regardless of how they are packaged.  This License gives no

     

       227
       227
       +
           permission to license the work in any other way, but it does not

     

       228
       228
       +
           invalidate such permission if you have separately received it.

     

       229
       229
       +
       

     

       230
       230
       +
           d) If the work has interactive user interfaces, each must display

     

       231
       231
       +
           Appropriate Legal Notices; however, if the Program has interactive

     

       232
       232
       +
           interfaces that do not display Appropriate Legal Notices, your

     

       233
       233
       +
           work need not make them do so.

     

       234
       234
       +
       

     

       235
       235
       +
         A compilation of a covered work with other separate and independent

     

       236
       236
       +
       works, which are not by their nature extensions of the covered work,

     

       237
       237
       +
       and which are not combined with it such as to form a larger program,

     

       238
       238
       +
       in or on a volume of a storage or distribution medium, is called an

     

       239
       239
       +
       "aggregate" if the compilation and its resulting copyright are not

     

       240
       240
       +
       used to limit the access or legal rights of the compilation's users

     

       241
       241
       +
       beyond what the individual works permit.  Inclusion of a covered work

     

       242
       242
       +
       in an aggregate does not cause this License to apply to the other

     

       243
       243
       +
       parts of the aggregate.

     

       244
       244
       +
       

     

       245
       245
       +
         6. Conveying Non-Source Forms.

     

       246
       246
       +
       

     

       247
       247
       +
         You may convey a covered work in object code form under the terms

     

       248
       248
       +
       of sections 4 and 5, provided that you also convey the

     

       249
       249
       +
       machine-readable Corresponding Source under the terms of this License,

     

       250
       250
       +
       in one of these ways:

     

       251
       251
       +
       

     

       252
       252
       +
           a) Convey the object code in, or embodied in, a physical product

     

       253
       253
       +
           (including a physical distribution medium), accompanied by the

     

       254
       254
       +
           Corresponding Source fixed on a durable physical medium

     

       255
       255
       +
           customarily used for software interchange.

     

       256
       256
       +
       

     

       257
       257
       +
           b) Convey the object code in, or embodied in, a physical product

     

       258
       258
       +
           (including a physical distribution medium), accompanied by a

     

       259
       259
       +
           written offer, valid for at least three years and valid for as

     

       260
       260
       +
           long as you offer spare parts or customer support for that product

     

       261
       261
       +
           model, to give anyone who possesses the object code either (1) a

     

       262
       262
       +
           copy of the Corresponding Source for all the software in the

     

       263
       263
       +
           product that is covered by this License, on a durable physical

     

       264
       264
       +
           medium customarily used for software interchange, for a price no

     

       265
       265
       +
           more than your reasonable cost of physically performing this

     

       266
       266
       +
           conveying of source, or (2) access to copy the

     

       267
       267
       +
           Corresponding Source from a network server at no charge.

     

       268
       268
       +
       

     

       269
       269
       +
           c) Convey individual copies of the object code with a copy of the

     

       270
       270
       +
           written offer to provide the Corresponding Source.  This

     

       271
       271
       +
           alternative is allowed only occasionally and noncommercially, and

     

       272
       272
       +
           only if you received the object code with such an offer, in accord

     

       273
       273
       +
           with subsection 6b.

     

       274
       274
       +
       

     

       275
       275
       +
           d) Convey the object code by offering access from a designated

     

       276
       276
       +
           place (gratis or for a charge), and offer equivalent access to the

     

       277
       277
       +
           Corresponding Source in the same way through the same place at no

     

       278
       278
       +
           further charge.  You need not require recipients to copy the

     

       279
       279
       +
           Corresponding Source along with the object code.  If the place to

     

       280
       280
       +
           copy the object code is a network server, the Corresponding Source

     

       281
       281
       +
           may be on a different server (operated by you or a third party)

     

       282
       282
       +
           that supports equivalent copying facilities, provided you maintain

     

       283
       283
       +
           clear directions next to the object code saying where to find the

     

       284
       284
       +
           Corresponding Source.  Regardless of what server hosts the

     

       285
       285
       +
           Corresponding Source, you remain obligated to ensure that it is

     

       286
       286
       +
           available for as long as needed to satisfy these requirements.

     

       287
       287
       +
       

     

       288
       288
       +
           e) Convey the object code using peer-to-peer transmission, provided

     

       289
       289
       +
           you inform other peers where the object code and Corresponding

     

       290
       290
       +
           Source of the work are being offered to the general public at no

     

       291
       291
       +
           charge under subsection 6d.

     

       292
       292
       +
       

     

       293
       293
       +
         A separable portion of the object code, whose source code is excluded

     

       294
       294
       +
       from the Corresponding Source as a System Library, need not be

     

       295
       295
       +
       included in conveying the object code work.

     

       296
       296
       +
       

     

       297
       297
       +
         A "User Product" is either (1) a "consumer product", which means any

     

       298
       298
       +
       tangible personal property which is normally used for personal, family,

     

       299
       299
       +
       or household purposes, or (2) anything designed or sold for incorporation

     

       300
       300
       +
       into a dwelling.  In determining whether a product is a consumer product,

     

       301
       301
       +
       doubtful cases shall be resolved in favor of coverage.  For a particular

     

       302
       302
       +
       product received by a particular user, "normally used" refers to a

     

       303
       303
       +
       typical or common use of that class of product, regardless of the status

     

       304
       304
       +
       of the particular user or of the way in which the particular user

     

       305
       305
       +
       actually uses, or expects or is expected to use, the product.  A product

     

       306
       306
       +
       is a consumer product regardless of whether the product has substantial

     

       307
       307
       +
       commercial, industrial or non-consumer uses, unless such uses represent

     

       308
       308
       +
       the only significant mode of use of the product.

     

       309
       309
       +
       

     

       310
       310
       +
         "Installation Information" for a User Product means any methods,

     

       311
       311
       +
       procedures, authorization keys, or other information required to install

     

       312
       312
       +
       and execute modified versions of a covered work in that User Product from

     

       313
       313
       +
       a modified version of its Corresponding Source.  The information must

     

       314
       314
       +
       suffice to ensure that the continued functioning of the modified object

     

       315
       315
       +
       code is in no case prevented or interfered with solely because

     

       316
       316
       +
       modification has been made.

     

       317
       317
       +
       

     

       318
       318
       +
         If you convey an object code work under this section in, or with, or

     

       319
       319
       +
       specifically for use in, a User Product, and the conveying occurs as

     

       320
       320
       +
       part of a transaction in which the right of possession and use of the

     

       321
       321
       +
       User Product is transferred to the recipient in perpetuity or for a

     

       322
       322
       +
       fixed term (regardless of how the transaction is characterized), the

     

       323
       323
       +
       Corresponding Source conveyed under this section must be accompanied

     

       324
       324
       +
       by the Installation Information.  But this requirement does not apply

     

       325
       325
       +
       if neither you nor any third party retains the ability to install

     

       326
       326
       +
       modified object code on the User Product (for example, the work has

     

       327
       327
       +
       been installed in ROM).

     

       328
       328
       +
       

     

       329
       329
       +
         The requirement to provide Installation Information does not include a

     

       330
       330
       +
       requirement to continue to provide support service, warranty, or updates

     

       331
       331
       +
       for a work that has been modified or installed by the recipient, or for

     

       332
       332
       +
       the User Product in which it has been modified or installed.  Access to a

     

       333
       333
       +
       network may be denied when the modification itself materially and

     

       334
       334
       +
       adversely affects the operation of the network or violates the rules and

     

       335
       335
       +
       protocols for communication across the network.

     

       336
       336
       +
       

     

       337
       337
       +
         Corresponding Source conveyed, and Installation Information provided,

     

       338
       338
       +
       in accord with this section must be in a format that is publicly

     

       339
       339
       +
       documented (and with an implementation available to the public in

     

       340
       340
       +
       source code form), and must require no special password or key for

     

       341
       341
       +
       unpacking, reading or copying.

     

       342
       342
       +
       

     

       343
       343
       +
         7. Additional Terms.

     

       344
       344
       +
       

     

       345
       345
       +
         "Additional permissions" are terms that supplement the terms of this

     

       346
       346
       +
       License by making exceptions from one or more of its conditions.

     

       347
       347
       +
       Additional permissions that are applicable to the entire Program shall

     

       348
       348
       +
       be treated as though they were included in this License, to the extent

     

       349
       349
       +
       that they are valid under applicable law.  If additional permissions

     

       350
       350
       +
       apply only to part of the Program, that part may be used separately

     

       351
       351
       +
       under those permissions, but the entire Program remains governed by

     

       352
       352
       +
       this License without regard to the additional permissions.

     

       353
       353
       +
       

     

       354
       354
       +
         When you convey a copy of a covered work, you may at your option

     

       355
       355
       +
       remove any additional permissions from that copy, or from any part of

     

       356
       356
       +
       it.  (Additional permissions may be written to require their own

     

       357
       357
       +
       removal in certain cases when you modify the work.)  You may place

     

       358
       358
       +
       additional permissions on material, added by you to a covered work,

     

       359
       359
       +
       for which you have or can give appropriate copyright permission.

     

       360
       360
       +
       

     

       361
       361
       +
         Notwithstanding any other provision of this License, for material you

     

       362
       362
       +
       add to a covered work, you may (if authorized by the copyright holders of

     

       363
       363
       +
       that material) supplement the terms of this License with terms:

     

       364
       364
       +
       

     

       365
       365
       +
           a) Disclaiming warranty or limiting liability differently from the

     

       366
       366
       +
           terms of sections 15 and 16 of this License; or

     

       367
       367
       +
       

     

       368
       368
       +
           b) Requiring preservation of specified reasonable legal notices or

     

       369
       369
       +
           author attributions in that material or in the Appropriate Legal

     

       370
       370
       +
           Notices displayed by works containing it; or

     

       371
       371
       +
       

     

       372
       372
       +
           c) Prohibiting misrepresentation of the origin of that material, or

     

       373
       373
       +
           requiring that modified versions of such material be marked in

     

       374
       374
       +
           reasonable ways as different from the original version; or

     

       375
       375
       +
       

     

       376
       376
       +
           d) Limiting the use for publicity purposes of names of licensors or

     

       377
       377
       +
           authors of the material; or

     

       378
       378
       +
       

     

       379
       379
       +
           e) Declining to grant rights under trademark law for use of some

     

       380
       380
       +
           trade names, trademarks, or service marks; or

     

       381
       381
       +
       

     

       382
       382
       +
           f) Requiring indemnification of licensors and authors of that

     

       383
       383
       +
           material by anyone who conveys the material (or modified versions of

     

       384
       384
       +
           it) with contractual assumptions of liability to the recipient, for

     

       385
       385
       +
           any liability that these contractual assumptions directly impose on

     

       386
       386
       +
           those licensors and authors.

     

       387
       387
       +
       

     

       388
       388
       +
         All other non-permissive additional terms are considered "further

     

       389
       389
       +
       restrictions" within the meaning of section 10.  If the Program as you

     

       390
       390
       +
       received it, or any part of it, contains a notice stating that it is

     

       391
       391
       +
       governed by this License along with a term that is a further

     

       392
       392
       +
       restriction, you may remove that term.  If a license document contains

     

       393
       393
       +
       a further restriction but permits relicensing or conveying under this

     

       394
       394
       +
       License, you may add to a covered work material governed by the terms

     

       395
       395
       +
       of that license document, provided that the further restriction does

     

       396
       396
       +
       not survive such relicensing or conveying.

     

       397
       397
       +
       

     

       398
       398
       +
         If you add terms to a covered work in accord with this section, you

     

       399
       399
       +
       must place, in the relevant source files, a statement of the

     

       400
       400
       +
       additional terms that apply to those files, or a notice indicating

     

       401
       401
       +
       where to find the applicable terms.

     

       402
       402
       +
       

     

       403
       403
       +
         Additional terms, permissive or non-permissive, may be stated in the

     

       404
       404
       +
       form of a separately written license, or stated as exceptions;

     

       405
       405
       +
       the above requirements apply either way.

     

       406
       406
       +
       

     

       407
       407
       +
         8. Termination.

     

       408
       408
       +
       

     

       409
       409
       +
         You may not propagate or modify a covered work except as expressly

     

       410
       410
       +
       provided under this License.  Any attempt otherwise to propagate or

     

       411
       411
       +
       modify it is void, and will automatically terminate your rights under

     

       412
       412
       +
       this License (including any patent licenses granted under the third

     

       413
       413
       +
       paragraph of section 11).

     

       414
       414
       +
       

     

       415
       415
       +
         However, if you cease all violation of this License, then your

     

       416
       416
       +
       license from a particular copyright holder is reinstated (a)

     

       417
       417
       +
       provisionally, unless and until the copyright holder explicitly and

     

       418
       418
       +
       finally terminates your license, and (b) permanently, if the copyright

     

       419
       419
       +
       holder fails to notify you of the violation by some reasonable means

     

       420
       420
       +
       prior to 60 days after the cessation.

     

       421
       421
       +
       

     

       422
       422
       +
         Moreover, your license from a particular copyright holder is

     

       423
       423
       +
       reinstated permanently if the copyright holder notifies you of the

     

       424
       424
       +
       violation by some reasonable means, this is the first time you have

     

       425
       425
       +
       received notice of violation of this License (for any work) from that

     

       426
       426
       +
       copyright holder, and you cure the violation prior to 30 days after

     

       427
       427
       +
       your receipt of the notice.

     

       428
       428
       +
       

     

       429
       429
       +
         Termination of your rights under this section does not terminate the

     

       430
       430
       +
       licenses of parties who have received copies or rights from you under

     

       431
       431
       +
       this License.  If your rights have been terminated and not permanently

     

       432
       432
       +
       reinstated, you do not qualify to receive new licenses for the same

     

       433
       433
       +
       material under section 10.

     

       434
       434
       +
       

     

       435
       435
       +
         9. Acceptance Not Required for Having Copies.

     

       436
       436
       +
       

     

       437
       437
       +
         You are not required to accept this License in order to receive or

     

       438
       438
       +
       run a copy of the Program.  Ancillary propagation of a covered work

     

       439
       439
       +
       occurring solely as a consequence of using peer-to-peer transmission

     

       440
       440
       +
       to receive a copy likewise does not require acceptance.  However,

     

       441
       441
       +
       nothing other than this License grants you permission to propagate or

     

       442
       442
       +
       modify any covered work.  These actions infringe copyright if you do

     

       443
       443
       +
       not accept this License.  Therefore, by modifying or propagating a

     

       444
       444
       +
       covered work, you indicate your acceptance of this License to do so.

     

       445
       445
       +
       

     

       446
       446
       +
         10. Automatic Licensing of Downstream Recipients.

     

       447
       447
       +
       

     

       448
       448
       +
         Each time you convey a covered work, the recipient automatically

     

       449
       449
       +
       receives a license from the original licensors, to run, modify and

     

       450
       450
       +
       propagate that work, subject to this License.  You are not responsible

     

       451
       451
       +
       for enforcing compliance by third parties with this License.

     

       452
       452
       +
       

     

       453
       453
       +
         An "entity transaction" is a transaction transferring control of an

     

       454
       454
       +
       organization, or substantially all assets of one, or subdividing an

     

       455
       455
       +
       organization, or merging organizations.  If propagation of a covered

     

       456
       456
       +
       work results from an entity transaction, each party to that

     

       457
       457
       +
       transaction who receives a copy of the work also receives whatever

     

       458
       458
       +
       licenses to the work the party's predecessor in interest had or could

     

       459
       459
       +
       give under the previous paragraph, plus a right to possession of the

     

       460
       460
       +
       Corresponding Source of the work from the predecessor in interest, if

     

       461
       461
       +
       the predecessor has it or can get it with reasonable efforts.

     

       462
       462
       +
       

     

       463
       463
       +
         You may not impose any further restrictions on the exercise of the

     

       464
       464
       +
       rights granted or affirmed under this License.  For example, you may

     

       465
       465
       +
       not impose a license fee, royalty, or other charge for exercise of

     

       466
       466
       +
       rights granted under this License, and you may not initiate litigation

     

       467
       467
       +
       (including a cross-claim or counterclaim in a lawsuit) alleging that

     

       468
       468
       +
       any patent claim is infringed by making, using, selling, offering for

     

       469
       469
       +
       sale, or importing the Program or any portion of it.

     

       470
       470
       +
       

     

       471
       471
       +
         11. Patents.

     

       472
       472
       +
       

     

       473
       473
       +
         A "contributor" is a copyright holder who authorizes use under this

     

       474
       474
       +
       License of the Program or a work on which the Program is based.  The

     

       475
       475
       +
       work thus licensed is called the contributor's "contributor version".

     

       476
       476
       +
       

     

       477
       477
       +
         A contributor's "essential patent claims" are all patent claims

     

       478
       478
       +
       owned or controlled by the contributor, whether already acquired or

     

       479
       479
       +
       hereafter acquired, that would be infringed by some manner, permitted

     

       480
       480
       +
       by this License, of making, using, or selling its contributor version,

     

       481
       481
       +
       but do not include claims that would be infringed only as a

     

       482
       482
       +
       consequence of further modification of the contributor version.  For

     

       483
       483
       +
       purposes of this definition, "control" includes the right to grant

     

       484
       484
       +
       patent sublicenses in a manner consistent with the requirements of

     

       485
       485
       +
       this License.

     

       486
       486
       +
       

     

       487
       487
       +
         Each contributor grants you a non-exclusive, worldwide, royalty-free

     

       488
       488
       +
       patent license under the contributor's essential patent claims, to

     

       489
       489
       +
       make, use, sell, offer for sale, import and otherwise run, modify and

     

       490
       490
       +
       propagate the contents of its contributor version.

     

       491
       491
       +
       

     

       492
       492
       +
         In the following three paragraphs, a "patent license" is any express

     

       493
       493
       +
       agreement or commitment, however denominated, not to enforce a patent

     

       494
       494
       +
       (such as an express permission to practice a patent or covenant not to

     

       495
       495
       +
       sue for patent infringement).  To "grant" such a patent license to a

     

       496
       496
       +
       party means to make such an agreement or commitment not to enforce a

     

       497
       497
       +
       patent against the party.

     

       498
       498
       +
       

     

       499
       499
       +
         If you convey a covered work, knowingly relying on a patent license,

     

       500
       500
       +
       and the Corresponding Source of the work is not available for anyone

     

       501
       501
       +
       to copy, free of charge and under the terms of this License, through a

     

       502
       502
       +
       publicly available network server or other readily accessible means,

     

       503
       503
       +
       then you must either (1) cause the Corresponding Source to be so

     

       504
       504
       +
       available, or (2) arrange to deprive yourself of the benefit of the

     

       505
       505
       +
       patent license for this particular work, or (3) arrange, in a manner

     

       506
       506
       +
       consistent with the requirements of this License, to extend the patent

     

       507
       507
       +
       license to downstream recipients.  "Knowingly relying" means you have

     

       508
       508
       +
       actual knowledge that, but for the patent license, your conveying the

     

       509
       509
       +
       covered work in a country, or your recipient's use of the covered work

     

       510
       510
       +
       in a country, would infringe one or more identifiable patents in that

     

       511
       511
       +
       country that you have reason to believe are valid.

     

       512
       512
       +
       

     

       513
       513
       +
         If, pursuant to or in connection with a single transaction or

     

       514
       514
       +
       arrangement, you convey, or propagate by procuring conveyance of, a

     

       515
       515
       +
       covered work, and grant a patent license to some of the parties

     

       516
       516
       +
       receiving the covered work authorizing them to use, propagate, modify

     

       517
       517
       +
       or convey a specific copy of the covered work, then the patent license

     

       518
       518
       +
       you grant is automatically extended to all recipients of the covered

     

       519
       519
       +
       work and works based on it.

     

       520
       520
       +
       

     

       521
       521
       +
         A patent license is "discriminatory" if it does not include within

     

       522
       522
       +
       the scope of its coverage, prohibits the exercise of, or is

     

       523
       523
       +
       conditioned on the non-exercise of one or more of the rights that are

     

       524
       524
       +
       specifically granted under this License.  You may not convey a covered

     

       525
       525
       +
       work if you are a party to an arrangement with a third party that is

     

       526
       526
       +
       in the business of distributing software, under which you make payment

     

       527
       527
       +
       to the third party based on the extent of your activity of conveying

     

       528
       528
       +
       the work, and under which the third party grants, to any of the

     

       529
       529
       +
       parties who would receive the covered work from you, a discriminatory

     

       530
       530
       +
       patent license (a) in connection with copies of the covered work

     

       531
       531
       +
       conveyed by you (or copies made from those copies), or (b) primarily

     

       532
       532
       +
       for and in connection with specific products or compilations that

     

       533
       533
       +
       contain the covered work, unless you entered into that arrangement,

     

       534
       534
       +
       or that patent license was granted, prior to 28 March 2007.

     

       535
       535
       +
       

     

       536
       536
       +
         Nothing in this License shall be construed as excluding or limiting

     

       537
       537
       +
       any implied license or other defenses to infringement that may

     

       538
       538
       +
       otherwise be available to you under applicable patent law.

     

       539
       539
       +
       

     

       540
       540
       +
         12. No Surrender of Others' Freedom.

     

       541
       541
       +
       

     

       542
       542
       +
         If conditions are imposed on you (whether by court order, agreement or

     

       543
       543
       +
       otherwise) that contradict the conditions of this License, they do not

     

       544
       544
       +
       excuse you from the conditions of this License.  If you cannot convey a

     

       545
       545
       +
       covered work so as to satisfy simultaneously your obligations under this

     

       546
       546
       +
       License and any other pertinent obligations, then as a consequence you may

     

       547
       547
       +
       not convey it at all.  For example, if you agree to terms that obligate you

     

       548
       548
       +
       to collect a royalty for further conveying from those to whom you convey

     

       549
       549
       +
       the Program, the only way you could satisfy both those terms and this

     

       550
       550
       +
       License would be to refrain entirely from conveying the Program.

     

       551
       551
       +
       

     

       552
       552
       +
         13. Use with the GNU Affero General Public License.

     

       553
       553
       +
       

     

       554
       554
       +
         Notwithstanding any other provision of this License, you have

     

       555
       555
       +
       permission to link or combine any covered work with a work licensed

     

       556
       556
       +
       under version 3 of the GNU Affero General Public License into a single

     

       557
       557
       +
       combined work, and to convey the resulting work.  The terms of this

     

       558
       558
       +
       License will continue to apply to the part which is the covered work,

     

       559
       559
       +
       but the special requirements of the GNU Affero General Public License,

     

       560
       560
       +
       section 13, concerning interaction through a network will apply to the

     

       561
       561
       +
       combination as such.

     

       562
       562
       +
       

     

       563
       563
       +
         14. Revised Versions of this License.

     

       564
       564
       +
       

     

       565
       565
       +
         The Free Software Foundation may publish revised and/or new versions of

     

       566
       566
       +
       the GNU General Public License from time to time.  Such new versions will

     

       567
       567
       +
       be similar in spirit to the present version, but may differ in detail to

     

       568
       568
       +
       address new problems or concerns.

     

       569
       569
       +
       

     

       570
       570
       +
         Each version is given a distinguishing version number.  If the

     

       571
       571
       +
       Program specifies that a certain numbered version of the GNU General

     

       572
       572
       +
       Public License "or any later version" applies to it, you have the

     

       573
       573
       +
       option of following the terms and conditions either of that numbered

     

       574
       574
       +
       version or of any later version published by the Free Software

     

       575
       575
       +
       Foundation.  If the Program does not specify a version number of the

     

       576
       576
       +
       GNU General Public License, you may choose any version ever published

     

       577
       577
       +
       by the Free Software Foundation.

     

       578
       578
       +
       

     

       579
       579
       +
         If the Program specifies that a proxy can decide which future

     

       580
       580
       +
       versions of the GNU General Public License can be used, that proxy's

     

       581
       581
       +
       public statement of acceptance of a version permanently authorizes you

     

       582
       582
       +
       to choose that version for the Program.

     

       583
       583
       +
       

     

       584
       584
       +
         Later license versions may give you additional or different

     

       585
       585
       +
       permissions.  However, no additional obligations are imposed on any

     

       586
       586
       +
       author or copyright holder as a result of your choosing to follow a

     

       587
       587
       +
       later version.

     

       588
       588
       +
       

     

       589
       589
       +
         15. Disclaimer of Warranty.

     

       590
       590
       +
       

     

       591
       591
       +
         THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY

     

       592
       592
       +
       APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT

     

       593
       593
       +
       HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY

     

       594
       594
       +
       OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,

     

       595
       595
       +
       THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

     

       596
       596
       +
       PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM

     

       597
       597
       +
       IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF

     

       598
       598
       +
       ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

     

       599
       599
       +
       

     

       600
       600
       +
         16. Limitation of Liability.

     

       601
       601
       +
       

     

       602
       602
       +
         IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING

     

       603
       603
       +
       WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS

     

       604
       604
       +
       THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY

     

       605
       605
       +
       GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE

     

       606
       606
       +
       USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF

     

       607
       607
       +
       DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD

     

       608
       608
       +
       PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),

     

       609
       609
       +
       EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF

     

       610
       610
       +
       SUCH DAMAGES.

     

       611
       611
       +
       

     

       612
       612
       +
         17. Interpretation of Sections 15 and 16.

     

       613
       613
       +
       

     

       614
       614
       +
         If the disclaimer of warranty and limitation of liability provided

     

       615
       615
       +
       above cannot be given local legal effect according to their terms,

     

       616
       616
       +
       reviewing courts shall apply local law that most closely approximates

     

       617
       617
       +
       an absolute waiver of all civil liability in connection with the

     

       618
       618
       +
       Program, unless a warranty or assumption of liability accompanies a

     

       619
       619
       +
       copy of the Program in return for a fee.

     

       620
       620
       +
       

     

       621
       621
       +
                            END OF TERMS AND CONDITIONS

     

       622
       622
       +
       

     

       623
       623
       +
                   How to Apply These Terms to Your New Programs

     

       624
       624
       +
       

     

       625
       625
       +
         If you develop a new program, and you want it to be of the greatest

     

       626
       626
       +
       possible use to the public, the best way to achieve this is to make it

     

       627
       627
       +
       free software which everyone can redistribute and change under these terms.

     

       628
       628
       +
       

     

       629
       629
       +
         To do so, attach the following notices to the program.  It is safest

     

       630
       630
       +
       to attach them to the start of each source file to most effectively

     

       631
       631
       +
       state the exclusion of warranty; and each file should have at least

     

       632
       632
       +
       the "copyright" line and a pointer to where the full notice is found.

     

       633
       633
       +
       

     

       634
       634
       +
           <one line to give the program's name and a brief idea of what it does.>

     

       635
       635
       +
           Copyright (C) <year>  <name of author>

     

       636
       636
       +
       

     

       637
       637
       +
           This program is free software: you can redistribute it and/or modify

     

       638
       638
       +
           it under the terms of the GNU General Public License as published by

     

       639
       639
       +
           the Free Software Foundation, either version 3 of the License, or

     

       640
       640
       +
           (at your option) any later version.

     

       641
       641
       +
       

     

       642
       642
       +
           This program is distributed in the hope that it will be useful,

     

       643
       643
       +
           but WITHOUT ANY WARRANTY; without even the implied warranty of

     

       644
       644
       +
           MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

     

       645
       645
       +
           GNU General Public License for more details.

     

       646
       646
       +
       

     

       647
       647
       +
           You should have received a copy of the GNU General Public License

     

       648
       648
       +
           along with this program.  If not, see <https://www.gnu.org/licenses/>.

     

       649
       649
       +
       

     

       650
       650
       +
       Also add information on how to contact you by electronic and paper mail.

     

       651
       651
       +
       

     

       652
       652
       +
         If the program does terminal interaction, make it output a short

     

       653
       653
       +
       notice like this when it starts in an interactive mode:

     

       654
       654
       +
       

     

       655
       655
       +
           <program>  Copyright (C) <year>  <name of author>

     

       656
       656
       +
           This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.

     

       657
       657
       +
           This is free software, and you are welcome to redistribute it

     

       658
       658
       +
           under certain conditions; type `show c' for details.

     

       659
       659
       +
       

     

       660
       660
       +
       The hypothetical commands `show w' and `show c' should show the appropriate

     

       661
       661
       +
       parts of the General Public License.  Of course, your program's commands

     

       662
       662
       +
       might be different; for a GUI interface, you would use an "about box".

     

       663
       663
       +
       

     

       664
       664
       +
         You should also get your employer (if you work as a programmer) or school,

     

       665
       665
       +
       if any, to sign a "copyright disclaimer" for the program, if necessary.

     

       666
       666
       +
       For more information on this, and how to apply and follow the GNU GPL, see

     

       667
       667
       +
       <https://www.gnu.org/licenses/>.

     

       668
       668
       +
       

     

       669
       669
       +
         The GNU General Public License does not permit incorporating your program

     

       670
       670
       +
       into proprietary programs.  If your program is a subroutine library, you

     

       671
       671
       +
       may consider it more useful to permit linking proprietary applications with

     

       672
       672
       +
       the library.  If this is what you want to do, use the GNU Lesser General

     

       673
       673
       +
       Public License instead of this License.  But first, please read

     

       674
       674
       +
       <https://www.gnu.org/licenses/why-not-lgpl.html>.

+16

license_header.txt

···

       1
       1
       +
       <one line to give the program's name and a brief idea of what it does.>

     

       2
       2
       +
       

     

       3
       3
       +
       Copyright (C) <year>  <name of author>

     

       4
       4
       +
       

     

       5
       5
       +
       This program is free software: you can redistribute it and/or modify

     

       6
       6
       +
       it under the terms of the GNU General Public License as published by

     

       7
       7
       +
       the Free Software Foundation, either version 3 of the License, or

     

       8
       8
       +
       (at your option) any later version.

     

       9
       9
       +
       

     

       10
       10
       +
       This program is distributed in the hope that it will be useful,

     

       11
       11
       +
       but WITHOUT ANY WARRANTY; without even the implied warranty of

     

       12
       12
       +
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

     

       13
       13
       +
       GNU General Public License for more details.

     

       14
       14
       +
       

     

       15
       15
       +
       You should have received a copy of the GNU General Public License

     

       16
       16
       +
       along with this program.  If not, see <https://www.gnu.org/licenses/>.

+32

plugin/build.gradle.kts

···

       1
       1
       +
       //import io.papermc.paperweight.userdev.ReobfArtifactConfiguration.Companion.MOJANG_PRODUCTION // paperweight

     

       2
       2
       +
       

     

       3
       3
       +
       plugins {

     

       4
       4
       +
           id("shadow-platform")

     

       5
       5
       +
           id("xyz.jpenilla.resource-factory-bukkit-convention") version "1.2.0"

     

       6
       6
       +
       //    id("xyz.jpenilla.resource-factory-paper-convention") version "1.2.0" // paper plugin

     

       7
       7
       +
           id("xyz.jpenilla.run-paper") version "2.3.1"

     

       8
       8
       +
       }

     

       9
       9
       +
       

     

       10
       10
       +
       //paperweight.reobfArtifactConfiguration = MOJANG_PRODUCTION // paperweight

     

       11
       11
       +
       

     

       12
       12
       +
       dependencies {

     

       13
       13
       +
       //    paperweight.paperDevBundle(libs.versions.paper.get()) // paperweight

     

       14
       14
       +
           compileOnly(libs.paper)

     

       15
       15
       +
           implementation(project(":${rootProject.name}-api"))

     

       16
       16
       +
       }

     

       17
       17
       +
       

     

       18
       18
       +
       tasks {

     

       19
       19
       +
           runServer {

     

       20
       20
       +
               minecraftVersion(libs.versions.paper.get().split("-R0.1-SNAPSHOT")[0])

     

       21
       21
       +
       

     

       22
       22
       +
               systemProperty("terminal.jline", false)

     

       23
       23
       +
               systemProperty("terminal.ansi", true)

     

       24
       24
       +
           }

     

       25
       25
       +
       }

     

       26
       26
       +
       

     

       27
       27
       +
       bukkitPluginYaml {

     

       28
       28
       +
           main = "${rootProject.group}.${rootProject.name}.TemplatePlugin"

     

       29
       29
       +
           name = rootProject.name

     

       30
       30
       +
           authors.add("somebody")

     

       31
       31
       +
           apiVersion = libs.versions.paper.get().split("-R0.1-SNAPSHOT")[0]

     

       32
       32
       +
       }

+25

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/biome/dark.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "carvers": [],

     

       3
       3
       +
           "downfall": 0,

     

       4
       4
       +
           "effects": {

     

       5
       5
       +
               "fog_color": 12638463,

     

       6
       6
       +
               "sky_color": 8103167,

     

       7
       7
       +
               "water_color": 4159204,

     

       8
       8
       +
               "water_fog_color": 329011

     

       9
       9
       +
           },

     

       10
       10
       +
           "features": [

     

       11
       11
       +
               [

     

       12
       12
       +
                   "checkerboard:under_floor"

     

       13
       13
       +
               ],

     

       14
       14
       +
               [

     

       15
       15
       +
                   "checkerboard:dark_square"

     

       16
       16
       +
               ],

     

       17
       17
       +
               [

     

       18
       18
       +
                   "checkerboard:over_floor"

     

       19
       19
       +
               ]

     

       20
       20
       +
           ],

     

       21
       21
       +
           "has_precipitation": false,

     

       22
       22
       +
           "spawn_costs": {},

     

       23
       23
       +
           "spawners": {},

     

       24
       24
       +
           "temperature": 0

     

       25
       25
       +
       }

+25

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/biome/light.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "carvers": [],

     

       3
       3
       +
           "downfall": 0,

     

       4
       4
       +
           "effects": {

     

       5
       5
       +
               "fog_color": 12638463,

     

       6
       6
       +
               "sky_color": 8103167,

     

       7
       7
       +
               "water_color": 4159204,

     

       8
       8
       +
               "water_fog_color": 329011

     

       9
       9
       +
           },

     

       10
       10
       +
           "features": [

     

       11
       11
       +
               [

     

       12
       12
       +
                   "checkerboard:under_floor"

     

       13
       13
       +
               ],

     

       14
       14
       +
               [

     

       15
       15
       +
                   "checkerboard:light_square"

     

       16
       16
       +
               ],

     

       17
       17
       +
               [

     

       18
       18
       +
                   "checkerboard:over_floor"

     

       19
       19
       +
               ]

     

       20
       20
       +
           ],

     

       21
       21
       +
           "has_precipitation": false,

     

       22
       22
       +
           "spawn_costs": {},

     

       23
       23
       +
           "spawners": {},

     

       24
       24
       +
           "temperature": 0

     

       25
       25
       +
       }

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/configured_feature/dark_square.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "type": "minecraft:fill_layer",

     

       3
       3
       +
           "config": {

     

       4
       4
       +
               "state": {

     

       5
       5
       +
                   "Name": "minecraft:lime_concrete"

     

       6
       6
       +
               },

     

       7
       7
       +
               "height": 62

     

       8
       8
       +
           }

     

       9
       9
       +
       }

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/configured_feature/light_square.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "type": "minecraft:fill_layer",

     

       3
       3
       +
           "config": {

     

       4
       4
       +
               "state": {

     

       5
       5
       +
                   "Name": "minecraft:lime_concrete_powder"

     

       6
       6
       +
               },

     

       7
       7
       +
               "height": 62

     

       8
       8
       +
           }

     

       9
       9
       +
       }

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/configured_feature/over_floor.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "type": "minecraft:fill_layer",

     

       3
       3
       +
           "config": {

     

       4
       4
       +
               "state": {

     

       5
       5
       +
                   "Name": "minecraft:lime_stained_glass"

     

       6
       6
       +
               },

     

       7
       7
       +
               "height": 63

     

       8
       8
       +
           }

     

       9
       9
       +
       }

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/configured_feature/under_floor.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "type": "minecraft:fill_layer",

     

       3
       3
       +
           "config": {

     

       4
       4
       +
               "state": {

     

       5
       5
       +
                   "Name": "minecraft:black_concrete"

     

       6
       6
       +
               },

     

       7
       7
       +
               "height": 61

     

       8
       8
       +
           }

     

       9
       9
       +
       }

+41

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/noise_settings/superflat.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "default_block": {

     

       3
       3
       +
               "Name": "minecraft:stone"

     

       4
       4
       +
           },

     

       5
       5
       +
           "default_fluid": {

     

       6
       6
       +
               "Name": "minecraft:water"

     

       7
       7
       +
           },

     

       8
       8
       +
           "sea_level": 0,

     

       9
       9
       +
           "disable_mob_generation": false,

     

       10
       10
       +
           "aquifers_enabled": false,

     

       11
       11
       +
           "ore_veins_enabled": false,

     

       12
       12
       +
           "legacy_random_source": false,

     

       13
       13
       +
           "noise": {

     

       14
       14
       +
               "min_y": 0,

     

       15
       15
       +
               "height": 256,

     

       16
       16
       +
               "size_horizontal": 1,

     

       17
       17
       +
               "size_vertical": 1

     

       18
       18
       +
           },

     

       19
       19
       +
           "noise_router": {

     

       20
       20
       +
               "barrier": 0,

     

       21
       21
       +
               "fluid_level_floodedness": 0,

     

       22
       22
       +
               "fluid_level_spread": 0,

     

       23
       23
       +
               "lava": 0,

     

       24
       24
       +
               "vein_toggle": 0,

     

       25
       25
       +
               "vein_ridged": 0,

     

       26
       26
       +
               "vein_gap": 0,

     

       27
       27
       +
               "temperature": 0,

     

       28
       28
       +
               "vegetation": 0,

     

       29
       29
       +
               "continents": 0,

     

       30
       30
       +
               "erosion": 0,

     

       31
       31
       +
               "depth": 0,

     

       32
       32
       +
               "ridges": 0,

     

       33
       33
       +
               "initial_density_without_jaggedness": 0,

     

       34
       34
       +
               "final_density": 0

     

       35
       35
       +
           },

     

       36
       36
       +
           "spawn_target": [],

     

       37
       37
       +
           "surface_rule": {

     

       38
       38
       +
               "type": "minecraft:sequence",

     

       39
       39
       +
               "sequence": []

     

       40
       40
       +
           }

     

       41
       41
       +
       }

+18

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/placed_feature/dark_square.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "feature": "checkerboard:dark_square",

     

       3
       3
       +
           "placement": [

     

       4
       4
       +
               {

     

       5
       5
       +
                   "type": "minecraft:random_offset",

     

       6
       6
       +
                   "xz_spread": 8,

     

       7
       7
       +
                   "y_spread": 0

     

       8
       8
       +
               },

     

       9
       9
       +
               {

     

       10
       10
       +
                   "type": "minecraft:biome"

     

       11
       11
       +
               },

     

       12
       12
       +
               {

     

       13
       13
       +
                   "type": "minecraft:random_offset",

     

       14
       14
       +
                   "xz_spread": -8,

     

       15
       15
       +
                   "y_spread": 0

     

       16
       16
       +
               }

     

       17
       17
       +
           ]

     

       18
       18
       +
       }

+18

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/placed_feature/light_square.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "feature": "checkerboard:light_square",

     

       3
       3
       +
           "placement": [

     

       4
       4
       +
               {

     

       5
       5
       +
                   "type": "minecraft:random_offset",

     

       6
       6
       +
                   "xz_spread": 8,

     

       7
       7
       +
                   "y_spread": 0

     

       8
       8
       +
               },

     

       9
       9
       +
               {

     

       10
       10
       +
                   "type": "minecraft:biome"

     

       11
       11
       +
               },

     

       12
       12
       +
               {

     

       13
       13
       +
                   "type": "minecraft:random_offset",

     

       14
       14
       +
                   "xz_spread": -8,

     

       15
       15
       +
                   "y_spread": 0

     

       16
       16
       +
               }

     

       17
       17
       +
           ]

     

       18
       18
       +
       }

+18

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/placed_feature/over_floor.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "feature": "checkerboard:over_floor",

     

       3
       3
       +
           "placement": [

     

       4
       4
       +
               {

     

       5
       5
       +
                   "type": "minecraft:random_offset",

     

       6
       6
       +
                   "xz_spread": 8,

     

       7
       7
       +
                   "y_spread": 0

     

       8
       8
       +
               },

     

       9
       9
       +
               {

     

       10
       10
       +
                   "type": "minecraft:biome"

     

       11
       11
       +
               },

     

       12
       12
       +
               {

     

       13
       13
       +
                   "type": "minecraft:random_offset",

     

       14
       14
       +
                   "xz_spread": -8,

     

       15
       15
       +
                   "y_spread": 0

     

       16
       16
       +
               }

     

       17
       17
       +
           ]

     

       18
       18
       +
       }

+18

plugin/run/world/datapacks/checkerboard/data/checkerboard/worldgen/placed_feature/under_floor.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "feature": "checkerboard:under_floor",

     

       3
       3
       +
           "placement": [

     

       4
       4
       +
               {

     

       5
       5
       +
                   "type": "minecraft:random_offset",

     

       6
       6
       +
                   "xz_spread": 8,

     

       7
       7
       +
                   "y_spread": 0

     

       8
       8
       +
               },

     

       9
       9
       +
               {

     

       10
       10
       +
                   "type": "minecraft:biome"

     

       11
       11
       +
               },

     

       12
       12
       +
               {

     

       13
       13
       +
                   "type": "minecraft:random_offset",

     

       14
       14
       +
                   "xz_spread": -8,

     

       15
       15
       +
                   "y_spread": 0

     

       16
       16
       +
               }

     

       17
       17
       +
           ]

     

       18
       18
       +
       }

+15

plugin/run/world/datapacks/checkerboard/data/minecraft/dimension/overworld.json

···

       1
       1
       +
       {

     

       2
       2
       +
           "type": "minecraft:overworld",

     

       3
       3
       +
           "generator": {

     

       4
       4
       +
               "type": "minecraft:noise",

     

       5
       5
       +
               "settings": "checkerboard:superflat",

     

       6
       6
       +
               "biome_source": {

     

       7
       7
       +
                   "type": "minecraft:checkerboard",

     

       8
       8
       +
                   "scale": 0,

     

       9
       9
       +
                   "biomes": [

     

       10
       10
       +
                       "checkerboard:light",

     

       11
       11
       +
                       "checkerboard:dark"

     

       12
       12
       +
                   ]

     

       13
       13
       +
               }

     

       14
       14
       +
           }

     

       15
       15
       +
       }

+11

plugin/run/world/datapacks/checkerboard/pack.mcmeta

···

       1
       1
       +
       {

     

       2
       2
       +
       	"pack": {

     

       3
       3
       +
       		"description": [

     

       4
       4
       +
       			{

     

       5
       5
       +
       				"text": "checkerboard world gen",

     

       6
       6
       +
       				"color": "gray"

     

       7
       7
       +
       			}

     

       8
       8
       +
       		],

     

       9
       9
       +
       		"pack_format": 61

     

       10
       10
       +
       	}

     

       11
       11
       +
       }

+32

plugin/src/main/java/com/example/template/TemplatePlugin.java

···

       1
       1
       +
       /*

     

       2
       2
       +
        * <one line to give the program's name and a brief idea of what it does.>

     

       3
       3
       +
        *

     

       4
       4
       +
        * Copyright (C) <year>  <name of author>

     

       5
       5
       +
        *

     

       6
       6
       +
        * This program is free software: you can redistribute it and/or modify

     

       7
       7
       +
        * it under the terms of the GNU General Public License as published by

     

       8
       8
       +
        * the Free Software Foundation, either version 3 of the License, or

     

       9
       9
       +
        * (at your option) any later version.

     

       10
       10
       +
        *

     

       11
       11
       +
        * This program is distributed in the hope that it will be useful,

     

       12
       12
       +
        * but WITHOUT ANY WARRANTY; without even the implied warranty of

     

       13
       13
       +
        * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

     

       14
       14
       +
        * GNU General Public License for more details.

     

       15
       15
       +
        *

     

       16
       16
       +
        * You should have received a copy of the GNU General Public License

     

       17
       17
       +
        * along with this program.  If not, see <https://www.gnu.org/licenses/>.

     

       18
       18
       +
        */

     

       19
       19
       +
       package com.example.template;

     

       20
       20
       +
       

     

       21
       21
       +
       import org.bukkit.plugin.java.JavaPlugin;

     

       22
       22
       +
       import org.jspecify.annotations.NullMarked;

     

       23
       23
       +
       

     

       24
       24
       +
       @NullMarked

     

       25
       25
       +
       public final class TemplatePlugin extends JavaPlugin {

     

       26
       26
       +
       

     

       27
       27
       +
           @Override

     

       28
       28
       +
           public void onEnable() {

     

       29
       29
       +
               getSLF4JLogger().info("Hello World!");

     

       30
       30
       +
           }

     

       31
       31
       +
       

     

       32
       32
       +
       }

+24

readme.md

···

       1
       1
       +
       # template

     

       2
       2
       +
       

     

       3
       3
       +
       Template to easily create Bukkit plugins for [paper](https://github.com/PaperMC/Paper). It is pretty

     

       4
       4
       +
       heavily inspired by [Carbon](https://github.com/Hexaoxide/Carbon)'s project layout.

     

       5
       5
       +
       This template was made as a personal convenience; I don't have any interest in providing support for

     

       6
       6
       +
       usage, but PR's are welcome. :)

     

       7
       7
       +
       

     

       8
       8
       +
       ## Assumptions

     

       9
       9
       +
       

     

       10
       10
       +
       This template makes a few assumptions based solely on my personal preference:

     

       11
       11
       +
       - Licensed under the [GPL](license.txt).

     

       12
       12
       +
       - Shades jpenilla's [gremlin](https://github.com/jpenilla/gremlin-gradle).

     

       13
       13
       +
       - Replaces the overworld on the test server with a custom generated checkerboard pattern (see [the datapack](plugin/run/world/datapacks/checkerboard))

     

       14
       14
       +
       

     

       15
       15
       +
       ### Checkstyle

     

       16
       16
       +
       

     

       17
       17
       +
       This template uses (a fork of) checkstyle to ensure code style is consistent across the entire project.  

     

       18
       18
       +
       For checkstyle support in IDEA:

     

       19
       19
       +
       

     

       20
       20
       +
       1. Install the [checkstyle plugin](https://github.com/jshiell/checkstyle-idea).

     

       21
       21
       +
       2. Compile https://gitlab.com/stellardrift/stylecheck

     

       22
       22
       +
       3. `Settings` -> `Tools` -> `Checkstyle` `Third-Party Checks`, add the compiled stylecheck jar

     

       23
       23
       +
       4. While still in the `Checkstyle` tab, go to `Configuration File`, add `.checkstyle/checkstyle.xml`

     

       24
       24
       +
          and tick the check-box.

+29

settings.gradle.kts

···

       1
       1
       +
       dependencyResolutionManagement {

     

       2
       2
       +
           repositories {

     

       3
       3
       +
               mavenCentral()

     

       4
       4
       +
       

     

       5
       5
       +
               maven {

     

       6
       6
       +
                   name = "papermc"

     

       7
       7
       +
                   url = uri("https://repo.papermc.io/repository/maven-public/")

     

       8
       8
       +
               }

     

       9
       9
       +
           }

     

       10
       10
       +
       }

     

       11
       11
       +
       

     

       12
       12
       +
       pluginManagement {

     

       13
       13
       +
           repositories {

     

       14
       14
       +
               gradlePluginPortal()

     

       15
       15
       +
               maven("https://repo.papermc.io/repository/maven-public/")

     

       16
       16
       +
           }

     

       17
       17
       +
           includeBuild("build-logic")

     

       18
       18
       +
       }

     

       19
       19
       +
       

     

       20
       20
       +
       plugins {

     

       21
       21
       +
           id("org.gradle.toolchains.foojay-resolver-convention") version "0.8.0"

     

       22
       22
       +
       }

     

       23
       23
       +
       

     

       24
       24
       +
       rootProject.name = "template"

     

       25
       25
       +
       

     

       26
       26
       +
       sequenceOf("plugin", "api").forEach {

     

       27
       27
       +
           include("${rootProject.name}-$it")

     

       28
       28
       +
           project(":${rootProject.name}-$it").projectDir = file(it)

     

       29
       29
       +
       }