SwornHeroWiki

Updating

Safely replace Dynamic Join Greetings without losing your configuration.

Follow this checklist whenever you replace the mod JAR.

Update steps

  1. Stop the server before replacing any JAR.
  2. Back up the server world and config/dynamic-join-greetings.json.
  3. Remove the previous Dynamic Join Greetings JAR from mods.
  4. Add the new JAR. Do not keep multiple versions in mods at the same time.
  5. Review the changelog and GitHub release notes for schema or dependency changes.
  6. Start the server.
  7. Run /joingreetings status and confirm the expected pools, delay, and selection mode.

What is preserved

  • Existing customized configurations are not overwritten during updates.
  • Newly packaged default greetings do not automatically replace customized message lists.
  • Persistent player history in <world>/dynamic-join-greetings/players.json remains unless you edit or delete it while the server is stopped.

Restoring packaged defaults

If you intentionally want the bundled defaults again:

  1. Stop the server.
  2. Delete or rename config/dynamic-join-greetings.json.
  3. Start the server so the mod regenerates the packaged default configuration.
  4. Run /joingreetings status to verify the regenerated pools.

Selection state is temporary

In-memory selection history resets when the server restarts or the configuration reloads. First-time player history remains persistent.

Found a problem in these docs? Report a documentation issue on GitHub.

On this page