Warn on unsupported pack languages and document how to add a game language

未关闭
#39 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
54/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
活跃
技术栈
typescript

调研方向

Start with packages/engine/src/messages/index.ts and packages/engine/src/analyze.ts to see how catalogs and analyzer warnings are handled; check packages/engine/src/playtime.ts for the default reading speed. Read CONTRIBUTING.md and the prompt kit to find where language guidance belongs, then use the existing analyzer tests as a starting point. Done means unsupported primary language tags warn, supported tags do not, and the guide lists the files a new language touches.

由索引模型根据 Issue 内容生成。

描述

area: engine help wanted priority: medium type: feature

Context

The schema accepts any BCP 47 tag in language, but the engine has message catalogs and parser vocabularies only for German and English (packages/engine/src/messages). Any other language silently falls back to English engine messages and parser words, so a French pack would mix French story text with English system messages and an English parser. ADR 0008 and docs/architecture.md (section 9) describe a new game language as an additive change, and the v0.2 milestone includes more engine messages and languages.

Scope

  • Analyzer: a warning (for example language.unsupported) when the primary subtag of language has no catalog, naming the supported languages; listed in Appendix A.
  • A section "Adding a game language" in CONTRIBUTING.md: message catalog, parser vocabulary (verbs, directions, stop words, prepositions, particles, meta words), default reading speed for the play-time estimate, parser tests, and accepting the code in the docs.
  • A first additional language is tracked in its own issue once a native-speaking contributor volunteers.

Acceptance criteria

  • A pack with language: fr gets the warning; de, de-AT, en and en-GB do not.
  • The guide section exists and lists every file a new language touches.
  • The prompt kit tells LLMs which pack languages are supported.

References

  • packages/engine/src/messages/index.ts
  • packages/engine/src/analyze.ts
  • packages/engine/src/playtime.ts
  • docs/adr/0008-language-policy.md
  • docs/architecture.md (section 9)
  • CONTRIBUTING.md
主要语言
TypeScript
星标
0
派生
0
平均合并
1 小时 24 分钟
30 天内合并 PR
5

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

nullthrone/lexvm 的其他 Issue

查看 nullthrone/lexvm 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。