Współpraca

Jak budować plugin lokalnie (Java 25, gradle jar) i aktualizować Wiki — bez publicznego gita.

Kompatybilne z: GrzybcioRynek 1.0.3Minecraft 26.2Web 0.1.0

Na podstawie kodu GrzybcioRynek 1.0.3 i web 0.1.0.

Repozytorium jest lokalne. Współpraca = zmiana kodu na dysku, gradle jar, test na Paper 26.2, aktualizacja Wiki.

Plugin — budowa

Wymagania: JDK 25, Gradle lokalnie. Szczegóły: Build.

bash

cd PLugin
gradle jar

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

groovy

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

Zależności compileOnly: Paper API 26.2.build.+, VaultAPI 1.7, PlaceholderAPI 2.11.6, Lombok 1.18.46.

Licencja pluginu: Apache License 2.0 (PLugin/LICENSE). Strona/ i Wiki/ są private (odpowiednio 0.1.0 i 1.0.3).

Test lokalny

Skopiuj JAR do plugins/ na Paper 26.2, uruchom serwer.

text

/market admin selftest

Bez nicków spawnuje FakePlayer SellerBot / BuyerBot. Z nickami: /market admin selftest <seller> <buyer> — obaj muszą być online i różni.

Czego nie wymyślać

workflow GitHub Actions / CI w chmurze — nie ma;
HTTP API i webhooki — 🚧 Planned, niezaimplementowane;
messages.yml — komunikaty są w config.yml.

Wiki

Napisz / popraw Markdown w Wiki/content/ (frontmatter: title, description, keywords).
Dodaj stronę do Wiki/src/lib/navigation.ts, jeśli to nowy URL.
W katalogu Wiki/:

bash

npm run index

To node scripts/validate-docs.mjs — sprawdza, czy każdy href z nawigacji ma plik. Nie indeksuje treści pod wyszukiwarkę zewnętrzną.

Tylko fakty z kodu 1.0.3. HTTP oznaczaj jako 🚧 Planned.

Checklista zmiany w pluginie

Zgodnie z Dodawanie funkcji: model → persist → config → message → serwis → GUI (pamiętaj o zahardkodowanym pasku browse) → komenda + tab → permission z checkiem → opcjonalny event / PAPI → MarketSelfTest → Wiki + npm run index.