GroupeZ Docs

Actions & Rewards

Configure job actions and rewards in zJobs

Cette page est affichée en anglais car sa traduction française n’est pas encore disponible.

This guide explains how to configure job actions and their rewards in zJobs.

Action Types

zJobs supports various action types that trigger rewards:

ActionDescription
breakBreaking blocks
placePlacing blocks
killKilling entities
fishFishing items
craftCrafting items
smeltSmelting items
breedBreeding animals
enchantEnchanting items
repairRepairing items
brewBrewing potions
shearShearing sheep
tameTaming animals
milkMilking cows

Basic Action Structure

actions:
  break:  # Action type
    STONE:  # Target (material, entity, etc.)
      money: 1.0        # Money reward
      xp: 5             # Minecraft XP
      job-xp: 2         # Job experience

Reward Types

Money

Currency reward (requires Vault economy):

DIAMOND_ORE:
  money: 50.0

Experience (XP)

Minecraft experience points:

DIAMOND_ORE:
  xp: 50

Job XP

Experience towards job level:

DIAMOND_ORE:
  job-xp: 15

Items

Item rewards:

DIAMOND_ORE:
  money: 50.0
  items:
    - material: DIAMOND
      amount: 1
      chance: 10  # 10% chance

Commands

Execute commands:

ENDER_DRAGON:
  money: 5000.0
  commands:
    - "broadcast &e%player% &7slayed the &5Ender Dragon&7!"
    - "give %player% diamond 64"

Action Examples

Break Action

Rewards for breaking blocks:

actions:
  break:
    # Ores
    COAL_ORE:
      money: 5.0
      xp: 5
      job-xp: 2
    DEEPSLATE_COAL_ORE:
      money: 6.0
      xp: 6
      job-xp: 3

    # Logs (using tags)
    "#minecraft:logs":
      money: 1.0
      job-xp: 1

    # Crops
    WHEAT:
      money: 2.0
      job-xp: 2
      conditions:
        - type: block_age
          value: 7

Place Action

Rewards for placing blocks:

actions:
  place:
    STONE:
      money: 0.5
      job-xp: 1
    COBBLESTONE:
      money: 0.5
      job-xp: 1
    OAK_PLANKS:
      money: 1.0
      job-xp: 2

Kill Action

Rewards for killing entities:

actions:
  kill:
    # Hostile mobs
    ZOMBIE:
      money: 5.0
      xp: 5
      job-xp: 2
    SKELETON:
      money: 7.0
      xp: 7
      job-xp: 3
    CREEPER:
      money: 10.0
      xp: 10
      job-xp: 5

    # Bosses
    WITHER:
      money: 3000.0
      xp: 3000
      job-xp: 300
      commands:
        - "broadcast &c%player% &7defeated the &5Wither&7!"

    # Players (if PvP rewards enabled)
    PLAYER:
      money: 100.0
      job-xp: 50

Fish Action

Rewards for fishing:

actions:
  fish:
    COD:
      money: 5.0
      job-xp: 3
    SALMON:
      money: 7.0
      job-xp: 4
    TROPICAL_FISH:
      money: 15.0
      job-xp: 8
    PUFFERFISH:
      money: 20.0
      job-xp: 10

    # Treasure
    NAME_TAG:
      money: 50.0
      job-xp: 25
    SADDLE:
      money: 40.0
      job-xp: 20
    ENCHANTED_BOOK:
      money: 100.0
      job-xp: 50

Craft Action

Rewards for crafting:

actions:
  craft:
    DIAMOND_SWORD:
      money: 25.0
      job-xp: 15
    DIAMOND_PICKAXE:
      money: 30.0
      job-xp: 18
    ENCHANTING_TABLE:
      money: 100.0
      job-xp: 50
    BEACON:
      money: 500.0
      job-xp: 200

Smelt Action

Rewards for smelting:

actions:
  smelt:
    IRON_INGOT:
      money: 3.0
      job-xp: 2
    GOLD_INGOT:
      money: 5.0
      job-xp: 3
    COOKED_BEEF:
      money: 2.0
      job-xp: 1
    GLASS:
      money: 1.0
      job-xp: 1

Breed Action

Rewards for breeding animals:

actions:
  breed:
    COW:
      money: 10.0
      job-xp: 5
    PIG:
      money: 10.0
      job-xp: 5
    SHEEP:
      money: 8.0
      job-xp: 4
    CHICKEN:
      money: 5.0
      job-xp: 3
    HORSE:
      money: 25.0
      job-xp: 12
    VILLAGER:
      money: 50.0
      job-xp: 25

Enchant Action

Rewards for enchanting:

actions:
  enchant:
    SHARPNESS:
      money: 20.0
      job-xp: 10
    EFFICIENCY:
      money: 15.0
      job-xp: 8
    FORTUNE:
      money: 30.0
      job-xp: 15
    MENDING:
      money: 50.0
      job-xp: 25

Conditions

Add conditions to actions for more control:

Block Age

Only reward mature crops:

WHEAT:
  money: 2.0
  conditions:
    - type: block_age
      value: 7

Permission

Require permission for bonus rewards:

DIAMOND_ORE:
  money: 50.0
  conditions:
    - type: permission
      value: "zjobs.bonus.mining"
      # Reward multiplied by 1.5 if player has permission
      multiplier: 1.5

World

Only in specific worlds:

ANCIENT_DEBRIS:
  money: 200.0
  conditions:
    - type: world
      value: "world_nether"

Tool

Require specific tool:

DIAMOND_ORE:
  money: 50.0
  conditions:
    - type: tool
      value: "DIAMOND_PICKAXE"

Time

Only during certain times:

PHANTOM:
  money: 20.0
  conditions:
    - type: time
      min: 13000  # Night time
      max: 23000

Block Tags

Use Minecraft block tags for multiple blocks:

actions:
  break:
    "#minecraft:logs":
      money: 1.0
      job-xp: 1
    "#minecraft:planks":
      money: 0.5
      job-xp: 1
    "#minecraft:wool":
      money: 1.0
      job-xp: 1
    "#minecraft:ores":
      money: 5.0
      job-xp: 3

Random Rewards

Add chance-based bonus rewards:

DIAMOND_ORE:
  money: 50.0
  job-xp: 15
  bonus:
    chance: 5  # 5% chance
    money: 100.0
    items:
      - material: DIAMOND
        amount: 1
    commands:
      - "msg %player% &aBonus diamond found!"

Multipliers

Level Multiplier

Increase rewards based on job level:

# In job configuration
income-multiplier: 0.02  # +2% per level

# At level 50: rewards are 100% higher (2x)

Tool Multipliers

Configure bonus for specific tools:

# In action configuration
DIAMOND_ORE:
  money: 50.0
  tool-multipliers:
    NETHERITE_PICKAXE: 1.5  # 50% more with netherite
    DIAMOND_PICKAXE: 1.2    # 20% more with diamond

Time Multipliers

Bonus during certain periods:

# Global config
time-multipliers:
  weekend:
    enabled: true
    multiplier: 1.5
    days:
      - SATURDAY
      - SUNDAY
  happy-hour:
    enabled: true
    multiplier: 2.0
    start-hour: 18
    end-hour: 20

Anti-Abuse

Block Tracking

Prevent placing and breaking the same blocks:

# In config.yml
anti-abuse:
  block-tracking: true
  track-duration: 3600  # 1 hour

Spawn Protection

No rewards near mob spawners:

anti-abuse:
  spawner-protection:
    enabled: true
    radius: 10

AFK Detection

Reduce rewards for AFK players:

anti-abuse:
  afk-detection:
    enabled: true
    timeout: 300  # 5 minutes
    multiplier: 0  # No rewards when AFK

zItems Integration

Use zItems runes to boost job rewards:

Job Money Boost Rune

# On zItems item
runes:
  - job_money_boost

Players holding items with this rune earn bonus money.

Job XP Boost Rune

# On zItems item
runes:
  - job_xp_boost

Players holding items with this rune earn bonus job XP.

Next Steps

Job Configuration

Précédent

Commands & Permissions

Suivant

Sur cette page

Action TypesBasic Action StructureReward TypesMoneyExperience (XP)Job XPItemsCommandsAction ExamplesBreak ActionPlace ActionKill ActionFish ActionCraft ActionSmelt ActionBreed ActionEnchant ActionConditionsBlock AgePermissionWorldToolTimeBlock TagsRandom RewardsMultipliersLevel MultiplierTool MultipliersTime MultipliersAnti-AbuseBlock TrackingSpawn ProtectionAFK DetectionzItems IntegrationJob Money Boost RuneJob XP Boost RuneNext Steps
GroupeZ MCP

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.