Troubleshooting

VoxelFurniture troubleshooting

Plugin fails to load: Confirm VoxelCore is installed and its JAR matches the Minecraft server version. Check the first startup exception and confirm you used the published release rather than a snapshot.

Furniture shows the wrong model: Check the VoxelCore ContentID, referenced model assets, resource-pack compilation and the client's pack revision. Modern ItemDisplay rendering differs from the legacy fallback.

Cannot interact, remove or place: Check furniture permissions, region protections and any enabled WorldGuard/Lands hooks; see Protection and Interactions and Seating.

Storage, animations or model swaps behave incorrectly: See Storage and Animations, Persistence and Reloads, and Rendering and Effects. Test the same operation on Java and Bedrock separately.

Potential lost items or duplicated furniture: Stop testing on production data; retain world and plugin-data backups, logs and exact reproducing steps. Include Minecraft/Paper, Core/Furniture/Geyser versions and whether the problem occurs after restart or chunk reload in an issue.