Better Cushion Placement

Visual Summary

---

Placement Mechanics

Holding Shift

• Place a cushion horizontally centered on the closest vertex of the block grid.
• Stack a held cushion on one in the world by interacting with it (if it will have block support).

Holding Control

• Place a cushion horizontally centered on the closest vertex of the pixel grid.

Holding Shift + Control

• Place a cushion horizontally centered exactly where clicked, completely off-grid.

Holding neither (Vanilla behavior)

• Place a cushion horizontally centered on the closest block grid tile center.

---

Placement Preview

A box renders where a cushion will place with the color it will have when placed.

---

Block Tags

• ID
  • #normal_cushion_placement
• Description
  • Forces the normal center-of-block placement of cushions when placing them against blocks with this tag.
• Default
  • Contains blocks with the #signs block tag.

---

Configs

Game rule features (Cushions Support Each Other and Snap Cushion Elevation To Pixel Grid) can be set to always enabled or always disabled in the bettercushionplacement-gamerules.properties file in the config folder.

• If set to always enabled/disabled the corresponding rule will not exist, but the feature will.
• If set to always disabled, the corresponding mixin that provides the feature will not be applied.
  • This means that even the negligible performance cost of the method call the mixin results in will be prevented.

---

Game Rules

Stack cushions directly on one another without block support

• ID
  • bettercushionplacement:cushions_support_each_other
• Name
  • Cushions Support Each Other
• Description
  • Instead of only being supported by blocks, cushions can also be supported by other cushions, allowing direct stacking.
• Default
  • Disabled

Background Explanation

Vanilla cushion support is as follows Cushion_wouldSuriveAt:

• L156-158 Make an anchor box by taking the bounding box a cushion is or might be, and slightly horizontally shrinking it and vertically expanding it down by 1/4 pixel.
• 159 Iterate the blocks intersecting that area additionally expanded down by another 4 pixels.
  • 160 For each block, get its general shape.
  • 161 Consider it supported if that shape is not empty and if it intersects the anchor box.

If no block support is found, this game rule additionally checks for other cushion entities below it, and considers it supported if one is found.

---

Flush placement w/o datapack	Close to flush via a sign

Bypass block tags for inner wall sub-pixel placement with a game rule

• ID
  • bettercushionplacement:allow_inner_wall_cushion_placement
• Name
  • Allow Inner Wall Cushion Placement
• Description
  • Ignores #cushion_uses_collision_shape block tags, thus allowing sub-pixel cushion placement on the inner walls of cauldrons, composters, and hoppers without a data pack.
• Default
  • Disabled

Background Explanation

Vanilla block interaction behavior is as follows BlockGetter_clipWithInteractionOverride:

• L87 Raytrace a block's main shape.
• L88 Check for hit.
  • L89 If hit, raytrace the block's interaction shape.
  • L90 Check for hit, and check if it's closer to the eyes than the main shape hit.
    • L91 If the interaction shape hit is closer than main shape hit, substitute the direction of the hit result with the new direction.

Blocks by default have no interaction shape BlockBehaviour_getInteractionShape, with the following exceptions:

• Cauldrons getInteractionShape
• Composters getInteractionShape
• Hoppers getInteractionShape
• Scaffolding getInteractionShape

Whether returning a full block shape or just the inner void shape, all of these blocks have interactions shapes with solid flat tops flush with the top of the block space.

Composter interaction shape	Hopper interaction shape

The only way to get a raytrace hit on the inner walls of the shapes of these blocks is to get an even closer hit on the top face of their interaction shapes. This means that any inner hit will have the expected inner location vector, but with a direction of Direction.UP. So although cushions require interacting with an upward face CushionItem_useOn#L38, these blocks uniquely bypass this requirement.

While sub-pixel placement is still possible (on signs WallSignBlock_SHAPES, for example), placement on horizontal faces and arbitrary Y positioning was not intended. This is why Mojang added the #cushion_uses_collision_shape block tag, which forces the use of the collision shape raytrace result CushionItem_recalculateContextForSpecialCollisionShapes#L81-88.

Wall collision placement	Soul Sand collision placement

Note that raytrace is from the eyes L84 to the slightly past the exiting hit result vector L85-86, and that hit failure defaults to the original hit result L88. This means that when a collision shape hit is closer to the eyes than the main shape hit, as with wall blocks WallBlock_collisionShapes, the collision shape will be used. But when the main shape hit is closer, as with soul sand blocks SoulSandBlock_SHAPE, the main shape will be used in spite of having the tag.

---

Server-only Installation

If this mod is installed on a server, but not a client, everything will work as intended, with the following purely visual exceptions:

1. The player's hand will swing
   • Even when cushion placement fails due to intersection with an existing cushion.
2. The player's hand will not swing
   • When placing a cushion on the inner wall of a cauldron, composter, or hopper.
   • When stacking a cushion on another cushion.