🎟️Tickets

The tickets section defines how players can access spins on the wheel. Tickets can be physical items, digital value in database, or time-based.

You are able to add unlimited amount of tickets to your wheel and system will allways check if player has any ticket from the configuration

---

Syntax

tickets:
  "<id>":
    type: <TYPE>
    ...type options (described below)
    
  ...other tickets

---

Ticket Id

Ticket id defines whole ticket section in the list of tickets. Make your own ticket ids that suits you, but do not use special characters and spaces. Examples od ids:

"example_physical_ticket"
"sunny_ticket_physical"
"daily_virtual"

---

Ticket Types

Ticket type defines how whole ticket of the wheel will work or look. Our premade ticket types are listed and described below, but other/your plugins and addons are able to connect their own ticket types to the system, then follow their documentation.

Currently available types:

• PHYSICAL = physical item in player inventory

• DIGITAL = virtual currency ticket in database

How to use types:

PHYSICAL

Player will recieve physical item to his inventory and using this item, he is able to spin the wheel.

Syntax:

tickets:
  "<your_id>":
    type: PHYSICAL
    pack-item: "<pack-item-path>" # optional
    item:
      material: PAPER
      name: "&e&lWheel Ticket"
      lore:
        - "&7Use this ticket to spin the wheel!"
      custom-model-data: 0
      ... other item data

pack-item

If you use our pack generator and want to connect uploaded asset (ticket) to the Physical ticket, then you can add this line and define it using this id:

<namespace>/<id>

Example:

• tickets/my-ticket

This value is optional and made only for pack generator use

item

If you use pack-item or not, you still wnt to use item, bcs item defines name, lore, enchants etc.

All info about item options can be found -> here <-

DIGITAL

Player will receive centrain amount of digital tickets that will be stored in database and after player interaction with the wheel, wheel will find these tickets automatically

Syntax:

tickets:
  "<your_id>":
    type: DIGITAL

Digital tickets doesn't have any options currently.

Some of them may be added soon

TIMED

Player will be able to spin the wheel for free in specific time windows. Something like a automatic daily reward system.

Syntax:

tickets:
  "<your_id>":
    type: TIMED
    reset_on_midnight: <true/false>
    reset_time: <time value>

Reset on midnight

if you have this value set on true, the reset time for the player will be rounded to closest midnight before calculated reset date

Example:

• claimed: 11. 10 at 19:30 - (1d reset time) - changed to: 12.10 at 00:00

• claimed: 11. 10 at 19:30 - (2d reset time) - changed to: 13.10 at 00:00

Reset time

Reset time defines when player will be able to claim TIMED spin again. Available time definitions: d = days, h = hours, m = minutes, s = seconds

Time value format: <number><time definition> <number><time definition> ...

Example:

• 1d

• 2d 5h 10s

Tickets can be given using this command

/fw ticket give <player> <wheel_id> <ticket_id> <amount>