Skip to content

Getting Started

Updating the plugin

How sofyCore updates its configuration files automatically, where backups are stored and what to check when updating a network.

Replacing the JAR

Stop the server, replace the JAR in plugins/ and start it again. Do not reload the plugin with third-party plugin managers.

Automatic configuration updates

config.yml carries a config-version (18 in the current version). When the core starts or a module reloads:

  • only missing values from the bundled template are added; existing values are never replaced;
  • a full copy of the previous file is saved first in plugins/sofyCore/backups/;
  • a future version, invalid YAML or an incompatible section is rejected instead of being overwritten.

staff.yml, essentials.yml and scoreboard.yml have their own config-version and are updated the same way.

Networks

Update every server of the network before using features that write newer data formats:

  • conditional rank rules write rank documents with schemaVersion: 2;
  • the maintenance rank freeze writes the rank policy head with schemaVersion: 4.

An older sofyCore rejects a newer schema and keeps ranks unavailable instead of misreading them.