Skip to content

0.5.0

Choose a tag to compare

View all tags
@dmccoystephenson dmccoystephenson released this 03 Oct 20:33
· 5 commits to main since this release
0.5.0
628bde2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Every event now carries a random per-installation ID as the tag install, so the trace server can count distinct servers instead of raw events.

  • Spigot plugins: the ID is the server-id: line in plugins/trace/config.yml. The first enabled client that finds none generates a UUID.randomUUID() and appends it, under a comment explaining it; the rest of the file is left exactly as it was. If the file can't be written, the ID is kept in memory for that run only.
  • Other programs: pass an ID with Builder.installId(String). Without one, no install tag is sent.
  • Privacy: the ID is random and identifies no person, account or IP address. Delete the server-id: line to get a new one. Every opt-out (TRACE_USAGE_REPORTING=off, DO_NOT_TRACK=1, enabled: false) stops it: a disabled client never generates or writes an ID.
  • An event's own install tag wins, and install is not added to an event that already has 32 tags.
  • installId() returns the ID in use, or null.

Re-vendor TraceClient.java to pick it up. Nothing else about the API changes. Plugin READMEs should mention the ID in their Usage reporting section.

drafted by Claude on behalf of Daniel Stephenson

Assets 2
Loading