Informations

Donnez des missions à vos joueurs, et monétisez votre serveur !

Présentation

FoxPass est un plugin de Battle Pass pour Minecraft qui permet de créer un ou plusieurs passes (saisons), de générer des quêtes journalières et hebdomadaires, de faire progresser les joueurs via un système d'XP et de niveaux, puis de distribuer des récompenses Free et Premium via une interface en jeu.

Le plugin est pensé pour être simple à configurer, entièrement personnalisable (MiniMessage, GUI, quêtes, rewards), et compatible avec les serveurs modernes.

Fonctionnalités

• Compatible 1.20.x à 1.21+ (Paper et Folia selon votre environnement)

• Configuration rapide

  • Pass : plugins/FoxPass/passes/ (1 pass = 1 fichier .yml)

  • Quêtes : plugins/FoxPass/quests/ (pools daily/weekly)

  • Messages : messages.yml

  • GUIs : plugins/FoxPass/guis/

• Multi-pass : créez autant de passes que vous voulez, avec permission optionnelle (ex : VIP)

• Quêtes journalières et hebdomadaires

  • Nombre configurable par pass

  • Sélection aléatoire via weight

  • Pools spécifiques par pass (vip_daily.yml, vip_weekly.yml, etc.)

• Progression XP → niveaux

  • Tiers avec xp-required

  • XP gagnée via quêtes

  • Progression affichable via placeholders

• Récompenses Free + Premium

  • free-rewards et premium-rewards par tier

  • Claim via GUI, exécution automatique de commandes

• Saisons et resets

  • Reset daily/weekly + timezone

  • Saisons via date de début/fin ou durée (jours)

• 42 objectifs avec filtres (blocs, entités, monde, biome, mode de déplacement...) + intégrations optionnelles (MythicMobs, CustomFishing, CustomCrops)

• CustomModelData pour les items d'affichage (icônes resource pack)

• MiniMessage / Hex (gradients, couleurs hex, balises)

Commandes joueurs

Commande	Description	Permission
/pass	Commande principale FoxPass	Aucune
/pass open [passId]	Ouvre le pass (par défaut si passId est omis)	Aucune (ou permission du pass si définie)
/pass quests [passId]	Ouvre le menu des quêtes du pass	Aucune (ou permission du pass si définie)
/pass list	Liste les passes disponibles	Aucune

Commandes admin

Commande	Description	Permission
/foxpass	Commande principale admin	foxpass.admin
/fp reload	Recharge toute la configuration	foxpass.admin.reload
/fp xp set <player> <passId> <amount>	Définit l'XP d'un joueur sur un pass	foxpass.admin.xp
/fp xp add <player> <passId> <amount>	Ajoute de l'XP à un joueur sur un pass	foxpass.admin.xp
/fp xp remove <player> <passId> <amount>	Retire de l'XP à un joueur sur un pass	foxpass.admin.xp
/fp level set <player> <passId> <level>	Définit le niveau d'un joueur sur un pass	foxpass.admin.level
/fp level add <player> <passId> <amount>	Ajoute des niveaux à un joueur sur un pass	foxpass.admin.level
/fp level remove <player> <passId> <amount>	Retire des niveaux à un joueur sur un pass	foxpass.admin.level
/fp premium grant <player> <passId>	Active le premium pour un joueur sur un pass	foxpass.admin.premium
/fp premium revoke <player> <passId>	Désactive le premium pour un joueur sur un pass	foxpass.admin.premium
/fp quests refresh <passId> <daily|weekly>	Régénère / rafraîchit les quêtes d'un pass	foxpass.admin.quests
/fp season reset <passId>	Réinitialise la saison d'un pass	foxpass.admin.season
/fp open <player> <main|rewards|daily|weekly> <passId>	Ouvre une interface FoxPass pour un joueur	foxpass.admin.open
/fp data delete <player>	Supprime les données FoxPass d'un joueur	foxpass.admin.data

Placeholders

Progression

• %foxpass_level_<passId>% : niveau actuel

• %foxpass_xp_<passId>% : XP actuelle

• %foxpass_xp_needed_<passId>% : XP restante pour le prochain niveau/tier

• %foxpass_maxlevel_<passId>% : niveau max (tiers configurés)

• %foxpass_percent_<passId>% : progression en pourcentage

• %foxpass_progress_<passId>% : progress bar texte

• %foxpass_status_<passId>% : statut (ex: actif, terminé selon implémentation)

Premium

• %foxpass_premium_<passId>% : vrai/faux (ou texte) selon le statut premium

Saison et timers

• %foxpass_season_<passId>% : numéro de saison

• %foxpass_start_<passId>% : timestamp début

• %foxpass_start_<passId>_date% : date lisible

• %foxpass_end_<passId>% : timestamp fin

• %foxpass_end_<passId>_date% : date lisible

• %foxpass_countdown_daily_<passId>% : temps avant le reset daily

• %foxpass_countdown_weekly_<passId>% : temps avant le reset weekly

• %foxpass_countdown_season_<passId>% : temps avant la fin de saison

Remplacez <passId> par l'id du pass, généralement le nom du fichier sans .yml (ex: default, vip).

Objectifs et filtres

Structure standard

objective:
  type: block_break
  amount: 64
  filters:
    material:
      - STONE

• type : l'objectif à suivre (obligatoire)

• amount : quantité requise (obligatoire)

• filters : filtres optionnels (selon l'objectif)

---

Filtres disponibles (exemples)

• Blocs : material, material_category, world, biome

• Entités : entity, category

• Déplacement (travel) : mode

• Chat : message

• Commande (execute-command) : command

• Intégrations :

  • MythicMobs : mob_type

  • CustomFishing : fish_id

  • CustomCrops : crop_id

Important : respectez les IDs attendus par FoxPass. Certains sont en kebab-case (ex : execute-command, kill-player, bucket-place, throw-projectile).

---

Liste complète des objectifs disponibles

Blocs

• block_break : casser des blocs

• block_place : poser des blocs

Entités / élevage

• kill-mob : tuer des mobs (hors joueurs)

• kill-player : tuer des joueurs (PvP)

• tame : apprivoiser des animaux

• breed : reproduire des animaux

• shear : tondre des moutons

• milk : traire des vaches

Craft / traitement

• craft : crafter des objets

• smelt : récupérer des objets cuits/fondus

• brew : préparer des potions

• enchant : enchanter (table)

• enchant-anvil : enchanter (enclume)

• enchant-all : enchanter (table ou enclume)

• item-break : casser/épuiser un item (durabilité)

Récolte / collecte

• fish : pêcher (vanilla)

• bucket-place : poser le contenu d'un seau (eau/lave)

• consume : consommer (nourriture/potion)

• exp-gain : gagner de l'XP (orbes)

Combat / dégâts

• damage : infliger des dégâts

• throw-projectile : lancer un projectile

Activité joueur

• login : se connecter

• play-time : temps de jeu

Interactions

• chat : envoyer des messages

• right-click : clic droit (général)

• left-click : clic gauche (général)

• right-click-block : clic droit sur un bloc

• left-click-block : clic gauche sur un bloc

• execute-command : exécuter une commande

Déplacement

• travel : distance parcourue

• fly : voler

• glide : planer (elytra)

• sneak : s'accroupir

• sprint : sprinter

• swim : nager

• ride-mob : monter une entité

Santé / régénération

• regenerate : régénérer des PV

Nature

• honey-extract : récupérer du miel (bouteille)

• honeycomb-extract : récupérer du rayon (cisailles)

Intégrations

• kill-mythicmob : tuer un mob MythicMobs

• custom-fishing : pêcher un poisson CustomFishing

• custom-crops : récolter une culture CustomCrops

Configurations

passes/default.yml

# Default Battle Pass Configuration
# This is an example battle pass with 10 tiers

display-name: "<gradient:#FF6B6B:#4ECDC4>Season Pass</gradient>"
description: "Complete quests and level up to earn rewards!"
enabled: true

# Optional permission required to access this pass
# permission: foxpass.pass.default

# Schedule configuration
schedule:
  daily-reset-time: "00:00"
  weekly-reset-day: "MONDAY"
  weekly-reset-time: "00:00"
  timezone: "UTC"
  # Uncomment to set a specific start date (ISO 8601 format):
  # season-start-date: "2026-01-01T00:00:00Z"
  # Uncomment to set season duration:
  # season-duration-days: 30
  # Or set a specific end date (ISO 8601 format):
  # season-end-date: "2025-12-31T23:59:59Z"

# Quest configuration
daily-quest-count: 3
weekly-quest-count: 3

# Tier configuration
# Each tier has a level, XP requirement, and rewards
tiers:
  1:
    xp-required: 100
    free-rewards:
      starter_coins:
        display-name: "<gold>100 Coins"
        description:
          - "<gray>Some starter coins"
          - "<gray>to get you going!"
        type: COMMAND
        commands:
          - "eco give {player} 100"
        display-material: GOLD_INGOT

  2:
    xp-required: 200
    free-rewards:
      basic_kit:
        display-name: "<green>Basic Kit"
        description:
          - "<gray>A basic starter kit"
        type: COMMAND
        commands:
          - "kit basic {player}"
        display-material: CHEST
    premium-rewards:
      premium_kit:
        display-name: "<light_purple>Premium Kit"
        description:
          - "<gray>An exclusive premium kit!"
        type: COMMAND
        commands:
          - "kit premium {player}"
        display-material: ENDER_CHEST

  3:
    xp-required: 350
    free-rewards:
      coins_250:
        display-name: "<gold>250 Coins"
        description:
          - "<gray>More coins for your journey"
        type: COMMAND
        commands:
          - "eco give {player} 250"
        display-material: GOLD_INGOT
        display-amount: 2

  4:
    xp-required: 500
    free-rewards:
      iron_set:
        display-name: "<white>Iron Tools"
        description:
          - "<gray>A set of iron tools"
        type: COMMAND
        commands:
          - "give {player} iron_pickaxe 1"
          - "give {player} iron_axe 1"
          - "give {player} iron_shovel 1"
        display-material: IRON_PICKAXE
    premium-rewards:
      fly_access:
        display-name: "<aqua>Fly Access (1 hour)"
        description:
          - "<gray>Temporary flight ability"
        type: COMMAND
        commands:
          - "lp user {player} permission settemp essentials.fly true 1h"
        display-material: ELYTRA

  5:
    xp-required: 700
    free-rewards:
      diamond_reward:
        display-name: "<aqua>Diamond Reward"
        description:
          - "<gray>A valuable diamond!"
        type: COMMAND
        commands:
          - "give {player} diamond 1"
        display-material: DIAMOND
    premium-rewards:
      diamond_block:
        display-name: "<aqua>Diamond Block"
        description:
          - "<gray>A whole block of diamonds!"
        type: COMMAND
        commands:
          - "give {player} diamond_block 1"
        display-material: DIAMOND_BLOCK

  6:
    xp-required: 1000
    free-rewards:
      coins_500:
        display-name: "<gold>500 Coins"
        description:
          - "<gray>Half a grand!"
        type: COMMAND
        commands:
          - "eco give {player} 500"
        display-material: GOLD_BLOCK

  7:
    xp-required: 1400
    free-rewards:
      enchant_book:
        display-name: "<light_purple>Enchantment Book"
        description:
          - "<gray>A random enchantment book"
        type: COMMAND
        commands:
          - "give {player} enchanted_book 1"
        display-material: ENCHANTED_BOOK
    premium-rewards:
      fortune_book:
        display-name: "<gold>Fortune III Book"
        description:
          - "<gray>Fortune III enchantment!"
        type: COMMAND
        commands:
          - "give {player} enchanted_book{StoredEnchantments:[{id:\"minecraft:fortune\",lvl:3}]} 1"
        display-material: ENCHANTED_BOOK

  8:
    xp-required: 1900
    free-rewards:
      golden_apple:
        display-name: "<gold>Golden Apples"
        description:
          - "<gray>5 Golden Apples"
        type: COMMAND
        commands:
          - "give {player} golden_apple 5"
        display-material: GOLDEN_APPLE
        display-amount: 5

  9:
    xp-required: 2500
    free-rewards:
      coins_1000:
        display-name: "<gold>1000 Coins"
        description:
          - "<gray>A thousand coins!"
        type: COMMAND
        commands:
          - "eco give {player} 1000"
        display-material: GOLD_BLOCK
        display-amount: 2
    premium-rewards:
      diamond_armor:
        display-name: "<aqua>Diamond Armor Set"
        description:
          - "<gray>Full diamond armor!"
        type: COMMAND
        commands:
          - "give {player} diamond_helmet 1"
          - "give {player} diamond_chestplate 1"
          - "give {player} diamond_leggings 1"
          - "give {player} diamond_boots 1"
        display-material: DIAMOND_CHESTPLATE

  10:
    xp-required: 3500
    free-rewards:
      final_reward:
        display-name: "<rainbow>Season Complete!</rainbow>"
        description:
          - "<gray>Congratulations on completing"
          - "<gray>the season pass!"
          - ""
          - "<gold>Rewards:"
          - "<yellow>- 5000 Coins"
          - "<yellow>- Special Title"
        type: COMMAND
        commands:
          - "eco give {player} 5000"
          - "lp user {player} meta addprefix 100 \"&6[Champion]&r \""
        display-material: NETHER_STAR
    premium-rewards:
      premium_final:
        display-name: "<gradient:#FFD700:#FF6347>Premium Champion</gradient>"
        description:
          - "<gray>The ultimate reward!"
          - ""
          - "<gold>Rewards:"
          - "<yellow>- 10000 Coins"
          - "<yellow>- Exclusive Title"
          - "<yellow>- Permanent Fly"
        type: COMMAND
        commands:
          - "eco give {player} 10000"
          - "lp user {player} meta addprefix 200 \"&d[Premium Champion]&r \""
          - "lp user {player} permission set essentials.fly true"
        display-material: BEACON

quests/daily.yml

# Daily Quest Pool
# These quests reset every day at the configured time

quests:
  mine_stone:
    display-name: "<yellow>Stone Breaker"
    description:
      - "<gray>Mine stone blocks"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: block_break
      amount: 64
      filters:
        material:
          - STONE
          - COBBLESTONE
          - DEEPSLATE
          - COBBLED_DEEPSLATE
    xp-reward: 100
    weight: 3
    display-material: STONE_PICKAXE

  mine_ores:
    display-name: "<yellow>Ore Miner"
    description:
      - "<gray>Mine any ore blocks"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: block_break
      amount: 20
      filters:
        material_category: ORE
    xp-reward: 150
    weight: 2
    display-material: IRON_ORE

  kill_mobs:
    display-name: "<red>Monster Hunter"
    description:
      - "<gray>Kill hostile mobs"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: mob_kill
      amount: 20
      filters:
        category: MONSTER
    xp-reward: 150
    weight: 2
    display-material: IRON_SWORD

  kill_zombies:
    display-name: "<red>Zombie Slayer"
    description:
      - "<gray>Kill zombies"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: mob_kill
      amount: 15
      filters:
        entity:
          - ZOMBIE
          - DROWNED
          - HUSK
          - ZOMBIE_VILLAGER
    xp-reward: 125
    weight: 2
    display-material: ROTTEN_FLESH

  craft_items:
    display-name: "<green>Crafting Spree"
    description:
      - "<gray>Craft any items"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: craft
      amount: 50
    xp-reward: 75
    weight: 3
    display-material: CRAFTING_TABLE

  fish_catch:
    display-name: "<aqua>Gone Fishing"
    description:
      - "<gray>Catch fish"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: fish
      amount: 10
    xp-reward: 125
    weight: 2
    display-material: FISHING_ROD

  travel_distance:
    display-name: "<gold>Wanderer"
    description:
      - "<gray>Travel by walking or running"
      - "<gray>Progress: <white>{progress}/{required} blocks"
    objective:
      type: travel
      amount: 1000
      filters:
        mode:
          - WALK
          - SPRINT
    xp-reward: 100
    weight: 2
    display-material: LEATHER_BOOTS

  break_crops:
    display-name: "<green>Harvest Time"
    description:
      - "<gray>Harvest crops"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: block_break
      amount: 32
      filters:
        material:
          - WHEAT
          - CARROTS
          - POTATOES
          - BEETROOTS
    xp-reward: 100
    weight: 2
    display-material: WHEAT

  place_blocks:
    display-name: "<blue>Builder"
    description:
      - "<gray>Place blocks"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: block_place
      amount: 100
    xp-reward: 75
    weight: 3
    display-material: BRICKS

  play_time:
    display-name: "<light_purple>Time Well Spent"
    description:
      - "<gray>Play on the server"
      - "<gray>Progress: <white>{progress}/{required} minutes"
    objective:
      type: play_time
      amount: 30
    xp-reward: 50
    weight: 4
    display-material: CLOCK

  eat_food:
    display-name: "<yellow>Foodie"
    description:
      - "<gray>Eat food items"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: consume
      amount: 20
    xp-reward: 50
    weight: 3
    display-material: COOKED_BEEF

  smelt_items:
    display-name: "<red>Smelter"
    description:
      - "<gray>Smelt items in a furnace"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: smelt
      amount: 30
    xp-reward: 75
    weight: 2
    display-material: FURNACE

  damage_dealt:
    display-name: "<red>Damage Dealer"
    description:
      - "<gray>Deal damage to entities"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: damage
      amount: 200
    xp-reward: 100
    weight: 2
    display-material: DIAMOND_SWORD

quests/weekly.yml

# Weekly Quest Pool
# These quests reset every week at the configured day and time

quests:
  mine_diamonds:
    display-name: "<aqua>Diamond Hunter"
    description:
      - "<gray>Mine diamond ore"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: block_break
      amount: 15
      filters:
        material:
          - DIAMOND_ORE
          - DEEPSLATE_DIAMOND_ORE
    xp-reward: 500
    weight: 2
    display-material: DIAMOND

  mine_ancient_debris:
    display-name: "<dark_red>Netherite Seeker"
    description:
      - "<gray>Mine ancient debris"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: block_break
      amount: 5
      filters:
        material: ANCIENT_DEBRIS
    xp-reward: 750
    weight: 1
    display-material: ANCIENT_DEBRIS

  kill_bosses:
    display-name: "<dark_red>Boss Slayer"
    description:
      - "<gray>Defeat boss mobs"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: mob_kill
      amount: 3
      filters:
        entity:
          - WITHER
          - ENDER_DRAGON
          - ELDER_GUARDIAN
          - WARDEN
    xp-reward: 1000
    weight: 1
    display-material: WITHER_SKELETON_SKULL

  kill_100_mobs:
    display-name: "<red>Monster Exterminator"
    description:
      - "<gray>Kill 100 hostile mobs"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: mob_kill
      amount: 100
      filters:
        category: MONSTER
    xp-reward: 400
    weight: 2
    display-material: NETHERITE_SWORD

  level_up:
    display-name: "<green>Experience Gatherer"
    description:
      - "<gray>Gain experience points"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: exp_gain
      amount: 500
    xp-reward: 400
    weight: 2
    display-material: EXPERIENCE_BOTTLE

  enchant_items:
    display-name: "<light_purple>Enchanter"
    description:
      - "<gray>Enchant items"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: enchant
      amount: 10
    xp-reward: 350
    weight: 2
    display-material: ENCHANTING_TABLE

  brew_potions:
    display-name: "<dark_purple>Alchemist"
    description:
      - "<gray>Brew potions"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: brew
      amount: 15
    xp-reward: 300
    weight: 2
    display-material: BREWING_STAND

  tame_animals:
    display-name: "<yellow>Animal Whisperer"
    description:
      - "<gray>Tame animals"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: tame
      amount: 5
    xp-reward: 250
    weight: 2
    display-material: LEAD

  breed_animals:
    display-name: "<light_purple>Animal Breeder"
    description:
      - "<gray>Breed animals"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: breed
      amount: 20
    xp-reward: 300
    weight: 2
    display-material: HAY_BLOCK

  travel_10k:
    display-name: "<gold>Explorer"
    description:
      - "<gray>Travel 10,000 blocks"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: travel
      amount: 10000
    xp-reward: 350
    weight: 2
    display-material: COMPASS

  fish_50:
    display-name: "<aqua>Master Angler"
    description:
      - "<gray>Catch 50 fish"
      - "<gray>Progress: <white>{progress}/{required}"
    objective:
      type: fish
      amount: 50
    xp-reward: 450
    weight: 2
    display-material: TROPICAL_FISH

  play_5_hours:
    display-name: "<light_purple>Dedicated Player"
    description:
      - "<gray>Play for 5 hours this week"
      - "<gray>Progress: <white>{progress}/{required} minutes"
    objective:
      type: play_time
      amount: 300
    xp-reward: 300
    weight: 3
    display-material: CLOCK