1.21.1 Mod API

Mod API

Version Parity: Package it.ratlab.signalradar.api (server-side) is identical on both Minecraft 1.20.1 (Forge) and Minecraft 1.21.1 (NeoForge).

For mod developers integrating directly with Signal Radar. All facade methods are static and thread-safe; none of them blocks on structure searches or chunk generation.

Facade SignalRadarAPI

• Targets: targetIds(), getTarget(id), getTargetPos(level or player, id).
• Player state: unlock, lock, isUnlocked, isFound, resetFound, resetAllFound (all take the player), getLastDeath(player).
• Radar stacks: isRadar, getTier, setTier, getEnergy, setEnergy, getAddons, setAddons, hasAddon, getCapacity(stack) (including batteries), getAddonCount(stack, id).
• Item Energy Capability:
  • 1.20.1 Forge: standard ForgeCapabilities.ENERGY
  • 1.21.1 NeoForge: Capabilities.EnergyStorage.ITEM

Events

Subscribed on MinecraftForge.EVENT_BUS (1.20.1) or NeoForge.EVENT_BUS (1.21.1):

Event	When
RadarScanEvent	Before a snapshot is sent. Cancellable. Mutable blip list: addTarget, removeTarget, removeCategory, removeTargets(predicate).
RadarTargetFoundEvent	A player found a target.
RadarUpgradedEvent	A radar was upgraded in the crafting grid (inferred from the crafted result).
RadarAddonChangedEvent	An addon slot changed.

KubeJS events are bridges to these, see KubeJS.

Registering addons

AddonRegistry.registerCustom(AddonDefinition) with the builder AddonDefinition.builder(id, detector). Allowed until this mod's item RegisterEvent starts; later calls log an error and return false. AddonRegistry.addProvider(Runnable) runs inside that event just before the registry freezes. Public detector types: container, block_tag, entity_tag, structure_tag. The builder takes the same options as the KubeJS one (Custom Addons).

Tags

Tag	Type	Default	Used by
signalradar:radar_modules	item	the 4 modules	upgrade ingredients
signalradar:addons	item	all built-in addons (mod addons optional)	addon slots
signalradar:two_handed	item	empty	items that switch off an offhand radar while held in the main hand (guns, ...)
signalradar:ore_targets	block	#c:ores	Ore addon
signalradar:container_targets	block	empty	extra blocks for the Container addon
signalradar:biosign	entity type	empty	extra entities for the Biosign addon
signalradar:trackable	entity type	empty	extra entities for the Motion addon
signalradar:scannable_structures	worldgen structure	empty (= all structures of the dimension)	Structure addon