spawnpack 0.1.23 → 0.2.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 veedy-dev
+Copyright (c) 2026 ve3dy
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,25 +2,22 @@
 
 Spawnpack is a Bun-powered CLI for scaffolding Minecraft Bedrock add-on projects with a guided terminal wizard.
 
-It generates BP/RP structure, optional Script API setup, optional rgl integration, marketplace-ready namespaced content folders, and optional AI tooling files.
+It generates a paired behavior pack and resource pack, an optional TypeScript script setup built with [rgl](https://github.com/ink0rr/rgl), marketplace-ready resource pack folders, and optional AI agent instructions.
 
 ## Features
 
 - Inline wizard built with `@clack/prompts`
-- Behavior Pack and Resource Pack scaffold
-- Scripting options: None, JavaScript, TypeScript
-- Optional packages:
+- Behavior Pack and Resource Pack scaffold with paired manifests
+- Scripting options: None, TypeScript (always built with rgl)
+- Optional Script API packages:
   - `@minecraft/server`
   - `@minecraft/server-ui`
   - `@minecraft/vanilla-data`
   - `@minecraft/math`
-- Optional `rgl` setup for faster Bedrock builds
-- Optional marketplace add-on structure using nested `namespace/projectId` folders in BP/RP content directories
-- Optional Rockide recommendation during setup
-- Optional AI setup:
-  - `CLAUDE.md` for Claude
-  - `AGENTS.md` for Other
-  - `.mcp.json` with keyless MCP servers
+- Marketplace structure that nests resource pack `textures/` and `sounds/` under `publisher_id/project_id`
+- Optional `AGENTS.md` for AI coding agents
+- Rockide and dprint recommendations in `.vscode/extensions.json`
+- Generated `.gitattributes` with LF normalization and binary rules for pack assets
 
 ## Runtime Requirement
 
@@ -74,56 +71,47 @@ The wizard walks through:
 1. Project name and author
 2. Marketplace add-on structure toggle
 3. Destination folder
-4. Script API setup
+4. Script API setup (`None` or `TypeScript`)
 5. Publisher ID and Project ID when needed
-6. Script packages
-7. `rgl` toggle
-8. Rockide toggle
-9. AI setup choice (`None`, `Claude`, or `Other`)
-10. Review screen and generation
-
-## Generated project options
+6. Script packages when scripting is enabled
+7. `AGENTS.md` confirmation
+8. Review screen with the planned file tree, then generation
+
+## Generated project
+
+Every project gets:
+
+- `packs/BP/manifest.json` and `packs/RP/manifest.json` with paired UUIDs
+- `packs/BP/texts/{en_US.lang,languages.json}` and `packs/RP/texts/{en_US.lang,languages.json}`
+- `packs/RP/blocks.json`, `sounds.json`, `sounds/sound_definitions.json`
+- `packs/RP/textures/{item_texture,terrain_texture,flipbook_textures}.json`
+- Empty content folders for blocks, entities, items, loot tables, recipes, spawn rules, structures, trading, animations, particles, models, UI, and textures
+- `.gitignore`
+- `.gitattributes`
+- `.vscode/extensions.json`
+- `README.md`
+- `AGENTS.md` when requested
 
-Depending on your choices, Spawnpack can generate:
+Projects with TypeScript also get:
 
-- `packs/BP`
-- `packs/RP`
-- `data/scripts/main.ts`
-- `packs/BP/scripts/<publisher-id>/<project-id>/main.js`
-- `package.json`
-- `tsconfig.json`
+- `data/scripts/main.ts` and `data/scripts/tsconfig.json`, plus empty `lib/` and `modules/` folders
+- `package.json` with `typecheck` and `format` scripts
 - `dprint.json`
-- `config.json` for `rgl`
-- `CLAUDE.md`
-- `AGENTS.md`
-- `.mcp.json`
-
-## AI MCP setup
-
-When AI setup is enabled, Spawnpack generates an `.mcp.json` that works out of the box without API keys.
-
-Generated MCP servers currently include:
-
-- Exa hosted MCP (`https://mcp.exa.ai/mcp`) for free, rate-limited web/documentation search
-- `grep_app` for code search
-- `context7` for library documentation context
-
-You can add your own Exa API key later if you need higher Exa limits, but it is not required for the generated scaffold.
+- `config.json` for rgl
+- `filters/typegen/` and `filters/rolldown/`
 
 ## Marketplace structure mode
 
-When enabled, Spawnpack creates marketplace-style nested folders under many BP/RP content directories.
-
-Example:
+When enabled, resource pack assets that Minecraft resolves by bare path are grouped under the publisher and project IDs:
 
 ```text
-packs/BP/animation_controllers/publisher/sample/
-packs/BP/entities/publisher/sample/
-packs/RP/animation_controllers/publisher/sample/
-packs/RP/textures/items/publisher/sample/
+packs/RP/textures/publisher/sample/blocks/
+packs/RP/textures/publisher/sample/entity/
+packs/RP/textures/publisher/sample/items/
+packs/RP/sounds/publisher/sample/
 ```
 
-This helps multiple add-ons coexist more safely in the same world by reducing content path collisions.
+Behavior pack content stays flat. Resource pack JSON still references these assets with paths relative to `packs/RP/`.
 
 ## Script dependency versions
 
@@ -134,7 +122,7 @@ Spawnpack fetches the latest stable npm versions for:
 - `@minecraft/vanilla-data`
 - `@minecraft/math`
 
-If version lookup fails, it falls back to baked stable defaults.
+If version lookup fails, it falls back to baked stable defaults. `min_engine_version` in both manifests follows `@minecraft/vanilla-data`.
 
 Only runtime Script API modules, currently `@minecraft/server` and `@minecraft/server-ui`, are written to the behavior pack manifest. npm-side libraries such as `@minecraft/vanilla-data` and `@minecraft/math` stay in the generated `package.json` for imports and bundling.
 
@@ -146,13 +134,14 @@ bun run typecheck
 bun run build
 ```
 
+`templates/AGENTS.md` and `templates/filters/typegen/main.js` are embedded into `dist/spawnpack.js` at build time, so the published bundle needs no runtime template files.
+
 ## Publish notes
 
 The npm package is configured to publish only:
 
 - `dist/spawnpack.js`
 - `bin/spawnpack.js`
-- `templates/AGENTS.md`
 - `README.md`
 - `LICENSE`
 - `package.json`