Configuration

Configuration

VortexEnchantments is configured through YAML files. Most gameplay systems can be enabled, disabled, priced, limited, or tuned without editing code.

Main Files

File	Purpose
config.yml	Core systems, rates, limits, shops, particles, storage, and integrations.
messages.yml	Prefixes and player-facing messages.
mob_drops.yml	Mob drop chances and rarity weights.
custom_items.yml	Custom items and recipes.
enchants/**/*.yml	Per-enchantment definitions.

Important config.yml Sections

Section	What it controls
debug	Extra console logging. Keep false on production unless diagnosing.
language	Active language key.
enchantments	Max enchants per item, anvil combining, grindstone stripping, discovery multiplier.
enchanting-table	Enchanting table integration and tier weights.
book-shop	Villager-style book shop base pricing.
gui	Enchant browser title, size, page size, background material.
cooldowns	Default cooldown behavior.
tick-rate	Passive enchant processing rate. Higher means lower load and less frequent processing.
storage	Player data backend and folder.
metrics	bStats toggle.
aura	Aura particles and interval.
mob-drops	Global mob drop system toggle.
mystery-scroll	Mystery Scroll system toggle.
extractor	Extractor Scroll system toggle.
forge	Enchant Forge system toggle.
success-rates	Success and destroy chance per rarity.
dust	Dust system and success bonus per tier.
tinkerer	Salvage output scaling.
alchemist	Alchemist system toggle.
souls	Souls rewards, loss fraction, streak bonus, and shop prices.
armor-sets	Armor set bonuses.
multi-world	Disabled worlds.
loot-tables	Loot chest injection chance.
villager	Librarian trade replacement chance.
update-checker	Version update checks.
slot-increaser	Slot bonus caps and tier success rates.
transmog	Lore sorting style.
randomization-scroll	Reroll upgrade and downgrade chances.
holy-white-scroll	Permanent item protection behavior.
enchant-shop	Vault shop prices, flash sales, and daily limits.
enchant-limits	Permission-based enchant slot caps.
combos	Enchant combo system.
evolution	Enchant evolution and failure destruction chance.
enchant-particles	Per-enchant particle effects and tick interval.

Production Tuning Tips

• Keep particle intervals at 4 or higher on busy servers.
• Increase tick-rate if passive enchant processing becomes too active for your server.
• Use multi-world.disabled-worlds for lobbies, hubs, minigames, and event worlds.
• Keep economy prices aligned with your server's money generation rate.
• Avoid extremely high mob drop rates on mob-farm-heavy servers.
• Back up config files before large edits.

Message Customization

Use messages.yml for player-facing text.

Color codes use &.

Placeholders use indexed values such as:

{0}
{1}

Reloading

Use:

/ve reload

Reloads are useful for small config and message edits. For jar updates, dependency changes, or major config restructuring, restart the server.