Trading in Aetherra

FantasyShop is Aetherra’s custom trading system. Instead of using chests or currency plugins, players trade items for items using magical shop signs and storage pages.

This system allows for:

Custom item trades (including enchanted and named items)
Bulk trading (multi-stack payments)
Safe, claimable earnings

📦 Step 1: Create a Shop Stock Page

Before you can sell anything, you need a stock page.

Use:

/shopstock create <name>

Example:

/shopstock create Bread

Then open it:

/shopstock open <name>

Place all items you want to sell into this inventory.

👉 Think of this as your shop’s “warehouse.”

Step 2: Create a Shop Sign

Place a sign
Look directly at it
Hold the item you want to SELL
Run:

/shopadd give <amount> <stockName>

Example:

/shopadd give 32 Bread

Hold the item you want as PAYMENT
Run:

/shopadd cost <amount>

Example: while holding a diamond

/shopadd cost 3

✅ Your shop is now active!

Alternatively, to make a random roll shop use:

/shopadd gacha <stockName>

Creates a random reward shop using a stock pool

Step 3: How Trading Works

Players can:

Right-click your sign
Hold the required payment item
Receive the item instantly (if stock is available)

Important rules:

You must hold the correct item to pay
Items must match exactly (including enchantments and names)
You must have enough inventory space

Step 4: Claim Your Earnings

When someone buys from your shop, you don’t receive items instantly.

Instead, they are stored safely for you.

Use:

/shoppayment

This will:

give you all available earnings
keep extra items stored if your inventory is full

❌ Removing a Shop

Look at your shop sign and run:

/shopremove

Only the owner (or admins) can remove a shop.

🧹 Canceling Shop Setup

If you make a mistake while creating a shop:

/shopadd cancel

⚠️ Common Mistakes

❌ Using the wrong stock name
❌ Holding the wrong item when setting cost/give
❌ Trying to buy with a similar but different item
❌ Full inventory when purchasing

💡 Tips for Successful Shops

Use clear stock names (ex: Bread, Sugar_Cane. UnbreakingIII)
Keep stock pages organized
Check your /shoppayment regularly
Test your shop once after creating it

🛍️ Additional Commands

Edit Shops

/shopedit give

Change the item being sold

/shopedit cost <amount>

Change the price

/shopedit amount <amount>

Change how many items are given per purchase

Stock Management

/shopstock add <stockName>

Add items to a stock pool

/shopstock list

View your stock pools
Clickable + hoverable display

/shopstock open <stockName>

Open and manage stock inventory

👑 Admin Commands

/shopadmin refreshall

Refresh all shop signs (updates formatting, colors, etc.)

🎲 Gacha System Guide

Gacha shops pull from stock pools
Example: /shopstock add ores
/shopadd gacha ores
Supports:
- Multiple gacha types (ores, dyes, enchantments, etc.)
- Custom reward amounts per shop

Bundle Shops

New in FantasyShop 1.1.0

Bundle Shops allow a seller to combine several different items into a single purchase.

For example, instead of creating three separate shops, you could create one Veggie Bundle containing:

2 Potatoes + 2 Carrots + 2 Pumpkins

A buyer pays the configured price once and receives the entire bundle.

Creating a Bundle Shop

First, create a stock page like you would for any other FantasyShop:

/shopstock create veggie

Open the stock page:

/shopstock open veggie

Place the items you want available for sale into the stock inventory, then close the inventory to save it.

Next, start the Bundle Builder:

/shopadd bundle veggie

The Bundle Builder GUI will open.

Click an item from your inventory to add it to the bundle. Selecting an item already in the bundle allows you to change its quantity using the on-screen controls:

-16    -1    REMOVE    +1    +16

You can also use Clear Bundle, Cancel, or Save Bundle.

The items you click in your inventory are used as templates—the Bundle Builder does not consume those items.

When your bundle is finished, select Save Bundle.

Now hold the item buyers should pay with, look directly at the sign you want to turn into the shop, and run:

/shopadd cost <amount>

For example:

/shopadd cost 1

If you are holding a Diamond, the Bundle Shop will charge 1 Diamond.

The sign will become a [BUNDLE] shop.

👀 Previewing a Bundle

Before purchasing, buyers can left-click the Bundle Shop sign.

This opens a read-only preview showing:

every item included in the bundle
the quantity of each item
the purchase price
the total number of items in the package
the number of complete bundles currently available

Nothing is purchased while viewing the preview.

For example:

Veggie Bundle

Potato ×2
Carrot ×2
Pumpkin ×2

Cost: Diamond ×1
Available Bundles: 8

The availability number is based on how many complete packages the shop can make.

For example, if a bundle requires:

2 Potatoes
2 Carrots
2 Pumpkins

and the stock contains:

20 Potatoes
20 Carrots
6 Pumpkins

only 3 complete bundles are available because Pumpkins are the limiting item.

🛒 Purchasing a Bundle

Right-click the Bundle Shop sign to purchase.

FantasyShop checks the entire transaction before completing it.

The purchase will only succeed if:

the shop has enough of every required bundle item
the buyer has the correct payment
the buyer has enough inventory space for the entire bundle

A Bundle Shop will never intentionally sell only part of a package.

If something prevents the complete transaction, the purchase is cancelled rather than leaving the buyer with an incomplete bundle.

✏️ Editing a Bundle Shop

Shop owners can change an existing Bundle Shop.

Look directly at the Bundle Shop sign and run:

/shopedit bundle

The Bundle Builder will reopen with the current package already loaded.

Change the items or quantities and select Save Bundle.

You can still change the shop’s price separately:

/shopedit cost <amount>

Or move the shop to another stock page:

/shopedit stock <stockName>

Bundle contents should be changed through /shopedit bundle rather than /shopedit item or /shopedit amount.

🌍 Aetherra Economy Philosophy

FantasyShop is built around true item-for-item trade:

No artificial currency required
Players define value
Markets evolve naturally

Your shop is your business – price wisely.

Welcome to the marketplace.

FantasyShop Guide