Summary
This is the rename release: the project moves from Paperwright to Plugwright. Everything that was named after the old project — the npm package, Gradle plugin ID, tasks, Kotlin package, and settings — has been renamed in a coordinated bump. Alongside the rebranding, this major release includes a new task to run the test server interactively, fixes for newer Minecraft versions, and significant CI/CD improvements with NPM provenance support.
Important
Breaking change. Existing users must update their package.json, build.gradle.kts, GitHub Actions CI, and any imports/task invocations. See Migration below.
Changes
Rename (Breaking)
- NPM package renamed:
@drownek/paperwright→@drownek/plugwright. - Gradle plugin ID renamed:
io.github.drownek.paperwright→io.github.drownek.plugwright. - Gradle tasks renamed:
paperwrightClean/paperwrightTest/paperwrightInit→plugwrightClean/plugwrightTest/plugwrightInit. - Kotlin package and classes renamed:
me.drownek.paperwright.PaperwrightPlugin→me.drownek.plugwright.PlugwrightPlugin(along withExtension,TestTask, etc.). - Environment Variables:
PAPERWRIGHT_DEBUGis nowPLUGWRIGHT_DEBUG.
Features
- New Task: Added the
plugwrightRunServerGradle task. This allows you to easily spin up the test server (with plugins and environment prepared) without running the automated test suite, which is extremely useful for manual debugging and GUI testing.
Bug Fixes
- Mineflayer & Formatting: Fixed text component parsing for newer Minecraft versions by updating the underlying
mineflayerdependency. - Server Downloads: Updated the Paper API integration to correctly allow downloading newer server versions.
- Test Stability: Fixed an issue where some test cases would fail on very slow machines.
Tooling & CI
- NPM Provenance: Moved to NPM trusted publishing. The packages are now signed with provenance using stable NPM versions.
- Release Automation: Improved the
bump-version.jsscript to target explicit tags, preventing push rejections, and optimized the release workflow.
Migration
In your plugin project:
build.gradle.kts
- id("io.github.drownek.paperwright") version "1.3.3"
+ id("io.github.drownek.plugwright") version "2.0.2"
- paperwright { ... }
+ plugwright { ... }Gradle task invocations
- ./gradlew paperwrightTest
- ./gradlew paperwrightInit
- ./gradlew paperwrightClean
+ ./gradlew plugwrightTest
+ ./gradlew plugwrightInit
+ ./gradlew plugwrightCleanpackage.json
- "@drownek/paperwright": "^1.3.3"
+ "@drownek/plugwright": "^2.0.2"Test Imports
- import { test, expect } from '@drownek/paperwright';
+ import { test, expect } from '@drownek/plugwright';GitHub Actions CI
- uses: drownek/paperwright-action@v1
+ uses: drownek/plugwright-action@v1