Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Calibrate the play-time model with local playtests

オープン
  • 何か問題がありますか？
#35 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
24/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript
領域
analytics, full-stack

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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
主要言語
TypeScript
スター
0
フォーク
0
平均マージ
28分
マージ済み PR（30日）
2

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

nullthrone/lexvm のほかの issue

nullthrone/lexvm の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。