⚙️ Configuration

The config.yml is the central brain of Tyche. This is where you connect your database, set up your Discord webhooks, and customize every visual aspect of the plugin.

📄 Full config.yml

Use the Copy button in the top right of the code block below to get the latest default configuration.

YAML

# -----------------------------------------------------------------------------
# Tyche Configuration | Developed by skiron.dev
# -----------------------------------------------------------------------------

license: "PASTE-YOUR-KEY-HERE"

database:
  uri: "mongodb+srv://admin:[email protected]/?appName=Cluster0"
  database_name: "tyche_db"

allowed-items:
  - "DIAMOND"
  - "GOLD_INGOT"
  - "EMERALD"
  - "NETHERITE_INGOT"
  - "ENCHANTED_GOLDEN_APPLE"

messages:
  prefix: "&8[&dTyche&8] "
  # ... (All other messages as provided in your file)

sounds:
  flip_created: "BLOCK_NOTE_BLOCK_PLING"
  flip_win: "ENTITY_PLAYER_LEVELUP"
  flip_loss: "ENTITY_VILLAGER_NO"
  click_ui: "UI_BUTTON_CLICK"
  withdraw: "ENTITY_ITEM_PICKUP"

gui:
  # ... (MainMenu, CollectionBin, Leaderboard, HistoryView settings)

discord:
  enabled: true
  webhook_url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE"
  min_bet_amount: 0
  username: "Tyche Casino"
  # ... (Embed settings)

---

🔍 Detailed Section Breakdown

1. Licensing & Protection

• license: Your unique key from skiron.dev. The plugin logic remains locked until a valid key is provided and verified by our home-hosted API.

2. Database Connection (MongoDB)

• uri: If you are using MongoDB Atlas, ensure you replace pass123 with your actual database user password.

• database_name: The name of the database where player stats and collection bins will be stored.

3. Item Filtering (Whitelist)

• allowed-items: Only items in this list can be used for flips. This prevents players from wagering "trash" items like Dirt or Cobblestone.

• Management: You can also manage this list in-game using /itemflip filter.

4. Interactive Messages & Placeholders

Tyche supports advanced chat interaction.

• flip_broadcast_create: This message automatically appends a [CLICK TO JOIN] button in global chat.

• Placeholders: You can use %player%, %amount%, %item%, %side%, %winner%, and %loser% in most strings.

5. GUI Customization

This is the most powerful section of the config. You can customize:

• Slots: Specifically for the Leaderboard and History View, you can define exactly which slots items appear in.

• Materials: We use XSeries, allowing you to use modern material names (e.g., NETHERITE_INGOT) even on 1.8.8 servers.

• Format: The rank_1 through rank_default settings allow you to give your top high-rollers special titles.

6. Discord Integration

Link your server's gambling activity directly to your Discord community.

• webhook_url: Create a webhook in your Discord channel settings and paste the URL here.

• min_bet_amount: Set this to a higher number if you only want to broadcast "High Roller" wins to Discord.

---

💡 Configuration Tips

• Color Codes: Use & followed by a hex or legacy code (e.g., &d for purple) to color your text.

• Reloading: After saving your changes, run /itemflip reload in-game to apply them instantly without a server restart.