Items

This file allows you to create custom, consumable items that grant players a specific amount of free flight time when used (right-clicked). You can create as many different types of items as you like.

Item Structure

Each item you create needs a unique ID (e.g., basic_ticket, premium_pass). This ID is what you will use in the /fly giveitem command.

unique_item_id:
  material: PAPER
  name: "&bFlight Ticket"
  lore:
    - "&7Right-click this item to receive"
    - "&a30 seconds &7of free flight time."
  custom-model-data: 1001
  seconds: 30
  base64-skull: "eyJ0ZXh0dXJlcyI6..."

Key Explanations

Key	Description
material	The Minecraft material for the item. A list of valid materials can be found on the Spigot Javadocs or Minecraft Wiki.
name	The name of the item as it appears in-game. Supports & and &#RRGGBB color codes.
lore	A list of text lines that appear as the item's description. Supports color codes.
custom-model-data	(Optional) An integer value used by resource packs to give the item a custom texture.
seconds	The number of free flight seconds the player receives when they use the item.
base64-skull	(Optional) If the material is PLAYER_HEAD, you can provide a Base64 texture string from sites like Minecraft-Heads to give the head a custom look.

Getting Items In-Game

To get a configured item in-game, use the following command:

/fly giveitem <player> <itemID> [amount]

• <itemID>: The unique ID you defined in this file (e.g., unique_item_id).

• <player>: The player who will receive the item.

• [amount]: (Optional) The number of items to give. Defaults to 1.