raffle
The on/off switch, the timer, the first-join rule, minimum entries and who hears the winner.
general:
enabled: true
debug: false
raffle:
duration-seconds: 60
start-delay-seconds: 2
first-join-only: true
min-entries: 1
max-open-raffles: 5
announce-winner-to: entrantsReference
| Key | Type | Default | Notes |
|---|---|---|---|
general.enabled | boolean | true | Master switch. While false, joining starts no raffle. Open raffles still finish. |
general.debug | boolean | false | Logs every step to console: raffles opening, entries, and why a player was turned away. |
raffle.duration-seconds | int | 60 | How long players have to welcome the newcomer. At least 5. |
raffle.start-delay-seconds | int | 2 | Wait after the join before announcing, so the announcement lands after the join message. |
raffle.first-join-only | boolean | true | false starts a raffle on every join. Only useful for testing. |
raffle.min-entries | int | 1 | Entrants that must still be online at the draw. With fewer, nobody is drawn. |
raffle.max-open-raffles | int | 5 | Most raffles open at once. A newcomer who joins while the limit is reached gets none. |
raffle.announce-winner-to | string | entrants | entrants, entrants-and-newcomer or everyone. |
Who hears the winner
| Value | Told who won |
|---|---|
entrants | Only the players who entered |
entrants-and-newcomer | The entrants plus the newcomer, if still online |
everyone | Every online player |
The winner never gets the announcement. They get their prize message instead.
First join on a network
"First join" means the first time on this server. On a network, a player who has already played on another backend still counts as new the first time they reach this one. Put the plugin only on the server players land on first if that is not what you want.
Players with tdxwelcomeraffle.exempt never start a raffle when they
join. Handy for staff alt accounts.
The draw
Only entrants who are still online can win. If fewer than
min-entries are online, the raffle ends without a winner and those
who are online get not-enough-entries from messages.yml.
Every draw is logged to console, with the winner, the prize and the number of entries.