Minecraft anticheat guide

Macro Dupe and Spear Checks in FairPlay

How FairPlay's four macro checks observe repeated damage, shield swaps and spear sequences, what legit PvP can resemble, and how to review alerts.

What do the macro checks observe?

FairPlay's macro group has four public checks: MacroDupeDamage, MacroDupeShield, MacroDupeShieldSlam and MacroSpear. Each one watches for a short run of actions that is unusually tidy when a hand performs it. They report sequences of events, not single clicks, so the evidence is always a small group of actions close together.

Treat each name as the subject of the check, not as a guarantee of what the sequence was. A macro alert says the sequence looked automated. Reviewers still have to establish what the player did.

In practice, a macro alert opens a review rather than closing one. Write down what you saw, which evidence supported the alert and which legitimate explanations you ruled out, so the next reviewer can follow the same path without rebuilding it.

Which macro behavior do these checks target?

A macro binds several actions to one key. Common examples include a key that swaps to a shield, attacks, and swaps back, or a key that repeats an action to multiply its effect. Duplication tools rely on repeated events arriving in a pattern that a person would not produce, and macro tools rely on the same timing every time.

The four checks cover different parts of that idea. The damage check looks at repeated damage from one action. The shield check looks at the order of shield actions. The shield-slam check looks at a shield break followed quickly by a second action. The spear check looks at a spear-style attack sequence. The public names are enough to guide review, and the exact evidence used sits in the code.

What legitimate play can resemble a macro?

A fast player in a combat-heavy mode can produce tidy sequences by practice. Shield-heavy PvP often has a shield break followed by an attack in a short window, which is a normal combo. Some players bind a legal keybind that swaps items on one key, and that keybind alone does not show automation.

Lag is the most common source of confusion. When the server receives several packets together, one action can look doubled, or two normal actions can look like one repeated action. Spear-style and trident-style weapons also produce their own combos in ordinary fights. Review these cases against the weapon the player held and the ping for the same second.

How should staff review macro alerts?

Start with the alert name, then look at the evidence that matches it. The table gives the first thing to inspect for each check and one common legit explanation to rule out.

First inspection points for FairPlay macro alerts.
AlertLook at firstLegit explanation to rule out
MacroDupeDamageDamage events that fire in the same moment from one attackTwo real hits from two targets, or a sweep attack
MacroDupeShieldOrder of shield and hotbar actions in the same windowA legal keybind the player uses on purpose
MacroDupeShieldSlamShield break followed by a second actionNormal shield-break combo in PvP
MacroSpearWeapon swap and attack timingA combo the player uses on other reviewed clips

What is a safe procedure for a macro flag?

Macro evidence is short and easy to misread, so reviewers should follow the same steps every time. The procedure below keeps the review focused on the sequence rather than on the player's skill.

What should you tune only in staging?

Macro checks depend on timing relationships between actions, so they are sensitive to the server's combat settings and the client mix. Test in staging with recorded legit combat and PvP sessions that use the keybinds and weapons your players actually use. Change one check at a time, and keep the family alert-only until reviewers agree on what a real macro looks like on your server.

Do not copy settings from another server. The same sequence can mean different things with a different knockback setup or a different shield rule.

If you change a macro-related setting, note the version and the date, then re-check the alerts a week later with the same staff members, so you can see whether the change alone moved the results.

What have we not verified?

We have not measured how often these four checks fire, how they respond to each keybind layout, or how they compare with macro detection in other anticheats. This article describes what the checks are named to observe. It does not claim that any of them catch every macro or that a given alert is correct.

FAQ

Is a keybind that swaps to a shield a macro?

Not automatically. Check whether the sequence is single-key and repeats with machine-like timing. Some legal keybinds do this on purpose, so review them case by case in staging.

Can ping alone cause a macro alert?

Yes, indirectly. Delivery delay can group packets so that normal actions look doubled. Always compare the ping for the same second before you judge a sequence.

Should macro alerts trigger automatic punishment?

Start alert-only. Sequence checks need a reviewed case history on your own server before any automatic action, so build that history first.

Related sources and official pages

Browse all anticheat guides