[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
de.eldoria.util:plugin	3.0.2 → 3.7.0

---

Warning

Some dependencies could not be looked up. Check the Dependency Dashboard for more information.

---

Release Notes

eldoriarpg/eldo-util (de.eldoria.util:plugin)

v3.7.0: 3.7.0

eldo-util 3.7.0

Plugins can now read the Lyna licence key their jar was handed out with, locale files reload without a restart, and update notices reach the right people by default.

Before updating

• Update permission named after the plugin: the default update notice permission is now <plugin>.updates (for example pickmeup.updates) instead of eldoutilities.admin. Declare it in your plugin descriptor with default: op; admins who granted eldoutilities.admin for update notices grant the new node instead.

Features

• Lyna licence key: LynaLicense.of(plugin) reads the key Lyna or BuiltByBit wrote into the jar, from lynaLicense in the build data (publishdata's buildData { lynaLicense() }). Its state says whether the jar carries a key, still holds the placeholder, or BuiltByBit could not get one. Debug reports show the state, never the key.
• Reloading translations: Localizer#reload() reads the locale files again, so edited texts and new language files apply without a restart.
• Keeping files out of debug reports: JacksonConfig#excludeFromDebug(key) and ConfigFiles.exclude(plugin, path) leave a configuration file out of the report entirely.

Improvements

• Update notices on join by default: players with the update permission and operators get the notice when they join, unless notifyUpdate(false) is set. The console always gets it.
• Default language for players: without setUserLocale, players get the default language, like the console.
• About text: the website line of the built-in about text is labelled Website:.
• Queue time limits: a time limit above 50 ms is cut to 50 ms with a warning in the log instead of silently.
• Docs: decimal replacements are documented to follow the server locale, and the updates page explains the licence key, a licence command and Lyna's claim link.

Developer notes

• New: de.eldoria.eldoutilities.debug.LynaLicense, DefaultProperties.LYNA_LICENSE, Localizer#reload(), JacksonConfig#excludeFromDebug, ConfigFiles.exclude.
• UpdateDataBuilder defaults changed: notifyPermission is <plugin>.updates, notifyUpdate is true. Pass your own values to keep the old behaviour.

v3.6.0: 3.6.0

eldo-util 3.6.0

Commands finally let the right senders through, translations stay the way plugins wrote them, and the failsafe mode behaves when a plugin fails to start. eldo-util also has proper docs now, a full guide for plugin developers on docs.eldoria.de.

Before updating

• Failsafe command permission: the debug command of the failsafe mode needs <plugin>.debug or eldoutilities.debug. It used the plugin's full name with its version before.
• plugin no longer brings configuration: plugins that use the legacy configuration module have to declare it themselves.

Improvements

• Docs: a guide for plugin developers at docs.eldoria.de/eldo-util: setup, commands, messages, localization, configuration, updates, debugging and threading, plus the Javadoc.
• Unexpected command errors are logged instead of being passed to the server.
• Missing locale keys: the warning says where the key was looked for.
• Player completion keeps the most recently seen players.
• Legacy code is deprecated for removal in 4.0: crossversion, the legacy configuration, conversation and the Spigot updater.

Bugfixes

• allowPlayer(), allowConsole() and allowCommandSender() locked out everyone: players and the console are accepted again.
• The sender assertion was inverted: it passes for the right senders.
• Misspelled locale keys (error.unkownPlayer, error.unkownWorld, error.invalidBoolen, error.tooLow) use the correct spelling. The old keys keep working, and locale files carry their translations over.
• Translations given to the builder were overwritten by the built-in English texts.
• MessageSenderBuilder.localizer(...) takes effect.
• Invalid enum values list the valid ones again, and split arguments are no longer duplicated.
• completeOnlinePlayers completes only online players.
• Failsafe mode registers its commands once, starts on enable after a failed load, and no longer crashes on disable.
• Build data is read when the plugin jar can't be found, and duplicate keys in build.data no longer crash.

Developer notes

• Published to EldoNexus only (maven-releases and maven-snapshots); Maven Central stays at 2.2.0. Every push to main publishes a -SNAPSHOT.
• Built with Java 25 for Java 21. Licence is LGPL-3.0-or-later, as the source headers always said.
• The root artifact de.eldoria.util:eldo-util now contains every module, including jackson-configuration and conversation, and its javadoc jar holds the full Javadoc.
• Coordinates and package names are unchanged.

v3.5.5: 3.5.5

eldo-util 3.5.5

Plugins built on eldo-util can now ship as Paper plugins with a paper-plugin.yml: their commands are registered through Paper, and failsafe mode answers there too.

Features

• Commands for Paper plugins: EldoPlugin.registerCommand registers a command through Paper when the plugin's descriptor does not declare it, which is always the case for a paper-plugin.yml. Commands declared in a plugin.yml work as before.
• Failsafe mode for Paper plugins: when such a plugin fails to enable, the failsafe command answers under the lower case plugin name.

Developer notes

• No new methods: registerCommand(AdvancedCommand), registerCommand(String, AdvancedCommand) and registerCommand(String, TabExecutor) pick the way by the descriptor. Call them from onPluginEnable; Paper only accepts commands while the plugin enables.
• Aliases come from the command's CommandMeta (CommandMetaBuilder.addAlias). With a paper-plugin.yml there are no aliases in the descriptor anymore. The TabExecutor overload registers without aliases.
• Paper plugins must not call getCommand while they start; eldo-util no longer does for commands missing from the descriptor.

v3.5.4: 3.5.4

eldo-util 3.5.4

A small one: the permissions of the debug command and the update notice are finally spelled right.

Before updating

• Renamed permissions: eldoutilitites.debug is now eldoutilities.debug and eldoutilitites.admin is now eldoutilities.admin. Grant the new names where you granted the old ones.

Bugfixes

• Misspelled permission nodes: the default debug and update notice permissions use the correct eldoutilities. prefix.

Developer notes

• DefaultDebug and UpdateDataBuilder default to the corrected nodes. Plugins passing their own permissions are not affected. No other API changes.

v3.5.2: 3.5.2

eldo-util 3.5.2

Patch release for jackson-configuration.

Fixes

• Configs load on every start: ocular is updated to 2.3.1. With 2.3.0, a plugin failed on its second start with an InaccessibleObjectException while applying config overrides.

Upgrading

• Bump eldo-util to 3.5.2. No API changes.
• Plugins that pinned dev.chojo:ocular:2.3.1 themselves can drop the pin.

v3.5.1: 3.5.1

eldo-util 3.5.1

Patch release for jackson-configuration. Every plugin that uses PluginBaseConfiguration should update.

Fixes

• DEBUG log level survives a restart: logLevel: DEBUG is mapped to Level.CONFIG and saved as CONFIG. On the next start, CONFIG was not recognised and the level fell back to INFO. CONFIG is now read back as CONFIG, so the setting persists.

Upgrading

• Bump eldo-util to 3.5.1. No API changes.
• Configs already rewritten to INFO by the bug stay at INFO. Set logLevel: DEBUG once more where it is wanted.

v3.5.0: 3.5.0

eldo-util 3.5.0

Highlights

• Lyna product id from the build: LynaUpdateData.builder(plugin) reads the product id from lynaProduct in the plugin's build.data, so the id lives in one place.

publishData {
    buildData {
        put("lynaProduct", "8")
    }
}

• Update notices link to Lyna: without updateUrl(...), the Lyna update notice links to the product page, e.g. https://lyna.eldoria.de/products/8, instead of the plugin's website.
• The default Lyna notice reads "Download the new version: " and no longer mentions Discord.

v3.4.0: 3.4.0

eldo-util 3.4.0

Highlights

• Major updates need a confirmation: a new major version is never installed automatically. Its update notice, in the console and on join, warns that it may not be compatible, and the download button asks to confirm before downloading (download confirm).
• Updater#isMajorUpdate() tells whether the found update is a new major version. The Lyna updater compares the major versions; other updaters report none.

v3.3.0: 3.3.0

eldo-util 3.3.0

Highlights

• Auto update stays within the major version: the Lyna updater installs stable releases automatically only when they share the installed major version. A new major version may break compatibility, so it is announced and offered for download instead.

v3.2.0: 3.2.0

eldo-util 3.2.0

Highlights

• Raw command arguments: Arguments#raw() returns the arguments exactly as typed, including flags and everything after the first flag-like word. The parsed arguments still end at the first flag; use raw() to read input that contains words such as -incair as plain text.

var expression = String.join(" ", args.raw());

v3.1.0: 3.1.0

eldo-util 3.1.0

Highlights

• Charts in debug reports: debug providers can return charts with getCharts(). Lyna draws them in a Charts tab of the debug report.

@Override
public @NotNull List<ChartData<?>> getCharts() {
    return List.of(
            SeriesChart.line("Render time").series("render", timings).unit("ms").mark(25, "budget"),
            CategoryChart.pie("Storage").value("yaml", 12).value("mysql", 3),
            GaugeChart.gauge("Cache usage", 42));
}

• Each chart type has its own class in de.eldoria.eldoutilities.debug.data.chart: SeriesChart (line, area, bar, stacked bar), ScatterChart, CategoryChart (bar, pie, donut), HeatmapChart and GaugeChart. ChartData.of(name, ChartType, data) sends loosely typed data for any ChartType.
• Every text in a chart passes the report filter, like the rest of the report.

Notes

• Charts need a Lyna version that knows them; older ones refuse reports holding charts.
• DebugReport.Snapshot and DebugReport.Section gained a component. Code constructing them directly needs updating.

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.