I'm making Minecraft Plugin which aside from it's normal behaviour provides API for developers.
In Minecraft it's important to run blocking operations Async - so main thread will not be blocked and thus not causing lags.
In my API I have simple method which loads data from Database. This method doesn't care about what thread its executed on - I want to inform user about blocking behavior of this method and that he should run it Async (preferably via BukkitScheduler). I don't want to return CompletableFuture.
Is there any special JavaDoc item or method annotation for this purpose?