Skip to content

2.1.0

Choose a tag to compare

View all tags
@dmccoystephenson dmccoystephenson released this 02 Oct 02:20
v2.1.0
d47470a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

2.1.0

For a server running v2.0.0 this is a drop-in upgrade, and no configuration changes are needed. Herald now runs on Java 17 as well as newer versions, and declares support for Minecraft 1.19.4 and later. Usage reporting still sends the same small events with the same opt-outs. The difference is that every event now carries the plugin version, and you can add your own server-wide tags, such as marking a test server so its events are left out of real-installation figures.

Changes

Usage reporting

  • Every usage-reporting event is now tagged with the Herald version, not only the startup event (#65).
  • plugins/trace/config.yml now accepts an optional tags: block. Its tags are added to every event that plugins using trace report from this server, and a plugin's own tag of the same name wins. Invalid or unreadable entries are skipped without affecting reporting, and enabled: false still turns reporting off. Newly created copies of the file include a commented-out ci: "true" example. An existing file is never rewritten (#64).

Compatibility

  • Herald is now compiled for Java 17 instead of Java 21, so it loads on servers running Java 17 through 20. Supported Minecraft versions are declared as 1.19.4 through 26.2 (#63).

Version

v2.0.0 → 2.1.0 — MINOR. Mechanical floor from comparing the two jars: PATCH.
Judgment: Usage reporting now does more than before. Every event, not just startup, now carries the plugin version tag. The shared plugins/trace/config.yml file also accepts a new optional tags: block that is added to every report, and newly created copies of that file include a commented-out example. That is new behaviour and new data sent, which the mechanical check can't see. Nothing breaks for existing servers: the TraceClient builder signature change is internal to the plugin's own copy of trace-client, existing config files are left as they are, and compiling for Java 17 instead of 21 only widens the set of servers it runs on.

  • no interface or storage difference observed between the jars
Java API changes (informational — nothing depends on this plugin)
  • com.dansplugins.herald.trace.TraceClient: removed/changed public static com.dansplugins.herald.trace.TraceClient$Builder builder(java.lang.String, java.lang.String);
  • com.dansplugins.herald.trace.TraceClient: added public static com.dansplugins.herald.trace.TraceClient$Builder builder(java.lang.String, java.lang.String, java.lang.String);
  • com.dansplugins.herald.trace.TraceClient: added public static final java.lang.String VERSION;

Verification

Verified on a real Spigot server before publication; this release carries the exact jar that was verified.

  • boot gate run: booted twice on a fresh Spigot server running Minecraft 1.19.4 (11 assertions passed).
  • boot gate run: booted twice on a fresh Spigot server running Minecraft 1.21.11 (11 assertions passed).
  • boot gate run: booted twice on a fresh Spigot server running Minecraft 26.2 (11 assertions passed).

Install with Dan's Plugin Manager: /dpm get <plugin>. How stable releases are made: Release channels.

drafted by Claude on behalf of Daniel Stephenson

Assets 3
Loading