The Contract

Features

• Interactive Contract Board: A physical block with a custom GUI to view, accept, deliver, and claim bounties.
• Procedural Contract Generation: Automatically refreshes contracts at set intervals with customizable task types (Hunting, Crafting, Exploration, Building, Raids, and Distance Travel).
• Optional Bonus Objectives: Side tasks that grant reward multipliers (e.g., $2\times$ currency bonuses) upon completion.
• Server-Wide & Dynamic: Global refresh cycles sync contracts across the entire server, preventing individual exploit farming.
• Extensive Datapack Support: Add static manual contracts or override the generator pools with JSON datapacks.
• Highly Configurable: Modify rewards, blacklists, task frequencies, currency items, and difficulty scaling in the config file.

Configuration Guide (the_contract-common.toml)

1. [generator]

• refreshIntervalMinutes (Default: 20): Time in minutes before the contract board clears and regenerates new contracts.
• contractsPerRefresh (Default: 15): Total number of procedural contracts generated per cycle.
• notifyOnRefresh (Default: false): Broadcasts a chat message to online players when contracts refresh.

2. [generator_blacklist]

• Format: Standard Resource Location lists, e.g., ["minecraft:beacon"] or ["minecraft:warden"].

3. [difficultyDistribution]

• basic (Default: 50)
• intermediate (Default: 35)
• hard (Default: 15)

4. [taskTypeDistribution]

• kill_entity (Default: 25)
• deliver_item (Default: 20)
• craft_item (Default: 20)
• travel_distance (Default: 15)
• break_block (Default: 12)
• place_block (Default: 12)
• find_biome (Default: 8)
• find_structure (Default: 6)
• defend_objective (Default: 5)
• complete_raid (Default: 3)

5. [player]

• maxActiveContractsPerPlayer (Default: 3): Maximum number of active contracts a player can hold simultaneously.

6. [rewards]

• currencyItem (Default: "minecraft:emerald"): The default item ID awarded as money/currency.
• Subcategories (basic_rewards, intermediate_rewards, advanced_rewards) allow configuring min/max currency payouts and extra item lists (e.g., ["minecraft:bread,8", "minecraft:iron_ingot,4"]).

7. [task_pools]

• Items / Mobs Syntax: "namespace:id|min-max" (e.g., "minecraft:copper_ingot|16-32" or "minecraft:zombie|5-15").
• Travel Distance Syntax: "min-max" in block meters (e.g., "250-500").

Datapack Creation Guide

Tip: You can download a ready-to-use Datapack template directly from our Discord server to get started faster!

File Structure & Paths

your_datapack/
├── pack.mcmeta
└── data/
    └── your_mod_or_pack_namespace/
        ├── contracts/
        │   └── custom_contract.json
        └── generator_pools/
            └── custom_pool.json

Creating Custom Static Contracts (data/<namespace>/contracts/*.json)

Example: data/mymodpack/contracts/dragon_slayer.json

{
  "title": "contract.mymodpack.dragon_slayer.title",
  "description": "contract.mymodpack.dragon_slayer.desc",
  "difficulty": "HARD",
  "repeatable": false,
  "optional_currency_multiplier": 2.5,
  "objectives": [
    {
      "id": "kill_dragon",
      "optional": false,
      "task": {
        "type": "KILL_ENTITY",
        "target": "minecraft:ender_dragon",
        "amount": 1
      }
    },
    {
      "id": "bonus_travel",
      "optional": true,
      "task": {
        "type": "TRAVEL_DISTANCE",
        "amount": 1000
      }
    }
  ],
  "rewards": [
    {
      "type": "CURRENCY",
      "count": 50
    },
    {
      "type": "ITEM",
      "item_id": "minecraft:netherite_ingot",
      "count": 2
    },
    {
      "type": "COMMAND",
      "command": "xp add @p 1000 levels"
    }
  ]
}

Task Types Reference (type):

• KILL_ENTITY — target: Entity ID
• DELIVER_ITEM — target: Item ID
• CRAFT_ITEM — target: Item ID
• BREAK_BLOCK — target: Block ID
• PLACE_BLOCK — target: Block ID
• FIND_STRUCTURE — target: Structure ID
• FIND_BIOME — target: Biome ID
• TRAVEL_DISTANCE — No target required, amount: blocks to walk
• COMPLETE_RAID — No target required, amount: raids to complete

Overriding Generator Pools (data/<namespace>/generator_pools/*.json)

Example: data/mymodpack/generator_pools/custom_hunt.json

{
  "difficulty": "BASIC",
  "entries": [
    {
      "target": "minecraft:zombie",
      "min_amount": 5,
      "max_amount": 15,
      "weight": 10
    },
    {
      "target": "minecraft:skeleton",
      "min_amount": 5,
      "max_amount": 15,
      "weight": 10
    }
  ]
}

Community & Support

Español

The Contract

Summary

Características

• Tablero de Contratos Interactivo: Un bloque físico con una interfaz personalizada para consultar, aceptar, entregar y reclamar recompensas.
• Generación Procedimental de Contratos: Los contratos se regeneran automáticamente a intervalos configurables con varios tipos de tareas (Caza, Crafteo, Exploración, Construcción, Raids y Distancia Recorrida).
• Objetivos Secundarios Opcionales: Tareas adicionales que otorgan multiplicadores de recompensa (por ejemplo, bono de $2\times$ en la moneda) al completarlas.
• Sistema Global para el Servidor: Los ciclos de refresco sincronizan los contratos para todos los jugadores, evitando que se farmeen de forma individual.
• Soporte Completo para Datapacks: Añade contratos estáticos manuales o reemplaza las listas de generación procedimental con archivos JSON.
• Altamente Configurable: Modifica las recompensas, listas negras, frecuencia de tareas, ítem utilizado como moneda y escalado de dificultad desde el archivo de configuración.

Guía de Configuración (the_contract-common.toml)

1. [generator]

• refreshIntervalMinutes (Por defecto: 20): Tiempo en minutos para que el tablero limpie y genere nuevos contratos.
• contractsPerRefresh (Por defecto: 15): Cantidad total de contratos procedimentales generados por ciclo.
• notifyOnRefresh (Por defecto: false): Envía un mensaje al chat de los jugadores conectados cuando se refrescan los contratos.

2. [generator_blacklist]

• Formato: Listas de Resource Location estándar, ej. ["minecraft:beacon"] o ["minecraft:warden"].

3. [difficultyDistribution]

• basic (Por defecto: 50)
• intermediate (Por defecto: 35)
• hard (Por defecto: 15)

4. [taskTypeDistribution]

• kill_entity (Por defecto: 25)
• deliver_item (Por defecto: 20)
• craft_item (Por defecto: 20)
• travel_distance (Por defecto: 15)
• break_block (Por defecto: 12)
• place_block (Por defecto: 12)
• find_biome (Por defecto: 8)
• find_structure (Por defecto: 6)
• defend_objective (Por defecto: 5)
• complete_raid (Por defecto: 3)

5. [player]

• maxActiveContractsPerPlayer (Por defecto: 3): Número máximo de contratos activos simultáneos que puede tener un jugador.

6. [rewards]

• currencyItem (Por defecto: "minecraft:emerald"): ID del ítem utilizado como moneda por defecto.
• Las subcategorías (basic_rewards, intermediate_rewards, advanced_rewards) permiten definir los mínimos/máximos de moneda entregada y listas de ítems extra (ej. ["minecraft:bread,8", "minecraft:iron_ingot,4"]).

7. [task_pools]

• Sintaxis para Ítems / Mobs: "namespace:id|min-max" (ej. "minecraft:copper_ingot|16-32" o "minecraft:zombie|5-15").
• Sintaxis para Recorrer Distancia: "min-max" en bloques/metros (ej. "250-500").

Guía para la Creación de Datapacks

Consejo: ¡Puedes descargar una plantilla de Datapack lista para usar directamente en nuestro servidor de Discord para empezar más rápido!

Estructura de Archivos y Rutas

tu_datapack/
├── pack.mcmeta
└── data/
    └── tu_namespace/
        ├── contracts/
        │   └── contrato_personalizado.json
        └── generator_pools/
            └── pool_personalizado.json

Crear Contratos Estáticos Personalizados (data/<namespace>/contracts/*.json)

Ejemplo: data/mimodpack/contracts/dragon_slayer.json

{
  "title": "contract.mimodpack.dragon_slayer.title",
  "description": "contract.mimodpack.dragon_slayer.desc",
  "difficulty": "HARD",
  "repeatable": false,
  "optional_currency_multiplier": 2.5,
  "objectives": [
    {
      "id": "kill_dragon",
      "optional": false,
      "task": {
        "type": "KILL_ENTITY",
        "target": "minecraft:ender_dragon",
        "amount": 1
      }
    },
    {
      "id": "bonus_travel",
      "optional": true,
      "task": {
        "type": "TRAVEL_DISTANCE",
        "amount": 1000
      }
    }
  ],
  "rewards": [
    {
      "type": "CURRENCY",
      "count": 50
    },
    {
      "type": "ITEM",
      "item_id": "minecraft:netherite_ingot",
      "count": 2
    },
    {
      "type": "COMMAND",
      "command": "xp add @p 1000 levels"
    }
  ]
}

Referencia de Tipos de Tareas (type):

• KILL_ENTITY — target: ID de la entidad
• DELIVER_ITEM — target: ID del ítem
• CRAFT_ITEM — target: ID del ítem
• BREAK_BLOCK — target: ID del bloque
• PLACE_BLOCK — target: ID del bloque
• FIND_STRUCTURE — target: ID de la estructura
• FIND_BIOME — target: ID del bioma
• TRAVEL_DISTANCE — No requiere target, amount: bloques a recorrer
• COMPLETE_RAID — No requiere target, amount: raids a completar

Modificar Pools de Generación (data/<namespace>/generator_pools/*.json)

Ejemplo: data/mimodpack/generator_pools/custom_hunt.json

{
  "difficulty": "BASIC",
  "entries": [
    {
      "target": "minecraft:zombie",
      "min_amount": 5,
      "max_amount": 15,
      "weight": 10
    },
    {
      "target": "minecraft:skeleton",
      "min_amount": 5,
      "max_amount": 15,
      "weight": 10
    }
  ]
}

Comunidad y Soporte