Retro Graffiti
Common issues and solutions.
Graffiti Does Not Place
Section titled โGraffiti Does Not PlaceโProblem: Placement is rejected.
Solution:
- Check wall/surface restrictions (
Config.AllowNonWall,Config.WallNormalZMax). - Check spacing moderation distance.
- Verify player is within placement distance.
Finalize Says No Art
Section titled โFinalize Says No ArtโProblem: Player drew but finalize blocked.
Solution:
- Finalize checks live panel art state.
- Ensure panel has visible stroke/text/image content.
- Verify no client errors in F8 console.
Viewer Shows Broken Image After Finalize
Section titled โViewer Shows Broken Image After FinalizeโProblem: Finalized tag briefly shows broken image.
Solution:
- Viewer retries PNG fetch via
wb_png_getfallback. - Ensure
data/graffwrite permissions are valid. - Confirm resource restart after updates.
UV Reveal Does Not Work
Section titled โUV Reveal Does Not WorkโProblem: UV tags stay hidden.
Solution:
- Ensure
Config.UVUseWeapon = true. - Ensure
WEAPON_UVLIGHTexists in framework/inventory weapon data. - Ensure UV meta resource starts before
rs_graff.
Admin Panel Access Denied
Section titled โAdmin Panel Access DeniedโProblem: /graffadmin denied.
Solution:
- Admin check uses framework admin permission first.
- Allowlist is fallback (
Config.AdminAllowlist). - Verify identifiers and framework permission level.
Support
Section titled โSupportโIf you still hit issues, collect:
- F8/client errors
- server console logs
- exact reproduce steps
- your framework/inventory stack