RDR configuration
Locate RDR settings and compare complete bundled file examples.Configuration
Files belong under plugins/RDR/. 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
The full plugin folder can include additional generated settings, translations and data. Use the generated files from the installed build as your starting point.
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/RDR/commands/prr.yml
# JExCommand 2.0 tree for /rr (RDR — Raindrop Distributed Resources)
name: rr
description: "RDR storage and trade commands"
aliases:
- rdr
permission: "raindropreserve.command"
senders: [player]
subcommands:
- name: storage
description: "Open the storage overview"
permission: "raindropreserve.command.storage"
- name: open
description: "Open a storage by hotkey number"
permission: "raindropreserve.command.storage"
argumentSchema:
- { name: hotkey, type: positive_integer, required: true, description: "Hotkey number (1–9)" }
- name: admin
description: "Open the admin panel"
permission: "raindropreserve.command.admin"
subcommands:
- name: rollback
description: "Open the rollback player selector"
permission: "raindropreserve.command.admin.rollback"
- name: backup
description: "Backup all online players' storages"
permission: "raindropreserve.command.admin.backup"
- name: trade
description: "Open the active trade sessions admin panel"
permission: "raindropreserve.command.admin"
- name: scoreboard
description: "Toggle the storage sidebar scoreboard"
permission: "raindropreserve.command.scoreboard"
- name: trade
description: "Open the trade hub"
permission: "raindropreserve.command.trade"
- name: taxes
description: "View storage tax overview"
permission: "raindropreserve.command.storage"
plugins/RDR/config/config.yml
# Number of storages every new player receives when their profile is first created.
starting_storages: 1
# Global maximum number of storages a player may own.
# Starting storages are clamped to this value when a new profile is created.
max_storages: 10
# Highest numeric hotkey players may bind to a storage for `/rr open <hotkey>` access.
max_hotkeys: 9
# Items that may never be deposited into any RDR storage.
global_blacklist:
- NETHER_STAR
# Log a startup warning listing required storage shop purchases that do not have configured requirements.
# Missing purchases are treated as having no requirements.
warn_missing_requirements: true
# Protection and storage-tax settings.
# Supported protection plugins: RDT, Towny, and HuskTowns.
protection:
# Storages that require the player to stand in their own claim from a supported protection plugin.
# Supports "none", "all", or one-based ranges such as "1-3,5".
restricted_storages: none
# Storages that should apply open taxes when accessed.
# Supports "none", "all", or one-based ranges such as "1-3,5".
taxed_storages: all
# Per-open storage taxes charged to the player.
# Set values to 0 to disable taxes by currency.
# Supports Vault and custom JExEconomy currencies.
open_storage_taxes:
vault: 0.0
raindrops: 0.0
# Recurring taxes charged for storages that currently contain one or more items.
# Taxes are applied per non-empty storage each interval using configured currencies.
filled_storage_taxes:
# Bukkit ticks between recurring tax runs.
interval_ticks: 1728000
# Maximum number of storages per owner that may be frozen for unpaid tax debt.
# Positive values cap frozen storages, 0 disallows creating new frozen storages, -1 is unlimited.
maximum_freeze: -1
# Maximum debt a single frozen storage may accrue for each currency.
# Positive values cap debt accrual, 0 or negative values allow unlimited debt.
maximum_debt:
vault: -1.0
raindrops: -1.0
# Tax amount charged per non-empty storage for each currency.
# Set values to 0 to disable recurring taxes by currency.
currencies:
vault: 0.0
raindrops: 0.0
# Cross-server DB-first trade settings.
trade:
# Master switch for all /rr trade features.
enabled: true
# Seconds before pending invites expire.
invite_timeout_seconds: 60
# Poll interval for invite/session/delivery inbox refresh (20 ticks = 1 second).
poll_interval_ticks: 20
# Max item offer slots per participant (capped to 12 by the plugin).
max_offer_slots: 9
# Cooldown in seconds between outbound trade invites by one player (global, any target).
invite_cooldown_seconds: 5
# Cooldown in seconds before one player can re-invite the same specific partner.
partner_invite_cooldown_seconds: 30
# Max non-terminal trade sessions one player may have open at the same time (0 = unlimited).
max_concurrent_sessions: 3
# Live UI, cross-server reconciliation, and network-wide safety controls.
live:
# Must match the network ID used by RCore on the backends and Velocity.
network_id: "default"
# Maximum non-terminal trades across this network (0 = unlimited).
max_network_sessions: 100
# IMMEDIATE_CANCEL, GRACE_CANCEL, or PERSIST.
disconnect_policy: GRACE_CANCEL
disconnect_grace_seconds: 60
# AUTO applies deliveries online and retains failures in the inbox; INBOX is manual.
delivery_mode: AUTO
# Safety reconciliation remains active even when push transport is healthy.
healthy_reconcile_interval_ticks: 100
degraded_reconcile_interval_ticks: 20
# Proxy-enhanced trade UI controls.
proxy:
# Enables proxy-backed participant presence badges and online route hints.
presence_enabled: false
# Enables UI actions that route the player to the partner's current server.
join_partner_action_enabled: false
# Per-trade completion taxes charged to each participant before settlement finalizes.
taxation:
# Global switch for trade taxation.
enabled: false
# Per-currency tax definitions keyed by currency identifier.
currencies:
# Supported tax modes:
# FLAT: tax = flat_amount
# GROWTH: tax = flat_amount + (offered_currency_amount * growth_per_currency_amount) + (offered_item_count * growth_per_item)
vault:
mode: FLAT
flat_amount: 0.0
growth_per_currency_amount: 0.0
growth_per_item: 0.0
raindrops:
mode: FLAT
flat_amount: 0.0
growth_per_currency_amount: 0.0
growth_per_item: 0.0
# Shared proxy bridge controls.
proxy:
# Enables module-level proxy integrations.
enabled: false
# Optional authoritative route identifier for this Paper server.
server_route_id: ""
# Admin rollback snapshot settings.
rollback:
# Master switch for automatic backups, manual admin backups, rollback browsing, and restores.
enabled: true
# Maximum number of saved snapshots retained for one player.
max_snapshots_per_player: 10
triggers:
# Capture a snapshot when a player dies.
death: true
# Capture a snapshot shortly after a player joins.
join: true
# Capture a snapshot when a player leaves the server.
leave: true
# Capture a snapshot after a player changes worlds.
world_change: true
# Allow `/rr admin backup` and admin backup UI actions to create snapshots.
manual_backup: true
# RPlatform-powered requirements consumed for each one-based storage shop purchase tier.
# Only the tiers required to move from `starting_storages` to `max_storages` are needed.
# The bundled config defines the first 10 purchase tiers so higher storage caps can reuse the same pattern.
requirements:
1:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 1125
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 53
consumable: true
icon:
type: "EMERALD"
2:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 1265
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 57
consumable: true
icon:
type: "EMERALD"
3:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 1423
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 62
consumable: true
icon:
type: "EMERALD"
4:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 1601
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 66
consumable: true
icon:
type: "EMERALD"
5:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 1802
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 71
consumable: true
icon:
type: "EMERALD"
6:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 2027
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 77
consumable: true
icon:
type: "EMERALD"
7:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 2280
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 82
consumable: true
icon:
type: "EMERALD"
8:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 2565
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 89
consumable: true
icon:
type: "EMERALD"
9:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 2886
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 95
consumable: true
icon:
type: "EMERALD"
10:
vault_purchase:
type: "CURRENCY"
currency: vault
amount: 3247
consumable: true
icon:
type: "DIAMOND"
coins_purchase:
type: "CURRENCY"
currency: coins
amount: 103
consumable: true
icon:
type: "EMERALD"
plugins/RDR/database/hibernate.properties
# RDQ Database Configuration for JExHibernate
# This file configures database connectivity and Hibernate settings
# ============================================
# Database Type Selection
# ============================================
# Supported types: H2, MYSQL, MARIADB, POSTGRESQL
# Default: H2 (embedded, no external database required)
database.type=H2
# ============================================
# H2 Database Configuration (Default - Embedded)
# ============================================
# H2 is used by default for easy setup without external database
h2.url=jdbc:h2:file:./plugins/RDR/database/rdr;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 Database Configuration
# ============================================
mysql.url=jdbc:mysql://localhost:3306/rdr?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC&characterEncoding=UTF-8
mysql.driver=com.mysql.cj.jdbc.Driver
mysql.dialect=org.hibernate.dialect.MySQL8Dialect
mysql.username=rdq_user
mysql.password=change_me
# ============================================
# MariaDB Database Configuration
# ============================================
mariadb.url=jdbc:mariadb://localhost:3306/rdr?useSSL=false&serverTimezone=UTC&characterEncoding=UTF-8
mariadb.driver=org.mariadb.jdbc.Driver
mariadb.dialect=org.hibernate.dialect.MariaDB106Dialect
mariadb.username=rdq_user
mariadb.password=change_me
# ============================================
# PostgreSQL Database Configuration
# ============================================
postgresql.url=jdbc:postgresql://localhost:5432/rdr
postgresql.driver=org.postgresql.Driver
postgresql.dialect=org.hibernate.dialect.PostgreSQLDialect
postgresql.username=rdr_user
postgresql.password=change_me
# ============================================
# Connection Pool Configuration (HikariCP)
# ============================================
# Maximum number of connections in the pool
hikari.maximumPoolSize=10
# Minimum number of idle connections
hikari.minimumIdle=2
# Maximum lifetime of a connection in milliseconds (30 minutes)
hikari.maxLifetime=1800000
# Connection timeout in milliseconds (30 seconds)
hikari.connectionTimeout=30000
# Idle timeout in milliseconds (10 minutes)
hikari.idleTimeout=600000
# Validation timeout in milliseconds (5 seconds)
hikari.validationTimeout=5000
# Leak detection threshold in milliseconds (0 = disabled)
hikari.leakDetectionThreshold=0
# Pool name for logging
hikari.poolName=RDR-HikariPool
# ============================================
# Hibernate Configuration
# ============================================
# Schema management: validate, update, create, create-drop, none
# Recommended: validate for production, update for development
hibernate.hbm2ddl.auto=update
# Show SQL statements in console (disable in production)
hibernate.show_sql=false
# Format SQL statements for readability
hibernate.format_sql=false
# Use SQL comments
hibernate.use_sql_comments=false
# Batch size for bulk operations
hibernate.jdbc.batch_size=25
# Order inserts for better batching
hibernate.order_inserts=true
# Order updates for better batching
hibernate.order_updates=true
# Enable batch versioned data
hibernate.jdbc.batch_versioned_data=true
# Second-level cache (disabled by default)
hibernate.cache.use_second_level_cache=false
# Query cache (disabled by default)
hibernate.cache.use_query_cache=false
# Statistics (disable in production)
hibernate.generate_statistics=false
# ============================================
# Advanced Settings
# ============================================
# Connection test query (for validation)
hikari.connectionTestQuery=SELECT 1
# Auto-commit mode
hikari.autoCommit=false
# Transaction isolation level
# Options: TRANSACTION_READ_UNCOMMITTED, TRANSACTION_READ_COMMITTED,
# TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE
hikari.transactionIsolation=TRANSACTION_READ_COMMITTED
# Register MBeans for JMX monitoring
hikari.registerMbeans=false