Skip to content

How do I diagnose a conflict between two addons?

The Health Monitor page (GMod and Minecraft servers), under its Addon Scan tab, includes a Hook Conflicts section that lists every case where two or more addons hook the same game event under the same identifier. A conflict flagged as High severity means three or more addons are colliding on the same hook.

Symptoms of a real conflict: a feature stops working after you install a new addon, the same Lua error repeats from a specific file, or behaviour is inconsistent between players.

If the addon scan does not point to an obvious culprit, isolate it by disabling half your addons (rename their folders to something like _disabled_addonname) and testing, then narrowing down from there.

Once you find the conflicting addon, you have two options: remove one of the conflicting addons if it is optional, or edit the Lua hook identifier in one of them so the identifiers no longer collide, for example changing hook.Add("PlayerDeath", "MyAddon", ...) to hook.Add("PlayerDeath", "MyAddon_v2_DeathHandler", ...). This requires being comfortable editing Lua directly.

Was this helpful?

Want to try this on a real server?

Everything described here is available on the trial too, on the same hardware and the same panel as the paid plans. Try it free for 24-hour, no credit card required.

Didn't fix it? Ask in Discord.

Ask in our Discord - we help with hosting questions whether or not you host with us.