create-vimp-game 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vimp-game",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Scaffolder for VIMP game plugins",
   "keywords": [
     "vimp",
@@ -24,7 +24,7 @@
     "node": ">=20.11.0"
   },
   "bin": {
-    "create-vimp-game": "./bin/create-vimp-game.js"
+    "create-vimp-game": "bin/create-vimp-game.js"
   },
   "files": [
     "bin",

package/src/versions.generated.json

@@ -1,4 +1,4 @@
 {
-  "engine": "0.10.2",
-  "core": "0.3.2"
+  "engine": "0.11.0",
+  "core": "0.4.0"
 }

package/templates/default/src/host/index.js

@@ -4,6 +4,11 @@ import authSchema from '../config/auth.js';
 import clientConfig from '../config/client.js';
 import createModules from './createModules.js';
 import spawnCommand from './spawnCommand.js';
+import {
+  nameCommand,
+  newRoundCommand,
+  rankCommand,
+} from './metaCommands.js';
 import systemMessages from './systemMessages.js';
 import { isNodeCore, loadNodeCore, loadWebCore } from './nodeCore.js';
 
@@ -41,7 +46,8 @@ export default {
   authSchema,
 
   // REQUIRED array — the engine iterates it unguarded; `[]` for no commands
-  chatCommands: [spawnCommand],
+  // the engine parses no commands of its own: this array IS the registry
+  chatCommands: [spawnCommand, nameCommand, newRoundCommand, rankCommand],
 
   // merged into the engine chat registry by a blind Object.assign: a code in
   // an engine group would overwrite an engine message without a word

package/templates/default/src/host/metaCommands.js

@@ -0,0 +1,49 @@
+// The chat commands the engine used to own. It owns none now:
+// `CommandProcessor` is a bare registry, so a game that wants a nickname
+// change, a round restart or a rank readout declares them itself — and the
+// same name may mean something else, or nothing, in the next game.
+//
+// Two more the engine used to have are left out here because they only make
+// sense in a game with a round timer and several maps: '/timeleft'
+// (`ctx.timerManager.getMapTimeLeft()`) and '/mapname'
+// (`ctx.roundManager.currentMap`). Add them the same way if yours has both.
+//
+// The message codes below are the engine's own (group 'c'); their texts live
+// in `modules.chat.params.messages` (src/config/client.js).
+
+// ctx = { participants, chat, scripted, roundManager, voteCoordinator,
+//         timerManager, playerDataSync, teams, spectatorTeam, spectatorId,
+//         isDevMode }
+
+/// '/name <nickname>' — the engine validates and announces it itself.
+export const nameCommand = {
+  name: '/name',
+
+  handler(ctx, gameId, args) {
+    ctx.roundManager.changeName(gameId, args.join(' '));
+  },
+};
+
+/// '/nr' — restart the round; dev builds only.
+export const newRoundCommand = {
+  name: '/nr',
+
+  handler(ctx, gameId) {
+    if (ctx.isDevMode) {
+      ctx.roundManager.initiateNewRound();
+    } else {
+      ctx.chat.pushSystemByUser(gameId, 'COMMANDS_NOT_FOUND');
+    }
+  },
+};
+
+/// '/rank' — the per-(user, game) number the auth service keeps.
+export const rankCommand = {
+  name: '/rank',
+
+  handler(ctx, gameId) {
+    ctx.chat.pushSystemByUser(gameId, 'RANK', [
+      ctx.playerDataSync.getRank(gameId),
+    ]);
+  },
+};

package/templates/default/src/host/spawnCommand.js

@@ -2,9 +2,10 @@
 // It is also what `npm run dev` uses to get a match going (startupCommands in
 // dev/main.js).
 //
-// The name must not collide with the engine's own commands (/name, /nr,
-// /timeleft, /mapname, /rank): those are matched by a switch BEFORE the game
-// registry, so a same-named command registers fine and never fires.
+// The engine has no chat commands of its own: `CommandProcessor` is a bare
+// registry, so every name a player can type is declared by the game here —
+// including the meta ones (/name, /nr, /rank) in src/host/metaCommands.js.
+// A name registered twice silently loses one of the two handlers.
 export default {
   name: '/spawn',
 

package/templates/default/tests/host/hostPlugin.test.js

@@ -19,13 +19,17 @@ describe('HostPlugin surface', () => {
     expect(Array.isArray(hostPlugin.chatCommands)).toBe(true);
   });
 
-  it('does not shadow an engine chat command', () => {
-    const reserved = ['/name', '/nr', '/timeleft', '/mapname', '/rank'];
+  // the engine parses no commands of its own: this array is the whole
+  // registry, and a name registered twice loses one of its handlers
+  it('declares well-formed, unique chat commands', () => {
+    const names = hostPlugin.chatCommands.map(command => command.name);
 
     for (const command of hostPlugin.chatCommands) {
       expect(command.name.startsWith('/')).toBe(true);
-      expect(reserved).not.toContain(command.name);
+      expect(typeof command.handler).toBe('function');
     }
+
+    expect(new Set(names).size).toBe(names.length);
   });
 
   it('keeps its system message codes out of the engine groups', () => {