| Wrong GUI is shown | Use gui.mode: AUTO and leave gui.use-viaversion enabled when ViaVersion is installed. |
| Pink / missing sprite icons | Run /homes icontest or /homes icontest <item>, then adjust gui.icons.atlas or sprite settings. GLYPH/NONE are fallback options. |
| Cross-server home does not connect | Confirm the Velocity companion is installed, server-name matches the proxy config and shared storage is working. |
| Cross-proxy home fails | Confirm Redis is enabled and proxy public host/port values are reachable by clients. |
| Player cannot create more homes | Check homes.default-limit, homes.max and the highest homes.limit.<number> permission the player has. |
| Teleport cancels | Review teleport.cancel-on-move, cancel-on-damage and move-threshold. |