GroupeZ Docs

Actions & Rewards

Configure job actions and rewards in zJobs

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

Previous Page

Commands & Permissions

Next Page

On this 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

Documentation in your AI

MCP lets your AI search GroupeZ documentation and read current examples to help you configure your plugins.

Read-only · No documentation API key needed

1. Copy the server URL

Transport: HTTP (Streamable HTTP). Authentication: none. Your tool uses its own model and subscription limits.

  1. Open Plugins in ChatGPT on the web, then + → Add custom MCP server.
  2. Name it ‘GroupeZ Documentation’, paste the URL above and choose ‘No authentication’. Create and install the plugin.
  3. In a conversation, type @ and select the plugin before asking. If needed, enable search, get_page and list_pages in its settings.
Official setup guide

3. Ask a question

Use GroupeZ MCP to help me create a zMenu inventory. Search relevant pages, read the examples and cite your sources.
Other clients and troubleshooting

For clients using mcpServers, adapt this example to their format:

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

Available tools are search, get_page and list_pages. Refresh the connector’s tools after updates. If your AI cannot access them, check that the connector is enabled in the conversation and your account allows custom MCP servers. Opening the URL in a browser is not an MCP test.