Welcome

_images/opening.png

Patchwork is a Minecraft Forge mod that adds a small collection of blocks, items, and features that I need for a private pack. It has an extensive configuration so modpack authors can tailor behavior.

MIT License

Copyright 2018 OreCruncher

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

3D Furnace

_images/3dfurnace.png

The 3D furnace behaves in a way very similar to the regular Minecraft furnace. The big difference between the two furnaces is that the 3D version shows the content of the furnace without having to open up the furnace GUI.

The other main feature of the 3D furnace is that the player can interact with it in a natural way:

  • Right clicking the block will remove any smelted material from the furnace, collecting any XP that has been generated.
  • Right clicking while holding furnace fuel will put it in the fuel slot assuming the current fuel ItemStack is compatible.
  • Right clicking with other ingredients will add them to the input slot assuming the current input ItemStack is compatible.
  • Shift+Right click will open the GUI without the interaction behavior.

While operating the furnace interior will glow, and the furnace itself will give off light at level 7. It will flame and smoke while it is lit. Once smelting has completed the light will turn off and the furnace will no longer glow.

Configuration

  • furnace.immersiveInteraction Enables/disables the ability of the player to interact with the furnace by right clicking with their hand.
  • items.enableFurnace Enable/disable crafting of the furnace.

Shop Shelf

_images/shopshelf_wood.png _images/shopshelf_stone.png _images/shopshelf_glass.png

The Shop Shelf is a special block that allows for trading between players on a server. Operationally it is like the Vending Machine block from my old 1.7.10 mod Thermal Recycling.

When the Shop Shelf is initially placed into the world it is unowned. The first player to open the Shop Shelf will become the owner.

As an owner you can do several things:

  • The Shop Shelf can be reskinned to a different texture. To do this just right click with a block and it will take on that texture. (Examples shown above.)
  • The Shop Shelf can be opened in trade mode by Shift+Right click. This is the GUI that non-owners will see when opening the Shop Shelf.
  • The Shop Shelf can be opened in configuration mode by a simple right click.
  • It can be broken with an axe, and it will drop with all it’s inventory stored in the ItemStack.

The owner can configure up to 6 different trades. Each trade can accept up to 2 input ItemStacks, and offer ItemStack that the player would receive in return.

_images/shopshelf_configure.png

In the picture above the Shop Shelf is identified as belonging to OreCruncher. The top grouping of slots are for trade, the center grouping of slots is the internal inventory of the Shop Shelf, and the bottom group of slots is the player inventory.

As you can see there are two configured trades: one that wants 8 stone and in return it will give a Sunflower, and the other that wants a Copper Coin and offers an Oak Plank in return. The Sunflower has a background of green meaning that there is enough Sunflower items in the Shop Shelf inventory to satisfy the trade. However, there are not enough Oak Planks so it’s background is shaded red.

A non-owner is capable of opening up the Shop Shelf and performing trades.

_images/shopshelf_trade.png

Configuring Trades

Configuration is pretty straight forward. The trade slots are ghost slots. Clicking on them with an item stack will set the slot to that item type and quantity. When the mouse cursor is over a slot several other short cuts methods for manipulating the slot content are available:

  • Wheel on the mouse. This will cause the quantity to go up/down depending on the direction the wheel is scrolled.
  • Left Click. Reduce the stack by one.
  • Shift+Left Click. Reduce the stack by half.
  • Right Click. Increment the stack by one.
  • Shift+Right Click. Double the stack size.

The region below the configuration slots is the Vending Machines inventory. Items that are to be handed out are placed into this inventory. Items that a player gives in return are also placed into this inventory. Make sure you leave empty space to hold incoming trade items. If there isn’t space a trade will not happen.

Trading Items

Trading is pretty easy. Just click on the item stack that is being offered for trade. The item(s) that are wanted in exchange are automatically taken from the player inventory and added to the Shop Shelf inventory. The offered item will automatically be placed directly into the player inventory.

A trade could fail for several different reasons:

  • The Shop Shelf ran out of a particular item to give out.
  • The Shop Shelf does not have space in it’s inventory to accept items in return.
  • The player does not have space in their inventory to get the item.
  • The player does not have the right items to give in exchange.

Server Shop Shelf

A Server Shop Shelf essentially has a bottomless inventory. It has infinite amount of items to hand out, and can accept an infinite amount of items in return. The operation is similar to Admin signs that are found on Bukkit servers.

New in version 0.2.0.0.

To create a Server Shop Shelf open an unowned Shop Shelf while in creative mode. Patchwork will automatically set the Server Shop Shelf role.

Notes

  • While the shop is owned it cannot be broken by another regular player, and it cannot be blown up with creepers or TNT. I’m not sure if it would survive a Draconic Evolution reactor explosion.
  • Automation is not possible with the Shop Shelf. Items cannot be piped in or extract using transfer pipes, hoppers, and similar devices.
  • Any player that is in creative mode can interact with the Shop Shelf as if they were the owner. This is to permit Administrators on servers latitude to administer their servers.

Configuration

  • items.enableShopShelf Enable/disable the crafting recipe for the Shop Shelf.

Coins

_images/coins.png

Patchwork adds 5 different coins: Copper, Bronze, Silver, Gold, and Platinum. The coins can be obtained as drops by killing mobs, or by finding in chests in villages, dungeons, strongholds, etc.

The coins can be used as barter when interacting with other players, or used with Shop Shelves to conduct a trade.

Coins can be combined to create a coin of the next larger denomination: 9 Copper to make a Bronze, 9 Bronze to make a Silver, 9 Silver to make a Gold, and 9 Gold to make a Platinum.

For server owners Coins can be handed out as rewards for things like voting, and can be used to purchase items at Server Shops. For modpack makers coins could be handed out as quest rewards, and used as items to satisfy quests.

Configuration

  • coins.mobsDropCoins Enable/disable coins as mob drops when a player kills a mob. Mobs do not drop coins if killed by other means (fall traps, machines, etc.)
  • coins.spawnAsLoot Enable/disable coins in the various loot tables.
  • items.enableCoins Enable/disable coin recipes.

Repair Paste

_images/repair.png

Repair paste is used to repair damaged items. It can be found randomly in village blacksmith chests as well as various dungeon chests throughout the world. It cannot be crafted by the player.

To repair a damaged item combine the item with Repair Paste and a Set of Tools in a crafting grid. Each paste will repair up to 100 points of damage. If a stack or more of Repair Paste is provided the crafting operation will deduct an amount needed to fully repair the item. The Set of Tools will be damaged based on the amount repaired.

It is recommended that the traditional method of Anvil repair should be used as long as possible to repair an item. When the cost of Anvil repair becomes prohibitive, Repair Paste should be used.

Configuration

  • items.enableToolRepair Enable/disable the ability to repair tools with Repair Paste.
  • repairpaste.repairAmount Amount of damage to repair per paste.

Ring of Flight

_images/ringofflight.png

The Ring of Flight gives the player creative flight capability when equipped in a Baubles ring slot. There are 5 types of rings:

  • Flight Core. Does not give flight ability itself but is used to create the other rings. There is no crafting recipe for the core - it has to be discovered in a village blacksmith or dungeon chest.
  • Avian Leg Ring Band. Basic flight ring crafted with a Flight Core and Feather Wings. Has the least durability of the rings.
  • Ring of Methodical Flight. This ring has much more durability than the Avian Leg Ring, but is much slower as well. It is crafted using the Flight Core and Obidian Wings.
  • Stout Ring of Flight. This ring has a little less durability than Methodical Ring, but the flight speed is the same as the Avian Leg Ring. It is crafted using the Flight Core and Sturdy Wings.
  • Ring of the Zephyr. This ring has less durability than the Methodical Ring, but faster flight speed than the other rings. It is crafted using the Flight Core and Speedy Wings.

The Feather and Obsidian Wings can be crafted by the player. The Stout and Speedy Wings cannot be crafted, and have to be found in village blacksmith and dungeon chests.

Each of the rings has a durability that will be consumed when the player flies. When the durability reaches 0, the player will drop to the ground and will take damage if the fall distance is high enough.

New in version 0.2.2.0.

To refuel a Ring of Flight combine the item with Essence of Flight and a Set of Tools in a crafting grid. Each Essence of Flight will repair up to 5000 points of flight time. If a stack or more of Essence of FLight is provided the crafting operation will deduct an amount needed to fully charge the item. The Set of Tools will be damaged based on the amount refueled.

Ring Flight Duration Comment
Avian Leg Ring Band 15 - 16 minutes Feather Wing
Ring of Methodical Flight 62 - 63 minutes Obsidian Wing
Stout Ring of Flight 46 - 47 minutes Sturdy Wing; must be found
Ring of the Zephyr 31 - 32 minutes Speedy Wing; must be found

Configuration

  • items.enableRingOfFlight Enables/disables loot table inclusion and recipes for the ring.
  • features.renderWings Enables/disables rendering of wings on player’s back.
  • ringofflight.refuelAmount Amount per Fire Charge repaired

Mob Net

_images/mobnet.png

The Mob Net is an item that allows the capture and transport of entities in the world. By default only passive mobs can be captured, but options can be enabled to permit the capture of Villagers and hostile mobs.

To capture a mob the player has to be in range. Right click the mob with an empty net will capture. To release the mob target an empty block face and right click.

When captured the title of the Mob Net will change to reflect the mob that has been captured.

Mob Net’s are not stackable.

Configuration

  • items.enableMobnet Enable/disable crafting of the Mob Net
  • mobnet.enableHostileCapture Enables/disables capture of hostile mobs, like Zombies and Creepers.
  • mobnet.enableVillagerCapture Enables/disables capture of Villagers.
  • mobnet.reusable Enables/disables reuse of a Mob Net. If disabled the Mob Net will disappear once the mob has been released.

Wood Pile

_images/woodpile.png

A Wood Pile is a simple multi-block structure which is used to make charcoal. The process is pretty easy:

  • STEP 1 Craft a bunch of Wood Pile blocks.
  • STEP 2 Place the Wood Pile blocks adjacent to each other. Number of layers does not really matter.
  • STEP 3 Cover up the pile using non-flammable solid blocks, like Dirt or Cobblestone. Leave one block surface exposed.
  • STEP 4 Light the exposed surface on fire. A good method is Flint and Steel. Once the fire has started, cover up the block. (This will put the fire out but the Wood Pile is actively burning.)

Let the Wood Pile burn. While burning smoke particles will be emitted and a burning sound will be heard. When the Wood Pile first starts burning the smoke particles are rather large and the fire sound will be loud and crackly. The closer it gets to being finished the smaller the smoke particles become and the burning sound more mute.

Once all signs of burning have ceased uncover the pile to expose the Ash Blocks underneath. Break the Ash Blocks with an Axe to drop charcoal. The amount of charcoal dropped per block is 8, and is affected by Fortune.

If you uncover the Wood Pile too soon the exposed burning Wood Pile will quickly turn to a fire. You will need to fill the gap with a solid non-flammable block to seal the pile back up.

Note

If the Wood Pile has multiple levels the smoke particles from the lower levels may not be seen. Make sure you give a good listen to hear if the burning has stopped before uncovering the Wood Pile.

If you don’t use non-flammable solid blocks fire will spread. This will destroy any other Wood Pile blocks adjacent, and of course it could spread to the rest of the area. Only you can prevent forest fires.

Configuration

  • items.enableWoodPile Enable/disable the Wood Pile recipe.
  • ashblock.yield The amount of charcoal that is dropped when an Ash Block is broken.
  • woodpile.tickRate The number of ticks between stage checks. The Wood Pile has 8 burning stages.

Prevent drops from Spawner Mobs

By default Patchwork will cancel drops from mobs that have spawned from mob spawners. Purpose is to encourage the player to go out exploring rather than camping spawners for ingredients. This does not block XP drops, however.

Configuration

  • features.noDropsFromSpawnerMobs Enables/disables this feature

Adjust Mob Spawn Quantity

New in version 0.2.3.0.

The mob spawn cap for natural spawns can be adjusted by enabling the Change Mob Quantities feature. This feature is off by default so you would have to specifically enable it.

During the normal world tick Minecraft will spawn mobs based on their class and the class mob cap. The Minecraft defaults are:

Class Mob Cap Example
MONSTER 70 Skeletons and Zombies
CREATURE 10 Cows, pigs, and sheep
AMBIENT 15 Bats
WATER_CREATURE 5 Derpy Squids

Minecraft will cap the number of mobs of a given type within all currently loaded chunks. Note that this only applies to natural spawning. Mob spawns from spawners and other modded sources can exceed this cap. However, once spawned they will affect the natural mob spawn process. (This is why you see less mobs in the world on servers where players have mob spawn systems producing large quantities of mobs. Not that I am salty or anything…)

Keep in mind that Minecraft has worldgen related mob spawn. This is entirely separate from natural mob spawn. Worldgen spawns occur when a chunk is initially created. This is how you get all the cows and pigs populated in new chunks. As you can see by the CREATURE cap in the table above (10) natural spawn for animals is limited to 10 mobs in all currently loaded chunks. This is why you rarely see animals spawn on servers. It is more than likely a player has an animal pen with at least 10 mobs, and once that chunk is loaded no more natural animal spawn will occur. You will have to find newly generated chunks.

OK - so why use this feature?

  • You can increase the number of hostile mob spawns by increasing the MONSTER cap. Quantity has a quality all it’s own.
  • You can decrease the number of Bats and Squids. If you want to reduce the quantity of these mobs and not eliminate them entirely tweak the values down.

Note

Mods can do their own mob spawning and not adhere to what Minecraft rules are. This feature cannot do anything about that. All this feature does is modify the constant values that Minecraft uses.

Configuration

  • features.modifyMobQuantity Enable/disable modification of mob spawn caps.
  • mobquantity.ambient Change the AMBIENT mob quantity cap.
  • mobquantity.creature Change the CREATURE mob quantity cap.
  • mobquantity.monster Change the MONSTER mob quantity cap.
  • mobquantity.water Change the WATER mob quantity cap.