DUXPLIMA Documentation

The pack

Which packs are converted, what each part becomes, the output and the build.

Sources

SourceFound at
Nexoplugins/Nexo/pack/pack.zip
ItemsAdderplugins/ItemsAdder/output/generated.zip or output/
Oraxenplugins/Oraxen/pack/pack.zip
CraftEngineplugins/CraftEngine/generated/resource_pack.zip or the folder, written the first time CraftEngine generates its pack (/ce reload all)
BetterHudplugins/BetterHud/build.zip or build/
MythicHUDplugins/MythicHUD/built-pack/, generated.zip or pack/
HappyHUDplugins/HappyHUD/pack.zip or pack/
CustomNameplates, CustomFishingplugins/<plugin>/ResourcePack
LuxDialoguesplugins/LuxDialogues/Output/LuxDialogues.zip or the folder
server.propertiesThe pack resource-pack names, fetched when sources.server-properties is on (up to 512 MB)
Your ownEvery zip or folder in sources.extra of pack.conf

Only the packs these plugins have built are read, never their configuration, and only while the plugin runs: a plugin taken off the server leaves its built pack behind, which Java players no longer get, so it is not read either. A pack listed in sources.extra is read whatever wrote it. A plugin that protects its pack is named in /uxmbedrock pack report with the setting to change. ItemsAdder 5 ships with its pack obfuscated: set zip_entries, zip_archive, png and short_texture_references under resource_pack.obfuscation to false, then /iazip.

What becomes what

JavaBedrock
Item models, item model definitions, old custom model dataCustom items Geyser registers, with icons; 3D models as geometry and attachables
Armour and elytra equipmentAttachables on the player
Leather armour a core shader draws (animated, emissive armour sets)Attachables with the shader's frames, played at its speed
Bows, crossbows, fishing rods and bundles with their statesThe same states: a bow drawn back, a cast rod, a filled bundle
Blocks with custom statesCustom blocks Geyser registers, broken at their host block's speed; animated textures as flipbooks
Custom stairs, slabs, doors and trapdoorsCustom blocks in every state, turned as Java turns them
Locator bar iconsThe same icons on Bedrock's locator bar
SoundsBedrock sounds, re-encoded smaller with ffmpeg when it is installed
FontsGlyph pages and menu pictures
Language filesGeyser's locale overrides, so items keep their names
Custom headsHeads Geyser registers by their skin

A Bedrock block draws only from 0.875 blocks below to 1.875 blocks above its corner, at most 1.875 blocks long along any axis. A block model reaching further, such as a plant two blocks high, is cut to that room: along y the part below the block goes first, where a plant stands in the ground, then the top; along x and z the side reaching further out. Each cut face keeps its texture where it was. A block state Java draws with nothing (CraftEngine's block/empty) is a clear block.

Geyser needs the vanilla item under each custom item. It is read from the packs, learned the first time a player holds, picks up, places or sees an item with that model, or written in items.conf. /uxmbedrock items unknown lists the ones still missing.

The output

plugins/uxmBedrock/output/ holds what the Geyser extension serves:

FileHolds
NN.mcpackThe content packs: items, blocks, sounds, glyphs, then your merged Bedrock packs
feature-<part>.mcpackOne pack per part a player may switch off, and feature-ui.mcpack for everyone
animated.mcpack, animated-light.mcpackAnimated content, full and light
items.json, blocks.json, locales/Geyser's mappings and names
choices.json, skulls.jsonEach player's choices; the heads
result.json, screen.json, report.txtThe index, the menu pictures, the report

A pack's version moves with its content, so a client downloads only a pack that changed. A build whose sources did not change comes from cache/ at once.

When it builds

WhenBuilds
StartAlways, from the cache when nothing changed
A source changesWhen auto-convert is on, checked every check-every-seconds
/uxmbedrock pack buildNow
A measure or a preview saveWith the new place

A pack switched off under modules is taken out of the build, so no player gets it.