Wiki

Duck Blocks Wiki

In-world machines, trigger systems, moving structures, redstone logic, and the public Duck Blocks authoring workflow.

Quick access

Plugin downloadsDuck Blocks All wikisOfficial docs hub AssetsMarketplace SupportHelp routes

Getting Started

Start here for first boot, the file split, server-wide defaults, and the real saved trigger shape.

Wiki Home First Boot, Trigger Types, and the File Map Config YML: Runtime Defaults and Save Policy DuckBlocks YML: Trigger Layout and Live Examples

In-Game Authoring

Build DuckBlocks live through the admin menu, trigger editor, display editor, and machine-by-machine editor flow.

Main Menu, Create Flow, and the Admin Command Surface Trigger Editor, Core Controls, and Machine Layout Command Authoring, Books, Command Files, and `db:` Action Lines Displays, Hitboxes, and ModelEngine

Placeholders and Context

Understand player context, built-in tokens, and how Duck Blocks hands finished commands into the rest of the server.

Placeholders, Player Context, and Command Handoffs

Trigger Logic and Motion

Control how DuckBlocks fire, sequence, move, and carry players through the world.

Activation Sources, Redstone, and Player Proximity Redstone Advanced, Edge Modes, Range, and Player Context Animations, Effects, and the Timeline Orchestrator Travel Paths, Walkable Platforms, and Rideable Structures Travel GUI, Path Builder, Waypoints, and Carry Batch Tools, Presets, and Nearby Mass Edits

YML File Guides

Jump straight into the reusable preset files that make a large Duck Blocks library maintainable.

Animations YML: Motion Presets and When to Use Them Effects YML: Sounds, ParticleFX, and Combo Presets

Runtime and Troubleshooting

Understand what gets saved, what the carry logs mean, and how to troubleshoot live Duck Blocks cleanly.

Admin Runtime, State, and Live Troubleshooting

What the preset library is for The main animation types The main animation modes Example preset How to pick the important numbers `amplitude``periodTicks``range``speed`Naming presets well Good preset families to keep Best next pages

Wiki navigation

Duck Blocks

Move through the core pages, grouped by system area instead of one long documentation wall.

Getting Started

Start here for first boot, the file split, server-wide defaults, and the real saved trigger shape.

Wiki Home First Boot, Trigger Types, and the File Map Config YML: Runtime Defaults and Save Policy DuckBlocks YML: Trigger Layout and Live Examples

In-Game Authoring

Build DuckBlocks live through the admin menu, trigger editor, display editor, and machine-by-machine editor flow.

Placeholders and Context

Understand player context, built-in tokens, and how Duck Blocks hands finished commands into the rest of the server.

Placeholders, Player Context, and Command Handoffs

Trigger Logic and Motion

Control how DuckBlocks fire, sequence, move, and carry players through the world.

YML File Guides

Jump straight into the reusable preset files that make a large Duck Blocks library maintainable.

Animations YML: Motion Presets and When to Use Them Effects YML: Sounds, ParticleFX, and Combo Presets

Runtime and Troubleshooting

Understand what gets saved, what the carry logs mean, and how to troubleshoot live Duck Blocks cleanly.

Admin Runtime, State, and Live Troubleshooting

YML File Guides

Animations YML: Motion Presets and When to Use Them

Use animations.yml as a motion library instead of rebuilding the same float, pop, and spin patterns by hand.

Plugin downloadsDuck Blocks

animations.yml is the reusable motion library. It exists so you can name a movement style once and then reuse it across many blocks instead of rebuilding every float or spin by hand.

What the preset library is for

Use animations.yml when you want consistency across many props:

the same hover on every collectible
the same nearby spin on every energy core
the same activate-pop on every premium button

That keeps the map readable and makes tuning much easier.

The main animation types

The live preset library revolves around:

FLOAT
POP
SPIN

The main animation modes

The live preset library also uses:

ALWAYS
NEARBY
ACTIVATE

That is the real authoring choice:

ALWAYS when the prop should constantly feel alive
NEARBY when the motion should wake up only around players
ACTIVATE when the motion is part of the trigger event itself

Example preset

YAML

presets:
  float_always_a050_p160:
    name: "Float - Always - a=0.05 p=160t"
    icon: FEATHER
    type: FLOAT
    mode: ALWAYS
    amplitude: 0.05
    periodTicks: 160

This is the right kind of preset for a calm, always-on hover.

How to pick the important numbers

`amplitude`

This is how far the motion travels.

small amplitude for premium polish
larger amplitude for magical or exaggerated props

`periodTicks`

This is how fast the cycle feels.

shorter periods feel more active
longer periods feel smoother and calmer

`range`

Use this for nearby-only behavior so distant props do not animate unnecessarily.

`speed`

This matters most for spin and more noticeable motion styles.

Naming presets well

Your live preset library already uses a very practical pattern:

motion family
mode
a compact numeric summary

Keep that idea. It scales well when the library becomes large.

Good preset families to keep

one calm always-float family
one stronger magical float family
one nearby spin family
one activate pop family

That is enough to make a large server feel consistent before you create dozens of niche presets.

Best next pages

PreviousBatch Tools, Presets, and Nearby Mass Edits Effects YML: Sounds, ParticleFX, and Combo PresetsNext