RDQ configuration
Locate RDQ settings and compare complete bundled file examples.Configuration
Files belong under plugins/RDQ/. The examples below are complete resource snapshots, not partial snippets. Keep your own database credentials. Restart after database or installation changes.
Apply a small change
Back up the file, edit one setting, validate YAML or properties syntax, and use the plugin-specific reload command only for supported changes. Verify the resulting behavior with an ordinary player.
Other generated files
RDQ also generates rank-system and perk-system settings, rank paths, quest definitions, perks and machines. Some system files are generated by code rather than copied from a bundled resource; review the files produced by your installed build.
Configuration files
Complete bundled file examples for the documented build. Merge the settings you need into your server-owned files; keep existing database credentials and custom content.
plugins/RDQ/bounty/bounty.yml
# RDQ bounty subsystem configuration.
# Parsed by com.raindropcentral.quests.bounty.BountyConfig at startup and on
# /rq admin reload bounty. Missing keys fall back to documented defaults.
# Master switch — disables placement, claim, and announcements.
enabled: true
placement:
# Allow players to place bounties on themselves. Operators and
# holders of raindropquests.bounty.bypass ignore this regardless.
self-target-allowed: false
min-amount: 100.0
max-amount: 1000000.0
# How many active bounties a single issuer may have at once.
max-active-per-issuer: 3
# Fraction (0.0 - 1.0) deducted from the payout at placement time.
tax-rate: 0.0
# Currencies offered in the creation GUI's currency cycler. Must
# match identifiers known to the economy provider.
supported-currencies:
- coins
- gems
expiration:
# 0 disables expiration entirely.
hours: 72
# How often the sweeper checks for expired bounties.
sweep-minutes: 10
refund-on-expire: true
claim:
# LAST_HIT | MOST_DAMAGE | DAMAGE_SPLIT
mode: LAST_HIT
# Damage older than this is dropped from the contribution log.
tracking-window-ms: 30000
# Mob kills don't count toward bounty payouts when true.
require-player-killer: true
distribution:
# INSTANT pays out at kill time; other modes are gated by
# enabled-modes below.
default-mode: INSTANT
enabled-modes:
- INSTANT
announcements:
on-create: true
on-claim: true
on-expire: true
# SERVER | NEARBY | NONE
scope: SERVER
nearby-radius-blocks: 128
visuals:
head-tag-enabled: false
particle-trail-enabled: false
tab-prefix: ""
plugins/RDQ/database/hibernate.properties
# ============================================
# Database Type Selection
# ============================================
# Supported types: H2, MYSQL, MARIADB, POSTGRESQL, ORACLE, MSSQL_SERVER
database.type=H2
# ============================================
# H2 (default, embedded)
# ============================================
h2.url=jdbc:h2:file:./plugins/RDQ/database/rdq;MODE=MySQL;AUTO_SERVER=TRUE;WRITE_DELAY=0
h2.driver=org.h2.Driver
h2.dialect=org.hibernate.dialect.H2Dialect
h2.username=sa
h2.password=
# ============================================
# MySQL
# ============================================
mysql.url=jdbc:mysql://localhost:3306/mydb?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC&characterEncoding=UTF-8
mysql.driver=com.mysql.cj.jdbc.Driver
mysql.dialect=org.hibernate.dialect.MySQLDialect
mysql.username=root
mysql.password=change_me
# ============================================
# MariaDB
# ============================================
mariadb.url=jdbc:mariadb://localhost:3306/mydb?useSSL=false&serverTimezone=UTC&characterEncoding=UTF-8
mariadb.driver=org.mariadb.jdbc.Driver
mariadb.dialect=org.hibernate.dialect.MariaDBDialect
mariadb.username=root
mariadb.password=change_me
# ============================================
# PostgreSQL
# ============================================
postgresql.url=jdbc:postgresql://localhost:5432/mydb
postgresql.driver=org.postgresql.Driver
postgresql.dialect=org.hibernate.dialect.PostgreSQLDialect
postgresql.username=postgres
postgresql.password=change_me
# ============================================
# Hibernate runtime
# ============================================
hibernate.hbm2ddl.auto=update
hibernate.show_sql=false
hibernate.format_sql=false
hibernate.highlight_sql=false
hibernate.use_sql_comments=false
hibernate.jdbc.batch_size=25
hibernate.order_inserts=true
hibernate.order_updates=true
hibernate.generate_statistics=false
plugins/RDQ/permissions/permissions.yml
# RDQ Permissions Configuration
# Define the default LuckPerms group to assign permissions to.
# Per-plugin overrides are not yet supported; all permission sets use this group.
defaultGroup: "default"
# Map of plugin keys to the list of LuckPerms permission nodes to assign.
# Plugin keys must match the identifiers registered in the permissions service.
# Example:
# permissions:
# my_plugin:
# - "my_plugin.use"
# - "my_plugin.admin"
permissions: {}
plugins/RDQ/ranks/paths/stonevein.yml
identifier: stonevein
displayName: "<gradient:#a8a29e:#facc15>Stonevein</gradient>"
description: "Follow the ore veins from surface stone to the deepest forge."
displayOrder: 1
enabled: true
icon: { material: IRON_PICKAXE }
allowSwitching: true
switchCooldownSeconds: 0
ranks:
dustbound:
orderIndex: 0
tier: 1
initialRank: true
displayName: "<gray>Dustbound</gray>"
description: "A new miner with a pick and a light for the first descent."
luckPermsGroup: stonevein_dustbound
prefixKey: "<dark_gray>[Dustbound] "
icon: { material: STONE_PICKAXE }
nextRanks: [prospector]
reward:
type: composite
children:
- { type: item, materialKey: STONE_PICKAXE, amount: 1, nbt: "{}" }
- { type: item, materialKey: TORCH, amount: 32, nbt: "{}" }
prospector:
orderIndex: 1
tier: 2
displayName: "<gold>Prospector</gold>"
description: "Recognizes a promising vein and maps the way back."
luckPermsGroup: stonevein_prospector
prefixKey: "<gold>[Prospector] "
icon: { material: IRON_PICKAXE }
previousRanks: [dustbound]
nextRanks: [iron_seeker, gem_seeker]
requirement:
type: composite
mode: AND
children:
- { type: quest-completed, questIdentifier: miner_cobble, minCompletions: 1 }
- { type: experience_level, level: 10, consumeOnComplete: false }
reward:
type: composite
children:
- { type: item, materialKey: IRON_PICKAXE, amount: 1, nbt: "{}" }
- { type: currency, currency: coins, amount: 250 }
iron_seeker:
orderIndex: 2
tier: 3
displayName: "<gray>Iron Seeker</gray>"
description: "Follows the iron seams and supplies the deep forges."
luckPermsGroup: stonevein_iron_seeker
prefixKey: "<gray>[Iron Seeker] "
icon: { material: RAW_IRON }
previousRanks: [prospector]
nextRanks: [deepforged]
requirement:
type: composite
mode: AND
children:
- { type: experience_level, level: 20, consumeOnComplete: false }
- type: choice
requiredCount: 1
mutuallyExclusive: false
choices:
- { type: quest-completed, questIdentifier: miner_iron, minCompletions: 1 }
- { type: item, material: IRON_INGOT, amount: 32, exactMatch: false, consumeOnComplete: false }
reward:
type: composite
children:
- { type: currency, currency: coins, amount: 500 }
- type: choice
maxSelections: 1
mutuallyExclusive: true
options:
- { type: item, materialKey: IRON_BLOCK, amount: 8, nbt: "{}" }
- { type: item, materialKey: DIAMOND_PICKAXE, amount: 1, nbt: "{}" }
gem_seeker:
orderIndex: 3
tier: 3
displayName: "<aqua>Gem Seeker</aqua>"
description: "Searches beneath the slate for the rarest stones."
luckPermsGroup: stonevein_gem_seeker
prefixKey: "<aqua>[Gem Seeker] "
icon: { material: DIAMOND }
previousRanks: [prospector]
nextRanks: [deepforged]
requirement:
type: composite
mode: AND
children:
- { type: experience_level, level: 20, consumeOnComplete: false }
- type: choice
requiredCount: 1
mutuallyExclusive: false
choices:
- { type: quest-completed, questIdentifier: miner_diamond, minCompletions: 1 }
- { type: item, material: DIAMOND, amount: 4, exactMatch: false, consumeOnComplete: false }
reward:
type: composite
children:
- { type: currency, currency: coins, amount: 500 }
- type: choice
maxSelections: 1
mutuallyExclusive: true
options:
- { type: item, materialKey: DIAMOND_PICKAXE, amount: 1, nbt: "{}" }
- { type: item, materialKey: EMERALD, amount: 16, nbt: "{}" }
deepforged:
orderIndex: 4
tier: 4
displayName: "<gradient:#fbbf24:#78716c>Deepforged</gradient>"
description: "Returns from the depths with a master miner's craft."
luckPermsGroup: stonevein_deepforged
prefixKey: "<gold>[Deepforged] "
icon: { material: NETHERITE_PICKAXE }
previousRanks: [iron_seeker, gem_seeker]
requirement:
type: composite
mode: AND
children:
- { type: quest-completed, questIdentifier: miner_master, minCompletions: 1 }
- { type: experience_level, level: 30, consumeOnComplete: false }
reward:
type: composite
children:
- { type: item, materialKey: NETHERITE_INGOT, amount: 1, nbt: "{}" }
- { type: currency, currency: sky_shards, amount: 5 }
plugins/RDQ/perks/haste.yml
# Haste — mining speed perk. Paired with the miner chain; unlock cost
# matches the mid-tier currency economy.
identifier: haste
category: utility
displayName: "<gradient:#fde047:#f59e0b>Quickened Strike</gradient>"
description: "Permanent Haste I — break blocks faster."
kind: PASSIVE
cooldownSeconds: 0
enabled: true
icon:
material: GOLDEN_PICKAXE
enchanted: true
requirement:
type: composite
op: AND
children:
- { type: quest-completed, questIdentifier: miner_cobble, minCompletions: 1 }
- { type: currency, currency: coins, op: GE, amount: 800.0 }
reward:
type: command
command: "tellraw {player} {\"text\":\"Quickened Strike unlocked.\",\"color\":\"gold\"}"
asConsole: true
behaviour:
effect: HASTE
amplifier: 0
durationTicks: 600
refreshEveryTicks: 400
particles: false
plugins/RDQ/machines/fabricator.yml
# ─────────────────────────────────────────────────────────────────────────────
# Fabricator — automated crafting machine
# ─────────────────────────────────────────────────────────────────────────────
# Drop raw materials into the input grid and the fabricator will run
# any unlocked recipe that matches, consuming fuel and writing the
# output back to the output grid. Four upgrade tracks tune speed, fuel
# efficiency, bonus output rolls, and fuel consumption.
#
# This file is read by MachineDefinitionLoader into MachineType — every
# key under `properties` is exposed through MachineType.properties(),
# and the strongly-typed wrappers in MachineType.fabricator() (speed,
# upgrades, recipes, fuel) decode the nested maps lazily.
identifier: fabricator
displayName: "<gradient:#fde047:#f59e0b>Fabricator</gradient>"
description: "Automated crafting station. Feed raw materials via input hoppers, burn fuel, collect processed goods from the output chest."
category: industrial
icon: BLAST_FURNACE
# World-space footprint used by MachinePlacementListener to reject
# placements that would overlap a chunk edge or solid block. The
# fabricator is a single-block machine core; the required-blocks list
# below describes the satellite hoppers/chest the player must arrange.
width: 1
height: 1
depth: 1
# Permission required to place or interact with a fabricator. Admins
# (rdq.machine.admin) bypass this check.
permission: "rdq.machine.fabricator"
# ── Structure ────────────────────────────────────────────────────────────────
# The fabricator is a multi-block machine modelled on the vanilla
# blast-furnace pipeline:
#
# ┌──────┐
# │ HOP↓ │ y=+1 INPUT hopper — point DOWN into the core
# └──────┘
# ┌──┐ ┌──────┐
# │HF│→│ CORE │ y= 0 FUEL hopper west, points east into the core
# └──┘ └──────┘
# ┌──────┐
# │ HOP↓ │ y=-1 OUTPUT hopper — pulls from the core
# └──────┘
# ┌──────┐
# │CHEST │ y=-2 OUTPUT chest — receives from the hopper above
# └──────┘
#
# This layout matches what every Minecraft player expects:
# • Hopper above a furnace feeds the input slot
# • Side hopper feeds the fuel slot
# • Hopper below pulls finished items
# • Chest below the bottom hopper is the storage
#
# Players can build it like a vanilla auto-smelter — the fabricator
# just routes items between those world-side containers and its own
# virtual storage / fuel buffer every tick.
#
# `role` tells the runtime whether a position is an input source, an
# output sink, or a fuel feed. A hopper without a role is structural
# only (validation passes, but no item routing happens through it).
structure:
core-block: BLAST_FURNACE
hint: "Vertical stack: INPUT hopper above, CORE, OUTPUT hopper below, CHEST below that. FUEL hopper to the west."
required-blocks:
- type: HOPPER
role: INPUT
relative-positions:
- {x: 0, y: 1, z: 0} # Above core — point hopper DOWN into the furnace
- type: HOPPER
role: FUEL
relative-positions:
- {x: -1, y: 0, z: 0} # West side — point hopper EAST into the furnace
- type: HOPPER
role: OUTPUT
relative-positions:
- {x: 0, y: -1, z: 0} # Below core — point hopper DOWN into the chest
- type: CHEST
role: OUTPUT
relative-positions:
- {x: 0, y: -2, z: 0} # Below output hopper — final storage
properties:
# ── Runtime ────────────────────────────────────────────────────────────────
# Tick interval between fabrication attempts. 40 ticks ≈ 2 seconds of
# real time; upgrades shave this down.
tick-interval-ticks: 40
base-craft-ticks: 100 # base time one craft takes, before speed upgrades
# Storage UI now ships with 6 rows: 2 input rows (18 slots) +
# divider + 2 output rows (18 slots). Match the YAML to the UI
# capacity so the router sees the full grid.
input-slots: 18
output-slots: 18
upgrade-slots: 4 # one slot per upgrade track
trust-slots: 8 # max trusted players allowed to interact
# ── Fuel ───────────────────────────────────────────────────────────────────
# Set `enabled: false` to run the fabricator without fuel (free crafts).
# `base-consumption` is the energy cost of one craft before upgrades.
fuel:
enabled: true
base-consumption: 10
buffer-capacity: 10000 # maximum energy the fabricator can hold
fuel-types:
coal:
material: COAL
energy-value: 100
display: "<gray>Coal</gray>"
charcoal:
material: CHARCOAL
energy-value: 100
display: "<gray>Charcoal</gray>"
coal-block:
material: COAL_BLOCK
energy-value: 900
display: "<dark_gray>Coal Block</dark_gray>"
blaze-rod:
material: BLAZE_ROD
energy-value: 600
display: "<gold>Blaze Rod</gold>"
lava-bucket:
material: LAVA_BUCKET
energy-value: 2000
display: "<red>Lava Bucket</red>"
# ── Recipes ────────────────────────────────────────────────────────────────
# Each recipe keys its input materials (stackable) against the output.
# `required-rank` and `required-quest` gate unlock per player; leave
# blank for "unlocked by default".
recipes:
iron_to_steel:
displayName: "<gray>Steel Ingot</gray>"
description: "Smelt iron into durable steel."
icon: IRON_INGOT
inputs:
- {material: IRON_INGOT, amount: 3}
- {material: COAL, amount: 1}
output: {material: IRON_INGOT, amount: 1, display-name: "<gradient:#cbd5e1:#64748b>Steel Ingot</gradient>"}
fuel-cost: 10
craft-ticks: 100
required-rank: ""
required-quest: ""
gold_to_electrum:
displayName: "<gold>Electrum Ingot</gold>"
description: "Alloy gold with silver dust to make electrum."
icon: GOLD_INGOT
inputs:
- {material: GOLD_INGOT, amount: 2}
- {material: IRON_NUGGET, amount: 4}
output: {material: GOLD_INGOT, amount: 1, display-name: "<gradient:#fde047:#facc15>Electrum Ingot</gradient>"}
fuel-cost: 15
craft-ticks: 120
diamond_compress:
displayName: "<aqua>Compressed Diamond</aqua>"
description: "Compress nine diamonds into a dense storage block."
icon: DIAMOND_BLOCK
inputs:
- {material: DIAMOND, amount: 9}
output: {material: DIAMOND_BLOCK, amount: 1}
fuel-cost: 50
craft-ticks: 200
netherite_refine:
displayName: "<dark_red>Refined Netherite</dark_red>"
description: "Refine a netherite ingot into a rare alloy core."
icon: NETHERITE_SCRAP
inputs:
- {material: NETHERITE_INGOT, amount: 1}
- {material: BLAZE_POWDER, amount: 4}
output: {material: NETHERITE_SCRAP, amount: 2}
fuel-cost: 100
craft-ticks: 400
required-rank: "ironclad"
# ── Upgrades ───────────────────────────────────────────────────────────────
# Four tracks, each 1..max-level. `effect-per-level` is multiplicative
# applied per level (so level-3 speed = 1 - 0.10*3 = 70% of base ticks).
upgrades:
speed:
displayName: "<gradient:#86efac:#16a34a>Speed</gradient>"
description: "Reduces the time each craft takes."
icon: SUGAR
max-level: 5
effect-per-level: 0.10
cost-per-level:
currency: {type: "vault", amount: 5000.0}
items:
- {material: REDSTONE, amount: 32}
efficiency:
displayName: "<gradient:#fde047:#f59e0b>Efficiency</gradient>"
description: "Chance to run a craft without consuming fuel."
icon: DIAMOND
max-level: 5
effect-per-level: 0.15
cost-per-level:
currency: {type: "vault", amount: 7500.0}
items:
- {material: DIAMOND, amount: 8}
bonus-output:
displayName: "<gradient:#d8b4fe:#9333ea>Bonus Output</gradient>"
description: "Chance to double the output of a successful craft."
icon: EMERALD
max-level: 3
effect-per-level: 0.10
cost-per-level:
currency: {type: "vault", amount: 10000.0}
items:
- {material: EMERALD, amount: 16}
fuel-reduction:
displayName: "<gradient:#fca5a5:#f59e0b>Fuel Reduction</gradient>"
description: "Reduces the fuel consumed per craft."
icon: GOLD_INGOT
max-level: 5
effect-per-level: 0.10
cost-per-level:
currency: {type: "vault", amount: 4000.0}
items:
- {material: GOLD_INGOT, amount: 16}
# ── Quality-of-life ────────────────────────────────────────────────────────
auto-output: true # push finished items into adjacent hoppers/chests
allow-trusted-interact: true # trusted players can toggle recipes and open storage
break-drops-contents: true # dismantling returns input/output items to owner
emit-redstone-when-idle: false