Minecraft anticheat guide

Custom Items and ModelEngine Models Under Anticheat Checks

How custom item plugins and ModelEngine entity models can shift hitboxes, attack timing, and reach, plus a staging method to find which checks need review.

Short answer

Custom items can change attack speed, reach, damage, or knockback, and model-based entities can move the hit target away from the vanilla hitbox. An anticheat that assumes vanilla values may alert on legitimate hits. List every custom item and model entity in use, run a fixed set of hits on staging for each one, and log the alerts before you change any check.

Where custom items change combat numbers

Custom item plugins often set their own damage, attack speed, or reach values. Some use item attributes. Others apply their effects in plugin code when a hit lands. Each method changes what the server accepts, so a check that uses vanilla numbers for a sword can read a custom weapon as impossible.

Which values change depends on how each item is built. Open the item definitions on your own server rather than assuming a weapon behaves like its vanilla counterpart. A weapon named like a sword can carry very different numbers.

How model entities affect hit detection

Model-based entity plugins place a visual model over an entity. Some also spawn invisible or interaction entities that receive the hit. The registered target can then sit at a different position or size than the vanilla mob. Reach and hitbox checks compare the attacker's position with that target, so an offset target can look like a hit from too far away.

The effect depends on where the interaction entity sits and how the plugin updates it. Stand at a few fixed distances on staging and compare the alert distance with the distance you actually hit from. Do not assume the model's visual edge matches the server's collision box.

Find the check that reacts

Use this table to decide which test to run first. Each row names a setup, the check family that may react, and a test you can repeat on staging. The table lists what to test, not a measured result.

Likely alert sources by item or model type.
SetupCheck that may reactStaging test
Custom weapon with a higher attack rateClick or attack-timing checksHit a fixed target 20 times and log the interval between hits
Custom weapon with changed reachReach checksHit at known distances and compare the alert distance with the item's stated reach
Model entity with an invisible interaction entityHitbox and reach checksStand at fixed distances and hit the model from each side
Custom item that alters knockbackKnockback or velocity checksCompare the target's response with and without the item

Test each item on staging

A repeatable test gives you evidence you can compare after each change. Use the same server version, the same anticheat version, the same client, and a flat test area with one fixed target. Change only one variable per run.

Why item-based exemptions are risky

It can be tempting to exempt a whole item from a check. Items can reach players through drops, trades, shops, or staff commands, so an item exemption works for anyone who obtains the item. Scope any relaxation to the check that alerted and keep the rest of that check active.

Model-based hitboxes raise a similar concern in the other direction. An offset target may let a player land hits from a distance the vanilla target would not allow. Test the target from both sides before you loosen any reach or hitbox setting.

What we have not verified

We have not tested any specific item plugin or ModelEngine release against any anticheat. Hit behavior depends on the plugin version, the server version, and the anticheat version together. The results of your own staging run are the only evidence that applies to your server.

FAQ

Do custom items always cause false flags?

No. Many custom items use values close to vanilla. Check each item's own settings and run the staging test before you change anything.

Should we exempt a custom weapon from every check?

Avoid that. The exemption then applies to any player who gets the weapon, through a drop, a trade, or a command. Keep the relaxation limited to the one check that alerted.

Does a model entity hitbox make combat easier to abuse?

It can. An interaction entity placed away from the visual model may let a player land hits from a distance the vanilla target would not allow. Compare hits from both sides of the model before you change reach or hitbox settings.

Can we use alert-only mode while we test?

Yes, if your anticheat offers it. Alert-only mode lets staff see the pattern during the staging run. Decide on settings from the logged data, not from the first alert.

Related sources and official pages

Browse all anticheat guides