apply_effect
Apply status effects like speed, strength, or invisibility to players in Minecraft servers using administrator controls for gameplay management.
Instructions
Apply a status effect to a player. Examples: speed, strength, regeneration, night_vision, invisibility, resistance.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | Player selector | |
| effect | Yes | Effect ID (e.g., 'speed', 'night_vision') | |
| duration | No | Duration in seconds | |
| amplifier | No | Amplifier level (0 = level I) |
Implementation Reference
- src/tools/player-tools.ts:246-270 (handler)The tool 'apply_effect' is registered and implemented in src/tools/player-tools.ts. It executes an RCON 'effect give' command.
server.tool( "apply_effect", "Apply a status effect to a player. Examples: speed, strength, regeneration, night_vision, invisibility, resistance.", { target: z.string().describe("Player selector"), effect: z.string().describe("Effect ID (e.g., 'speed', 'night_vision')"), duration: z.number().optional().default(30).describe("Duration in seconds"), amplifier: z.number().optional().default(0).describe("Amplifier level (0 = level I)"), }, async ({ target, effect, duration, amplifier }) => { try { const response = await manager.rcon.send( `effect give ${target} ${effect} ${duration} ${amplifier}` ); return { content: [{ type: "text", text: response }] }; } catch (error) { return { content: [ { type: "text", text: `Failed: ${error instanceof Error ? error.message : String(error)}`, }, ], isError: true, };