Skip to content

Troubleshooting

Ghost edited this page Nov 15, 2026 · 1 revision

🔧 Troubleshooting

/rg does not exist

Check:

  • Is the server running Fabric, not Paper/Spigot/NeoForge?
  • Is Fabric Guard's 1.7.10 distribution for the correct Minecraft minor version installed?
  • Are Fabric API and WorldEdit for Fabric installed for that version?
  • Is your Java runtime compatible (Java 21 for Minecraft 1.20.5+)?
  • Does the log show a Fabric Loader dependency or mixin failure?

/rg define says to make a cuboid selection

  • Select an area in WorldEdit first.
  • Make sure both positions are set.
  • Use /rg define for a cuboid, not a polygon.
  • Run the command as the selecting player.

Players can still build in a region

  • Check /rg list <region> for block-break, block-place, build and related flags.
  • Test with an ordinary non-operator; operators may bypass protections.
  • Check ownership, membership and worldguard.region.flag.*.*.bypass nodes.
  • Inspect overlapping regions and priorities.
  • Determine whether the action came from ordinary player placement, WorldEdit, a dispenser, or a modded machine; different hooks may apply.

A flag unexpectedly disappeared

Important for 1.7.10: /rg flag <id> <flag> clears the flag instead of displaying it. Use /rg list <id> to inspect values.

/rg definepoly fails

Use an actual WorldEdit polygon selection and verify its minimum/maximum Y settings. Ensure the WorldEdit build supports the required selection type.

Permission changes do not work

  • Confirm a compatible permissions provider is installed and loaded.
  • Test both worldguard.* and compatibility fabricguard.* nodes as appropriate.
  • Check the user's operator level and effective groups.
  • Use a non-operator account for a realistic protection test.

Regions were not restored after restart

  • Check the per-dimension fabricguard/regions.json files described in Configuration.
  • Look for JSON errors in the server log.
  • Verify the world folder and dimension path were not changed.
  • Restore from a backup if a save is damaged.
  • Use /rg reload to reload region storage, or /fabricguard reload for a broader reload.

Blacklist rules are not behaving as expected

  • Check config/fabricguard/blacklist.json for valid JSON.
  • Verify the item ID and any dimension filters.
  • Read the server log for parse failures.
  • Test how the matched action is triggered; direct use and dispenser-driven effects may differ.

Before reporting a bug

Collect the exact Minecraft version, Fabric Loader version, Fabric API version, WorldEdit build, Fabric Guard JAR name, reproduction steps, region flag list, relevant server log excerpts and whether the actor is operator/member/outsider. Remove secrets and personal information before sharing logs.

Clone this wiki locally