К основному содержанию
скилл CX Codex

minecraft-essentials-ops — скилл для Claude Code: обзор и запуск

Скилл minecraft-essentials-ops помогает настраивать плагин EssentialsX на серверах Paper и Spigot для Minecraft 26.x и 1.21.x, от экономики до прав игроков.

MIT 185 установок ★ 211 обновлён 2026-10-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-essentials-ops -a claude-code
Открыть на GitHub

Что делает minecraft-essentials-ops

Скилл ориентирован на администрирование EssentialsX: он ведёт по настройке конфигураций, модулей Chat, Spawn и Protect, магазинов на табличках и цепочки экономики с Vault. В инструкции заложены шаблоны прав для LuckPerms с разделением ролей на admin, staff и player, а также типовые рабочие процессы модерации — от временных банов до изоляции нарушителей через /jail.

Folia и любые её форки плагином не поддерживаются: версия EssentialsX 2.22.0 прямо предупреждает о риске потери данных игроков на таких ядрах. Также скилл не рассчитан на серверы Forge, NeoForge или гибриды Fabric с Bukkit, поэтому запускать операции следует строго на проверенных билдах Paper или Spigot.

Какие задачи решает

  • Собрать права LuckPerms для ролей админа, персонала и игроков без лишних wildcard-доступов
  • Настроить магазины на табличках с раздельной стоимостью покупки и продажи
  • Развернуть экономику сервера с проверкой связки через Vault
  • Оформить наборы предметов kits и точки телепортации warp и home

Примеры запросов агенту

  • Составь набор starter в kits.yml с задержкой 86400 секунд и предметами первой необходимости
  • Распиши права для группы staff: мут, джейл, временный бан и базовые телепорты
  • Проверь формат таблички магазина для продажи 32 единиц камня за 20 монет

Как установить minecraft-essentials-ops

1Через Skills CLI (Vercel)

npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-essentials-ops -a claude-code

2Вручную: положить файлы

~/.claude/skills/minecraft-essentials-ops/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/minecraft-essentials-ops/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о minecraft-essentials-ops

Как установить minecraft-essentials-ops в Claude Code?

Выполните в терминале команду npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-essentials-ops -a claude-code.

Для чего предназначен этот скилл?

Он помогает управлять плагином EssentialsX на серверах Minecraft: настраивать экономику, киты, спавн, таблички магазинов и модерацию без написания Java-кода.

Можно ли использовать скилл на сервере с ядром Folia?

Нет. Релиз EssentialsX 2.22.0 помечает Folia неподдерживаемой платформой из-за угрозы потери файлов игроков, поэтому скилл предназначен только для Paper и Spigot.

Исходный текст

SKILL.md · MIT
---
name: minecraft-essentials-ops
description: "Operate EssentialsX on Minecraft 26.x and 1.21.x servers, including configuration, permissions, economy, kits, warps, homes, and moderation. Use for EssentialsX administration, not plugin development or general server deployment."
---

# Minecraft EssentialsX Operations Skill

## Skill Scope

### Routing Boundaries
- `Use when`: the task is EssentialsX command, config, permissions, economy, or moderation operations.
- `Do not use when`: the task is generic server deployment/proxy/performance architecture (`minecraft-server-admin`).
- `Do not use when`: the task is writing Java plugin code (`minecraft-plugin-dev`).
- `Do not use when`: the task is WorldEdit selection/build workflows (`minecraft-worldedit-ops`).

## References

- Read `references/permissions-and-rollout-checklists.md` when the task is a permissions audit, economy rollout, or moderation-policy change and you need a compact preflight list.

---

## Module Overview and Install Notes

### Platform gate

Use EssentialsX only on a supported Paper or Spigot server build. EssentialsX
2.22.0 warns that Folia and Folia forks are unsupported and can lose userdata;
it also does not support Forge, NeoForge, or Fabric Bukkit-hybrid servers. If
the current platform is in either category, stop before enabling or configuring
EssentialsX and verify a supported operational path. This guide does not
recommend a migration.

Common EssentialsX modules in production:
- `EssentialsX` (core commands and user tools)
- `EssentialsXChat`
- `EssentialsXSpawn`
- `EssentialsXProtect`

Operational install checklist:
1. Match EssentialsX build to your Paper/Spigot API generation.
2. Install `Vault` if using economy providers or permission/chat bridges.
3. Start server once and inspect logs for dependency warnings.
4. Keep plugin jar versions documented for rollback.

Version-alignment rule:
- update EssentialsX and companion plugins as a tested batch in staging first.
- verify the exact EssentialsX release or development build supports the target
  Paper release; 2.22.0 lists 26.1.2 and 1.21.11 support, not blanket 26.x
  compatibility. Check the [release notes](https://github.com/EssentialsX/Essentials/releases)
  before using it on 26.3.

---

## Vault and Economy Basics

### Economy stack model

- EssentialsX can provide economy commands and balances.
- Vault provides a shared bridge so other plugins (shops, jobs, ranks) can read/write balances.

Verify provider chain:
1. Server starts without Vault hook errors.
2. Economy commands respond without permission errors.
3. Third-party plugin transactions affect balances consistently.

### Core economy commands

```text
/bal
/baltop
/pay Alex 250
/eco give Alex 1000
/eco take Alex 100
/eco reset Alex
```

Use admin economy commands through staff roles only.

---

## Shop Pricing and Sign Shops

If using EssentialsX signs and economy interactions:

1. Define pricing policy:
   - starter-tier prices
   - anti-inflation sinks
   - admin-only item exceptions
2. Enable only the sign types you intend to support in `config.yml`:
   ```yaml
   enabledSigns:
     - buy
     - sell
   ```
3. Restrict creation permissions to trusted groups:
   - `essentials.signs.create.buy`
   - `essentials.signs.create.sell`
4. Grant use permissions only to groups that should transact:
   - `essentials.signs.use.buy`
   - `essentials.signs.use.sell`
5. Validate buy/sell math with a non-op player account after config changes.

### Sign shop formats

```
[Buy]
<quantity>
<item>
<price>

[Sell]
<quantity>
<item>
<price>
```

Example (stone at spawn market):
```
[Buy]
32
stone
$50

[Sell]
32
stone
$20
```

Use separate `[Buy]` and `[Sell]` signs when you want different buy and sell
prices. Line 4 is a single transaction price for that sign.

Operational guardrails:
- never enable broad player access to unrestricted admin shop signs
- monitor rapid balance spikes for dupes/exploit patterns

---

## Kits, Warps, Homes, Nicknames, Spawn

### Kits operations

Typical kit lifecycle:
1. create/edit kit definition
2. set cooldown and permission
3. test with player-rank account

Kit entry in `plugins/Essentials/kits.yml`:
```yaml
kits:
  starter:
    delay: 86400
    items:
      - stone 64
      - oak_planks 32
      - bread 16
```

Common commands:

```text
/kit
/kit starter
/createkit starter 86400
```

### Warps and homes

```text
/setwarp spawn
/setwarp market
/warp spawn
/sethome
/home
/delhome
```

Control limits through permissions and Essentials config values.

### Nicknames and spawn management

`/setspawn` and `/spawn` require the `EssentialsXSpawn` module. Confirm the jar is
installed, the startup log has no module-load errors, and player groups have
`essentials.spawn` before treating a spawn command failure as a location issue.

```text
/nick BuilderOne
/realname BuilderOne
/setspawn
/spawn
```

Keep nickname policy explicit for moderation and impersonation prevention.

---

## Permissions Patterns

Use a permission manager (for example LuckPerms) to model role tiers.

Suggested role intent:
- `admin`: full EssentialsX admin + moderation + economy controls
- `staff`: moderation and support commands, limited economy tools
- `player`: basic homes/warps/msg/pay with guardrails

Example permission outline:

```yaml
groups:
  admin:
    permissions:
      - essentials.*
  staff:
    permissions:
      - essentials.kick
      - essentials.mute
      - essentials.tempban
      - essentials.togglejail
      - essentials.warp
      - essentials.msg
  player:
    permissions:
      - essentials.home
      - essentials.sethome
      - essentials.delhome
      - essentials.spawn
      - essentials.warp
      - essentials.msg
      - essentials.pay
```

Avoid wildcard permissions outside trusted admin roles.

---

## Moderation Workflows

## Workflow: Mute

```text
/mute Alex 30m Chat abuse after warning
/unmute Alex
```

Practice:
- include reason and duration
- log escalation path for repeat behavior

Troubleshooting: mute not applying → verify the EssentialsX core module loaded,
the actor has `essentials.mute`, the target has no mute-exempt state, and no
other moderation or chat plugin is overriding the result. EssentialsXChat
formats chat; it is not a prerequisite for core mute enforcement.

## Workflow: Jail

```text
/setjail intake
/jail Alex intake 20m
/unjail Alex
```

Practice:
- define clear jail reasons
- pair with rollback/repair actions when relevant
- grant `essentials.setjail` only to roles authorized to create or move jail
  locations; staff who only need to jail or unjail players use
  `essentials.togglejail`

Troubleshooting: jail not working → confirm jail location exists with `/setjail intake` and player has no bypass permission.

## Workflow: Temporary Ban

```text
/tempban Alex 7d Repeated harassment
/unban Alex
```

Practice:
- align durations with policy tiers
- document evidence and staff actor

IP bans are separate: `/banip Alex <reason>` resolves the player's last IP and
can affect other players sharing it. Undo an authorized IP ban with
`/unbanip <address>` using the exact banned address; `/unban Alex` only removes
the account ban.

Troubleshooting: tempban not sticking → check `essentials.tempban` permission and that no override plugin (e.g., LiteBans) is conflicting.

---

## Config Pitfalls and Hardening Notes

Common pitfalls:
- mismatched EssentialsX/Vault/provider versions after partial plugin updates
- permissive wildcard grants that expose admin economy commands
- high home/warp limits causing navigation abuse or command spam
- inconsistent chat/nickname rules across staff shifts

Hardening checklist:
- keep a tested baseline config backup before edits
- change one policy area at a time (economy, homes, moderation, chat)
- run staff and player smoke tests after every config rollout
- maintain written policy mapping to command permissions

---

## Operations Runbook: Safe Config Rollout

1. Backup current Essentials config files.
2. Apply targeted config edits.
3. Reload only if plugin docs explicitly support live reload for changed sections.
4. Prefer maintenance restart for sensitive changes.
5. Validate:
   - login flow
   - homes/warps
   - economy transactions
   - moderation commands
6. Keep rollback bundle ready for immediate restore.

---

## References

- https://essentialsx.net/wiki/Home.html
- https://essentialsx.net/commands
- https://essentialsx.net/permissions
- https://essentialsx.net/wiki/modules
- [Configuration defaults](https://github.com/EssentialsX/Essentials/blob/2.22.0/Essentials/src/main/resources/config.yml)
- [Signs](https://wiki.mc-ess.net/wiki/Sign_Tutorial)
- https://github.com/EssentialsX/Essentials/discussions/6552
- https://www.spigotmc.org/resources/vault.34315/

© Jahrome907 · MIT · Jahrome907/minecraft-agent-skills

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
minecraft-bukkit-pro rmyndharis Скилл minecraft-bukkit-pro для Claude Code помогает разрабатывать плагины Minecraft через Bukkit, Spigot и Paper. Включается для архитектуры, команд, событий и оптимизации сервера. CX Codex +1 131установок minecraft-plugin-development официальный github Скилл minecraft-plugin-development помогает создавать и отлаживать серверные плагины для Paper, Spigot и Bukkit. Настраивает команды, слушатели событий, конфиги и игровые механики. CX Codex +1 485установок game-development Seth Hobson Плагин game-development помогает с разработкой игр на Unity с C# и серверных плагинов Minecraft через Bukkit/Spigot API. Укажите агенту, для какой из этих сред нужна работа. CX Codex ★ 42 780звёзд репо minecraft-mcp MakkCH Позволяющий ИИ-агенту управлять персонажем в Minecraft. Агент выполняет JavaScript-сценарии через JsMacros, делает снимки экрана и общается в игровом чате. CX Codex +1 ★ 26звёзд репо mc-asset — Minecraft Pixel Asset Engine smile-minecraft MCP-сервер mc-asset — Minecraft Pixel Asset Engine для Claude Code создаёт текстуры и проверяет ресурс-паки Minecraft Java Edition. Запускается при генерации спрайтов по текстовым сеткам. CX Codex +1 ★ 5звёзд репо Minecraft Wiki l3-n0x MCP-сервер ищет страницы в официальной Minecraft Wiki и отдаёт агенту текст разделов: блоки, мобы, предметы, структуры. CX Codex +1

Из того же набора13

Весь набор →
minecraft-server-admin Скилл minecraft-server-admin для Claude Code ведёт Java-серверы Minecraft: Paper, Purpur, Folia, Velocity, Fabric и NeoForge. Разбирает падение TPS, отказ прокси и ошибки запуска версии. CX Codex +1 279установок minecraft-world-generation Скилл minecraft-world-generation для Claude Code помогает создавать и отлаживать генерацию мира Minecraft в датапаках и модах NeoForge или Fabric. Он подключается к задачам с биомами, измерениями, структурами и регистрацией worldgen-данных. CX Codex +1 269установок minecraft-plugin-dev Скилл minecraft-plugin-dev помогает создавать, менять и отлаживать серверные плагины для Paper и Bukkit-производных серверов. Пригодится при работе с JavaPlugin, событиями и командами. CX Codex +1 267установок minecraft-multiloader Скилл minecraft-multiloader настраивает моды Minecraft на базе Architectury для версий 26.x и 1.21.x с общей кодовой базой под NeoForge и Fabric. Включается при одновременной поддержке обоих загрузчиков. CX Codex +1 247установок minecraft-commands-scripting Скилл minecraft-commands-scripting генерирует и отлаживает команды Minecraft Java 26.x и 1.21.x, цепочки execute, скорборды и RCON-скрипты. Работает со строками команд без сборки структуры датапаков. CX Codex +1 241установок minecraft-ci-release Скилл minecraft-ci-release собирает CI и релизы для модов Minecraft и плагинов Paper: workflow, артефакты, версии, теги и GitHub Release. CX Codex +1 238установок minecraft-imagegen Скилл minecraft-imagegen создаёт и редактирует растровые изображения для Minecraft: иконки паков, баннеры, текстурные концепты и макеты интерфейса. CX Codex +1 213установок minecraft-worldedit-ops Скилл minecraft-worldedit-ops задаёт безопасный порядок команд WorldEdit для Minecraft 26.x и 1.21.x: выделений, масок, схематики, кистей и рельефа. Разводит выделение, замену и вставку с предпросмотром и бэкапами. CX Codex +1 201установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой