Item Search Guide - ShockerAttack01/MinecraftCommandGenerator GitHub Wiki

Item Search Guide

The Minecraft Command Generator provides a powerful item search system that helps you quickly find and select items for your commands.

Basic Search

Using the Search Box

  1. Type any part of an item's name.
  2. Suggestions appear in real-time.
  3. Click on a suggestion to select the item.
  4. The selected item appears in the command.

Search Tips

  • Search is case-insensitive.
  • Partial matches work (e.g., "sword" finds "diamond_sword").
  • Spaces are automatically converted to underscores.
  • Special characters are handled automatically.

Example

search_box.set_query("diamond")
results = search_box.get_suggestions()
print(results)  # Output: ["diamond_sword", "diamond_pickaxe", "diamond_helmet"]

Category Filtering

Available Categories

  • All Categories
  • Tools
  • Weapons
  • Armor
  • Food
  • Blocks
  • Materials
  • Redstone
  • Transportation
  • Miscellaneous

Using Categories

  1. Select a category from the dropdown.
  2. Search within that category.
  3. Suggestions are filtered by category.
  4. Switch categories at any time.

Example

search_box.set_category("tools")
results = search_box.get_suggestions()
print(results)  # Output: ["diamond_pickaxe", "iron_shovel", "golden_axe"]

Advanced Features

Real-time Suggestions

  • Suggestions update as you type.
  • Shows up to 10 matching items.
  • Displays formatted item names.
  • Maintains proper item IDs.

Item Validation

  • Validates item IDs automatically.
  • Prevents invalid item selections.
  • Shows error messages for invalid items.
  • Maintains command integrity.

NBT Data Support

  • Add custom NBT data to items.
  • Format: {key:value}.
  • Validates NBT syntax.
  • Supports complex NBT structures.

Example

item.set_nbt_data({"Enchantments": [{"id": "sharpness", "lvl": 5}]})
print(item.get_command())  # Output: /give @p diamond_sword{Enchantments:[{id:"sharpness",lvl:5}]}

Common Tasks

Finding Specific Items

  1. Use the category filter.
  2. Type the item name.
  3. Select from suggestions.
  4. Verify the item ID.

Adding Custom Items

  1. Select the base item.
  2. Add NBT data.
  3. Verify the command.
  4. Test in-game.

Bulk Item Selection

  1. Use target selectors.
  2. Set amount parameter.
  3. Add NBT data if needed.
  4. Verify the command.

Troubleshooting

Common Issues

  • Item not found:

    • Check spelling.
    • Try a different category.
    • Use a partial name.
    • Verify the item exists.

  • Invalid NBT:

    • Check syntax.
    • Verify data types.
    • Use proper format.
    • Test in-game.

Tips

  • Use categories to narrow search.
  • Try different search terms.
  • Check item documentation.
  • Verify command output.

Related Topics