Json block behaviors OmniRotatable

Purpose

The OmniRotatable behavior selects an orientation variant of a block when the block is placed. The orientation variant is selected based on the orientation of the player. Note that WrenchOrientable behavior is similar, but it allows the variant to be changed after the block is placed with the wrench tool.

There are several meaningful ways to define a group of orientation variants for a block. Each orientation group type has different variant group requirements and different properties for the OmniRotatable behavior. Where possible, the examples below use world properties to assist in defining the variant states, but this is optional; the states may be directly listed instead.

Orientation group type	Required variant groups	Example block	Example variant group definition	Required behavior properties
Face 6 directions	rot variant group with the states "north", "east", "south", "west", "up", and "down"	slab	{ code:"rot", states: ["up", "down"], loadFromProperties: "abstract/horizontalorientation" }	{ name: "OmniRotatable", properties: {rotateSides: "true"} }
Face up/down	rot variant group with the states "up" and "down"	none	{ code:"rot", loadFromProperties: "abstract/verticalorientation" }	{ name: "OmniRotatable", properties: {rotateV: "true"} }
Face horizontally	rot variant group with the states "north", "east", "south", and "west"	none	{ code:"rot", loadFromProperties: "abstract/horizontalorientation" }	{ name: "OmniRotatable", properties: {rotateH: "true"} }
Face horizontally and flip vertically	rot variant group with the states "north", "east", "south", and "west" v variant group with the states "up" and "down"	none	{ code:"rot", loadFromProperties: "abstract/horizontalorientation"}, { code:"v", loadFromProperties: "abstract/verticalorientation" }	{ name: "OmniRotatable", properties: {rotateH: "true", rotateV: "true"} }
Face 6 directions and rotate along axis	rot variant group with the states "north", "east", "south", and "west" v variant group with the states "up", "down", "left", and "right"	trapdoor	{ code:"rot", loadFromProperties: "abstract/horizontalorientation"}, { code:"v", states: ["left", "right"], loadFromProperties: "abstract/verticalorientation" }	{ name: "OmniRotatable", properties: {rotateH: "true", rotateV: "true", rotateV4: "true"} }

Additionally, the behavior adds a placement mode to items. The behavior shows the placement mode when the item is hovered over in the inventory or hotbar. The placement modes are auto, horizontal, and vertical. Auto is the default. The horizontal and vertical modes only work correctly for face 6 directions blocks.

The behavior changes the placement mode when it detects that the block was created through crafting, and the first item in the recipe was an orientable block. So to allow changing the placement mode, add a 1x1 recipe that takes the block as input and produces it as output. The placement mode changes in the following cycle: auto to horizontal, horizontal to vertical, and vertical to auto.

Properties

rotateSides: (boolean)

Enables face 6 directions mode.

rotateH: (boolean)

Enables orienting along the 4 cardinal directions.

rotateV: (boolean)

Enables orienting up or down.

rotateV4: (boolean)

This can only be used if rotateV is also enabled. It extends the rotateV mode to also use the "left" and "right" values for the vertical variant group.

facing: (string, default "player")

Tells the block what it should orient to. Typically "block" is used, since the player almost always is building against another block.

dropChance: (float, default 1)

Values less than 1 reduce the chances of the block getting dropped when it is broken. Values 1 and above do not affect the drop rate.

Wondering where some links have gone?
The modding navbox is going through some changes! Check out Navigation Box Updates for more info and help finding specific pages.