Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Calibrate the play-time model with local playtests

Đang mở
  • Có gì không ổn?
#35 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
24/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
analytics, full-stack

Hướng nghiên cứu

Start with packages/engine/src/playtime.ts, apps/web/src/screens/settings.ts, and apps/web/src/logic/catalog.ts; read section 17 of docs/spec/content-pack.md and the offline-first ADR to understand existing estimates and privacy constraints. The issue also requires collecting at least 15 complete playthroughs and choosing how library cards display duration. Done means documenting the report format and before/after median error, updating defaults, spec and prompt kit or recording why they stay, and implementing the recorded card decision.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

area: engine area: web help wanted priority: medium type: research

Context

The play-time defaults come from reading research and from two small packs (the demo pack and a German test fixture). The noir pack is the first full-length game to compare against; its estimate is about 47 minutes against a target of 40 (19 percent over, inside the tolerance). The project has no telemetry and the player makes no network requests, so measurements must stay on the device unless a tester chooses to share them.

Scope

  • An opt-in playtest mode in settings, off by default. Per game it records on the device: active play time (excluding time in the background and idle periods), accepted and rejected commands, dialogue choices, words shown, hints revealed and undos.
  • "Export playtest report" downloads a JSON file with pack id, version and hash, the counters and the relevant settings (text size, UI language). No personal data.
  • An issue form "Playtest report" to submit the file voluntarily.
  • A calibration script that compares reports with estimatePlaytime and fits reading speed, seconds per command and choice, coverage and failed attempts.
  • Goal: at least ten complete playthroughs of the noir pack and five of the demo pack, including the v0.1 release playthrough.
  • Update PLAYTIME_DEFAULTS and BUDGET_DEFAULTS and the spec with the measured values and the sample size.
  • Decide what library cards show. Today they show the declared playtime ("ca. 40 Min." for the noir pack) and fall back to the estimate only when a pack declares none. Options: the declared value, the estimate, or both.

Acceptance criteria

  • Playtest mode is off by default; nothing leaves the device without an explicit export.
  • The report format is documented.
  • The estimate error (median, before and after calibration) is documented.
  • Defaults, spec and prompt kit are updated from the results, or the reasons for keeping them are recorded here.
  • The decision on the length shown on library cards is recorded here and implemented.

References

  • packages/engine/src/playtime.ts
  • docs/spec/content-pack.md (section 17)
  • apps/web/src/screens/settings.ts
  • apps/web/src/logic/catalog.ts
  • SECURITY.md
  • docs/adr/0006-offline-first-pwa-on-github-pages.md
Ngôn ngữ chính
TypeScript
Star
0
Fork
0
Merge trung bình
28 phút
Pull request đã merge (30 ngày)
2

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của nullthrone/lexvm

Tất cả issue của nullthrone/lexvm

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.