Blocklings

Every Blockling as of the latest version.

**Blocklings** are tamable small block-like creatures that can be tasked to fight, mine, chop, and harvest for you. They are additionally upgradable using various materials found throughout the world, and through experience.

## Spawning

Blocklings can naturally spawn anywhere in both the Overworld and Nether as a random block type. This type can be one of 13 variants, determined by where they spawn.

They also spawn in random sizes, being anywhere from 0.45 to 0.95 blocks tall.

## Taming

You can tame a Blockling using **any type of Flower**. The amount needed is random - each flower having a 1⁄3 chance of taming the Blockling. Upon being tamed, the Blockling will gain a nametag and can be right-clicked to access their GUI, which will display their Stats upon being opened.

## Upgrading

Blocklings can be upgraded using some types of blocks and items found throughout your world. The chance of upgrading a Blockling is the same as taming one, being a 1⁄3 chance. The type of item you use will affect what it's new Primary type will be, regardless of if the item is better or worse than it's current Primary type.

### Typing

All Blocklings have 2 types: A **Natural** type, and a **Primary** type. The Blockling's **Natural** type will always be pre-determined, as it will always be whatever the Blockling **originally** spawned as. The **Primary** type is the Blocklings **current** type, and is the one which affects the Blockling's **stats**. However, both types will provide their respective **Special Abilities**.

When a Blockling has a different Primary type from their Natural type, they will inherit the appearance of their Primary type, but will have streaks of their Natural type run through their texture.

For items that you can feed to your Blockling, refer to Blockling **Types**, which has what items you can feed to your Blockling to change their Primary type.

## GUI

Tamed Blocklings gain a GUI which can be opened by right-clicking them. This GUI is separated into 2 parts: Info tabs, which are on the left, and Skill Tree tabs, on the right.

### Stats

The Stats tab will display all relevant information regarding the Blockling's **Health**, **Attack**, **Defense**, **Harvesting Speed**, and **Movement Speed**. It also includes experience bars which also displays their current **Combat**, **Mining**, **Woodcutting**, and **Harvesting** levels, as indicated by the tool icons on both sides of the bars. You can additionally **edit** the Blockling's name at the top of the menu.

Hovering over the Blockling itself in this menu will display **Food** it can eat to heal, along with their **Natural** and **Primary** types.

### Tasks

The **Tasks** tab allows you to customize how the Blockling will behave. You can **change** or **configure tasks** by clicking their icon on the left, **enable** or **disable** the tasks by toggling the circular icon on the right of the task, and **remove** and **add** new ones by clicking the red "X" or green plus further right of the task. By default, all tamed Blocklings will start with the **Retaliate** and **Follow** tasks enabled.

Some examples of options for tasks include:

* Wander: Lets the Blockling randomly wander the area.
* Sit: Makes the Blockling stay in place.
* Hunt: Lets the Blockling attack enemies and pick up their drops. You can additionally configure which enemies are whitelisted to be targeted.
* Mine Ores: Lets the Blockling mine ores near it. You can additionally set which ores are whitelisted that it will mine.

It is important to note that some tasks can conflict with each other; having Follow and Sit enabled at the same time will nullify the Sit task, Follow can sometimes mess with harvesting related tasks by stalling their movement a bit, etc.

### Equipment

The **Equipment** tab allows you to access the Blockling's **inventory**. You can **take** and **store** items in their 24 inventory slots, and give them 2 different weapons or tools to use.

Some skills from the **Skill Tree** will allow for your Blockling to make use of this inventory by themself, like **Replanter**, which allows it to replant saplings in place of trees they've chopped down.

### Skill Tree

The **Skill Tree** is divided into 5 categories: **General**, **Combat**, **Mining**, **Woodcutting**, and **Farming**. Each skill can be unlocked once you get to the required level the skill requires you to reach.

* **General** covers **utility** skills which do not focus on a particular tool or weapon. Examples include:
	+ **Heal**: Allows you to feed your Blocklings flowers to heal anywhere from 3 () to 5 () health.
	+ **Autoswitch**: Allows your Blockling to switch to their best tools fit for the job on their own.
	+ **Armadillo**: Allows your Blockling to drop in item form instead of dying.
	+ **Speedy**: Increases your Blockling's speed by 5%. Can be upgraded up to Speediest, increasing speed by 20% instead.
* **Combat** covers skills which relate to **combat**. Examples include:
	+ **Regeneration**: Allows your Blockling to recover 1 () health every 20 seconds. Can be upgraded up to Regeneration 3, increasing the health recovered to 5 ().
	+ **Adrenaline**: Increases your Blockling's attack damage the lower their health gets.
	+ **Monster Hunter**: Doubles the loot dropped from hostile mobs hunted by the Blockling.
* **Mining** covers skills related to **mining**. Examples include:
	+ **Hammer**: Allows your Blockling to mine in a 3x3x3 area.
	+ **Night Owl**: Allows your Blockling to mine faster the darker it is.
	+ **Hot Hands**: Automatically smelts ores mined by your Blockling.
* **Woodcutting** covers skills related to **chopping** and **foraging**. Examples include:
	+ **Replanter**: Allows your Blockling to replant saplings when it chops down trees.
	+ **Momentum**: Allows your Blockling to chop faster as long as it keeps chopping.
	+ **Leaf Blower**: Allows your Blockling to break leaves adjacent to logs it chops.
* **Farming** covers skill related to **crops** and **harvesting**. Examples include:
	+ **Scythe**: Allows your Blockling to harvest in a 3x3x3 area.
	+ **Efficiency**: Increases Blockling's Farming speed by 10%.
	+ **Hasty**: Allows your Blockling to harvest quicker at the cost of using twice the durability of their hoes.

There are no limits on how many skills your Blockling can have, as the only thing holding it back are the skill requirements for each skill, meaning it is possible to get a Blockling every skill possible in the skill tree.

## Types

There are a large variety of types which Blocklings can spawn and be changed into through upgrading. Below lists every type of Blockling and a general explanation of what they're best used for. You can find more detailed explanations of their stats on their respective pages which are linked.

Something important to note is that any time a passive effect does something when an ally is nearby, it only applies the effects onto allies within an 8 block radius.

### Grass & Dirt

Grass & Dirt Blocklings spawn on top of Grass Blocks in the Overworld. They have the same stat totals, apart from the fact that their passive ability causes grass to grow on dirt or grass to turn into dirt respectively. They are notable for having the best Farming Speed stat bonus out of any Blockling type.

Both can be fed flowers, but Grass Blocklings can only be fed Grass, and Dirt Blocklings can only be fed Dirt.

### Log

Log Blocklings spawn on top of Grass Blocks in the Overworld when near an Oak Log is within an 8 block radius. They are notable for their passive ability to heal nearby allies by 2 () every 10 seconds while near an Oak Tree, and additionally having the best Woodcutting Speed stat bonus out of any Blockling type.

Log Blocklings can be fed flowers and Oak Logs.

### Stone

Stone Blocklings spawn nearby Stone in the Overworld on top of any block that isn't a Grass Block. They are notable for their passive ability that grants nearby allies Resistance 1, and their relatively high defensive stats.

Stone Blocklings can be fed flowers and Stone.

### Quartz

Quartz Blocklings spawn nearby Quartz Ore in the Nether on any block. They are notable for their passive ability to reflect 15% of damage taken back to the attacker, along with being just behind Gold in terms of Attack Speed and Movement Speed.

Quartz Blocklings can be fed flowers, Nether Quartz, Nether Quartz Ore, and Nether Quartz Blocks.

### Lapis

Lapis Blocklings spawn nearby Lapis Ore in the Overworld on top of any block that isn't a Grass Block. They are notable for their passive ability which acts as an innate Fortune/Looting 1 effect.

Lapis Blocklings can be fed flowers, Lapis Lazuli, Lapis Lazuli Ore, and Lapis Lazuli Blocks.

### Iron

Iron Blocklings spawn nearby Iron Ore in the Overworld on top of any block that isn't a Grass Block. They are notable for their passive ability which provides nearby allies Strength 1.

Iron Blocklings can be fed flowers, Iron Ingots, Iron Ore, and Iron Blocks.

### Gold

Gold Blocklings spawn nearby Gold Ore in the Overworld on top of any block that isn't a Grass Block. They are notable for their passive ability which grants nearby allies Speed 1, along with having the best Attack Speed AND Movement Speed bonuses of any Blockling type.

Gold Blocklings can be fed flowers, Gold Ingots, Gold Ore, and Gold Blocks.

### Diamond

Diamond Blocklings spawn nearby Diamond Ore in the Overworld on top of any block that isn't a Grass Block. They are notable for their distinct passive ability that avoids damaging tools that they use, thus making them unbreakable in their hands. They are also notable for having the best Mining Speed stat bonus of any Blockling type.

Diamond Blocklings can be fed flowers, Diamonds, Diamond Ore, and Diamond Blocks.

### Emerald

Emerald Blocklings spawn nearby Emerald Ore in very specific biomes, those being the **Mountains**, **Frozen Peaks** and **Windswept Hills** biomes on top of any block that isn't a Grass Block. They are notable for their passive ability which provides nearby allies Luck 1, and for having relatively high Mining Speed stats.

Emerald Blocklings can be fed flowers, Emeralds, Emerald Ore, and Emerald Blocks.

### Glowstone

Glowstone Blocklings spawn nearby Glowstone in the Nether on top of any block. They are notable for their innate ability to emit light in a large radius around them.

Glowstone Blocklings can be fed flowers, Glowstone Dust, and Glowstone Blocks.

### Obsidian

Obsidian Blocklings spawn nearby Obsidian in the Overworld on top of any block. They are notable for their fire resistance and passive ability which knocks attackers away from them. They additionally have the best Health and overall Defense stats of any Blockling.

Obsidian Blocklings can be fed flowers and Obsidian.

### Netherite

Netherite Blocklings spawn nearby Ancient Debris in the Nether on top of any block. They are notable for their fire resistance and their ability which grants them a 10% chance to reflect an attack dealt to them. Additionally, they have the best Attack Damage bonus of any Blockling type, and very high Defense stats.

Netherite Blocklings can be fed flowers, Netherite Ingots, Blocks of Netherite, Ancient Debris, and Netherite Scrap.

## References

1. ↑ https://github.com/WillR27/Blocklings/blob/1.16/src/main/java/com/willr27/blocklings/entity/blockling/BlocklingEntity.java#L197
2. ↑ 2.00 2.01 2.02 2.03 2.04 2.05 2.06 2.07 2.08 2.09 2.10 2.11 https://github.com/WillR27/Blocklings/blob/1.16/src/main/java/com/willr27/blocklings/entity/blockling/BlocklingType.java#L58