Be it from the ruins of an ancient city, the umbral depths that lurk below the surface or from the body of some hostile foe, scrap can be found anywhere. It has the potential to be great fortune or nothing more than trash. Exactly what and where Scrap can be found is up to you. Scrap is designed as mod to be used by modpack makers to add items that generate items using Minecraft's LootTable system. Scrap can be configured to use any existing LootTable be it chest loot, mob drops, or even fishing attempts. They all work. You can also supply your own LootTable using Scrap itself.

Before attempting to make your own LootTable, I'd recommend reading up on them over at the Minecraft Wiki, https://minecraft.gamepedia.com/Loot_table

To use Scrap you will also need a method to acquire the Piles of Scrap. You will need a mod like InControl by McJty that lets you add drops on death or you can give out Piles of Scrap as rewards when using a questing mod. Heck, if you're crazy enough you could make a recipe using Craft Tweaker. It's up to you.

By default Scrap is configured to create a single Pile of Scrap that generates Dungeon loot. It's provided mostly as an example but it is not all that is possible.

S:loot_tables <
  Dungeon@minecraft:chests/simple_dungeon@3d4@#ab948b@#269463
 >

Every entry can be broken down to two main parts. The Name of the Pile and the Resource Path of the Loot Table. In this example the name is 'Dungeon' and the Loot Table being used is 'minecraft:chests/simple_dungeon'. Every entry requires at least these two parts, each separated by the '@' character. The remaining three entries are XP to be award when used and the color overlays to use for the Pile of Scrap icon, in Hexadecimal format. XP Dice and the two color overlays are optional. If you provide only a single overlay color, it will be used for both the plate and the gear.

You can also load in Custom Loot Tables by adding the appropriate Loot Table JSON file to the Config\Scrap directory of your Minecraft instance. Again, check out the Minecraft Wiki if you have questions on how to setup LootTables or check out what vanilla provides as a base.

Entries added via the Scrap folder will use the LootTable of 'scrap:your file name here'

As an example in the following entry...

S:loot_tables <
    Parts@scrap:scrap@3d4
    City Chest@scrap:chest@ab948b@269463
 >

… will create two Piles of Scrap in the Scrap Creative Tab. The first one generates loot from a Loot Table called scrap.json in the Config\scrap folder and uses the default colors for the Pile of Scrap. It will also bestow 3d4(3 to 12) experience. The second entry generates loot from a table called chest.json that is also located in the Config\scrap folder, however this one specifies the colors of the Pile of Scrap and does not give any experience.

It is important to note that this step, while recommened, is not required. The look and function of a Pile of Scrap is determined by it's NBT data and as such you can create unique Piles of Scrap directly in CraftTweaker or InControl by defining the items NBT information.

The five Tags used are 'NAME', 'TABLE', 'GEAR', 'PLATE', and 'XP'. Each holds a String representation of the data that would normally be entered in the scrap config file.

As an example, you could use the following command to give all players a Pile of Scrap that generates the loot of killing a Cow, has a Red Gear and a Green Plate, and gives 2 to 16 XP... all without having to define it in the configuration file.

/give @a scrap:scrap 1 0 {NAME:"Cow",TABLE:"minecraft:entities/cow",GEAR:"FF0000",PLATE:"00FF00",XP:"2d8"}

There also some other Configuration options worth mentioning.

  # If True, XP granted will be given directly to the player. Otherwise XP Orbs will spawn at their feet<br />  B:easyXP=true<br />  # Enables Chipped Gears
  B:enableBrokenGears=false
  # Enables Dented Plates
  B:enableBrokenPlates=false
  # Enable Opening a stack of Scrap at a time when Sneaking. Watchout for overflow
  B:rightclick_stack=false&nbsp;

enableBrokenGears and enableBrokenPlates will cause the mod to register Chipped Gears and Dented Plates based on the metals of Thermal Foundation. These items have no recipes and no uses. They are intended for use with CraftTweaker primarily. Both of these options are disabled by default.

rightclick_stack is what it sounds like. It allows you to open a stack of Scrap at a time when right clicking... well so long as you're also sneaking. This option is off by default as any excess items will drop at your feet. This could potentially be... Bad. easyXP determines if XP is given directly to the player or instead spawns as XP orbs at their feet.