Lottery

Description

The Lottery Plugin allows players on your Minecraft server to participate in regular lottery draws where they can purchase tickets and compete for a jackpot. It enhances the gameplay experience by adding a fun and engaging way to win in-game currency through luck or strategic ticket purchases. The plugin supports both random and manually selected ticket numbers, with customizable prize levels, including partial prizes for players who come close to the winning number.

Key Features:

Random or Manual Ticket Purchases:

Players can either buy a ticket with a randomly generated number or select their own custom ticket number. The option to allow manual number selection can be configured based on the server admin's preferences.

Commands:

• /lt buyticket – Buys a ticket with a random number.
• /lt buyticket – Buys a ticket with a custom number (if allowed).

Configurable Jackpot:
The starting jackpot and the amount added to the prize pool after each draw (if no one wins) can be configured.
If there’s no winner, the jackpot grows, making each subsequent draw more exciting.

Automated Draws:

Lottery draws happen at regular intervals, which are fully configurable. Players can see reminders through the automated messaging system, keeping them informed about when the next draw will happen.

Partial Prize System:

Players can win partial prizes based on how many digits of their ticket match the winning number. Different levels of partial prize matching and the corresponding prize percentage are fully customizable.

For example:

Matching 4 digits could reward 20% of the jackpot.
Matching 3 digits could reward 10%.
Matching 2 digits could reward 5%.

Persistent Ticket Storage:

Player tickets are saved to a file (tickets.yml), ensuring that ticket information is not lost even if the server restarts. This allows for uninterrupted participation in ongoing lottery events.

Winner Logging:

When a player wins, the plugin logs the winner's details, including their name, the winning ticket number, and the amount won. This information is saved to a file (winners.log) for future reference or to maintain a history of lottery draws.

BossBar Countdown:

A BossBar countdown is shown to players as the next draw approaches, displaying how much time is left before the lottery draw. This adds a visual element of excitement and keeps players engaged.

Configurable Announcements:

Periodic messages can be broadcast to the server, reminding players to buy their lottery tickets before the next draw. The timing and content of these announcements can be fully customized.

Multiple Language Support (via Configurable Messages):

All plugin messages are customizable via the configuration file, making it easy to translate the plugin into different languages or adjust the wording to fit the style of your server.

Configuration Options:

Lottery Settings:

• lottery_digits: The number of digits in each ticket number.
• starting_amount: The initial jackpot for each draw.
• ticket_price: The cost of a lottery ticket.
• draw_interval: Time in minutes between each lottery draw.
• jackpot_sum_amount: The amount added to the jackpot if no one wins.

Custom Ticket Numbers:

allow_custom_numbers: Enables or disables the ability for players to choose their own ticket numbers.

Partial Prizes:

partial_prizes.enabled: Enables or disables partial prize winnings for matching part of the winning number.
partial_prizes.levels: Defines the levels of partial prize winnings based on matching digits and the percentage of the jackpot rewarded for each level.

Messaging System:

All in-game messages (ticket purchase confirmations, draw announcements, jackpot information, etc.) can be customized to fit your server’s tone and language.

Commands:

• /lt buyticket or /lt bt: Purchase a random lottery ticket.
• /lt buyticket or /lt bt : Purchase a ticket with a custom number.
• /lt tickets: View the player’s purchased tickets.
• /lt info: Show information about the current lottery, including the jackpot amount and the time remaining until the next draw.
• /lt reload: Reload the plugin configuration without restarting the server.

Permissions:

• lottery.use: Allows players to use the basic lottery commands.
• lottery.buyticket: Allows players to buy lottery tickets.
• lottery.tickets: Allows players to view their purchased tickets.
• lottery.reload: Allows administrators to reload the plugin configuration.

How it Works:

Buying Tickets: Players can buy tickets at any time between draws, using either randomly generated numbers or custom numbers if enabled. Each ticket has a unique number that players can use to participate in the lottery.

Automated Draws:
At the configured interval, the plugin will automatically draw a winning number. Players who have purchased tickets that match the winning number will win the jackpot. If no one wins, the jackpot rolls over to the next draw and increases by the configured amount.

Partial Prizes:
If partial prizes are enabled, players whose tickets match part of the winning number can still win a smaller portion of the jackpot, depending on how many digits they matched.

Persistent Records:
All ticket data and winner information are saved persistently, ensuring that players’ tickets are not lost even if the server restarts, and a record of all winners is kept for reference.

Why Use the Lottery Plugin?
The Lottery Plugin adds an engaging, chance-based gameplay mechanic to your Minecraft server, encouraging player participation and interaction. The excitement of accumulating jackpots, combined with the configurable prize structure, ensures that players stay engaged over the long term. The flexibility in configuration allows server admins to tailor the plugin to their server’s unique needs, whether they want large, infrequent jackpots or smaller, more regular draws.

This plugin is perfect for any server looking to add a fun and interactive way for players to earn in-game rewards through luck and strategy!