Eve library

@v2/message-of-the-day-service

Other

Revision 1

On this page

V2 live-ops message-of-the-day service to push announcements to the shipped game client without a client patch. The package validates authored messages, filters active windows, applies client targeting, preserves per-account dismissal, and emits compact client payloads for events, downtime, and patch notes.

Announcement types:

  • event
  • downtime
  • patch-notes

Primary API:

  • buildV2MessageOfTheDayServiceSurface
  • resolveV2MessageOfTheDayForClient

The service exposes these live-ops endpoints as contract metadata:

  • GET /v2/live-ops/motd/{environment}
  • POST /v2/live-ops/motd/{environment}/messages
  • POST /v2/live-ops/motd/{environment}/messages/{messageId}/publish

Client Payload#

buildV2MessageOfTheDayServiceSurface creates a versioned MOTD surface with active announcements ordered by priority and start time. The payload sets pushAnnouncements: true, includes an ETag, carries announcementCount, and keeps requiresClientPatch: false.

resolveV2MessageOfTheDayForClient applies region, platform, build-version, and account-level targeting before returning the client payload. Per-account dismissal is preserved: dismissible messages are omitted when their messageId is present in the account dismissal set, while non-dismissible downtime notices remain visible and can require acknowledgement.

Validation#

The service rejects duplicate message IDs, invalid active windows, unsupported platforms, invalid build ranges, and missing category metadata. Event messages require eventId, downtime messages require downtimeWindowId and statusPageUrl, and patch-note messages require patchNotesUrl for patch notes.

The focused validation gate is check-v2-message-of-the-day.py.

Verification#

bash
pnpm --filter @v2/message-of-the-day-service test
pnpm --filter @v2/message-of-the-day-service typecheck
pnpm --filter @v2/message-of-the-day-service lint
pnpm --filter @v2/message-of-the-day-service build
python3 V2/ue/Tools/check-v2-message-of-the-day.py