Bag of Yurting Mod — Guide

Mechanics

The Bag of Yurting operates through a simple right-click interface, but contains sophisticated logic for handling the world state.

Capturing a Yurt

To store a structure, the player must right-click a block with an empty Bag of Yurting. 1. Selection: The block clicked becomes the bottom-center of the capture area. 2. Storage: All blocks within the bag's defined radius are removed from the world and stored inside the item. 3. Tile Entities: Containers such as Chests, Barrels, Furnaces, and Hoppers retain their inventory and internal states (e.g., smelting progress) when stored.

Unloading a Yurt

To place a stored structure, right-click a block in the world. 1. Placement: The structure will be deployed with the clicked block acting as the bottom-center of the new location. 2. Safety Checks: The mod checks if the target area is clear. If the area contains blocks that are not "replaceable" (like stone or wood), the unloading process will fail to prevent accidental destruction of existing builds. 3. Replaceable Blocks: Blocks like tall grass, flowers, and snow layers are automatically overwritten when a yurt is unloaded.

Block Tags and Permissions

The mod utilizes Minecraft's tag system to allow for fine-tuned control over what can be moved: * bagofyurting:blacklist: Blocks in this tag cannot be picked up by the bag. * bagofyurting:whitelist: If this tag is not empty, only blocks listed here can be picked up. * bagofyurting:replaceable: Defines which blocks in the world can be overwritten during the unloading process.

World Content

The Bag of Yurting mod is a utility toolset and does not add the following to the game: * Mobs/Creatures: No new entities are added. * Biomes: No new environmental zones are added. * Dimensions: The mod does not create new worlds; it only interacts with existing blocks in the current dimension. * Structures: No naturally generating structures are added; the "yurts" are entirely player-built.

Items

The mod centers around a single primary item that can exist in various states and sizes.

Bag of Yurting

The Bag of Yurting is the core item of the mod. It functions as a storage vessel for blocks. When empty, it appears as a standard pouch; once it contains a structure, it gains an enchantment-like glow and stores the block data within its NBT (Named Binary Tag) data.

• Dyeing: Similar to leather armor, the Bag of Yurting can be dyed in a crafting grid using any standard Minecraft dye. This is particularly useful for players carrying multiple bags, allowing them to color-code their portable structures (e.g., a red bag for a combat outpost, a blue bag for a fishing hut).
• Tiers: The bag's capacity is determined by its "Radius" value. A bag with a radius of $x$ will capture a cube with a diameter of $(2x + 1)$.

Recipes

Crafting and upgrading bags is the primary progression path in the mod.

Base Bag Recipe

The initial Bag of Yurting (Radius 0) requires an Ender Pearl, symbolizing its ability to hold more on the inside than the outside.

Upgrade Recipe

To increase the size of a bag, players must combine multiple bags of the same radius in a crafting table. In version 1.20.1, this typically involves combining two bags of the same size to produce one bag of the next size up (Radius + 1).

• Recipe: Bag (Radius X) + Bag (Radius X) = Bag (Radius X+1)
• Note: Only empty bags can be used for upgrading. Bags containing stored structures cannot be used as crafting ingredients.

Dyeing Recipe