PHPackages                             aternos/plop - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. aternos/plop

ActiveProject[Utility & Helpers](/categories/utility)

aternos/plop
============

Plop Minecraft structures into existence

v1.0.0(1y ago)691MITPHP

Since Aug 9Pushed 1y ago1 watchersCompare

[ Source](https://github.com/aternosorg/plop)[ Packagist](https://packagist.org/packages/aternos/plop)[ RSS](/packages/aternos-plop/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

Plop
====

[](#plop)

Generate Minecraft function files to make structures plop into existence in Vanilla Minecraft.

[![plop](https://private-user-images.githubusercontent.com/8943286/356582648-28ec4c33-a8fc-40a9-8a08-7d6471d57ee9.gif?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUyMDAwNTQsIm5iZiI6MTc3NTE5OTc1NCwicGF0aCI6Ii84OTQzMjg2LzM1NjU4MjY0OC0yOGVjNGMzMy1hOGZjLTQwYTktOGEwOC03ZDY0NzFkNTdlZTkuZ2lmP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA0MDNUMDcwMjM0WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NjhhYTg2OTg1OWU0MzQyYzRiMzZkOWMyOTM2OGM1NzQ0ZjAzMzU2NjRkNTY0MjQ5ZjM0MjZhNWM5MDEwNDRjZCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.zDVcp9aCQ5ySwhVkt1jCuwUNUfwXn0g9tbF1K2V4oTA)](https://private-user-images.githubusercontent.com/8943286/356582648-28ec4c33-a8fc-40a9-8a08-7d6471d57ee9.gif?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUyMDAwNTQsIm5iZiI6MTc3NTE5OTc1NCwicGF0aCI6Ii84OTQzMjg2LzM1NjU4MjY0OC0yOGVjNGMzMy1hOGZjLTQwYTktOGEwOC03ZDY0NzFkNTdlZTkuZ2lmP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA0MDNUMDcwMjM0WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NjhhYTg2OTg1OWU0MzQyYzRiMzZkOWMyOTM2OGM1NzQ0ZjAzMzU2NjRkNTY0MjQ5ZjM0MjZhNWM5MDEwNDRjZCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.zDVcp9aCQ5ySwhVkt1jCuwUNUfwXn0g9tbF1K2V4oTA)

Plop uses a Vanilla structure file to generate a single function file that works without any other dependencies.

Installation
------------

[](#installation)

### CLI

[](#cli)

```
git clone https://github.com/aternosorg/plop.git
cd plop
composer install
```

### Library

[](#library)

```
composer require aternos/plop
```

Usage
-----

[](#usage)

Plop generates its function files from Minecraft structure files. These files can be created using the structure block in Minecraft: [https://minecraft.wiki/w/Structure\_Block](https://minecraft.wiki/w/Structure_Block)

### CLI

[](#cli-1)

Plop includes a simple CLI to generate Minecraft function files using a handful of preset animation types.

```
php plop.php  [--function|-f ] [--output|-o ] [--animation|-a ] [--placement|-p ]
```

The only required argument is the path to your `` structure file.

#### Options

[](#options)

Other available options are:

OptionShortDescription`--function``-f`The name of the Minecraft function to generate, e.g. plop:example`--output``-o`The output file to save the generated function to, prints output to terminal if not set.`--animation``-a`The animation preset to use, e.g. 'plop'. Defaults to no animation.`--placement``-p`The placement strategy preset to use, e.g. 'xzy'. Defaults to placing everything at once or 'full'.`--blocks``-b`List of blocks to filter for, start your list with ~ to use all blocks except the listed blocks.#### Animations

[](#animations)

An animation defines how individual blocks appear usually using block entities. You can find all available animations and parameters here: [wiki/Animations](https://github.com/aternosorg/plop/wiki/Animations)

#### Placement strategies

[](#placement-strategies)

A placement strategy defines in which order and at which speed blocks of the structure are added to the world. You can find all available placement strategies and parameters here: [wiki/Placement Strategies](https://github.com/aternosorg/plop/wiki/Placement-Strategies)

### Library

[](#library-1)

Using Plop as a library allows much greater control over the generation process. It is also possible to extend Plop to support custom animation types and placement strategies.

```
$input = \Aternos\Plop\Input\StructureFile\StructureFile::loadFile("something.nbt");
$strategy = new \Aternos\Plop\Placement\SameMaterialPlacementStrategy(perTick: 3);
$animation = new \Aternos\Plop\Animation\FloatAnimation(animationDuration: 25, x: -10, y: 6, z: -10);

$plop = new \Aternos\Plop\Plop(
    input: \Aternos\Plop\Input\StructureFile\StructureFile::loadFile("something.nbt"),
    functionName: "plop:example",
    placementStrategy: $strategy,
    defaultAnimation: $animation
);
$plop->generate();

echo $plop->getOutput()->getAsString();
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance34

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 60.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

647d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/182e603c02f308d1036a1ecaba0b994665e87d13a86ff4550a96c9189a92c544?d=identicon)[aternos](/maintainers/aternos)

---

Top Contributors

[![matthi4s](https://avatars.githubusercontent.com/u/8943286?v=4)](https://github.com/matthi4s "matthi4s (43 commits)")[![KurtThiemann](https://avatars.githubusercontent.com/u/26512466?v=4)](https://github.com/KurtThiemann "KurtThiemann (28 commits)")

### Embed Badge

![Health badge](/badges/aternos-plop/health.svg)

```
[![Health](https://phpackages.com/badges/aternos-plop/health.svg)](https://phpackages.com/packages/aternos-plop)
```

###  Alternatives

[aternos/thanos

Simple library to detect and remove unused chunks from a Minecraft world.

263586.9k](/packages/aternos-thanos)[dirkpersky/typo3-dp_cookieconsent

Enable a cookie consent box. Let you visitors control the usage of cookies and load script or content after a consent. (ePrivacy, TTDSG)

36201.3k1](/packages/dirkpersky-typo3-dp-cookieconsent)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)