Skip to content

Telemetry Notice

Jump to bottom
ExoHayvan edited this page Jul 19, 2026 · 5 revisions

Telemetry Notice

Dissolver Enhanced uses optional telemetry to identify mod-specific errors, understand compatibility across supported games and loaders, and guide improvements to the mod.

Note: Telemetry is not required for gameplay, but we strongly recommend leaving it enabled. It helps us find issues sooner, verify fixes across game versions and loaders, and ship improvements with better confidence.

At a glance

Question Answer
Is telemetry enabled by default? Yes. It can be disabled at any time with analytics_enabled=false.
Is it anonymous? It is pseudonymous, not anonymous. The mod creates a random installation ID and a separate random session ID for each run.
Is it tied to an account or in-game identity? No. The mod does not use a Minecraft UUID, Minecraft username, Stardew Valley account ID, player name, save name, server name, or server address as its telemetry identifier.
Does it collect IP addresses? The mod does not intentionally send an IP address as an event property. As with any HTTPS request, PostHog and network providers may process connection metadata such as IP addresses under their own service operations.
Is it sold or used for advertising? No. We do not sell telemetry data or use it for advertising. It exists solely to diagnose issues, validate compatibility, and improve Dissolver Enhanced.
Does disabling it affect gameplay? No. Disabling telemetry does not disable any gameplay feature.

What is collected

Common (all versions of the mod)

  • Mod, game, and loader information: the Dissolver Enhanced mod ID and version, game version, loader name, and loader version. This helps us identify affected releases and compatibility patterns.
  • Runtime information: whether the mod is running on a client or dedicated server, the operating-system name, and Java or .NET runtime version.
  • Random installation and session IDs: a locally generated random installation ID (analytics-instance-id.txt) is used as the PostHog distinct_id; a fresh random session ID is created for each mod run. These IDs are not derived from player accounts or in-game identities.
  • Lifecycle events: session_started, mod_started, and config_loaded are sent at startup; session_ended is sent during a clean shutdown; a heartbeat is sent about once per minute while the mod is active.
  • Dissolver Enhanced configuration state: HUD EMC display, private/shared EMC mode, creative-item handling, difficulty, balance mode, and counts of EMC override entries. The mod does not upload the contents of EMC override files.
  • Mod-related error reports: when an error has a Dissolver Enhanced code frame, the mod can send its exception type, message, handled state, fingerprint, cause chain, and stack-trace details such as module/class names, methods, source filenames, and line numbers when available.

Error-reporting note: Exception messages and stack traces can sometimes contain information supplied by other software, mods, or the local environment. Errors without a Dissolver Enhanced code frame are not sent by this error reporter.

Minecraft

This covers Fabric 1.21.x, Fabric 26.1.x, Forge 1.20.x, NeoForge 1.21.x, and Quilt 1.21.x.

  • Client heartbeat data: menu versus in-world state, single-player versus multiplayer mode, game mode, dimension/registry key, current EMC total, and number of learned/stored items.
  • Dedicated-server heartbeat data: player count, shared/private EMC storage mode, aggregate EMC total, and aggregate stored-item count. The mod does not send server name, server address, player names, or player UUIDs in these heartbeats.
  • Block-use events: use of the Dissolver, Condenser, or Materializer block, including the block type.
  • Item events: when an item is learned, dissolved, extracted, or rejected. These include item namespace, item name and ID, stack count, individual and total EMC value, creative-item flag, and a rejection reason where relevant.
  • Progression events: the relevant Dissolver Enhanced criterion and progress values, such as an item ID, EMC value, learned-item count, or EMC-orb action.

The gameplay event categories are aligned across loaders. Fabric 26.1.x does not include connected_players in its server heartbeat, and Quilt does not implement the hidden internal-tester marker used by the other Minecraft builds.

Stardew Valley

This covers the Stardew Valley SMAPI build.

  • Heartbeat data: the client runtime and generic Stardew Valley state. The mod does not send a Stardew Valley account ID, farmer name, save name, farm name, or location identifier.
  • Configuration state: the same Dissolver Enhanced settings listed in the common section. The current Stardew Valley build reports zero EMC override counts because it does not populate those fields.
  • Dissolver UI events: opening the Dissolver UI from a placed Dissolver object.
  • Item events: when an item is learned, dissolved, extracted, or rejected. These include namespace, item name, qualified item ID, display name when available, stack count, EMC values, creative/debug-item flag, and a rejection reason where relevant.

Item-name note: An item display name is game or mod content rather than an account name. However, custom or third-party item content can contain text chosen by a player or another mod, so it should not be treated as guaranteed free of user-supplied text.

The shared Stardew analytics component includes an achievement-event method, but the current SMAPI build does not invoke it.

Where telemetry is stored and who can access it

Telemetry is sent over HTTPS to the Dissolver Enhanced PostHog Cloud project at the United States PostHog endpoint. The mod does not operate a separate telemetry database, and the source code does not set a retention interval.

The PostHog project's data-retention configuration, actual access list, contractual data-processing terms, and downstream sharing policy are operational settings that are not contained in this repository. The only third-party telemetry recipient evidenced by the mod code is PostHog Cloud. The reviewed code contains no integration with advertising networks or another analytics service.

Disable telemetry

Set the following property to false, then restart the game or server:

analytics_enabled=false

Minecraft normally stores this in the game instance or server configuration directory:

config/dissolver-enhanced/dissolver_enhanced.properties

Stardew Valley stores this in:

<Stardew Valley Mods>/Dissolver Enhanced/config/dissolver-enhanced/dissolver_enhanced.properties

When disabled, the mod does not initialize the PostHog client, create an installation or session ID, send events, run heartbeat timers, or report errors. Gameplay continues normally.

Deletion requests

The current source code has no deletion-request workflow, published private contact channel, or remote deletion routine. It therefore cannot promise a deletion service from the implementation alone.

For immediate local control, set analytics_enabled=false. You may also remove analytics-instance-id.txt to prevent future enabled telemetry from using the prior installation ID. Neither action deletes events that PostHog already received.

Before publishing a deletion process, the project owner should provide a private contact route and document the expected handling period. A deletion request should provide the value from analytics-instance-id.txt only through that private route, never in a public GitHub issue.

Clone this wiki locally