Skip to Content
1robie
Configuration

Configuration reference

Every file in plugins/CraftEngineConverter and every key, with its default.

The plugin has one file per subject, in plugins/CraftEngineConverter/. /cec reload reloads all of them, except where a key says it needs a restart.

FileAbout
config.ymlGeneral settings and settings shared by the converters
nexo.ymlNexo: hook and conversion on interaction
itemsadder.ymlItemsAdder: the same, plus the img placeholder
world-converter.ymlConverting blocks and furniture as chunks load
database-config.ymlWhere converted blocks are recorded, for restore

config.yml

General

Prop

Type

Items

Shared by every item converter.

Prop

Type

Block-state limits

Custom blocks borrow vanilla block states (note blocks, mushroom blocks, tripwire, leaves…), and each kind has a fixed number of free states. block-state-limit decides how that budget is shared, and where each kind starts counting. The real capacity is read from your CraftEngine configuration at runtime (and on /cec reload).

Prop

Type

The kinds, and how they nest (a parent's count includes its children's):

SOLID
β”œβ”€ MUSHROOM
β”‚   β”œβ”€ RED_MUSHROOM_BLOCK
β”‚   β”œβ”€ BROWN_MUSHROOM_BLOCK
β”‚   └─ MUSHROOM_STEM
└─ NOTE_BLOCK

TRIPWIRE
β”œβ”€ LOWER_TRIPWIRE  [attached=true]
└─ HIGHER_TRIPWIRE [attached=false]

LEAVES
└─ WATERLOGGED_LEAVES

On their own: CACTUS, SUGAR_CANE, WEEPING_VINE, TWISTING_VINE, CAVE_VINE,
SAPLING, KELP, CHORUS

Keys use the kind in lower case with dashes: note-block, red-mushroom-block, lower-tripwire, waterlogged-leaves…

Converting at startup

Prop

Type

config.yml
auto-convert-on-startup: true
auto-convert-on-startup-types:
  nexo:
    - ITEMS
    - EMOJIS
  itemsadder:
    - ITEMS
    - IMAGES

Resource pack

Prop

Type

Shaders are left out by default: another plugin's core shaders are a common cause of a broken CraftEngine pack.

Text formatting

Where glyph, image and PlaceholderAPI tags are rewritten. See Placeholders & tags.

Prop

Type

World conversion on interaction

Prop

Type

Progress bars

progress-bar-options.<option> styles the console progress bar of each converter option (items, emojis, images, languages, sounds, packs):

Prop

Type

Colours: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE.

nexo.yml

Only read when Nexo is installed.

Prop

Type

itemsadder.yml

Only read when ItemsAdder is installed.

Prop

Type

world-converter.yml

Converts blocks and furniture of Nexo and ItemsAdder as chunks are explored, without those plugins installed. This is what lets you remove the old plugin and still convert the parts of the world nobody has visited yet.

Prop

Type

database-config.yml

Every block and furniture the world converter replaces is recorded, with what was there before, so that /cec worldconverter restore can put it back.

Prop

Type

Last updated on

On this page