🖼️Pack Generator

The pack section in FortuneWheel2/config.yml defines how the plugin generates and manages its resource pack. Below you can find a detailed explanation of every option.

---

Syntax:

pack:
  override-material: FEATHER
  start-of-model-data: 18000
  pack-folder: "generated-pack"
  zip-file-name: "fortunewheel2-pack"
  description: "FortuneWheel2 Pack"
  clone-on-build:
    use: false
    path: ""

---

override-material

Default: FEATHER

This sets the base material that FortuneWheel 2 uses for custom models.

• Minecraft assigns textures to items based on their material + CustomModelData.

• By overriding a material (e.g. FEATHER), the plugin can register custom textures without interfering with other items.

• It is recommended to use a rarely used item such as FEATHER, STICK, or PAPER to avoid conflicts with gameplay items.

---

start-of-model-data

Default: 18000

Defines the starting value for CustomModelData IDs generated by FortuneWheel 2.

• Every custom texture generated by the plugin increments this value by 1.

• Setting a high number (like 18000) ensures no collisions with other plugins or packs that might also assign CustomModelData values.

• If you already use CustomModelData in your own pack, adjust this number so that FortuneWheel 2 does not overlap with your IDs.

---

pack-folder

Default: "generated-pack"

The name of the folder where the plugin will generate the resource pack.

• This folder is created automatically inside the plugin’s directory.

• It contains all generated models, textures, and the pack.mcmeta file.

• You can change this if you want the generated pack stored under a different name.

---

zip-file-name

Default: "fortunewheel2-pack"

Specifies the name of the ZIP archive that is generated when building the resource pack.

• This is the file that can be distributed to players via the server’s resource pack system.

• The .zip extension is automatically added, e.g. fortunewheel2-pack.zip.

• Change this if you want to use a custom filename for your resource pack.

---

description

Default: "FortuneWheel2 Pack"

Sets the description text shown in the Minecraft resource pack menu.

• This text helps players identify the pack when multiple resource packs are enabled.

• Cosmetic only — it has no effect on functionality.

---

clone-on-build

Use this feature to clone builded FortuneWheel resourcepack zip to your own pack provider or any path you want Paths for supported providers:

• Nexo: Nexo/pack/external_packs

clone-on-build:
  use: false
  path: ""

---

How to use pack items in the plugin

To use custom textures in FortuneWheel 2:

1. Upload your .png file into:

   • wheels/<name>.png (wheel items)

   • tickets/<name>.png (tickets)

2. Reference the texture in configs with:

   1. wheels/diamond → from wheels/diamond.png

   2. tickets/vip_ticket → from tickets/vip_ticket.png

📌 Do not include .png in the reference.