minecraft-commands-scripting — Claude Code skill: how to install
minecraft-commands-scripting writes and debugs Minecraft Java 26.x and 1.21.x commands, execute chains, scoreboards, and RCON scripts. Targets command logic directly without generating full datapack folder structures.
MIT 241 installs ★ 211 updated 2026-10-30
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-commands-scripting -a claude-codeWhat minecraft-commands-scripting does
The skill provides syntax rules and references for chat commands, command blocks, .mcfunction files, and remote server administration. It includes dedicated cheat sheets for execute subcommands and selectors, alongside ready-to-use patterns for arena countdowns and podium stopwatches. It also tracks release syntax shifts, such as version 26.3 handling of /item replace, /item fill, and /item override.
Server administrators get integration templates for Bash scripts using mcrcon and Python scripts using the mcrcon package. These handle routine operational flows: announcing scheduled maintenance, disabling world auto-saving before backups, and querying active player counts.
Because RCON traffic is unencrypted, server port 25575 must remain bound to localhost or an isolated network. The skill focuses strictly on raw command logic. Tasks requiring full datapack manifests belong in minecraft-datapack, while Java mod or plugin authoring requires dedicated developer tools.
What it helps with
- Chain complex conditions with execute if and target selector arguments
- Build first-join starter kits and death trackers using scoreboard objectives
- Automate server alerts and world folder backups with Bash and Python RCON scripts
- Handle integer multiplication and division on scoreboard values without decimals
Example prompts for the agent
- Write load.mcfunction and tick.mcfunction commands to grant starter items when a player joins for the first time.
- Create a Bash script using mcrcon that notifies chat, pauses saves, and copies the world directory.
- Construct an execute condition to run a function when any player steps within 5 blocks of 10 64 10.
How to install minecraft-commands-scripting
1Skills CLI (Vercel)
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-commands-scripting -a claude-code2Manually: put the files in place
~/.claude/skills/minecraft-commands-scripting/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/minecraft-commands-scripting/
1Skills CLI (Vercel)
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-commands-scripting -a codex2Manually: put the files in place
.agents/skills/minecraft-commands-scripting/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-commands-scripting -a cursor2Manually: put the files in place
.cursor/skills/minecraft-commands-scripting/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Jahrome907/minecraft-agent-skills plugins/minecraft-codex-skills/skills/minecraft-commands-scripting2Manually: put the files in place
.github/skills/minecraft-commands-scripting/SKILL.md1Skills CLI (Vercel)
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-commands-scripting -a gemini-cli2Platform CLI
gemini skills install https://github.com/Jahrome907/minecraft-agent-skills --path plugins/minecraft-codex-skills/skills/minecraft-commands-scriptingManually: put the files in place
.devin/skills/minecraft-commands-scripting/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-commands-scripting -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about minecraft-commands-scripting
How do I install minecraft-commands-scripting in Claude Code?
Run npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-commands-scripting -a claude-code in your terminal. The skill file is placed in ~/.claude/skills/minecraft-commands-scripting/SKILL.md.
What does minecraft-commands-scripting do?
It helps write and troubleshoot Minecraft Java 26.x and 1.21.x commands, execute pipelines, scoreboards, and RCON maintenance scripts.
Can this skill create full datapacks or Minecraft mods?
No, it handles raw commands and function files only. Full datapack project structures require the minecraft-datapack skill, while mod and plugin development requires separate Java coding tools.
Source text
SKILL.md · MIT
---
name: minecraft-commands-scripting
description: "Write and debug Minecraft Java 26.x and 1.21.x commands, selectors, execute chains, scoreboards, NBT, and RCON scripts. Use for command-only work; use minecraft-datapack for complete datapack structures."
---
# Minecraft Commands & Scripting Skill
Before editing, inspect the exact Minecraft version and execution context
(chat, function, command block, or RCON). Keep the requested scope and use only
the relevant examples. Check current release notes for version-sensitive syntax.
In [26.3](https://www.minecraft.net/en-us/article/minecraft-java-edition-26-3),
`/item replace` maps source slots to destinations once; use `/item fill` to
repeat items or `/item override` to clear unmatched slots.
## Command Syntax Conventions
- `<required>` — required argument
- `[optional]` — optional argument
- `(a|b|c)` — choose one
- `...` — repeating / multiple
- Coordinates: `~` = relative offset, `^` = local (look-direction)
### Routing Boundaries
- `Use when`: the task is raw command chains, scoreboards, selector logic, or RCON command scripting.
- `Do not use when`: creating or editing full datapack structures and registries (`minecraft-datapack`).
- `Do not use when`: behavior depends on Java plugin or mod code (`minecraft-plugin-dev`/`minecraft-modding`).
## Bundled References And Examples
- Execute cheat sheet: `references/execute-cheat-sheet.md`
- Selector cheat sheet: `references/selector-cheat-sheet.md`
- Example scripts: `scripts/examples/arena-countdown.mcfunction`, `scripts/examples/stopwatch-podium.mcfunction`, `scripts/examples/rcon-backup-warning.sh` (one-time setup commands are called out in comments when needed)
Use the cheat sheets when you need fast command recall without scanning this whole
skill file. Copy and adapt the example scripts as needed.
---
## Command reference
Use [references/command-reference.md](references/command-reference.md) for the
relevant command family. It includes version boundaries for item components,
attributes, text events, gamerules, and 26.x world clocks. Do not run example
blocks as a batch; each demonstrates a separate operation.
## RCON Scripting
Connect to a Minecraft server remotely using RCON (enable in `server.properties`):
```properties
# server.properties
enable-rcon=true
rcon.password=your_password
rcon.port=25575
```
RCON is unencrypted. Keep the port bound to a trusted private network, VPN, or
localhost, and inject the password through a protected secret rather than a
command-line argument.
### Bash RCON script (using `mcrcon`)
```bash
#!/usr/bin/env bash
set -euo pipefail
: "${MCRCON_PASS:?inject MCRCON_PASS from a protected secret}"
export MCRCON_HOST="${MCRCON_HOST:-127.0.0.1}"
export MCRCON_PORT="${MCRCON_PORT:-25575}"
restore_saves() {
mcrcon "save-on" >/dev/null || true
}
trap restore_saves EXIT INT TERM
# Send command
mcrcon "say Server backup starting in 5 minutes"
sleep 300
mcrcon "save-off"
mcrcon "save-all flush"
# Backup world
rsync -av /path/to/server/world/ /backups/world_$(date +%Y%m%d_%H%M%S)/
mcrcon "save-on"
trap - EXIT INT TERM
mcrcon "say Backup complete!"
```
### Python RCON
```python
import os
from mcrcon import MCRcon
with MCRcon("localhost", os.environ["MCRCON_PASS"], port=25575) as mcr:
response = mcr.command("list")
print(response)
# "There are 3 of a max of 20 players online: Steve, Alex, Notch"
players = response.split(": ")[1].split(", ") if ": " in response else []
print(f"Online players: {players}")
```
---
## Common Scripting Patterns
### First-join setup (load and tick functions)
```mcfunction
# load.mcfunction: create the objective
scoreboard objectives add initialized dummy
# tick.mcfunction: detect players who have not been initialized
execute as @a unless score @s initialized matches 1 run function mypack:on_first_join
# on_first_join.mcfunction
scoreboard players set @s initialized 1
give @s minecraft:stone_sword
give @s minecraft:bread 16
tellraw @s {"text":"Welcome! Here's a starter kit.","color":"green"}
```
### Death counter + respawn
```mcfunction
# load.mcfunction
scoreboard objectives add deaths deathCount
scoreboard objectives add total_deaths dummy
# tick.mcfunction — check deaths
execute as @a[scores={deaths=1..}] run function mypack:on_death
# on_death.mcfunction (separate file)
scoreboard players reset @s deaths
scoreboard players add @s total_deaths 1
```
### Proximity detection
```mcfunction
# Check if any player is within 5 blocks of a location
execute if entity @a[x=10,y=64,z=10,distance=..5] run function mypack:player_nearby
```
### Math tricks (no fractions in scoreboards)
```mcfunction
# load.mcfunction: create objectives and constants
scoreboard objectives add value dummy
scoreboard objectives add result dummy
scoreboard objectives add constants dummy
scoreboard players set #two constants 2
scoreboard players set #three constants 3
# Run as a player whose value score is already set
# Multiply @s.value by 1.5 using integer math (×3 then /2)
scoreboard players operation @s result = @s value
scoreboard players operation @s result *= #three constants
scoreboard players operation @s result /= #two constants
```
---
## References
- Minecraft Wiki — Commands: https://minecraft.wiki/w/Commands
- Minecraft Wiki — Target selectors: https://minecraft.wiki/w/Target_selectors
- Minecraft Wiki — NBT format: https://minecraft.wiki/w/NBT_format
- Minecraft Wiki — Raw JSON text: https://minecraft.wiki/w/Raw_JSON_text_format
- Minecraft Wiki — Scoreboard: https://minecraft.wiki/w/Scoreboard
- Execute command wiki: https://minecraft.wiki/w/Commands/execute
© Jahrome907 · MIT · Jahrome907/minecraft-agent-skills