Connect Discover: add searchable discovery and one-click join to the mod

[robinbraemer]

Human need

Players with Connect Share installed should be able to discover a compatible public server and join it without leaving Minecraft, decoding addresses, or learning Connect terminology.

Outcome

Add an accessible Discover experience to the Connect Share mod backed exclusively by the canonical public directory API.

Experience

• A clear Discover entry from the multiplayer/social surfaces without replacing vanilla saved servers.
• Immediate search, useful fixed filters, online/freshness state, compatibility, favorite/save, recently joined, and one primary Join action.
• Details show verified address, description/media, editions, supported versions, loader/modpack requirements, authentication expectations, resource-pack requirements, categories, language, public vote/rank aggregates, and report action.
• Preflight identifies known incompatibility before connecting and offers an actionable install/update path where possible.
• Deep links can open a listing or join intent, but admission and confirmation rules remain intact.
• Failure copy distinguishes directory/API outage, stale/offline endpoint, incompatible client, endpoint rejection, direct-path failure, and Connect fallback failure.

Privacy and resilience

• Never upload the player's vanilla server list, favorites, recent joins, friend graph, identity, or search history unless a separate consented sync feature is designed.
• Local favorites/recent history have clear deletion controls.
• Cache only published public records and honor delisting/moderation expiry.
• API outage leaves vanilla multiplayer and existing saved/friend joins usable.
• Directory calls must not block the render/client thread.

Acceptance criteria

• Search, filters, pagination, detail, favorite, report, join, empty, loading, stale, offline, incompatible, delisted, rate-limited, and offline-cache states have deterministic UI tests.
• Keyboard-only, screen-reader narration, controller where supported, localization expansion, reduced motion, and common resolutions are verified.
• A compatible listing joins with one intentional action and reuses the existing direct/Connect transport policy without changing endpoint admission.
• Incompatible version/loader/modpack cases fail before network join with a useful explanation and next action.
• A private or unpublished endpoint cannot be surfaced through cache, slug guessing, deep link, or stale search results.
• API latency/failure never freezes Minecraft or breaks vanilla multiplayer.
• E2E covers a real published Java endpoint, Bedrock-capable metadata, offline transition, moderation removal, unpublish, and API-version skew.
• Product telemetry measures privacy-safe search-to-detail and detail-to-join outcomes without recording raw queries or player identity by default.

Non-goals

• Replacing the vanilla saved-server list.
• Exposing friend-only worlds through public discovery.
• Adding a proprietary mod-only listing source.