Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Vertically stacked hoppers fail to pull before the upper one pushes if hopper-check is equal to hopper-transfer

Open
#14,392 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@CanIGetaPR is already working on this.

Since Oct 15, 2026.

  • #14393 by @CanIGetaPR — open

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
15/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Stale
Tech stack
java

Research direction

The payload names only the hopper-check and hopper-transfer settings in spigot.yml and the hopper tick ordering within a chunk; it does not name source files. Start by reading the open linked pull request #14393 to see what it already changes, since the work is under way. A newcomer could reproduce the skip with a vertical hopper chain and hopper-check: 8, then confirm that the fix keeps pull checks running every tick.

Written by the indexing model from the issue text.

Description

status: needs triage
Expected behavior

A warning for server owners if they misconfigure hopper-check for performance reasons, or a deterministic approach to executing hopper ticks such as by order of placement in the chunk.

Observed/Actual behavior

Server owners can be unaware that hopper-check = hopper-transfer is causing unpredictable item skips for hopper filters and other usages of vertically stacked hoppers.

If the top hoppers tick executes before the bottom hoppers, it may push before the bottom hopper pulls. This can happen when all hopper cooldowns become synced and processed in the same tick.

Web Examples of misconfigured servers:
https://www.minerealm.com/community/viewtopic.php?t=14973
https://www.spigotmc.org/threads/what-is-hopper-check-in-spigot-yml.380434/

Steps/models to reproduce

Set hopper-check: 8 in spigot.yml and attempt to run a large automated item sort filter from a mob farm.

If the hopper chain and filter hoppers cooldowns regularly expire on the same tick, and a hopper chain hopper executes before the filter hopper, the item will be moved before the filter hopper sees it.

In vanilla minecraft all hoppers check if they can pull items every tick, therefore more often than the transfer cooldown expires of a hopper above it. hopper-check >= hopper-transfer causes pull checks to be delayed and miss their pull opportunity.

Plugin and Datapack List

None

Paper version

26.2-DEV-e5fe717

Other

No response

Dominant language
Java
Stars
12.7k
Forks
3.5k
Avg merge
2d 11h
Merged PRs (30d)
46

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from PaperMC/Paper

All issues in PaperMC/Paper

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.