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 (useairif the slot must be empty).<location>:- Use
playerto target your own inventory. - Use
x,y,z(e.g.,10,64,10) to target a chest or barrel.
- Use
<amount|objective>:- A number:
64 - A scoreboard name:
money(the script will give items equal to your score). none: Defaults to 1.
- A number:
[Properties]: Optional custom data separated by pipes (|).- Format:
Name | Lore | Keep | Lock | Place | Destroy | Enchants
- Format:
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 1B. 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 1C. 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_balanceD. 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:34. 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,10not10, 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.
The Replaceitem X2 Team
