@zhin.js/plugin-game-hub 1.1.14 → 1.1.16

package/commands/games/[[action]]/index.js

@@ -1,19 +1,27 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
 import { gameFeatureId } from '@zhin.js/game-kit';
+import { createMessages } from 'zhin.js/i18n';
+const messages = createMessages({
+    start: { 'zh-CN': '发送 `{command}` 开始 {title}', en: 'Send `{command}` to start {title}' },
+});
 export default defineCommand({
     description: 'Game hub — list loaded games',
     params: { action: { type: 'string', default: '' } },
-    async execute({ params, project }) {
+    async execute({ params, project, locale, formatCommand }) {
         const games = project(gameFeatureId);
         const action = String(params.action ?? '').trim();
         if (action) {
             const game = games.get(action);
             if (game) {
-                const start = game.quickStart ? ` ${game.quickStart}` : '';
-                return `发送 \`${game.commandPrefix}${start}\` 开始 ${game.title}`;
+                const command = games.formatCommand(game.id, formatCommand);
+                const quickStart = game.quickStartI18n?.[locale] ?? game.quickStart;
+                const start = quickStart ? ` ${quickStart}` : '';
+                if (command)
+                    return messages(locale, 'start', { command: command + start,
+                        title: game.titleI18n?.[locale] ?? game.title });
             }
         }
-        return games.formatHelp();
+        return games.formatHelp(locale, formatCommand);
     },
 });

package/commands/games/[[action]]/index.ts

@@ -1,19 +1,27 @@
 import { defineCommand } from 'zhin.js/command';
 import { gameFeatureId, type GameIndex } from '@zhin.js/game-kit';
+import { createMessages } from 'zhin.js/i18n';
+
+const messages = createMessages({
+  start: { 'zh-CN': '发送 `{command}` 开始 {title}', en: 'Send `{command}` to start {title}' },
+});
 
 export default defineCommand({
   description: 'Game hub — list loaded games',
   params: { action: { type: 'string', default: '' } },
-  async execute({ params, project }) {
+  async execute({ params, project, locale, formatCommand }) {
     const games = project<GameIndex>(gameFeatureId);
     const action = String(params.action ?? '').trim();
     if (action) {
       const game = games.get(action);
       if (game) {
-        const start = game.quickStart ? ` ${game.quickStart}` : '';
-        return `发送 \`${game.commandPrefix}${start}\` 开始 ${game.title}`;
+        const command = games.formatCommand(game.id, formatCommand);
+        const quickStart = game.quickStartI18n?.[locale] ?? game.quickStart;
+        const start = quickStart ? ` ${quickStart}` : '';
+        if (command) return messages(locale, 'start', { command: command + start,
+          title: game.titleI18n?.[locale] ?? game.title });
       }
     }
-    return games.formatHelp();
+    return games.formatHelp(locale, formatCommand);
   },
 });

package/commands//346/210/230/347/273/251/index.js

@@ -1,22 +1,32 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createMessages } from 'zhin.js/i18n';
 import { defineCommand } from 'zhin.js/command';
 import { channelKey, gameFeatureId, messageFromCommandInput, } from '@zhin.js/game-kit';
-function formatStats(index, stats) {
+function formatStats(index, stats, locale, menu) {
     if (!stats.length)
-        return '暂无战绩记录，快去 `/游戏` 开一局吧！';
+        return messages(locale, 'empty') + (menu ? messages(locale, 'menu', { command: menu }) : '');
     const lines = stats.map((s) => {
         const g = index.get(s.gameId);
-        const title = g ? `${g.icon} ${g.title}` : s.gameId;
-        return `• ${title}：${s.wins} 胜 ${s.losses} 负${s.draws ? ` ${s.draws} 平` : ''}（${s.games} 局，得分 ${s.totalScore}）`;
+        const title = g ? `${g.icon} ${g.titleI18n?.[locale] ?? g.title}` : s.gameId;
+        return messages(locale, 'record', { title, wins: s.wins, losses: s.losses, draws: s.draws ? messages(locale, 'draws', { count: s.draws }) : '', games: s.games, score: s.totalScore });
     });
-    return ['📊 **你的战绩**', '', ...lines].join('\n');
+    return [messages(locale, 'title'), '', ...lines].join('\n');
 }
 export default defineCommand({
-    description: '查看本人在本群的游戏战绩',
-    async execute({ input, project }) {
+    alias: ['game-stats'],
+    preferredAliasI18n: { en: 'game-stats' },
+    description: '查看本人在本群的游戏战绩', descriptionI18n: { en: "View your game statistics in this group" },
+    async execute({ input, project, locale, formatCommand }) {
         const index = project(gameFeatureId);
-        const message = messageFromCommandInput(input);
+        const message = messageFromCommandInput(input, { locale, formatCommand });
         const stats = await index.getUserStats(message.$sender.id, channelKey(message));
-        return formatStats(index, stats);
+        return formatStats(index, stats, locale, formatCommand?.('games'));
     },
 });
+const messages = createMessages({
+    empty: { 'zh-CN': '暂无战绩记录。', en: 'No game statistics yet.' },
+    menu: { 'zh-CN': '发送 `{command}` 查看游戏。', en: ' Send `{command}` to browse games.' },
+    title: { 'zh-CN': '📊 **你的战绩**', en: '📊 **Your statistics**' },
+    draws: { 'zh-CN': ' {count} 平', en: ' {count} draws' },
+    record: { 'zh-CN': '• {title}：{wins} 胜 {losses} 负{draws}（{games} 局，得分 {score}）', en: '• {title}: {wins} wins, {losses} losses{draws} ({games} games, score {score})' },
+});

package/commands//346/210/230/347/273/251/index.ts

@@ -1,3 +1,4 @@
+import { createMessages, type Locale } from 'zhin.js/i18n';
 import { defineCommand } from 'zhin.js/command';
 import {
   channelKey,
@@ -7,22 +8,32 @@ import {
   type UserGameStats,
 } from '@zhin.js/game-kit';
 
-function formatStats(index: GameIndex, stats: UserGameStats[]): string {
-  if (!stats.length) return '暂无战绩记录，快去 `/游戏` 开一局吧！';
+function formatStats(index: GameIndex, stats: UserGameStats[], locale: Locale, menu?: string): string {
+  if (!stats.length) return messages(locale, 'empty') + (menu ? messages(locale, 'menu', { command: menu }) : '');
   const lines = stats.map((s) => {
     const g = index.get(s.gameId);
-    const title = g ? `${g.icon} ${g.title}` : s.gameId;
-    return `• ${title}：${s.wins} 胜 ${s.losses} 负${s.draws ? ` ${s.draws} 平` : ''}（${s.games} 局，得分 ${s.totalScore}）`;
+    const title = g ? `${g.icon} ${g.titleI18n?.[locale] ?? g.title}` : s.gameId;
+    return messages(locale, 'record', { title, wins: s.wins, losses: s.losses, draws: s.draws ? messages(locale, 'draws', { count: s.draws }) : '', games: s.games, score: s.totalScore });
   });
-  return ['📊 **你的战绩**', '', ...lines].join('\n');
+  return [messages(locale, 'title'), '', ...lines].join('\n');
 }
 
 export default defineCommand({
-  description: '查看本人在本群的游戏战绩',
-  async execute({ input, project }) {
+  alias: ['game-stats'],
+  preferredAliasI18n: { en: 'game-stats' },
+  description: '查看本人在本群的游戏战绩', descriptionI18n: { en: "View your game statistics in this group" },
+  async execute({ input, project, locale, formatCommand }) {
     const index = project<GameIndex>(gameFeatureId);
-    const message = messageFromCommandInput(input);
+    const message = messageFromCommandInput(input, { locale, formatCommand });
     const stats = await index.getUserStats(message.$sender.id, channelKey(message));
-    return formatStats(index, stats);
+    return formatStats(index, stats, locale, formatCommand?.('games'));
   },
 });
+
+const messages = createMessages({
+  empty: { 'zh-CN': '暂无战绩记录。', en: 'No game statistics yet.' },
+  menu: { 'zh-CN': '发送 `{command}` 查看游戏。', en: ' Send `{command}` to browse games.' },
+  title: { 'zh-CN': '📊 **你的战绩**', en: '📊 **Your statistics**' },
+  draws: { 'zh-CN': ' {count} 平', en: ' {count} draws' },
+  record: { 'zh-CN': '• {title}：{wins} 胜 {losses} 负{draws}（{games} 局，得分 {score}）', en: '• {title}: {wins} wins, {losses} losses{draws} ({games} games, score {score})' },
+});

package/commands//346/216/222/350/241/214/[[query]]/index.js

@@ -1,41 +1,52 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { createMessages } from 'zhin.js/i18n';
 import { defineCommand } from 'zhin.js/command';
 import { channelKey, gameFeatureId, messageFromCommandInput, } from '@zhin.js/game-kit';
-function formatLeaderboard(index, gameId, entries) {
+function formatLeaderboard(index, gameId, entries, locale, menu) {
     const g = index.get(gameId);
-    const title = g ? `${g.icon} ${g.title}` : gameId;
+    const title = g ? `${g.icon} ${g.titleI18n?.[locale] ?? g.title}` : gameId;
     if (!entries.length) {
-        return `${title} 在本群暂无排行，发送 \`/游戏\` 开始第一局！`;
+        return messages(locale, 'empty', { title }) + (menu ? messages(locale, 'menu', { command: menu }) : '');
     }
-    const lines = entries.map((e, i) => `${i + 1}. ${e.userName} — ${e.wins} 胜 / ${e.games} 局（得分 ${e.totalScore}）`);
-    return [`🏆 **${title} 本群排行**`, '', ...lines].join('\n');
+    const lines = entries.map((e, i) => messages(locale, 'entry', { rank: i + 1, name: e.userName, wins: e.wins, games: e.games, score: e.totalScore }));
+    return [messages(locale, 'title', { title }), '', ...lines].join('\n');
 }
 export default defineCommand({
-    description: '查看本群某游戏排行榜',
+    alias: ['game-ranking'],
+    preferredAliasI18n: { en: 'game-ranking' },
+    description: '查看本群某游戏排行榜', descriptionI18n: { en: "View this group's leaderboard for a game" },
     params: { query: { type: 'string', default: '' } },
-    async execute({ input, params, project }) {
+    async execute({ input, params, project, locale, formatCommand }) {
         const index = project(gameFeatureId);
         const query = String(params.query ?? '').trim();
         const games = index.list();
         if (!games.length)
-            return '暂无已注册游戏。';
+            return messages(locale, 'noGames');
         const firstGame = games[0];
         if (!firstGame)
-            return '暂无已注册游戏。';
+            return messages(locale, 'noGames');
         let gameId = firstGame.id;
         if (query) {
             const hit = games.find((g) => g.id === query
-                || g.title.includes(query)
+                || (g.titleI18n?.[locale] ?? g.title).includes(query)
                 || g.commandPrefix.includes(query)
                 || g.aliases?.some((a) => a.includes(query)));
             if (!hit) {
-                const names = games.map((g) => g.title).join('、');
-                return `未找到游戏「${query}」。可选：${names}`;
+                const names = games.map((g) => g.titleI18n?.[locale] ?? g.title).join(locale === 'en' ? ', ' : '、');
+                return messages(locale, 'missing', { query, names });
             }
             gameId = hit.id;
         }
-        const message = messageFromCommandInput(input);
+        const message = messageFromCommandInput(input, { locale, formatCommand });
         const board = await index.getLeaderboard(gameId, channelKey(message));
-        return formatLeaderboard(index, gameId, board);
+        return formatLeaderboard(index, gameId, board, locale, formatCommand?.('games'));
     },
 });
+const messages = createMessages({
+    empty: { 'zh-CN': '{title} 在本群暂无排行。', en: 'No {title} leaderboard in this group yet.' },
+    menu: { 'zh-CN': '发送 `{command}` 查看游戏。', en: ' Send `{command}` to browse games.' },
+    entry: { 'zh-CN': '{rank}. {name} — {wins} 胜 / {games} 局（得分 {score}）', en: '{rank}. {name} — {wins} wins / {games} games (score {score})' },
+    title: { 'zh-CN': '🏆 **{title} 本群排行**', en: '🏆 **{title} group leaderboard**' },
+    noGames: { 'zh-CN': '暂无已注册游戏。', en: 'No games are registered.' },
+    missing: { 'zh-CN': '未找到游戏「{query}」。可选：{names}', en: 'Game “{query}” was not found. Available: {names}' },
+});

package/commands//346/216/222/350/241/214/[[query]]/index.ts

@@ -1,3 +1,4 @@
+import { createMessages, type Locale } from 'zhin.js/i18n';
 import { defineCommand } from 'zhin.js/command';
 import {
   channelKey,
@@ -7,44 +8,55 @@ import {
   type GameIndex,
 } from '@zhin.js/game-kit';
 
-function formatLeaderboard(index: GameIndex, gameId: string, entries: LeaderboardEntry[]): string {
+function formatLeaderboard(index: GameIndex, gameId: string, entries: LeaderboardEntry[], locale: Locale, menu?: string): string {
   const g = index.get(gameId);
-  const title = g ? `${g.icon} ${g.title}` : gameId;
+  const title = g ? `${g.icon} ${g.titleI18n?.[locale] ?? g.title}` : gameId;
   if (!entries.length) {
-    return `${title} 在本群暂无排行，发送 \`/游戏\` 开始第一局！`;
+    return messages(locale, 'empty', { title }) + (menu ? messages(locale, 'menu', { command: menu }) : '');
   }
   const lines = entries.map((e, i) =>
-    `${i + 1}. ${e.userName} — ${e.wins} 胜 / ${e.games} 局（得分 ${e.totalScore}）`,
+    messages(locale, 'entry', { rank: i + 1, name: e.userName, wins: e.wins, games: e.games, score: e.totalScore }),
   );
-  return [`🏆 **${title} 本群排行**`, '', ...lines].join('\n');
+  return [messages(locale, 'title', { title }), '', ...lines].join('\n');
 }
 
 export default defineCommand({
-  description: '查看本群某游戏排行榜',
+  alias: ['game-ranking'],
+  preferredAliasI18n: { en: 'game-ranking' },
+  description: '查看本群某游戏排行榜', descriptionI18n: { en: "View this group's leaderboard for a game" },
   params: { query: { type: 'string', default: '' } },
-  async execute({ input, params, project }) {
+  async execute({ input, params, project, locale, formatCommand }) {
     const index = project<GameIndex>(gameFeatureId);
     const query = String(params.query ?? '').trim();
     const games = index.list();
-    if (!games.length) return '暂无已注册游戏。';
+    if (!games.length) return messages(locale, 'noGames');
     const firstGame = games[0];
-    if (!firstGame) return '暂无已注册游戏。';
+    if (!firstGame) return messages(locale, 'noGames');
     let gameId = firstGame.id;
     if (query) {
       const hit = games.find(
         (g) => g.id === query
-          || g.title.includes(query)
+          || (g.titleI18n?.[locale] ?? g.title).includes(query)
           || g.commandPrefix.includes(query)
           || g.aliases?.some((a) => a.includes(query)),
       );
       if (!hit) {
-        const names = games.map((g) => g.title).join('、');
-        return `未找到游戏「${query}」。可选：${names}`;
+        const names = games.map((g) => g.titleI18n?.[locale] ?? g.title).join(locale === 'en' ? ', ' : '、');
+        return messages(locale, 'missing', { query, names });
       }
       gameId = hit.id;
     }
-    const message = messageFromCommandInput(input);
+    const message = messageFromCommandInput(input, { locale, formatCommand });
     const board = await index.getLeaderboard(gameId, channelKey(message));
-    return formatLeaderboard(index, gameId, board);
+    return formatLeaderboard(index, gameId, board, locale, formatCommand?.('games'));
   },
 });
+
+const messages = createMessages({
+  empty: { 'zh-CN': '{title} 在本群暂无排行。', en: 'No {title} leaderboard in this group yet.' },
+  menu: { 'zh-CN': '发送 `{command}` 查看游戏。', en: ' Send `{command}` to browse games.' },
+  entry: { 'zh-CN': '{rank}. {name} — {wins} 胜 / {games} 局（得分 {score}）', en: '{rank}. {name} — {wins} wins / {games} games (score {score})' },
+  title: { 'zh-CN': '🏆 **{title} 本群排行**', en: '🏆 **{title} group leaderboard**' },
+  noGames: { 'zh-CN': '暂无已注册游戏。', en: 'No games are registered.' },
+  missing: { 'zh-CN': '未找到游戏「{query}」。可选：{names}', en: 'Game “{query}” was not found. Available: {names}' },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-game-hub",
-  "version": "1.1.14",
+  "version": "1.1.16",
   "description": "Zhin.js 游戏大厅 — 列出已加载的游戏插件 (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
@@ -22,12 +22,12 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@zhin.js/game-kit": "1.1.14"
+    "@zhin.js/game-kit": "1.1.16"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "zhin.js": "1.1.14"
+    "zhin.js": "1.1.16"
   },
   "repository": {
     "type": "git",
@@ -60,8 +60,8 @@
     "plugins": []
   },
   "peerDependencies": {
-    "@zhin.js/command": "^1.1.9",
-    "zhin.js": "^1.1.14"
+    "@zhin.js/command": "^1.1.11",
+    "zhin.js": "^1.1.16"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {