Fetchr

5.2 updates the map to 1.21, brings new items, and a few improvements

Changelog

• The targeted Minecraft version is now 1.21-1.21.4
• Added new items and changed categories of existing items
• Worldgen Tweaks
• Armadillos are more common to generate in savanna biomes compared to vanilla
• Items taken from the game that include an inner inventory now return their inventory to the player
  • This includes bundles, shulker boxes and loaded crossbows
• Item get messages in chat now contain a tooltip with the exact item that was taken
• Improved category chest
• Improved big lobby & skybox card interaction
• Creepers and tnt no longer cause damage in the lobby
• Technical Improvements and better Performance
• Removed machinery as command blocks are no longer necessary
  • Command blocks are no longer required to be enabled in a server environment
• Updated translations from Crowdin
• 1EEFEzBzXBZzUPzCSJOHzNPSFzNPCTzUPzUIFzMPCCZAz3BNFMT1SFiIF2FTUAz7PzUPzUIFzHJUIVCAz7PzUPzDPEFAz3MJDLzPOzUIFzJNBHFTzEJSFDUPSZAziBLFzBzMPPLzBUzuArAz8PQFzUIJTzIFMQTAzLBZzCZF
  • sorry this got corrupted
  • dont worry about it
  • possible characters are [a-zA-Z0-9 .]

Item Changes

Roots

New category "Roots" with:

• Carrot
• Golden Carrot
• Carrot on a Stick
• Baked Potato

Armadillo

New "Armadillo" Category with:

• Armadillo Scute
• Wolf Armor

Pale Garden

New category "Pale Garden"
These items are only available when playing in 1.21.4

• Pale Moss Block
• Closed Eyeblossom
• Open Eyeblossom
• Pale Hanging Moss (also mutually exclusive with shear items)
• Resin Clump (also mutually exclusive with nighttime mob drops)
• Chiseled Resin Bricks (also mutually exclusive with nighttime mob drops)
• Creaking Heart (also mutually exclusive with nighttime mob drops)

Other new items

• Jungle Sapling as part of the jungle category
• White Stained Glass exclusive with glass bottle and orange concrete
• Brown Banner as part of the wool category
• Light Blue Bundle as part of the leather category
  • This is only active in 1.21.2 or higher
• Added Poison arrow which splits its weight with slowness arrow

Changes

• Book items have been separated from the leather category and are no longer exclusive with item frames
• Tnt and Tnt Minecart are no longer exclusive with glass bottle and orange concrete
• Saplings are no longer mutually exclusive
  • Mangrove propagule is exclusive with mud items
  • spruce sapling is exclusive with sweet berries, fern and snow
  • acacia is exclusive with cactus green, lime dye and sea pickle
  • dark oak is exclusive with apple and golden apple

Removed Items

• Birch sapling
• Golden hoe, golden pickaxe
• Diamond shovel, diamod axe, diamond sword

The variety in gold and diamond tools was reduced to make blind runs need to craft fewer of them.

Lobby & Skybox

• The machinery is gone, as command blocks are no longer needed
• Removed the floating property in front of the big lobby & skybox card
• The reach to interact with item frames and other entities is now increased while in the lobby or skybox.
• Item chests in the lobby now show the global item weight.
• Item chests in the lobby now generate with scaffolding and make the room grow in height depending on the item pool (without pale garden items, the room is shorter, for example.)

Worldgen Tweaks

• Buried treasure is now more common like other structures
• This means map chests are now less likely to have no map
• Buried treasure will generally be closer to their map
• Pillager outposts now require less distance from villages
• Trial chambers are more common, just like other structures in Fetchr
• Creaking heart frequency in pale oak trees has been increased compared to vanilla from 10% to 35%

Technical Changes

• Overhauled item registration card generation and item detection with new Minecraft Features in Mind such as Macros

Item Registration

Item registration has been overhauled and existing forks that change the item pool will need to update to the new system.

• textComponent has been removed
• clearCommand has been removed
• detectCommand has been removed
• icon is no longer a text component and instead the 4 digit hex code of the unicode character representing the item on the HUD bingo card
• icon_font specifies a own custom font to use for this item. Can be used to avoid conflicts in the vanilla Fetchr font files when maintaining forks
  • actionbar A list of 5 font definitions to use for the card displayed in the actionbar. Each definition is for a different row on the Bingo card and needs to have the corresponding ascend value set. Reference the vanilla Fetchr assets.
• translation New property for the translation key of the item
• item_tests Optional. Can be used for custom item tests.
  • type see blow
  • Type specific fields (see below)

Item Tests

Item tests can be used to further specify an item or override default behavior. By default, any item in the item field will match, including any defined components.

If item_tests is specified the components of the item definition will be ignored for testing purposes and only be used to construct a display item for the item frame card or the category chests.

• fetchr:component
  A component the item must have exactly like specified.
  • id The data component id
  • component The component value
• fetchr:negated_component
  A component the item must not have
  • id The data component id
• fetchr:predicate
  An item sub predicate that must succeed for the item
  • id The item sub predicate type
  • predicate The predicate data

At runtime, this will be parsed together with the item id into a command item argument.

For example this definition would leather boots with a blue shaper trim which is not shown in the tooltip and a custom lore text whenever it is displayed, and any leather boots that have any kind of blue trim would match:

{
	item: {
		id: "minecraft:leather_boots",
		components: {
			"minecraft:trim": {
				pattern: "minecraft:shaper",
				material: "minecraft:lapis",
				show_in_tooltip: false
			},
			"minecraft:lore": [
				'{"translate": "item.minecraft.smithing_template.upgrade", "color": "gray", "italic": false}',
				'[" ", {"translate": "fetchr.item.description.any_trim", "color": "#406d95", "italic": false}]',
				'[" ", {"translate": "trim_material.minecraft.lapis", "color": "#406d95", "italic": false}]'
			]
		}
	},
	item_tests: [
		{
			type: "fetchr:predicate",
			id: "minecraft:trim",
			predicate: {material: "minecraft:lapis" }
		}
	]
}

When testing the item id together with the specified item tests would check for minecraft:leather_boots["minecraft:trim"~{material:"minecraft:lapis"}]

Renamed properties in storages

Properties in the item storage and the card storage have been renamed to follow snake_case convention.

Item Detection & Performance

The machinery room is obsolete now and has been removed. Item detection has been fully implemented using macros and no longer needs any command blocks.

This should improve the performance quite significantly, as running command blocks every tick was quite expensive.

Item detection now only runs for a player who had a change to their inventory and does not have any active checks that run every tick anymore.

Command blocks are also more expensive because they parse their command every time they are executed anew while functions are pre-parsed. Macro lines still may need to be parsed more often, but because of macro caching, they will only need to be re-parsed when a new card with different items is generated. The cache only caches up to 8 unique combinations of arguments per function file which means some functions have been duplicated to take advantage of the cache for 25 items. There will still be a small performance overhead for cache lookup.

Card Generation

Card generation also could be simplified using macros. Furthermore, there is no custom random number generator in place anymore, and instead the built-in random command is used.

Bug Fixes

• Fixed Green Dye having the wrong internal id of fetchr:lime_dye (#236)
• Fixed spawning inside leaves in some spawn points
• Fixed vines not getting replaced by drop chute
• Fixed old skybox remaining when generating new card
  • This would lead to a black box hovering underneath the spawn point when re-generating a card with the same seed again.