platform-api/ — Interface Definitions

MC-free interfaces consumed by core/. Each MC version module provides implementations.

Structure

kamkeel/npcs/platform/       → PlatformService, PlatformServiceHolder, annotations
noppes/npcs/api/             → Entity, item, handler, NBT interfaces
noppes/npcs/platform/nbt/    → NBTFactory, NBTIO abstractions

Naming Conventions

Short I prefix: IMob, ILiving, IUser, INpc, IStack, IGameWorld, IDamage
No Platform prefix on interfaces — only PlatformService itself uses it
Scripting API (IPlayer, IEntity, ICustomNpc) is in the same package but separate concern

Key Interfaces

Interface	Wraps	Extends
`IMob`	Entity	—
`ILiving`	EntityLivingBase	`IMob`
`IUser`	EntityPlayerMP	`ILiving`
`INpc`	EntityNPCInterface	`ILiving` (planned)
`IStack`	ItemStack	—
`IGameWorld`	World	—
`IDamage`	DamageSource	—

PlatformService

Central SPI (kamkeel.npcs.platform.PlatformService): NBT factory + I/O, file paths, entity/item/world wrapping, logging, environment queries, scheduling. Access: PlatformServiceHolder.get().

Rules

Interfaces only — no MC imports allowed
@ClientOnly / @ServerOnly annotations for side-specific contracts
New interfaces follow I[Thing] naming — keep names short

1.4 KiB Raw Blame History