render_battlefield

Visualize combat scenarios in text-based grids to display participant positions, obstacles, and terrain for tactical planning.

Instructions

Render an ASCII map of the current combat state showing participant positions, obstacles, and terrain. Returns a text-based grid visualization.

Input Schema

TableJSON Schema

Name	Required	Default
`encounterId`	Yes
`showLegend`	No
`showCoordinates`	No
`showElevation`	No
`viewport`	No
`focusOn`	No
`legendDetail`	No	standard

Implementation Reference

src/registry.ts:880-898 (registration)

Registration of the 'render_battlefield' MCP tool. Defines name, description, input schema (using imported renderBattlefieldSchema), and handler function that parses input with the schema and executes renderBattlefield(validated) to generate the result.

render_battlefield: {
  name: 'render_battlefield',
  description: 'Render an ASCII map of the current combat state showing participant positions, obstacles, and terrain. Returns a text-based grid visualization.',
  inputSchema: toJsonSchema(renderBattlefieldSchema),
  handler: async (args) => {
    try {
      const validated = renderBattlefieldSchema.parse(args);
      const result = renderBattlefield(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:884-896 (handler)

The MCP tool handler for render_battlefield. Validates arguments using renderBattlefieldSchema and calls the core renderBattlefield function with validated args, returning success(result). Handles Zod validation errors and other exceptions.

handler: async (args) => {
  try {
    const validated = renderBattlefieldSchema.parse(args);
    const result = renderBattlefield(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);
  }

ChatRPG