HexHopper

Place hoppers in all 6 directions. Rotate push and pull independently with a compass.

Vanilla hoppers are locked: they always pull from above and can only push downward or sideways. HexHopper removes that restriction. When you place a hopper, it faces the surface you clicked — including up. Use a compass to reconfigure any hopper after placement without breaking it.

---

How it works

Placement

Hold a hopper and click any face of a block. The hopper's push direction (the spout) will face the surface you clicked. The pull direction (the funnel opening) is set automatically based on where you're looking — it picks the closest direction that isn't already taken by the push.

!A player places three hoppers in sequence. The first is placed by clicking the underside of a block — the hopper's spout points upward toward the block above. The second is placed on a side face — the spout points sideways into the adjacent block. The third is placed on top of a block — the spout points straight down. In each case the funnel opening faces toward the player. The placement is immediate and consistent: the spout always aims at the face that was clicked.

Compass: right-click rotates pull direction

Hold a compass and right-click a hopper to cycle its pull direction (funnel) through the five valid options. A message appears in the action bar after each click showing the current pull direction.

!A player holds a compass and repeatedly right-clicks a hopper mounted on a wall. After each click, the funnel opening visibly rotates to a new face of the hopper — cycling from Up to East to Down to West and so on. A short text message appears in the bottom center of the screen each time, reading "Pull: Up", "Pull: East", "Pull: Down", etc. The hopper's body stays in place throughout; only the funnel opening changes direction.

Compass: left-click rotates push direction

Hold a compass and left-click a hopper to cycle its push direction (spout) through the five valid options. The same action bar message appears confirming the new push direction.

!A player holds a compass and repeatedly left-clicks a hopper sitting on the ground. After each click, the spout rotates to a different face — cycling through North, East, South, West, and Up. A message appears in the action bar reading "Push: North", "Push: East", and so on. The hopper block does not break; only its orientation changes.

---

Compatibility

HexHopper modifies vanilla HopperBlock and HopperBlockEntity using Mixins. It is compatible with:

• Existing worlds — hoppers placed before installing the mod default to pull=Up, which matches vanilla behaviour exactly
• MinecartHoppers — fall back to vanilla pull=Up behaviour
• Mods that don't touch hopper logic — storage mods, visual mods, etc.

Not compatible with mods that also modify HopperBlock or HopperBlockEntity (other hopper-direction mods, some deep storage mods). HexHopper also overrides assets/minecraft/blockstates/hopper.json — resource packs or mods that replace the same file will conflict visually.

---