Skip to content

PasteSpell

MomoPewpew edited this page Apr 8, 2024 · 9 revisions

Source Code

spell-class: ".targeted.PasteSpell"

Description:

Targeted Spell that pastes a WorldEdit schematic at the target location. Create a .schem file with WorldEdit and put it into MagicSpells/schematics folder.

Configuration Options:

Option Description Default Value
schematic Name of the schematic file. "none"
y-offset Modifies the start height location. 0
undo-delay Delay before removing the schematic. 0
paste-air Should the schematic paste air? false
remove-paste Should the schematic be removed on server stop/reload? true
paste-at-caster Should the schematic be pasted at the caster's location? false
build-interval How fast the animated paste should build the schematic. Use 0 for a regular paste. 0
build-interval-randomness A random number between 0 and this value will be added to the build-interval. 7
max-working-blocks How many blocks is an animated paste allowed to handle at the same time. Reduce this if large pastes are causing lag. 1000
blocks-per-cast If this is greater than 0, then an animated paste will stop after this many altered blocks. Pasted air is also counted towards this limit. This lets you effectively split a paste up into several casts. 0
dismantle-first If true, an animated paste will first paste all of the required air blocks before building out the schematic. If false, the blocks and the air will be pasted at the same time. false
display-animation Whether an animated paste should use BlockDisplays to show moving blocks. true
play-block-break-effect Whether an animated paste should show block break particles. true
instant-undo If false, an animated paste will also animate the undo when it expires. false
build-start-offsets A list of vectors that determine where the animated paste first starts. These are x, y, z offsets compared to the schematic's origin point. If null, the paste will start as close to the schematic's origin point as possible. null
dismantle-start-offsets A list of vectors that determine where the animated pasting of air starts. These are x, y, z offsets compared to the schematic's origin point. If null, the pasting of air will start as far away from the schematic's origin point as possible. null
only-replace-air When true and build-interval > 0, the animated paste will only fill in air blocks, rather than replacing any block. false

Spell Example:

paste:
    spell-class: ".targeted.PasteSpell"
    schematic: schematicName.schem
    y-offset: 1
    undo-delay: 100
    paste-air: false
    remove-paste: true
    paste-at-caster: false
secretAlterOpen-paste:
    spell-class: ".targeted.PasteSpell"
    schematic: PromotionDoorOpen.schem
    paste-air: true
    build-interval: 40
    max-working-blocks: 500
    display-animation: true
    play-block-break-effect: true
    dismantle-start-offsets:
        - 0 2 0

secretAlterClose-paste:
    spell-class: ".targeted.PasteSpell"
    schematic: PromotionDoorClosed.schem
    paste-air: false
    build-interval: 40
    max-working-blocks: 500
    display-animation: true
    play-block-break-effect: true
    build-start-offsets:
        - 0 2 4
        - 0 2 -4
Clone this wiki locally