Tumbleweed Mod Wiki

The Tumbleweed mod is a lightweight utility mod designed to enhance the atmosphere and utility of desert environments. In the vanilla game, deserts are often seen as barren and dangerous areas with little to offer beyond sand and cacti. This mod changes that dynamic by spawning Tumbleweeds—entities that roll across the landscape, driven by the wind.

Players can intercept and break these tumbleweeds to obtain various items, ranging from basic survival materials like sticks and seeds to rare treasures like gold nuggets or even diamonds. This makes the desert a viable location for early-game scavenging and late-game resource gathering.

The Tumbleweed is a unique entity added by the mod. Unlike most mobs, it does not have an AI that targets players; instead, it follows a physics-based movement pattern.

Stats and Behavior

Behavior Patterns

• Movement: Tumbleweeds move in a semi-random direction, simulating being blown by the wind. They can climb over blocks that are one level high but will bounce off steeper walls.
• Despawning: Tumbleweeds will naturally despawn if they wander too far from the player or if they exist for an extended period without being broken.
• Destruction: A tumbleweed can be destroyed by any form of damage, including player attacks, arrows, fire, or contact with cacti. Upon destruction, it disappears and drops items from its internal loot table.

The primary draw of the Tumbleweed mod is the loot system. By default, the mod includes a wide variety of items that can be found inside a tumbleweed. The items are categorized by rarity based on their weight in the configuration file.

Default Loot Table

Drop Mechanics

When a tumbleweed is broken, it typically drops 1 to 3 items from the loot table. The specific items and their quantities are determined by the mod's configuration settings, which can be customized by server administrators or modpack creators.

Tumbleweeds do not spawn like traditional mobs. Instead, they use a specialized spawning algorithm tied to the environment.

• Dead Bush Requirement: Tumbleweeds primarily spawn in the vicinity of Dead Bushes. The mod checks for the presence of these blocks in Desert biomes and periodically attempts to 'spawn' a tumbleweed entity from their location.
• Biome Restrictions: By default, tumbleweeds only spawn in biomes categorized as 'Desert.' However, this can be expanded in the configuration to include Badlands, Sandy Wastelands, or custom modded biomes.
• Frequency: The spawn rate is governed by a timer. If there are too many tumbleweeds in a small area, the mod will throttle spawning to prevent lag and maintain game balance.

The Tumbleweed mod is highly customizable via its configuration file (usually found in config/tumbleweed-common.toml or tumbleweed.json depending on the version).

Configurable Options

• Spawn Rates: Adjust how frequently tumbleweeds appear.
• Loot Tables: Users can add or remove any item from the game (including items from other mods) to the tumbleweed drop list.
• Drop Weights: Each item is assigned a 'weight.' A higher weight increases the chance of that item dropping relative to others.
• Allowed Biomes: A list of biome IDs where tumbleweeds are permitted to spawn.

Example Loot Entry Format

Items are typically added using the following syntax: "minecraft:diamond#1#1" (This represents: Item ID # Minimum Amount # Weight)