[MattBDev]

Cherry picked EngineHub/WorldEdit#2802.
"Use NIO in the YAMLProcessor class"
THIS SHOULD BE AN EASY APPROVE
This restores compatibility with WorldGuard, which now calls the Path constructors of YAMLProcessor and fails with NoSuchMethodError on FAWE.

Differences from the upstream commit:

• The verification/ API change list does not exist in FAWE, so that part is dropped.
• WorldEditPlugin applies .toPath() to FAWE's worldedit-config.yml line instead of upstream's config.yml line.

Submitter Checklist

• Make sure you are opening from a topic branch (/feature/fix/docs/ branch (right side)) and not your main branch.
• Ensure that the pull request title represents the desired changelog entry.
• New public fields and methods are annotated with @since TODO. (The new Path constructors are upstream API and are kept as upstream has them.)
• I read and followed the contribution guidelines.

[Copilot]

Note

Copilot was unable to complete this review at the selected tier due to model policy or plan restrictions.

🟡 Changes recommended

The change replaces the protected File file field with a Path path field in YAMLProcessor, which is a binary-incompatible API break for external subclasses/plugins and directly conflicts with the stated compatibility goal unless a deprecated alias is retained.

1 open issue

• Keep deprecated File field for subclass binary compatibility · New

What changed in this PR

This pull request cherry-picks upstream WorldEdit changes to migrate YAMLProcessor from java.io.File-based I/O to NIO (Path/Files) and adds Path constructors, restoring runtime compatibility with integrations (e.g., WorldGuard) that now call YAMLProcessor(Path, ...).

Changes:

• Add Path-accepting constructors to YAMLProcessor and switch internal read/write operations to java.nio.file.Files streams.
• Update Bukkit bootstrap/config initialization to pass .toPath() for worldedit-config.yml.
• Update WEPIF permissions configuration loading to use Path/Files APIs.

Review notes (unresolved):

• Critical: Changing protected File file to Path path is binary-incompatible for external subclasses/plugins accessing YAMLProcessor#file (risk of NoSuchFieldError). Consider keeping a deprecated protected File file alias derived from path to preserve compatibility.
• Moderate: save() creates an OutputStreamWriter that is not closed/flushed; this can truncate output while still returning true. Use try-with-resources for the writer.
• Nit: save() directory creation/logging should also consider SecurityException, and use parameterized logging instead of string concatenation.

File	Summary
worldedit-core/​src/​main/​java/​com/​sk89q/​util/​yaml/​YAMLProcessor.java	Adds Path constructors and migrates YAML read/write and directory creation to NIO (Path/Files).
worldedit-bukkit/​src/​main/​java/​com/​sk89q/​worldedit/​bukkit/​WorldEditPlugin.java	Passes a Path (.toPath()) into YAMLProcessor for Bukkit config initialization (worldedit-config.yml).
worldedit-bukkit/​src/​main/​java/​com/​sk89q/​wepif/​PermissionsResolverManager.java	Converts WEPIF config handling from File to Path/Files and constructs YAMLProcessor with a Path.

_{Review effort: Balanced}