Bird Watching Bird WatchingEdDYON
中文English

Server and photo maintenance

Back up the world and photos together

The photo index is stored in the world's SavedData, and JPEG files are in<world>/data/guaniao/photos. When restoring, both must come from the same backup point.

Photo administration commands

/guaniao photo stats
/guaniao photo stats <player>
/guaniao photo list <player>
/guaniao photo delete <PhotoId>
/guaniao photo restore <PhotoId>
/guaniao photo verify
/guaniao photo prune dry_run
/guaniao photo prune confirm

Deleted photos go to the recycle bin first. After the configured retention period,prune confirm permanently removes the files. First run dry_run to review the plan, and keep a full backup.

Investigating performance issues

  • Bird Watching, Forge, Java and server versions.
  • Player count, loaded chunks, and where and how long the issue occurs.
  • A Spark report or equivalent profiling data, and the number of entities concentrated in affected areas.
  • Whether the issue continues when no players are online.

Remove private information such as IP addresses and tokens before sharing logs.

Sources · 2026.09.24

SERVER_ADMIN.md ↗