Customers

Customer Spawner Blocks

A customer spawner block is the starting point for this mod. Where you place it is where your customers will spawn and what you place inside of it determines what your customers will want to buy from you.

Customers only spawn where they have enough vertical clearance and a 2x2 surface made from solid blocks, slabs, carpet, or stairs.

Open the Customer Spawner interface and change its Max setting to control the maximum number of customers for that individual spawner. Customers that are done buying and are leaving do not count toward this maximum.

Breaking a customer or supplier spawner that still contains items asks for confirmation. Cancel or press Escape to keep the configured spawner in place.

During timed shifts, the customer maximum starts low, ramps up to the spawner’s configured maximum, and ramps down over the final portion of the shift. The longer Day and Night Shifts ramp up more gradually than the shorter meal shifts.

customer-spawners.png

Crafting Customer Spawner Blocks

You can craft a customer spawner block from a bed surrounded by 8 emeralds.

Spawning Modes

The customer spawning modes are mostly around time or shifts, do you configure the spawning mode with a Clock. Hold a Clock and right-click the customer spawner block to cycle through the spawning modes. Each spawning mode change will show a message with the change and change the block texture.

For the time restricted shift modes, the players within 64 blocks of the spawner will get shift messages, progress bars, and a results screen showing the final score, customer totals, total items crafted and served, and each participating player’s crafted and served item counts. The star beside a player is their served item count, while the spoon is their crafted item count. The progress bar shows every item currently requested, grouped by customer with yellow for normal customers, red for impatient customers, and green for casual customers.

Redstone and Customer Spawner

Similar to a hopper, if the Customer Spawner block is in any mode other than Manual and is receiving power, it will turn off spawning. This will allow you to turn off getting new customers when you don’t want to deal with them or if you want to use redstone to control when the shifts are on.

If a Customer Spawner is in Manual mode, a redstone pulse like with a button will spawn a customer. This will let you completely customize the spawning with your redstone contraption.

redstone.png

Controlling Items For Purchase

To control the items the customers can purchase the customer spawner block also acts like a container like a chest. The items or stacks of items you put in the spawner are what the customers can randomly decide to purchase.

The size of the stack is the limit to how many of that item a customer can ask to buy. For example if you have put a single apple in the customer spawner the customer will only ask to buy a single apple. However, if you put a stack of 5 apples in the customer spawner, the customer will decide to randomly buy 1 to 5 apples.

The separate 6 rows in the spawner container are used to define how many different items a customer can decide to buy and what each of those items can be. Each of the 6 container rows is a “slot” for a customer to decide to buy from. The first 8 columns on each row define the items a customer can ask to buy from that row. A customer will only ask for one item per slot, and it will randomly decide how many slots to buy from from 1 to the number of rows you have items in.

The 9th column is the Cost column for its row. The item and count in that slot are the price for the full stack configured in the selected sell slot. If a customer randomly asks for fewer items, the payment is reduced by the same sell-item-to-cost ratio and rounded down, with a minimum payment of one cost item. For example, if 5 apples cost 2 emeralds, a customer asking for 3 apples pays 1 emerald.

The maximum number of customers is not controlled by an inventory item. Use the Max setting in the Customer Spawner interface to set a value from 1 through 99 for that spawner.

Examples:

customer-spawner-inventory.png

customer-trades.png

The Customer Spawner UI is also where you can chnge the spawner mode, set the max customers, and enable different customer appearances.