AddonBridge

Run Minecraft Bedrock addons (.mcaddon / .mcpack) on a PowerNukkitX server. Drop the files in, restart, and everything is live: items, blocks, entities, recipes, loot tables, spawn rules, AI, creative menu groups, the resource pack served to players, and the @minecraft/server scripts, actually executed by an embedded JavaScript engine.

No conversion, no manual BP/RP splitting, no code to write.

Usage

plugins/AddonBridge/addons/
|- Rustic Furniture.mcaddon
|- Free Fire Gun 1.9.mcaddon
`- The Lost Age.mcaddon

Put the jar into plugins/.
Start once (this creates plugins/AddonBridge/addons/ and config.yml).
Drop your .mcaddon files in there.
Restart.

AddonBridge accepts .mcaddon, .mcpack, .zip and already extracted folders, including nested ones: a .mcaddon containing two .mcpack files is handled on its own. Archives are extracted into plugins/AddonBridge/cache/ and only re-extracted when their content changes, so later restarts are immediate.

On startup:

[AddonBridge]: Addons detected: 14 packs (7 BP, 7 RP).
[AddonBridge]: Load finished in 3 s: 10232 items, 420 blocks, 29 entities,
               10126 recipes, 11 loot tables, 16 spawn rules,
               40 creative groups, 7 resource packs.
[AddonBridge]: Scripts active: 5 modules, 10 custom components.

Command

/addons (alias /addonbridge), permission addonbridge.command (op):

Command	Effect
`/addons list`	List the loaded addons and their packs (BP / RP)
`/addons status`	Counters from the last load
`/addons scripts`	JS engine state plus any missing `@minecraft/server` API reached
`/addons info <name>`	Details for one addon: version, uuid, scripts

Behavior pack content	Status
`items/**.json`	Full items: icon, name, durability, damage, armor, enchantability, digger, food, fuel, block placer, shooter/throwable, cooldown, tags, repairable, render offsets, mining speed
`items` with `minecraft:wearable`	Real armor: the slot is inferred from the enchant slot when it is missing, `minecraft:armor` merges into the protection value, and `/addons check` tells you whether the matching attachable exists
`items` with `minecraft:digger`	`destroy_speeds` evaluated like the client, Molang conditions included (`"1"`, `q.any_tag(...)`, `&&`, `
`blocks/**.json`	Full blocks: geometry, material instances, collision and selection boxes (a list of boxes becomes their union instead of a full cube), integer and string states, permutations, tags, hardness, light, friction, map color
`blocks` with the `minecraft:placement_direction` trait	The block faces the player who places it
`entities/**.json`	Entities: health, collision box, speed, attack, families, physics, spawn egg, `/summon`, plus rideable seats, saddle, ride controls, horse jump strength, tameable, ageable, breedable, healable, home, inventory, equippable, boostable, item controllable
`entities` `component_groups` and `events`	Applied at runtime: `add` / `remove`, `sequence`, weighted `randomize`, `trigger` chains, `run_command`, and the common filters. The active groups are saved with the entity
`entities` with `minecraft:rideable`	Interacting mounts the player on the declared seat, whether the component sits in the base components or in a group an event turns on later
`entities` with `minecraft:interact`	Right clicking with the declared item fires the event, plays the sound and consumes the item
`entities` with `minecraft:timer`, `spawn_entity`, `despawn`, `damage_sensor`, `experience_reward`	Ticked at runtime: countdowns fire their event, spawners produce their entity, damage immunity is honoured
`entities` with `minecraft:behavior.*`	AI translated into PowerNukkitX behaviors, with the route finder and controllers chosen from `minecraft:navigation.` / `minecraft:movement.`, so a flying or swimming mob no longer walks a ground path. Covers roaming, melee and ranged attack, targeting by family, retaliation, fleeing, panic, tempt, breeding, following, looking, hovering
`loot_tables/**.json`	Block and entity drops: pools, rolls, weights, `set_count`, `set_damage`, `set_data`, `enchant_randomly`, `looting_enchant`, `specific_enchants`, and the `killed_by_player`, `random_chance`, `match_tool` conditions
`spawn_rules/**.json`	Natural spawning: surface, underground, underwater, brightness, height, biome, density, herd size, weight
`recipes/**.json`	`recipe_shaped`, `recipe_shapeless`, `recipe_furnace`
`item_catalog/**.json`	Custom creative menu groups
`scripts/**.js`	Executed, see the next section
Resource pack	Zipped and served to players, flagged as an addon pack

Behavior pack content

Status

items/**.json

Full items: icon, name, durability, damage, armor, enchantability, digger, food, fuel, block placer, shooter/throwable, cooldown, tags, repairable, render offsets, mining speed

items with minecraft:wearable

Real armor: the slot is inferred from the enchant slot when it is missing, minecraft:armor merges into the protection value, and /addons check tells you whether the matching attachable exists

items with minecraft:digger

destroy_speeds evaluated like the client, Molang conditions included ("1", q.any_tag(...), &&, `

blocks/**.json

Full blocks: geometry, material instances, collision and selection boxes (a list of boxes becomes their union instead of a full cube), integer and string states, permutations, tags, hardness, light, friction, map color

blocks with the minecraft:placement_direction trait

The block faces the player who places it

entities/**.json

Entities: health, collision box, speed, attack, families, physics, spawn egg, /summon, plus rideable seats, saddle, ride controls, horse jump strength, tameable, ageable, breedable, healable, home, inventory, equippable, boostable, item controllable

entities component_groups and events

Applied at runtime: add / remove, sequence, weighted randomize, trigger chains, run_command, and the common filters. The active groups are saved with the entity

entities with minecraft:rideable

Interacting mounts the player on the declared seat, whether the component sits in the base components or in a group an event turns on later

entities with minecraft:interact

Right clicking with the declared item fires the event, plays the sound and consumes the item

entities with minecraft:timer, spawn_entity, despawn, damage_sensor, experience_reward

Ticked at runtime: countdowns fire their event, spawners produce their entity, damage immunity is honoured

entities with minecraft:behavior.*

AI translated into PowerNukkitX behaviors, with the route finder and controllers chosen from minecraft:navigation.* / minecraft:movement.*, so a flying or swimming mob no longer walks a ground path. Covers roaming, melee and ranged attack, targeting by family, retaliation, fleeing, panic, tempt, breeding, following, looking, hovering

loot_tables/**.json

Block and entity drops: pools, rolls, weights, set_count, set_damage, set_data, enchant_randomly, looting_enchant, specific_enchants, and the killed_by_player, random_chance, match_tool conditions

spawn_rules/**.json

Natural spawning: surface, underground, underwater, brightness, height, biome, density, herd size, weight

recipes/**.json

recipe_shaped, recipe_shapeless, recipe_furnace

item_catalog/**.json

Custom creative menu groups

scripts/**.js

Executed, see the next section

Resource pack

Zipped and served to players, flagged as an addon pack

Area	Implemented
`world`	`getDimension`, `getAllPlayers`, `getEntity`, `sendMessage`, `getAbsoluteTime`, `getTimeOfDay`/`setTimeOfDay`, `getDay`, dynamic properties, `beforeEvents`/`afterEvents`, `scoreboard` (read)
`system`	`run`, `runTimeout`, `runInterval`, `runJob` (generators, sliced per tick), `clearRun`, `currentTick`, `waitTicks`, `beforeEvents.startup`
`Dimension`	`getBlock`, `getTopmostBlock`, `setBlockType`, `setBlockPermutation`, `spawnEntity`, `spawnItem`, `getEntities`/`getPlayers` with the full filter set (`type`, `families`, `tags`, their `exclude*` counterparts, `minDistance`/`maxDistance`, `closest`/`farthest`), `runCommand(Async)`, `createExplosion`, `playSound`
`Entity` / `Player`	Position, rotation, velocity, `teleport`, `getComponent`, `getComponents`, `triggerEvent`, effects, tags, `applyDamage`, `kill`, `runCommand`, dynamic properties, `nameTag`, `onScreenDisplay`, game mode, XP, `getBlockFromViewDirection`, `playSound`, `playMusic`
`Block`	`typeId`, `permutation`, `setType`, `setPermutation`, `above`/`below`/`north`/`offset`, `getComponent("inventory")`, tags
`BlockPermutation`	`resolve`, `getState`, `withState`, `getAllStates`, `matches`, `clone`, `getItemStack`
`ItemStack`	Constructor, `typeId`, `amount`, `nameTag`, `getLore`/`setLore`, `clone`, `getComponent`
Components	`health`, `inventory` with `Container` and `ContainerSlot`, `equippable`, `movement`, `durability`, `rideable` (`getRiders`, `addRider`, `ejectRider(s)`, seats), `type_family`, `variant`, `mark_variant`, `scale`, `tameable`, `is_baby`, `onfire`, `leashable`
Events	`playerSpawn`, `playerJoin`, `playerLeave`, `playerBreakBlock`, `playerPlaceBlock`, `playerInteractWithBlock`, `playerInteractWithEntity`, `itemUse`, `entityHurt`, `entityHitEntity`, `entityDie`, `entitySpawn`, `projectileHitBlock`, `projectileHitEntity`, `scriptEventReceive`, `chatSend`. The `beforeEvents` variants are cancellable
Custom components	`blockComponentRegistry` and `itemComponentRegistry`: `onPlayerInteract`, `onPlace`, `onPlayerDestroy` / `onBreak`, `onStepOn`, `onStepOff`, `onEntityFallOn`, `onTick`, `onRandomTick`, `onUse`, `onUseOn`, `onMineBlock`, `onHitEntity`
Sounds	`playSound` on `world`, `Dimension` and `Player` sends the name straight to the client, so a sound declared in the addon `sound_definitions.json` plays like any vanilla one
`@minecraft/server-ui`	`ActionFormData`, `MessageFormData`, `ModalFormData` mapped onto PowerNukkitX forms

Area

Implemented

world

getDimension, getAllPlayers, getEntity, sendMessage, getAbsoluteTime, getTimeOfDay/setTimeOfDay, getDay, dynamic properties, beforeEvents/afterEvents, scoreboard (read)

system

run, runTimeout, runInterval, runJob (generators, sliced per tick), clearRun, currentTick, waitTicks, beforeEvents.startup

Dimension

getBlock, getTopmostBlock, setBlockType, setBlockPermutation, spawnEntity, spawnItem, getEntities/getPlayers with the full filter set (type, families, tags, their exclude* counterparts, minDistance/maxDistance, closest/farthest), runCommand(Async), createExplosion, playSound

Entity / Player

Position, rotation, velocity, teleport, getComponent, getComponents, triggerEvent, effects, tags, applyDamage, kill, runCommand, dynamic properties, nameTag, onScreenDisplay, game mode, XP, getBlockFromViewDirection, playSound, playMusic

Block

typeId, permutation, setType, setPermutation, above/below/north/offset, getComponent("inventory"), tags

BlockPermutation

resolve, getState, withState, getAllStates, matches, clone, getItemStack

ItemStack

Constructor, typeId, amount, nameTag, getLore/setLore, clone, getComponent

Components

health, inventory with Container and ContainerSlot, equippable, movement, durability, rideable (getRiders, addRider, ejectRider(s), seats), type_family, variant, mark_variant, scale, tameable, is_baby, onfire, leashable

Events

playerSpawn, playerJoin, playerLeave, playerBreakBlock, playerPlaceBlock, playerInteractWithBlock, playerInteractWithEntity, itemUse, entityHurt, entityHitEntity, entityDie, entitySpawn, projectileHitBlock, projectileHitEntity, scriptEventReceive, chatSend. The beforeEvents variants are cancellable

Custom components

blockComponentRegistry and itemComponentRegistry: onPlayerInteract, onPlace, onPlayerDestroy / onBreak, onStepOn, onStepOff, onEntityFallOn, onTick, onRandomTick, onUse, onUseOn, onMineBlock, onHitEntity

Sounds

playSound on world, Dimension and Player sends the name straight to the client, so a sound declared in the addon sound_definitions.json plays like any vanilla one

@minecraft/server-ui

ActionFormData, MessageFormData, ModalFormData mapped onto PowerNukkitX forms

Key	Default	Effect
`enabled`	`true`	Turn the plugin off entirely
`addons-folder`	`addons`	Scanned folder, relative to the plugin folder
`serve-resource-packs`	`true`	Send addon resource packs to players
`creative-menu`	`true`	Add content to the creative menu, see below
`register-items` / `-blocks` / `-entities` / `-recipes` / `-creative-groups`	`true`	Enable each content type
`register-loot-tables`	`true`	Drops driven by the addon loot tables
`register-entity-ai`	`true`	Translate `minecraft:behavior.*` into PowerNukkitX AI
`run-scripts`	`true`	Execute the `@minecraft/server` scripts
`passthrough-unknown-components`	`true`	Forward unmodelled components to the client
`apply-placement-traits`	`true`	Face blocks towards the player placing them
`force-reextract`	`false`	Re-extract archives on every startup
`disabled`	`[]`	File or folder names to ignore, without extension
`log-level`	`normal`	`quiet`, `normal` or `verbose`

Content	`creative-menu: true`	`creative-menu: false`
6 addons, 442 items and blocks	1 s	1 s
Plus one addon with 10232 items	279 s	3 s

AddonBridge

AddonBridge

Usage

Command

What gets loaded

The `@minecraft/server` scripts

What is not loaded

Configuration

Creative menu grouping

Creative menu ordering

`creative-menu` and very large addons

How it works

Build

AddonBridge

AddonBridge

Usage

Command

What gets loaded

The @minecraft/server scripts

What is not loaded

Configuration

Creative menu grouping

Creative menu ordering

creative-menu and very large addons

How it works

Build

The `@minecraft/server` scripts

`creative-menu` and very large addons