Requirements

GrzybcioRynek 1.0.3 requirements — Paper 26.2, Java 25, Vault with an economy, optional hooks.

Compatible with: GrzybcioRynek 1.0.3Minecraft 26.2Web 0.1.0

Based on GrzybcioRynek 1.0.3 and web 0.1.0 source.

The plugin refuses to start if the server is not Paper 26.2 or there is no working Vault economy.

Tip

Admin: you need Paper 26.2, Vault, an economy, and the ready JAR — Installation.
Developer: JDK 25 + gradle jar — Build.

Server (runtime)

Requirement	Value	If missing
Engine	Paper 26.2	plugin disables
Minecraft	26.2	other versions are rejected
Vault + economy	required	plugin disables after retry

Building from source (developers only)

Requirement	Value
Java (toolchain)	25
Build	Gradle without a wrapper → Build

java

if (!isSupportedServerVersion()) {
    getLogger().severe("GrzybcioRynek działa TYLKO na Paper 26.2!");
    getLogger().severe("Wykryta wersja: " + describeServerVersion());
    Bukkit.getPluginManager().disablePlugin(this);
    return;
}

Version is detected via Paper ServerBuildInfo (brandVersion, minecraftVersionId) and Bukkit strings, among other things. Accepted tokens look like 26.2, 26.2-…, 26.2.… — not 26.20 / 26.21.

In paper-global.yml / the startup log it must be Paper 26.2. The plugin will disable on Spigot, Folia, and on Paper of another version.

Required plugins

yaml

depend: [Vault]
softdepend: [Nexo, Oraxen, PlaceholderAPI, Essentials]

Vault is a hard dependency. In addition, Vault must register Economy in ServicesManager. Vault alone without an economy plugin (e.g. EssentialsX Economy) is not enough.

Startup order:

Attempt VaultHook.setupEconomy().
If Vault is missing or Economy is missing — warning log and retry after 1 s (20 ticks), so late Essentials can finish.
Second failure → disablePlugin.

Warning

Essentials is a softdepend only for Vault timing. The code does not call the Essentials API. The economy must be registered in Vault (EssentialsX Economy is a typical example).

Optional hooks

Plugin	In `plugin.yml`	What it provides
Nexo	`softdepend`	custom item ID on the listing; restore when the saved stack is AIR
Oraxen	`softdepend`	the same for Oraxen
PlaceholderAPI	`softdepend`	expansion `grybciorynek` (8 placeholders, 20-tick cache)
Essentials	`softdepend`	load order for Vault Economy only

Without Nexo / Oraxen / PAPI the plugin still works — custom items are then just the saved ItemStack.

What you do not need

An HTTP server, Node, or Strona/ — the mock website is not connected.

Minimum production set

Paper 26.2, Java 25.
Vault.
An economy plugin visible in Vault (deposits by UUID).
GrzybcioRynek-1.0.3.jar.

Optionally: Nexo and/or Oraxen, PlaceholderAPI.

Architecture

Installation