mccode-ai 1.18.22 → 1.18.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +83 -15
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,15 +1,83 @@
1
- # js
2
-
3
- To install dependencies:
4
-
5
- ```bash
6
- bun install
7
- ```
8
-
9
- To run:
10
-
11
- ```bash
12
- bun run index.ts
13
- ```
14
-
15
- This project was created using `bun init` in bun v1.2.12. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.
1
+ # mccode-ai — CLI
2
+
3
+ > **MCCODE-AI is CLI** — Open-source Minecraft-first fork of [OpenCode](https://github.com/anomalyco/opencode) for building **Paper/Spigot/Purpur/Folia** plugins, **Fabric/NeoForge** mods, **Skript** scripts, **Bedrock** addons and **Discord bots** (discord.js / JDA).
4
+ > Interview → verify versions online → plan in `plans/` → build. Same UX as `opencode`, separate config.
5
+
6
+ **Credit:** Built on top of [anomalyco/opencode](https://github.com/anomalyco/opencode). **Not** affiliated with or endorsed by the OpenCode team. Original at [opencode.ai](https://opencode.ai), `MIT`.
7
+
8
+ ---
9
+
10
+ ### Installation
11
+
12
+ ```bash
13
+ npm i -g mccode-ai # primary — also `mc-code`: npm i -g mc-code
14
+ # or bun / pnpm / yarn
15
+ bun add -g mccode-ai
16
+ pnpm add -g mccode-ai
17
+ yarn global add mccode-ai
18
+
19
+ mccode --help # CLI — same flags as opencode
20
+ mccode --version # check install
21
+ ```
22
+
23
+ All three bins point to the same: `mccode`, `mccode-ai`, `mc-code`.
24
+ Installs side-by-side with `opencode` — own dirs `~/.config/mccode`, `~/.local/share/mccode`, same model catalog including free zen models.
25
+
26
+ Why `mccode-ai` on npm but `mccode` on disk? `mccode` is taken on npm (2019). Published as `mccode-ai` (and `mc-code` alias), binary stays `mccode` so commands stay short: `mccode -s <id>`.
27
+
28
+ ### Quick start — CLI
29
+
30
+ ```bash
31
+ # CLI prompt (no TUI)
32
+ mccode -p "make a paper 1.21 shop plugin with Vault"
33
+
34
+ # run with full permissions
35
+ mccode run "fix the dupe in my GUI"
36
+
37
+ # list agents
38
+ mccode agent list # build (default) + plan
39
+
40
+ # TUI (optional)
41
+ mccode # interactive TUI — separate from CLI
42
+ ```
43
+
44
+ ### Agents
45
+
46
+ - **build** — default, Minecraft builder. Interviews you (edition → platform → verified version → build tool → dependencies like Vault/PlaceholderAPI), verifies every version online, then builds. Full edit access.
47
+ - **plan** — same interview + `plans/<feature>/README.md` contract, but read-only (no file edits except `plans/`). Use to plan a plugin before building.
48
+ - Hidden `mc` harness is now merged into `build`/`plan` — both are Minecraft-aware.
49
+
50
+ General/explore subagents (`@general`, `@explore`) still available for research.
51
+
52
+ ### What it builds
53
+
54
+ - **Plugins:** Paper, Spigot, Purpur, Folia (Gradle Kotlin DSL recommended)
55
+ - **Mods:** Fabric, NeoForge, Forge
56
+ - **Other:** Skript, Bedrock addons, resource packs, Discord bots (discord.js / JDA), Java / Node.js / Gradle / Maven
57
+
58
+ Version-truth rule: never writes a dependency coordinate, `api-version`, or Java requirement from memory — always websearches current stable first and records source URL in `plans/`.
59
+
60
+ ### Side-by-side with opencode
61
+
62
+ ```bash
63
+ mccode # uses ~/.config/mccode
64
+ opencode # uses ~/.config/opencode — untouched
65
+ ```
66
+
67
+ First run: `mccode` will ask to log in a provider (own auth store, separate from opencode).
68
+
69
+ ### Publishing from this fork
70
+
71
+ ```bash
72
+ git clone https://github.com/NOTBOOSTER/mccode.git
73
+ cd mccode
74
+ bun install
75
+ cd packages/opencode
76
+ npm publish --access public # needs npm login with Bypass 2FA token
77
+ ```
78
+
79
+ ### Links
80
+
81
+ - GitHub: https://github.com/NOTBOOSTER/mccode
82
+ - Upstream: https://github.com/anomalyco/opencode — https://opencode.ai/docs
83
+ - Issues: https://github.com/NOTBOOSTER/mccode/issues
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
- "version": "1.18.22",
3
+ "version": "1.18.24",
4
4
  "name": "mccode-ai",
5
- "description": "MCCODE-AI — Minecraft-first fork of OpenCode (Paper/Fabric plugins, mods, Skript, Discord bots). Built on top of anomalyco/opencode.",
5
+ "description": "MCCODE-AI — Open-source Minecraft-first fork of OpenCode for building Paper/Spigot/Purpur/Folia plugins, Fabric/NeoForge mods, Skript scripts, Bedrock addons and Discord bots. Interviews, verifies versions online and plans in plans/ — not affiliated with anomalyco/opencode.",
6
6
  "type": "module",
7
7
  "license": "MIT",
8
8
  "private": false,