{"slug":"minecraft-essentials-ops-4","title":"minecraft-essentials-ops","summary":"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.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-07T18:38:51.964712Z","repo":{"url":"https://github.com/Jahrome907/minecraft-agent-skills","stars":151,"forks":9,"license":"MIT","updatedAt":"2026-09-13T05:52:30Z"},"bodyHtml":"<hr>\n<h2>name: minecraft-essentials-ops\ndescription: \"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.\"</h2>\n<h1>Minecraft EssentialsX Operations Skill</h1>\n<h2>Skill Scope</h2>\n<h3>Routing Boundaries</h3>\n<ul>\n<li><code>Use when</code>: the task is EssentialsX command, config, permissions, economy, or moderation operations.</li>\n<li><code>Do not use when</code>: the task is generic server deployment/proxy/performance architecture (<code>minecraft-server-admin</code>).</li>\n<li><code>Do not use when</code>: the task is writing Java plugin code (<code>minecraft-plugin-dev</code>).</li>\n<li><code>Do not use when</code>: the task is WorldEdit selection/build workflows (<code>minecraft-worldedit-ops</code>).</li>\n</ul>\n<h2>Support Assets</h2>\n<ul>\n<li>Read <code>references/permissions-and-rollout-checklists.md</code> when the task is a permissions audit, economy rollout, or moderation-policy change and you need a compact preflight list.</li>\n</ul>\n<hr>\n<h2>Module Overview and Install Notes</h2>\n<h3>Platform gate</h3>\n<p>Use EssentialsX only on a supported Paper or Spigot server build. EssentialsX\n2.22.0 warns that Folia and Folia forks are unsupported and can lose userdata;\nit also does not support Forge, NeoForge, or Fabric Bukkit-hybrid servers. If\nthe current platform is in either category, stop before enabling or configuring\nEssentialsX and verify a supported operational path. This guide does not\nrecommend a migration.</p>\n<p>Common EssentialsX modules in production:</p>\n<ul>\n<li><code>EssentialsX</code> (core commands and user tools)</li>\n<li><code>EssentialsXChat</code></li>\n<li><code>EssentialsXSpawn</code></li>\n<li><code>EssentialsXProtect</code></li>\n</ul>\n<p>Operational install checklist:</p>\n<ol>\n<li>Match EssentialsX build to your Paper/Spigot API generation.</li>\n<li>Install <code>Vault</code> if using economy providers or permission/chat bridges.</li>\n<li>Start server once and inspect logs for dependency warnings.</li>\n<li>Keep plugin jar versions documented for rollback.</li>\n</ol>\n<p>Version-alignment rule:</p>\n<ul>\n<li>update EssentialsX and companion plugins as a tested batch in staging first.</li>\n<li>verify the exact EssentialsX release or development build supports the target\nPaper release; do not assume a build for 26.1 also supports 26.2.</li>\n</ul>\n<hr>\n<h2>Vault and Economy Basics</h2>\n<h3>Economy stack model</h3>\n<ul>\n<li>EssentialsX can provide economy commands and balances.</li>\n<li>Vault provides a shared bridge so other plugins (shops, jobs, ranks) can read/write balances.</li>\n</ul>\n<p>Verify provider chain:</p>\n<ol>\n<li>Server starts without Vault hook errors.</li>\n<li>Economy commands respond without permission errors.</li>\n<li>Third-party plugin transactions affect balances consistently.</li>\n</ol>\n<h3>Core economy commands</h3>\n<pre><code>/bal\n/baltop\n/pay Alex 250\n/eco give Alex 1000\n/eco take Alex 100\n/eco reset Alex\n</code></pre>\n<p>Use admin economy commands through staff roles only.</p>\n<hr>\n<h2>Shop Pricing and Sign Shops</h2>\n<p>If using EssentialsX signs and economy interactions:</p>\n<ol>\n<li>Define pricing policy:\n<ul>\n<li>starter-tier prices</li>\n<li>anti-inflation sinks</li>\n<li>admin-only item exceptions</li>\n</ul>\n</li>\n<li>Enable only the sign types you intend to support in <code>config.yml</code>:\n<pre><code>enabledSigns:\n  - buy\n  - sell\n</code></pre>\n</li>\n<li>Restrict creation permissions to trusted groups:\n<ul>\n<li><code>essentials.signs.create.buy</code></li>\n<li><code>essentials.signs.create.sell</code></li>\n</ul>\n</li>\n<li>Grant use permissions only to groups that should transact:\n<ul>\n<li><code>essentials.signs.use.buy</code></li>\n<li><code>essentials.signs.use.sell</code></li>\n</ul>\n</li>\n<li>Validate buy/sell math with a non-op player account after config changes.</li>\n</ol>\n<h3>Sign shop formats</h3>\n<pre><code>[Buy]\n&lt;quantity&gt;\n&lt;item&gt;\n&lt;price&gt;\n\n[Sell]\n&lt;quantity&gt;\n&lt;item&gt;\n&lt;price&gt;\n</code></pre>\n<p>Example (stone at spawn market):</p>\n<pre><code>[Buy]\n32\nstone\n$50\n\n[Sell]\n32\nstone\n$20\n</code></pre>\n<p>Use separate <code>[Buy]</code> and <code>[Sell]</code> signs when you want different buy and sell\nprices. Line 4 is a single transaction price for that sign.</p>\n<p>Operational guardrails:</p>\n<ul>\n<li>never enable broad player access to unrestricted admin shop signs</li>\n<li>monitor rapid balance spikes for dupes/exploit patterns</li>\n</ul>\n<hr>\n<h2>Kits, Warps, Homes, Nicknames, Spawn</h2>\n<h3>Kits operations</h3>\n<p>Typical kit lifecycle:</p>\n<ol>\n<li>create/edit kit definition</li>\n<li>set cooldown and permission</li>\n<li>test with player-rank account</li>\n</ol>\n<p>Kit entry in <code>plugins/Essentials/kits.yml</code>:</p>\n<pre><code>kits:\n  starter:\n    delay: 86400\n    items:\n      - stone 64\n      - oak_planks 32\n      - bread 16\n</code></pre>\n<p>Common commands:</p>\n<pre><code>/kit\n/kit starter\n/createkit starter 86400\n</code></pre>\n<h3>Warps and homes</h3>\n<pre><code>/setwarp spawn\n/setwarp market\n/warp spawn\n/sethome\n/home\n/delhome\n</code></pre>\n<p>Control limits through permissions and Essentials config values.</p>\n<h3>Nicknames and spawn management</h3>\n<p><code>/setspawn</code> and <code>/spawn</code> require the <code>EssentialsXSpawn</code> module. Confirm the jar is\ninstalled, the startup log has no module-load errors, and player groups have\n<code>essentials.spawn</code> before treating a spawn command failure as a location issue.</p>\n<pre><code>/nick BuilderOne\n/realname BuilderOne\n/setspawn\n/spawn\n</code></pre>\n<p>Keep nickname policy explicit for moderation and impersonation prevention.</p>\n<hr>\n<h2>Permissions Patterns</h2>\n<p>Use a permission manager (for example LuckPerms) to model role tiers.</p>\n<p>Suggested role intent:</p>\n<ul>\n<li><code>admin</code>: full EssentialsX admin + moderation + economy controls</li>\n<li><code>staff</code>: moderation and support commands, limited economy tools</li>\n<li><code>player</code>: basic homes/warps/msg/pay with guardrails</li>\n</ul>\n<p>Example permission outline:</p>\n<pre><code>groups:\n  admin:\n    permissions:\n      - essentials.*\n  staff:\n    permissions:\n      - essentials.kick\n      - essentials.mute\n      - essentials.tempban\n      - essentials.togglejail\n      - essentials.warp\n      - essentials.msg\n  player:\n    permissions:\n      - essentials.home\n      - essentials.sethome\n      - essentials.delhome\n      - essentials.spawn\n      - essentials.warp\n      - essentials.msg\n      - essentials.pay\n</code></pre>\n<p>Avoid wildcard permissions outside trusted admin roles.</p>\n<hr>\n<h2>Moderation Workflows</h2>\n<h2>Workflow: Mute</h2>\n<pre><code>/mute Alex 30m Chat abuse after warning\n/unmute Alex\n</code></pre>\n<p>Practice:</p>\n<ul>\n<li>include reason and duration</li>\n<li>log escalation path for repeat behavior</li>\n</ul>\n<p>Troubleshooting: mute not applying → verify the EssentialsX core module loaded,\nthe actor has <code>essentials.mute</code>, the target has no mute-exempt state, and no\nother moderation or chat plugin is overriding the result. EssentialsXChat\nformats chat; it is not a prerequisite for core mute enforcement.</p>\n<h2>Workflow: Jail</h2>\n<pre><code>/setjail intake\n/jail Alex intake 20m Griefing spawn edge\n/unjail Alex\n</code></pre>\n<p>Practice:</p>\n<ul>\n<li>define clear jail reasons</li>\n<li>pair with rollback/repair actions when relevant</li>\n<li>grant <code>essentials.setjail</code> only to roles authorized to create or move jail\nlocations; staff who only need to jail or unjail players use\n<code>essentials.togglejail</code></li>\n</ul>\n<p>Troubleshooting: jail not working → confirm jail location exists with <code>/setjail intake</code> and player has no bypass permission.</p>\n<h2>Workflow: Temporary Ban</h2>\n<pre><code>/tempban Alex 7d Repeated harassment\n/unban Alex\n</code></pre>\n<p>Practice:</p>\n<ul>\n<li>align durations with policy tiers</li>\n<li>document evidence and staff actor</li>\n</ul>\n<p>IP bans are separate: <code>/banip Alex &lt;reason&gt;</code> resolves the player's last IP and\ncan affect other players sharing it. Undo an authorized IP ban with\n<code>/unbanip &lt;address&gt;</code> using the exact banned address; <code>/unban Alex</code> only removes\nthe account ban.</p>\n<p>Troubleshooting: tempban not sticking → check <code>essentials.tempban</code> permission and that no override plugin (e.g., LiteBans) is conflicting.</p>\n<hr>\n<h2>Config Pitfalls and Hardening Notes</h2>\n<p>Common pitfalls:</p>\n<ul>\n<li>mismatched EssentialsX/Vault/provider versions after partial plugin updates</li>\n<li>permissive wildcard grants that expose admin economy commands</li>\n<li>high home/warp limits causing navigation abuse or command spam</li>\n<li>inconsistent chat/nickname rules across staff shifts</li>\n</ul>\n<p>Hardening checklist:</p>\n<ul>\n<li>keep a tested baseline config backup before edits</li>\n<li>change one policy area at a time (economy, homes, moderation, chat)</li>\n<li>run staff and player smoke tests after every config rollout</li>\n<li>maintain written policy mapping to command permissions</li>\n</ul>\n<hr>\n<h2>Operations Runbook: Safe Config Rollout</h2>\n<ol>\n<li>Backup current Essentials config files.</li>\n<li>Apply targeted config edits.</li>\n<li>Reload only if plugin docs explicitly support live reload for changed sections.</li>\n<li>Prefer maintenance restart for sensitive changes.</li>\n<li>Validate:\n<ul>\n<li>login flow</li>\n<li>homes/warps</li>\n<li>economy transactions</li>\n<li>moderation commands</li>\n</ul>\n</li>\n<li>Keep rollback bundle ready for immediate restore.</li>\n</ol>\n<hr>\n<h2>References</h2>\n<ul>\n<li><a href=\"https://essentialsx.net/wiki/Home.html\">https://essentialsx.net/wiki/Home.html</a></li>\n<li><a href=\"https://essentialsx.net/commands\">https://essentialsx.net/commands</a></li>\n<li><a href=\"https://essentialsx.net/permissions\">https://essentialsx.net/permissions</a></li>\n<li><a href=\"https://essentialsx.net/wiki/modules\">https://essentialsx.net/wiki/modules</a></li>\n<li><a href=\"https://essentialsx.net/wiki/Module-breakdown.html\">https://essentialsx.net/wiki/Module-breakdown.html</a></li>\n<li><a href=\"https://essentialsx.net/wiki/Configuration-file.html\">https://essentialsx.net/wiki/Configuration-file.html</a></li>\n<li><a href=\"https://essentialsx.net/wiki/Sign-Tutorial.html\">https://essentialsx.net/wiki/Sign-Tutorial.html</a></li>\n<li><a href=\"https://github.com/EssentialsX/Essentials/discussions/6552\">https://github.com/EssentialsX/Essentials/discussions/6552</a></li>\n<li><a href=\"https://www.spigotmc.org/resources/vault.34315/\">https://www.spigotmc.org/resources/vault.34315/</a></li>\n</ul>\n","files":[{"path":"references/permissions-and-rollout-checklists.md","sizeBytes":1501,"isText":true},{"path":"SKILL.md","sizeBytes":8666,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-16T16:00:22.744375Z","sha256":"AF99613DF194320389B04442D93EE61E6D50E255F04C1E9AE32F79DDCE9E85E4","sizeBytes":4629},"review":null,"source":{"repositoryUrl":"https://github.com/Jahrome907/minecraft-agent-skills","path":"plugins/minecraft-codex-skills/skills/minecraft-essentials-ops","license":"MIT","commit":"dd57c5a97741cdc0eb5bb3a8f876581a4f09eeb0","subtreeSha":"20F63CE86401F845C41DE9D12A652E81B22B25BFABBDFD458051633C5738A1F2","lastSyncedAt":"2026-09-25T06:49:17.478439Z"},"reviewedAt":"2026-09-16T16:02:14.358744Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/Jahrome907/minecraft-agent-skills/tree/main/plugins/minecraft-codex-skills/skills/minecraft-essentials-ops"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install jahrome907-minecraft-agent-skills@llmmart"},{"target":"git","command":"git clone https://github.com/Jahrome907/minecraft-agent-skills.git"}]}