Placeholder Items

Unlock the full potential of your shopkeepers in Terra Nova with this detailed guide on utilizing placeholder items for advanced trading mechanics. Say goodbye to the limitations of needing to own an item before setting up trades for it. Let’s explore how renamed paper items can revolutionize your shopkeeper trades! 🚀

Placeholder Paper Items: The Trade Game-Changer 🔄

Sometimes, as a merchant, you want to buy items from adventurers that you don’t currently possess. Here’s a clever workaround using placeholder items to create trades for any item, even those not in your inventory. 📝

Creating a Placeholder Item 🔨

1. Renaming Paper: Grab a normal paper item and head to an anvil. Rename the paper to match the name of the item type you wish to trade for. This renamed paper becomes a ‘placeholder item.’ 🏷️

2. Conversion in Shopkeeper Editor: When used in the shopkeeper editor, the placeholder item is instantly recognized and converted into the actual item you intended to trade. If it doesn’t convert, the name likely doesn’t match any known item type. ✨
   

Finding Valid Item Names 📚

• To ensure accuracy, refer to the Spigot Material class documentation: Spigot Material Documentation. Here, you’ll find valid item type names to use for your placeholders.
• Remember, only item names are supported. Blocks without corresponding item names, non-English names, or display names not matching item type names won’t work.

Naming Guidelines and Leniency 🛠️

• Namespace Flexibility: The Minecraft namespace prefix (minecraft:) is optional, and due to character limits in anvils, often better left out.
• Case Insensitivity: The system doesn’t care about uppercase or lowercase characters.
• Whitespace and Characters: Leading/trailing spaces are ignored, and spaces or dashes should be replaced with underscores.
• Color Codes: Any color codes in the name are disregarded.

Important Notes on Placeholder Item Usage 📝

• Item Type Only: Placeholder items can only specify the type of the substituted item. Other properties, like enchantments or custom names, are not supported.
• Versatile Applications: Use placeholder items in selling, buying, and trading setups. This flexibility allows you to set up trades for items you don’t yet have, either to buy or sell.
• Limitations: It’s impossible to trade for the placeholder items themselves within the editor; they are always converted. However, regular paper or incorrectly named paper items can still be traded as usual.

Benefits of Using Placeholder Items 💡

• Trade Expansion: Set up a wider range of trades without the need to have every item in stock.
• Strategic Planning: Prepare your shop for future trades, anticipating what your customers will need or offer.
• Inventory Management: Reduce the need to clutter your inventory with items solely for trade purposes, using placeholders instead.

By incorporating placeholder items into your shopkeeper strategy, you unlock a new level of trading possibilities, making your shop more appealing and versatile to the adventurers of Terra Nova. Embrace this add-on technique to maximize your merchant potential! 🌈🔝