Installation

Requirements

• Java 21
• Paper or Leaf 1.21.11 (build 132 / 168 are the pinned smoke-test baselines)
• Optional: PlaceholderAPI for the daisyfilter placeholder expansion
• Optional: MariaDB/MySQL if you do not want the default embedded SQLite database

Install

1. Stop the server.
2. Drop DaisyFilter-<version>.jar into the plugins/ folder.
3. Start the server. DaisyFilter generates its configuration under plugins/DaisyFilter/ and creates a local SQLite database by default.
4. Confirm the startup banner reports Status: Ready.

First run

On first start DaisyFilter:

• writes the default configuration files (see configuration.md);
• installs the small reviewed Daisy core snapshot before communication listeners;
• copies attributed list references into plugins/DaisyFilter/lists/;
• validates and asynchronously imports the pinned GamerSafer CSV directly from the JAR;
• generates an encryption key under plugins/DaisyFilter/secrets/ (only used if you later enable raw content storage — see privacy.md).

Default behaviour filters, warns, logs, and alerts staff. Automatic punishments (temp-mute/kick) are disabled until you opt in via actions.md.

Verify

/daisyfilter status
/daisyfilter test <a harmless message>

status reports the snapshot version, rule counts, database health, queue depth, and scan timings. See troubleshooting.md if anything reports Degraded.