it replaces items in inventorys/containers with more passion then normal /replaceitem

1. The Command Syntax

text

/scriptevent my:replaceitem <newItem> <slot> <target> <location> <amount|objective> [Properties]

2. Argument Guide

<newItem>: The item you want to give (e.g., minecraft:diamond).
<slot>: The slot index (0 is the first slot).
<target>: The script checks this slot first. It only replaces the item if the slot contains this target (use air if the slot must be empty).
<location>:
- Use player to target your own inventory.
- Use x,y,z (e.g., 10,64,10) to target a chest or barrel.
<amount|objective>:
- A number: 64
- A scoreboard name: money (the script will give items equal to your score).
- none: Defaults to 1.
[Properties]: Optional custom data separated by pipes (|).
- Format: Name | Lore | Keep | Lock | Place | Destroy | Enchants

3. Usage Examples

A. Basic Swap (Empty Slot Only)

Place a torch in slot 0 of a chest at 10, 64, 10, but only if the slot is empty:
/scriptevent my:replaceitem minecraft:torch 0 air 10,64,10 1

B. Upgrade System (Targeted Replace)

Turn a player's wooden_sword in slot 0 into a stone_sword:
/scriptevent my:replaceitem minecraft:stone_sword 0 minecraft:wooden_sword player 1

C. Scoreboard Shop (Dynamic Amount)

Give the player a number of gold ingots equal to their "gold_balance" score:
/scriptevent my:replaceitem minecraft:gold_ingot 0 air player gold_balance

D. Advanced Item (Using Properties)

Replace an empty slot with a named, enchanted sword. Note the pipes | used to skip empty sections:

/scriptevent my:replaceitem minecraft:iron_sword 0 air player 1 "Hero Sword" | "Legacy Blade" | true | none | none | none | sharpness:3

4. Special Logic Features

Stacking: If the slot already contains the <newItem>, the script won't replace it; it will simply add the amount to the existing stack (up to 64).
Coordinates: When using coordinates, don't use spaces between the numbers (use 10,64,10 not 10, 64, 10).
Safety: If the <target> doesn't match what is currently in the slot, the script does nothing. This prevents accidentally deleting a player's valuable items.

Replaceitem X2