Installation

Requirements

• Java 21
• Paper or Leaf 1.21.11 (build 132 / 168 are the pinned smoke-test baselines)
• Outbound HTTPS to license.daisy.cat on port 443, at every startup. DaisyFilter is a licensed plugin and validates on each start; there is no offline or cached mode, so an air-gapped server cannot run it. See licensing.md.
• 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 console reports License validated. and the startup banner reports Status: Ready.

BuiltByBit downloads have the licence key applied automatically — there is nothing to configure. If you were issued a key privately, paste it into plugins/DaisyFilter/license.yml, which is generated on the first start even if that start was refused. licensing.md lists the LK-nn codes.

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.