Skip to content

sofyCore Developer documentation

Use sofyCore's public Java API to read ranks, issue sanctions, freeze, vanish, open menus, move VIP points and listen to events from your plugins.

sofyCore exposes a platform-independent API in the net.sofycore.api package (module sofycore-api). Your plugin compiles against it with provided scope and obtains the implementation from Bukkit's ServicesManager at runtime.

Design principles

  • Typed services, no generic executor. Business actions are exposed through typed services. There is no permission-free "run anything" API.
  • Asynchronous I/O. Methods that touch the database or Redis return CompletableFuture and run on bounded workers.
  • Same rules as commands. Services that act on players apply the same permissions and hierarchy as the in-game commands.
  • No platform types in the API. sofycore-api does not import Bukkit, NMS or database driver classes.