# prismarine-loottable
> A small utility package to help in parsing Minecraft loot tables.
Latest version **1.0.0** (published 2020-08-23) · MIT license · 0 weekly downloads
## Install
```sh
npm install prismarine-loottable
pnpm add prismarine-loottable
yarn add prismarine-loottable
bun add prismarine-loottable
```
## Health
**Score 25/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned.
## Facts
| | |
|---|---|
| Version | 1.0.0 |
| Published | 2020-08-23 |
| First published | 2020-08-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 19.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | TheDudeFromCI |
| Maintainers | rom1504 |
| Keywords | prismarine, template |
## Links
- npm: https://www.npmjs.com/package/prismarine-loottable
- Repository: https://github.com/PrismarineJS/prismarine-loottable
- Homepage: https://github.com/PrismarineJS/prismarine-loottable#readme
- Issues: https://github.com/PrismarineJS/prismarine-loottable/issues
- npm.io page: https://npm.io/package/prismarine-loottable
## Alternatives
- [@oh-my-pi/pi-natives](https://npm.io/package/@oh-my-pi/pi-natives.md) — 51.8K weekly downloads
- [@capgo/capacitor-light-sensor](https://npm.io/package/@capgo/capacitor-light-sensor.md) — 3.0K weekly downloads
- [@heyhuynhgiabuu/pi-diff](https://npm.io/package/@heyhuynhgiabuu/pi-diff.md) — 492 weekly downloads
- [@lotsa/verdant-lang-asm](https://npm.io/package/@lotsa/verdant-lang-asm.md) — 38 weekly downloads
- [new-era-syntax](https://npm.io/package/new-era-syntax.md) — 20 weekly downloads
## Recent versions
- 1.0.0 (latest) — 2020-08-23
## README
# prismarine-loottable
[](http://npmjs.com/package/prismarine-loottable)
[](https://github.com/PrismarineJS/prismarine-loottable/actions?query=workflow%3A%22CI%22)
[](https://discord.gg/GsEFRM8)
[](https://gitter.im/PrismarineJS/general)
[](https://irc.gitter.im/)
[](https://gitpod.io/#https://github.com/PrismarineJS/prismarine-loottable)
A utility package for parsing Minecraft loot table files.
Based on Loot Table format: https://minecraft.gamepedia.com/Loot_table
## Usage
```js
const getPotentialDrops = require("prismarine-loottable").getPotentialDrops;
const lootTable = require('./path/to/table.json')
const drops = getPotentialDrops(lootTable)
const itemType = drops[0].itemType
const silkTouch = drops[0].requiresSilkTouch()
```
## API
### Global Functions
`getPotentialDrops(lootTable: MinecaftLootTable): LootItemDrop[]`
This function can be used to directly parse a raw Minecraft loot table to pull out all potential drops as well as conditions required for that item to drop and functions that applied to the item (or user) in order. It returns a list of potential item drops.
### Classes
_**LootItemDrop**_
This object is the main object returned from the `getPotentialDrops` function. It contains information about the details involved in getting this item to drop from the table.
* `lootItemDrop.itemType: string`
Gets the name of the item type which is dropped. This is a namespaced value.
* `lootItemDrop.minCount: number`
The smallest number of this item type which can be dropped, assuming all conditions are met. This does not take functions into consideration, which may change this value.
* `lootItemDrop.maxCount: number`
The maximum number of this item type which can be dropped assuming all conditions are met. This does not take functions into consideration, which may change this value.
* `lootItemDrop.functions: LootFunction[]`
The list of all functions that should be applied to this item drop, in order. Some functions may contain additional conditions required for them to occur.
* `lootItemDrop.conditions: LootCondition[]`
The list of all conditions which are required for this item drop to occur. This list contain conditions from both the item drop entry as well as the pool the item drop is in. These conditions do not have to be applied in any other but all conditions must be true.
* `lootItemDrop.weight: number`
The randomness weight of this item drop within the pool, relative to other entries in the pool. Items with a higher weight are more likely to be dropped than items with a lower weight compared to other entries in the same pool.
* `lootItemDrop.quality: number`
The bonus weight to add for each point of luck being used. The new weight value is calculated via the formula: `floor(weight + (quality * generic.luck))` More information can be found on the Minecraft wiki page.
* `lootItemDrop.poolIndex: number`
The index of the loot table pool this item drop is located in.
* `lootItemDrop.entryType: string`
This value contains the entry type of the parent entry this item drop occurs from. For item drops not being nested, this is equal to `minecraft:item`. For item drops which are nested inside another entry, this value contains the parent entry's group type. `group`, `alternatives`, or `sequence`. This can be used to calculate more information about how item drops are calculated compared to the siblings
* `lootItemDrop.sibling: LootItemDrop[]`
A list of all other item drops that come from the same pool as this item drop. The list also contains this item.
* `lootItemDrop.requiresSilkTouch(): boolean`
Checks if any of the drop conditions is a silk touch requirement.
* `lootItemDrop.requiresNoSilkTouch(): boolean`
Checks if the item drop requires the tool to not have silk touch.
* `lootItemDrop.requiresPlayerKill(): boolean`
Checks if the item drop requires the entity to be killed by a player directly.
* `lootItemDrop.estimateDropChance(looting?: number, luck?: number): number`
Estimates the drop chance of the item with the given luck potion effect, looting enchantment level and all relevant functions and conditions applied to the item drop. If the looting parameter is not defined, it is defaulted to 0. If the luck parameter is not defined, it is defaulted to 0.
* `lootItemDrop.getRequiredBlockAge(): number`
Gets the required age of the block (for plant based blocks) in order for this item drop to occur.
* `lootItemDrop.getStackSizeRange(fortune?: number, looting?: number): [number, number]`
Gets the range of potential stack sizes for this item drop. This value may exceed the actual size of a Minecraft stack. If looting or fortune enchantments are used, the level can be specified to produce a more accurate range.
_**LootFunction**_
Contains information about a function to be applied to an item drop. The properties within this class match the properties of the given type as defined within the Minecraft Loot Table format.
* `lootFunction.type: string`
The namespaced type of function that is being applied.
* `lootFunction.onPool: boolean`
True if this function is applied to the entire pool. False if this function is only applied to the item.
_**LootCondition**_
Contains information about a condition required for an item drop to occur. The properties within this class match the properties of the given type as defined within the Minecraft Loot Table format.
* `lootCondition.type: string`
The namespaced type of condition that is being applied.
* `lootCondition.onPool: boolean`
True if this condition is applied to the entire pool. False if this condition is only applied to the item.
* `lootCondition.isSilkTouch(): boolean`
Checks if the condition is a silk touch check.
---
_Source: https://npm.io/package/prismarine-loottable · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._