create_encounter

Generate D&D 5e combat encounters with participants, terrain, and initiative tracking for roleplaying games.

Instructions

Create a D&D 5e combat encounter with participants, terrain, and initiative tracking

Input Schema

TableJSON Schema

Name	Required	Default
`seed`	No
`participants`	Yes
`terrain`	No
`lighting`	No	bright
`surprise`	No

Implementation Reference

src/registry.ts:755-773 (registration)

Registration of the 'create_encounter' tool, including name, description, input schema conversion from Zod schema, and handler function that validates arguments using createEncounterSchema and calls the createEncounter function to perform the logic.

create_encounter: {
  name: 'create_encounter',
  description: 'Create a D&D 5e combat encounter with participants, terrain, and initiative tracking',
  inputSchema: toJsonSchema(createEncounterSchema),
  handler: async (args) => {
    try {
      const validated = createEncounterSchema.parse(args);
      const result = createEncounter(validated);
      return success(result);
    } catch (err) {
      if (err instanceof z.ZodError) {
        const messages = err.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ');
        return error(`Validation failed: ${messages}`);
      }
      const message = err instanceof Error ? err.message : String(err);
      return error(message);
    }
  },
},

src/registry.ts:759-772 (handler)

The tool handler executes the core logic: Zod validation with createEncounterSchema, execution of createEncounter(validated), and formatting success/error response.

handler: async (args) => {
  try {
    const validated = createEncounterSchema.parse(args);
    const result = createEncounter(validated);
    return success(result);
  } catch (err) {
    if (err instanceof z.ZodError) {
      const messages = err.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ');
      return error(`Validation failed: ${messages}`);
    }
    const message = err instanceof Error ? err.message : String(err);
    return error(message);
  }
},

src/registry.ts:761-761 (schema)
Usage of createEncounterSchema for input validation (schema imported from './modules/combat.js'). The schema definition itself is not in this file.
```
const validated = createEncounterSchema.parse(args);
```
src/registry.ts:762-762 (helper)
Call to the helper function createEncounter which contains the detailed implementation logic (imported from './modules/combat.js').
```
const result = createEncounter(validated);
```

src/registry.ts:225-225 (registration)

Import statement bringing in createEncounter function and createEncounterSchema from the combat module.

import { manageCondition, manageConditionSchema, createEncounter, createEncounterSchema, executeAction, executeActionSchema, advanceTurn, advanceTurnSchema, rollDeathSave, rollDeathSaveSchema, modifyTerrain, modifyTerrainSchema, renderBattlefield, renderBattlefieldSchema, getEncounter, getEncounterSchema, endEncounter, endEncounterSchema, manageEncounter, manageEncounterSchema } from './modules/combat.js';

ChatRPG