Contributing

How to build the plugin locally (Java 25, gradle jar) and update the Wiki — no public git.

Compatible with: GrzybcioRynek 1.0.3Minecraft 26.2Web 0.1.0

Based on GrzybcioRynek 1.0.3 and web 0.1.0 source.

The repository is local. Contributing means changing code on disk, gradle jar, testing on Paper 26.2, and updating the Wiki.

Plugin — build

Requirements: JDK 25, Gradle installed locally. Details: Build.

bash

cd PLugin
gradle jar

Output: PLugin/build/libs/GrzybcioRynek-1.0.3.jar (archiveBaseName = GrzybcioRynek, version = 1.0.3 in build.gradle).

groovy

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(25)
    }
}

compileOnly dependencies: Paper API 26.2.build.+, VaultAPI 1.7, PlaceholderAPI 2.11.6, Lombok 1.18.46.

Plugin license: Apache License 2.0 (PLugin/LICENSE). Strona/ and Wiki/ are private (0.1.0 and 1.0.3 respectively).

Local test

Copy the JAR to plugins/ on Paper 26.2, start the server.

text

/market admin selftest

Without names it spawns FakePlayer SellerBot / BuyerBot. With names: /market admin selftest <seller> <buyer> — both must be online and different.

Do not invent

GitHub Actions / cloud CI workflows — none;
HTTP API and webhooks — 🚧 Planned, not implemented;
messages.yml — messages live in config.yml.

Wiki

Write / fix Markdown under Wiki/content/ (frontmatter: title, description, keywords).
Add the page to Wiki/src/lib/navigation.ts if it is a new URL.
In the Wiki/ directory:

bash

npm run index

That runs node scripts/validate-docs.mjs — checks that every navigation href has a file. It does not index content for an external search engine.

Facts from code 1.0.3 only. Mark HTTP as 🚧 Planned.

Plugin change checklist

Per Adding features: model → persist → config → message → service → GUI (remember the hardcoded browse bar) → command + tab → permission with a real check → optional event / PAPI → MarketSelfTest → Wiki + npm run index.

Adding Features

Overview