Integrations
Converting from Nexo and ItemsAdder step by step, and what PlaceholderAPI and PacketEvents add.
Converting content
The same three steps for either plugin: convert, copy the result into CraftEngine, reload CraftEngine.
Run the converter. Nexo or ItemsAdder does not need to be running, only its
folder under plugins/:
/cec convert nexo
# or
/cec convert itemsadderAdd --dryrun first to see how it goes without writing anything.
Copy the result into CraftEngine. The output mirrors CraftEngine's own folder:
Copy resources/craftengineconverter to
plugins/CraftEngine/resources/<a name of your choice>, for example
resources/nexo.
Converting from both plugins
Nexo and ItemsAdder both write a resources/craftengineconverter folder. Give
each its own name in CraftEngine (resources/nexo, resources/itemsadder), or
one overwrites the other.
Reload CraftEngine so it loads the new content and rebuilds its resource pack:
/ce reload allConverting again writes to the output folder only, never to what you copied into CraftEngine: copy again after each run.
Nexo
| Option | Reads (plugins/Nexo/…) | Writes (configuration/… or resourcepack/) |
|---|---|---|
ITEMS | items/ | items/ |
EMOJIS | glyphs/ | emojis/ |
IMAGES | glyphs/ | images/ |
RECIPES | recipes/ | recipes/ |
SOUNDS | sounds.yml | sounds/sounds.yml |
LANGUAGES | languages.yml | languages/languages.yml |
PACKS | pack/ | resourcepack/ |
Disabled vanilla recipes. Nexo's recipes/disabled_recipes.yml becomes a
config.yml holding recipe.disable-vanilla-recipes.list. Do not copy it
over CraftEngine's config.yml: merge that one list into it.
Interaction and chunk conversion are set in
nexo.yml and need Nexo
installed. To convert after removing Nexo, use the
world converter.
ItemsAdder
| Option | Reads (plugins/ItemsAdder/contents/…) | Writes |
|---|---|---|
ITEMS | item definitions | configuration/items/ |
IMAGES | font images | configuration/images/ |
LANGUAGES | translations | configuration/languages/ |
SOUNDS | sounds | configuration/sounds/ |
RECIPES | recipes | configuration/recipes/ |
PACKS | each namespace's resourcepack/ | resourcepack/ |
ItemsAdder has no separate emoji step: its font images become CraftEngine
images, used by :name: tags and %img_<name>%.
To leave part of contents/ out, list its folders or namespaces in
blacklisted-content-folders-namespaces in
itemsadder.yml.
While both plugins are installed, turn off ItemsAdder's resource pack generation, so its pack does not fight with CraftEngine's.
Converting the world
Blocks and furniture already placed are converted in three ways, which can be combined:
| How | Needs the old plugin? | Set up |
|---|---|---|
| When a player uses them | Yes | enable-block-interaction-conversion, enable-furniture-interaction-conversion + permissions |
| As chunks load | No | world-converter.yml enable: true (restart) |
| Every loaded chunk, now | No | /cec worldconverter start |
Converted blocks propagate to their neighbours (up to 64 per interaction by
default), so a build converts in one go. Everything the world converter replaces
is recorded, and
/cec worldconverter restore
puts it back.
PlaceholderAPI
Optional. Adds <placeholderapi:…> / <papi:…> tags in text and the
%img_<name>% placeholder. See Placeholders & tags.
PacketEvents
Optional. Lets the plugin rewrite glyph and image tags in packets, so text sent
by any plugin is covered, not only messages that go through Paper's API. On by
default once installed (formatting.packet-events).
Last updated on