Migrating from Paper

FeatherMC keeps Paper’s config filenames, data keys and plugin API, so a Paper 26.3 server moves over by swapping the jar.

• Worlds load as they are.
• Plugins built for Paper load without changes.
• Configs in config/ are read as normal. Values you already set are kept.

1. Back up

   Stop the server and copy the whole folder somewhere safe.

2. Swap the jar

   Replace the Paper jar with the FeatherMC jar, and update your start command or script to the new filename.

3. Start it up

   Start up, check the console for a Done! message, and you’re good!

Your existing values win

Paper writes every setting into paper-world-defaults.yml, so a migrated server keeps Paper’s values for the mob AI throttle and per-chunk save limits. To use FeatherMC’s defaults, set them as listed in Changed Paper defaults.