New Item Scaffold

Create all required files for a new Mega Knights item.

Arguments

$ARGUMENTS

If arguments were provided, parse them (e.g. "siege_horn Siege Horn"). If not, ask the user:

1. Short name (snake_case, no mk_ prefix, e.g. siege_horn)
2. Display name (Title Case, e.g. Siege Horn)
3. Max stack size (default: 1 — most MK items are unique)
4. Category in creative menu: items, equipment, or nature (default: items)
5. On-use behavior? Does this item do something when used (right-clicked)? If yes, describe it briefly so the skill can decide whether to add minecraft:use_duration and remind the user to wire a scriptevent handler.

Once you have answers, proceed without further prompting.

File Creation Steps

Variables (derive from inputs)

• SHORT_NAME = input without mk_ prefix (e.g. siege_horn)
• IDENTIFIER = mk:mk_<SHORT_NAME> (e.g. mk:mk_siege_horn)
• ICON_KEY = mk_<SHORT_NAME> (e.g. mk_siege_horn) — used in item_texture.json and minecraft:icon
• TEXTURE_PATH = textures/items/<SHORT_NAME> (no extension — Bedrock appends .png automatically)
• DISPLAY_NAME = input (e.g. Siege Horn)

Step 1 — BP Item JSON (MegaKnights_BP/items/tools/mk_<SHORT_NAME>.json)

Base template for a non-wearable tool/scroll/token:

json
1{
2  "format_version": "1.21.40",
3  "minecraft:item": {
4    "description": {
5      "identifier": "mk:mk_SHORTNAME",
6      "menu_category": {
7        "category": "CATEGORY"
8      }
9    },
10    "components": {
11      "minecraft:icon": "mk_SHORTNAME",
12      "minecraft:display_name": {
13        "value": "item.mk:mk_SHORTNAME.name"
14      },
15      "minecraft:max_stack_size": STACKSIZE
16    }
17  }
18}

If the item has on-use behavior (triggers a scriptevent or ability when right-clicked), also add:

json
1"minecraft:use_duration": 1.6,
2"minecraft:use_animation": "eat"

Do NOT add minecraft:food — the eat animation is used for activation feedback without making the item consumable.

Step 2 — item_texture.json Registration

Read MegaKnights_RP/textures/item_texture.json.

Find the "texture_data" object and add a new entry. Keep entries alphabetical by key if possible:

json
1"mk_SHORTNAME": {
2  "textures": "textures/items/SHORTNAME"
3}

Note: The key is ICON_KEY (e.g. mk_siege_horn). The texture path has no file extension.

Use the Edit tool for a surgical insertion — do not rewrite the whole file.

Step 3 — Lang Entries

Add this line to both lang files:

• MegaKnights_BP/texts/en_US.lang
• MegaKnights_RP/texts/en_US.lang

item.mk:mk_SHORTNAME.name=DISPLAY_NAME

Read each file first, then append after the last item.mk: entry to keep it organized.

Step 4 — Texture Reminder

The texture PNG is not created by this skill. Remind the user:

"Create MegaKnights_RP/textures/items/<SHORT_NAME>.png (16×16 or 32×32 px). You can copy the closest existing item texture as a starting point."

Step 5 — On-Use Handler (if applicable)

If the item has on-use behavior, remind the user:

"Wire up the handler in the relevant system file. Listen for ItemUseOnBeforeEvent or ItemUseBeforeEvent in src/systems/<SystemName>.ts, check event.item.typeId === 'mk:mk_<SHORT_NAME>', then call system.run(() => { ... }) for any world mutations."

Step 6 — Build Verification

Run npm run build and report the result. Item files are JSON-only so TS errors are unlikely, but the build confirms the project still compiles cleanly.

Summary Output

After creating files, print a checklist:

✓ MegaKnights_BP/items/tools/mk_<name>.json
✓ item_texture.json — entry added for mk_<name>
✓ Lang entry added to MegaKnights_BP/texts/en_US.lang
✓ Lang entry added to MegaKnights_RP/texts/en_US.lang
⚠ MegaKnights_RP/textures/items/<name>.png — NEEDS MANUAL CREATION
⚠ On-use handler — NEEDS WIRING IN SYSTEM FILE  (if applicable)