Developer API Overview
NookureStaff provides a clean API module (NookureStaff-API) designed to allow other plugins or standalone addons to interact with staff wrappers, subscribe to event buses, and manage punishments.
Adding the Dependency
Section titled “Adding the Dependency”repositories { maven("https://repo.nookure.com/repository/maven-public/")}
dependencies { compileOnly("com.nookure.staff:NookureStaff-API:2.0.0")}<repositories> <repository> <id>nookure-repo</id> <url>https://repo.nookure.com/repository/maven-public/</url> </repository></repositories>
<dependencies> <dependency> <groupId>com.nookure.staff</groupId> <artifactId>NookureStaff-API</artifactId> <version>2.0.0</version> <scope>provided</scope> </dependency></dependencies>Core Architecture Principles
Section titled “Core Architecture Principles”- Player Wrapper Pattern:
PlayerWrapper: Represents standard player models, caching UUID, name, and database state.StaffPlayerWrapper: ExtendsPlayerWrapperfor players withnookure.staff. Holds staff mode status, vanish state, and assigned glow colors.
- Dependency Injection & Services:
- Internal components and services (such as
PunishmentService,AltAccountService,S3PresignerService, andActionService) are managed using Google Guice. - Plugins can utilize
@Injectto resolve service singletons.
- Internal components and services (such as
- Decoupled Event Bus:
- In addition to standard Bukkit listeners, NookureStaff features an internal high-performance event bus (
EventManager) for cross-platform and network-level packet events.
- In addition to standard Bukkit listeners, NookureStaff features an internal high-performance event bus (