Your first install

Confirm prerequisites

Run /version on your server. You need Paper 1.20.x or newer running on Java 21+. If either of those is missing, fix that first — see prerequisites for the full list.

Drop the jar in plugins/

Stop the server, copy the jar into your plugins/ folder, then start the server back up. On first boot you'll see something like:

[INFO] [TDXVotePlus] Loading TDXVotePlus v1.2.8
[INFO] [TDXVotePlus] config.yml created — review it before going live
[INFO] [TDXVotePlus] Storage backend: SQLite (plugins/TDXVotePlus/data.db)
[INFO] [TDXVotePlus] Enabled — listening for votes

If you see that, the plugin is alive. Stop the server again — we're going to edit the config before any real votes come in.

Find your config files

The plugin creates a folder under plugins/ on first boot. For VotePlus it looks like this:

• config.yml — every behavioural setting
• messages.yml — every player-facing string (MiniMessage-aware)
• data.db — SQLite database, leave it alone
• logs/ — per-day plugin logs, separate from latest.log

Set the essentials in config.yml

You can ship the defaults to production unchanged, but at minimum you'll want to:

• Add at least one vote site under vote-sites: so players know where to vote
• Decide whether vote-rewards: should give items, money, exp, or commands
• (Optional) Switch the storage backend to MySQL if you're on a network — see the storage configuration page for the schema

Every key in config.yml has an inline comment explaining what it does, so read top to bottom once before changing anything.

Reload, then test

Start the server, then run:

/voteplus reload
/voteplus test <yourname>

The test subcommand simulates an incoming vote so you can verify rewards fire correctly without needing to wait for a real vote to bounce through your voting site.

If your test reward shows up in chat / inventory, you're done — you have a working TDX VotePlus install. Wire it to your real Votifier setup and ship it.