Help

Updating

Manual update#

Stop the server, replace the old jar in plugins/ with the new one and start it again. Your configs and data are kept. Missing config keys use the defaults, so your current config keeps working.

Update checker#

The plugin checks BuiltByBit for a newer version. It only runs on a copy that was downloaded from BuiltByBit. Other copies log that update checks are off.

updates:
  enabled: true
  check-on-startup: true
  # Hours between checks, from 1 to 168.
  check-interval-hours: 24
  # Download new versions by themselves. They install on the next restart, and the old jar is kept in plugins/mcShardShop/backup.
  auto-download: false
  # Tell the console and admins (mcshardshop.admin) about updates.
  notify: true
  # Leave these blank to use the built-in values.
  shared-token: ""
  resource-id: 0
  • The check runs shortly after startup (when check-on-startup is on) and then every check-interval-hours hours (1 to 168). It never runs on the main thread.
  • With notify: true, the console and players with mcshardshop.admin are told when a newer version exists. Admins also see the notice a few seconds after they join.
  • With auto-download: true, the plugin downloads the new jar, checks that it is mcShardShop at the expected version, copies your current jar to plugins/mcShardShop/backup and places the new one in the server's update folder. It installs on the next restart. The jar that is running is never touched.
  • Auto-download needs the license to have download rights for the new version. Otherwise you are told it cannot download it.
Rolling back

If auto-download was on, the previous jar is in plugins/mcShardShop/backup. Put it back in plugins/ to return to the old version.