Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for Vystorm

Connected ore veins for new chunks: ready-made configs, vanilla ore switches, prospecting rod, regrowing veins.

Report Vystorm-Veins?

Works on its own. Vystorm Core (free) is optional; the placeholders need Core 0.65.0 or newer.

Vystorm Veins

Connected ore veins in new chunks, with a prospecting rod, vein mining and claims.

Vystorm Veins generates ore as connected deposits in the worlds you choose. You set the rules per ore and decide whether vanilla ore stays. Players find veins with a prospecting rod, mine them in one go and can claim them for a while.

Vystorm Veins banner

What players get

  • Real veins to follow through the rock where vanilla has scattered blobs.
  • A prospecting rod that points to the nearest ore.
  • Vein mining: sneak, break one ore and the connected vein comes along.
  • Claims that keep a vein theirs for 20 minutes.
  • A mining journal with their discoveries per ore.

Features

Veins in the world

  • Generate connected ore deposits in new chunks. Each rule sets an ore, an optional deep ore, host blocks, biomes, a Y range, attempts per chunk, size and chance. Iron, coal, copper and diamond rules are included.
  • Add deep veins: rare ancient debris veins far down. Their core blocks can only be mined while 3 players stand within 12 blocks, and every miner nearby gets XP.
  • Let veins grow back (needs Core, off by default): one ore per vein returns every 60 seconds at a mined position, as long as at least 10 % of the vein is left standing.

A connected ore vein running through a cave wall

Your world, your rules

  • Start from one of three ready-made configs: rare-large, frequent-small or mixed.
  • Replace vanilla ore per family with replace_natural: coal, iron, copper, gold, redstone, lapis, diamond, emerald, nether gold, nether quartz and ancient debris, each on its own.
  • Check a chunk before you change it: /vveins preview calculates the result, /vveins apply executes it and /vveins cancel discards it. Existing chunks are never regenerated on their own.
  • See generation, switches and counters with /vveins status. /vveins reload rejects an invalid config with the reason and keeps the old settings.

Different vein layouts from different configs

Mining

  • Prospect with the rod: sneak and right-click with an amethyst shard to scan 10 blocks. Chat lists the nearest ores with distance and direction, a particle trail points the way, and a chime rises in pitch the closer you are. You can hide valuable ores from the rod.
  • Mine a whole vein: sneak and break one ore with a fitting pickaxe and up to 32 connected blocks follow. Each block is a normal break, so protection plugins, Fortune and Silk Touch work. Players switch it for themselves with /veinmine.
  • Stay safe while vein mining: the batch stops before it would open lava, water or a falling block above you.
  • Claim a vein: right-click an ore with the rod and the connected vein is yours for 20 minutes. Your party and admins can still mine it. /veinclaim shows the claim and /veinclaim release frees it.
  • Open the ore map with /veinmap (needs Core): the chunks around you with the most common ore in each.
  • Read your mining journal with /veinjournal: discoveries for ten ore families, tiers at 1, 16, 64 and 256 finds, and collection goals. The goals are cosmetic.
  • Read the short tutorial under /vmenu tutorials (needs Core).
  • Show journal discoveries per ore family with their tiers, your mining claim and the regrowth counters in other plugins: values such as %vystorm_veins_journal_total% come from Vystorm Core 0.65.0 or newer, which passes them on to PlaceholderAPI when it is installed. /vadmin placeholders veins lists them.

Ore growing back in a mined vein

Switch features on and off

Every feature except the ready-made configs and the admin commands has its own switch in config.yml. With Vystorm Core installed you also find them in game under /vadmin features. Without Core you edit the file and run /vveins reload, which applies the changes at once.

generation.enabled switches the vein generation: off, new chunks keep vanilla ore, no vanilla ore is removed, and /vveins preview, apply and cancel are off. The eleven replace_natural keys and chunk-preview.enabled need it. Existing veins stay, and the rod, vein mining, claims and the journal keep working on any ore. Veins has no master switch for the whole plugin.

A switched-off feature answers "This feature is switched off on this server." or names the switch it needs. With Core 0.65.0 or newer its commands also leave tab completion at once; with an older Core that happens after a restart. Only tutorial.enabled needs a restart. Mining journals stay on the players when mining-journal.enabled is off. The ready-made configs are three files you copy by hand, and /vveins status and /vveins reload stay on so you can see and apply the switches. A server that updates keeps its values: a missing vein-mining or ore-map section in a config older than 1.5.0 still means off.

Setup

  1. Put the jar into plugins/ and restart.
  2. Set your world names under worlds in config.yml (default: world).
  3. Optional: install Vystorm Core 0.64.0 or newer for the ore map, regrowth, texts in each player's language and the in-game config editor.

The plugin comes preconfigured with the mixed rules. Without Core all messages are English. With Core you get seven languages (English, German, French, Italian, Brazilian Portuguese, Russian, Simplified Chinese), a first-run setup and /vadmin config VystormVeins.

Compatibility: Tested on Paper and Purpur 26.2, Paper 1.20.6 and Spigot 26.2. Java 21 or newer. Folia is not supported.

Commands and permissions

Command What it does Permission
/veinmine Switch vein mining for yourself vystormveins.veinmine
/veinclaim, /veinclaim release Show or free your claim vystormveins.claim
/veinmap (/oremap) Ore map vystormveins.map
/veinjournal Mining journal vystormveins.journal
sneak + right-click with an amethyst shard Prospecting rod vystormveins.prospect
/vveins status|reload|preview|apply|cancel Administration vystormveins.admin (OP)

vystormveins.claim.bypass (OP) lets someone mine veins other players claimed. All player permissions are given to everyone by default.

Vystorm Veins gets at least one update every month. If the veins work well on your server, a review helps other server owners find the plugin.

More from Vystorm

Vystorm Core, Vystorm Rails, VystormPortals, CustomTrees, XPVaultEconomy, BlockIntegrations, Winter Is Coming, Vystorm Insomnia, Vystorm Gallery, Vystorm Paddock, Vystorm Snapshot, Vystorm Boards, Vystorm Estates, Vystorm Chat, Vystorm Worlds and Vystorm Locks, all free.

Free and open source (GPL-3.0): source code on GitHub

Information

Category
World Management
Published
October 29, 2026
License
MIT
10Downloads
0Stars

Pinned Versions

Members

1