Configuration

Configuration

VortexRPG generates editable YAML files inside plugins/VortexRPG/ after first boot.

Main Files

File	Purpose
config.yml	Core settings, integrations, scoreboard, resource pack delivery, economy tuning, and smart-system toggles
spells.yml	Spell definitions, mechanics, targeters, scaling, and gating
effects.yml	Status effects and reusable combat modifiers
items.yml	Custom items, class relics, click bindings, locked items, and item overrides
quests.yml	Quest content and progression rules
talents.yml	Talent trees and passive progression definitions
fractures.yml	Fracture pressure, breach pacing, rewards, and world-state tuning
gateways.yml	Gateway destinations and travel configuration
bosses.yml	Boss encounter definitions and boss editing data
dungeons.yml	Dungeon instances, entry rules, waves, and dungeon metadata

Smart Systems Config

smart-systems:
  director:
    enabled: true
    pulse-ticks: 1200
  relic-affixes:
    enabled: true
    roll-chance: 0.18
  dungeon-mutators:
    enabled: true
    roll-chance: 1.0
  class-synergies:
    enabled: true
    radius: 24.0
    refresh-ticks: 100
  codex:
    enabled: true
  reputation:
    enabled: true

Setting	Description
director.enabled	Enables the Vortex Director control layer
director.pulse-ticks	How often the Director recalculates its directive
relic-affixes.enabled	Enables random affix rolling on eligible custom items
relic-affixes.roll-chance	Base affix roll chance before Director multipliers
dungeon-mutators.enabled	Enables random dungeon run mutators
dungeon-mutators.roll-chance	Chance for a dungeon run to receive a mutator
class-synergies.enabled	Enables nearby class combo bonuses
class-synergies.radius	Radius used to detect nearby class partners
class-synergies.refresh-ticks	How often live synergy attributes refresh
codex.enabled	Enables discovery tracking
reputation.enabled	Enables faction reputation progression

Items

items:
  prevent-drop-locked: true

When enabled, locked VortexRPG relics cannot be dropped or lost through normal drop/death flows.

Scoreboard

The scoreboard can show class, level, XP, balance, breach tokens, active quests, and talent points.

scoreboard:
  enabled: true
  update-ticks: 20

Resource Pack Delivery

resource-pack:
  enabled: false
  send-on-join: true
  required: false
  url: ""
  sha1: ""

Use this when deploying custom GUI icons, relic visuals, and menu artwork.

Integrations

integrations:
  protection:
    enabled: true
    worldguard:
      enabled: true
  citizens:
    enabled: true
  placeholderapi:
    enabled: true
  vault:
    enabled: true

All integrations are optional soft dependencies.

Economy

VortexRPG includes dynamic market tuning with stock, price floor/cap, demand elasticity, stock elasticity, and decay settings.

Use Vault if you want external economy payouts for dungeons, expeditions, breaches, and other reward loops.

Fractures and Realms

Fracture config controls world pressure, escalation thresholds, boss breach thresholds, breach rewards, market pressure, loot chances, and fracture realm behavior.

Important values include:

• fractures.base-intensity
• fractures.corrupted-threshold
• fractures.overrun-threshold
• fractures.boss-threshold
• fractures.breach-token-base-reward
• fracture-realm.enabled
• fracture-realm.world-name
• fracture-realm.difficulty

Safe Config Workflow

1. Stop the server.
2. Back up plugins/VortexRPG/.
3. Edit YAML files.
4. Start the server.
5. Watch console logs for migration or validation notes.
6. Use hot reload commands where supported.