Ponder is a Java/Kotlin library that contains a collection of modules to assist with the development of Minecraft plugins. It provides utilities for Bukkit/Spigot plugins (distance calculations, plugin helpers), a caching system, and a command abstraction layer.
Add the DansPlugins repository and the desired module(s) to your pom.xml:
<repository>
<id>dansplugins.com</id>
<url>https://repo.dansplugins.com/repository/maven-public/</url>
</repository><dependency>
<groupId>com.dansplugins</groupId>
<artifactId>ponder-bukkit</artifactId>
<version>3.0.0-SNAPSHOT-8-8-2026</version>
</dependency>
<dependency>
<groupId>com.dansplugins</groupId>
<artifactId>ponder-cache</artifactId>
<version>3.0.0-SNAPSHOT-8-8-2026</version>
</dependency>
<dependency>
<groupId>com.dansplugins</groupId>
<artifactId>ponder-commands</artifactId>
<version>3.0.0-SNAPSHOT-8-8-2026</version>
</dependency>Packages are also available via GitHub Packages. Add the repository to your pom.xml:
<repository>
<id>github</id>
<url>https://maven.pkg.github.com/Dans-Plugins/Ponder</url>
</repository>Authenticate by adding your GitHub username and a personal access token with read:packages scope to ~/.m2/settings.xml:
<settings>
<servers>
<server>
<id>github</id>
<username>YOUR_GITHUB_USERNAME</username>
<password>YOUR_GITHUB_TOKEN</password>
</server>
</servers>
</settings>Add the repository and dependency to your build.gradle:
repositories {
maven {
url 'https://repo.dansplugins.com/repository/maven-public/'
}
}
dependencies {
implementation 'com.dansplugins:ponder-bukkit:3.0.0-SNAPSHOT-8-8-2026'
implementation 'com.dansplugins:ponder-cache:3.0.0-SNAPSHOT-8-8-2026'
implementation 'com.dansplugins:ponder-commands:3.0.0-SNAPSHOT-8-8-2026'
}repositories {
maven {
url = uri("https://maven.pkg.github.com/Dans-Plugins/Ponder")
credentials {
username = project.findProperty("gpr.user") ?: System.getenv("GITHUB_ACTOR")
password = project.findProperty("gpr.token") ?: System.getenv("GITHUB_TOKEN")
}
}
}Add your credentials to ~/.gradle/gradle.properties:
gpr.user=YOUR_GITHUB_USERNAME
gpr.token=YOUR_GITHUB_TOKEN- User Guide – Getting started and common usage scenarios
- API Reference – Overview of the public API provided by each module
- Configuration Guide – Configuration options for
ponder-cache
You can find the support Discord server here.
Please fill out a bug report here.
Linux:
./gradlew clean test
Windows:
.\gradlew.bat clean test
If you see BUILD SUCCESSFUL, the tests have passed.
Ponder is a library rather than a plugin, so it is exercised on a server through a plugin that depends on it. For manual integration testing, build the project, install the JARs into the dependent plugin's build, and run that plugin on a local Spigot server. No test server or hot-reloading tooling is provided by this repository.
./gradlew build
The compile.sh wrapper at the repository root runs ./gradlew clean build for a clean build.
The compiled JARs are placed in each module's build/libs/ directory.
| Name | Main Contributions |
|---|---|
| Daniel Stephenson | Creator |
| Callum | Methods in AbstractPluginCommand and ApplicationCommand; NMSAssistant; NMSVersion; ColorChecker; ColorConverter; EventHandlerRegistry improvements; UUIDChecker; ArgumentParser; ConfigurationFile |
| Pasarus | JsonWriterReader; UUIDChecker; Pair |
| Caibinus | BlockChecker |
| Deej | Javadocs setup |
| VoChiDanh | BlockChecker improvements; MaterialChecker |
| alyphen | Generified types; project restructure into modules; tests |
Have you made a contribution and don't see yourself above? Please add your name and open a PR!
This project is licensed under the MIT License.
You are free to use, modify, and distribute this software, provided that the original license and copyright notice are included in all copies or substantial portions of the software.
See the LICENSE file for the full text.
This project is in active development.
See CHANGELOG.md for a release-by-release summary of changes.