Sueta

WelcomeRaffle

3.0.0

Welcome Raffles by welcoming people enter a raffle to win items! Fully Configable!

·Plugin
Tested MC versions
1.20, 1.21, 26.1, 26.2, 26.3

Key art for Welcome Raffles: three Minecraft players celebrate on a path in a cherry-blossom village at sunset as confetti falls, under the pink and gold 3D pixel logo "Welcome Raffles".

Welcome Raffles rewards players for welcoming newcomers to your server. When someone joins for the first time, a raffle opens. Everyone who welcomes them gets one entry, and when the timer runs out, winners are drawn and rewarded.

How it works

Animated Minecraft chat: MapleFox joins, a green "Click here to welcome MapleFox!" message appears, eight players type "welcome MapleFox!", and "Sakura has won the raffle!" is announced.

  1. Someone joins for the first time. A raffle opens automatically.
  2. Players welcome them. Say the welcome keyword, click the suggested message, or use /welcome <player>.
  3. Winners are drawn. After the delay, one or more online entrants win a reward.

Features

A panel listing ten features, each beside a Minecraft item icon in an inventory slot.

  • Automatic raffles: a raffle starts whenever a first-time player joins.
  • Clickable welcome messages: suggests a welcome message players can send in one click.
  • One entry per player: each player can enter once per raffle.
  • Multiple winners: configure the draw delay and how many different players win.
  • Weighted rewards: give common and rare rewards different chances, or switch one off with a weight of 0.
  • Items, commands and bundles: award custom items, run console commands, or deliver several rewards together.
  • In-game reward editor: /raffle rewards edits item rewards in-game, keeping item metadata, command rewards, bundles and weights.
  • Leaderboards and history: track wins and show recent winners, saved to YAML.
  • Customization: messages, colors, welcome keywords, sounds, GUI labels and private winner announcements.
  • Permissions: separate permissions for administration, participation, the leaderboard and history.
  • Reload support: apply config changes with /raffle reload.

Rewards

The in-game Rewards Editor chest menu with a diamond being added, next to an example weighted reward pool with chance bars.

Leaderboards and history

A raffle leaderboard in Minecraft chat style next to an in-game screenshot of the Recent Raffle Winners history.

Commands

CommandWhat it does
/welcome <player>Welcome someone and enter the raffle
/raffle start · stop · statusControl the current raffle
/raffle leaderboard [limit]Show the top winners
/raffle history [limit]Show recent wins
/raffle rewardsOpen the in-game reward editor
/raffle reloadReload the config

Permissions

PermissionWhat it allows
TODO.adminStart, stop, reload and edit rewards
TODO.participateEnter raffles by welcoming new players
TODO.leaderboardView the leaderboard
TODO.historyView raffle history

Good to know

  • Requires Paper 1.21.11 – 26.3.
  • One raffle runs at a time.
  • Winners have to be online when the raffle is drawn.
  • If a winner's inventory is full, reward items drop at their feet.
  • On first startup, Paper downloads and caches the Kotlin runtime from Maven Central. This only happens once.

Support

Found a bug or have an idea? Join our Discord.

The Welcome Raffles logo with the Discord invite discord.gg/dCEjnEMqy and sakurastudios.co, made by Sakura Studios.

Similar projects

Plugin →