Public API

Compile-time dependency

<repositories><repository><id>jiuwu-releases</id><url>https://repo.crypticlib.com/repository/maven-public/</url></repository></repositories>
<dependency><groupId>emaki.jiuwu.craft</groupId><artifactId>emaki-level-api</artifactId><version>1.6.6</version><scope>provided</scope></dependency>

repositories { maven("https://repo.crypticlib.com/repository/maven-public/") }
dependencies { compileOnly("emaki.jiuwu.craft:emaki-level-api:1.6.6") }

Compile only — never install, shade, or relocate this jar

The runtime embeds these API classes; duplicates invalidate event and bridge class identity

Check EmakiLevelApi.status().usable() before use. catalog(), operations(), and extensions() are never null; install, uninstall, and Bridge exist only for the runtime lifecycle

LevelCatalog is any-thread for types, in-memory progress, requirements, ranking, previews, and loadPlayerDataAsync(UUID). The load future uses EmakiLevel's asynchronous store and its completion thread is unspecified; marshal later Bukkit work yourself. LevelOperations is synchronous and target-player owner-thread only: exp/level mutations, reset, player sync, and GUIs return LevelOperationResult or EmakiResult<Unit>

extensions().registerExpSource(owner, provider) is the owner-scoped third-party experience source point. Provider registration may occur on any thread; its handle is idempotently closeable

Success, Partial, Failure, and optionalValue() distinguish outcomes. Failure kinds are UNAVAILABLE, NOT_FOUND, INVALID_INPUT, REJECTED, CANCELLED, TARGET_OFFLINE, WRONG_THREAD, INTERNAL_ERROR