Repository navigation
0.6.0
Programs that aren't Spigot plugins can now persist their installation ID: Builder.installIdFile(File). The file is resolved only after every opt-out check.
- How the file is read: its first line matching
[A-Za-z0-9_.-]{1,255}is the ID. When the file is missing or has no such line, a random UUID is written to it, creating parent directories as needed. - Failures never throw: if the file exists but can't be read, an in-memory ID is used and the file is left untouched. If the write fails, an in-memory ID is used.
- Precedence: explicit
installId(...), theninstallIdFile(...), then the server-wideserver-id:(Spigot). - Static helper:
TraceClient.installIdFromFile(File)does the same load-or-create step. Called directly, it writes even when reporting is off, so prefer the builder option.
Brings the Java client to parity with python 0.4.0, js 0.4.0, csharp 0.3.0 and cpp 0.3.0.
drafted by Claude on behalf of Daniel Stephenson