Xiaoxiang's Spirit Stone Veins

# Xiaoxiang's Spirit Stone Veins

An addon for **Xiaoxiang Cultivation (小翔的修仙世界)** that generates permanent spirit stone veins across the Overworld.

Unlike secret realms, a vein **never disappears and never re-generates on its own** — it is a structure that stays in the world until you mine it out.

## Features

### Four vein tiers
| Vein | Core grade | Radius | Look |
| --- | --- | --- | --- |
| Small | Low (下品) | 14 | Cyan crystal |
| Medium | Mid (中品) | 20 | Deep blue crystal |
| Large | High (上品) | 28 | Purple crystal |
| Giant | Supreme (极品) | 40 | Gold crystal |

Higher tiers contain more ore, more cores, and mixed grades of spirit stone ore (low → supreme). Blocks are the original spirit stone ores from Xiaoxiang Cultivation, so everything you mine is fully usable.

### Vein cores
- Every vein has **1–3 vein cores**, all clustered at the very center.
- The center of the vein is carved into a hollow, so the cores **float freely in the middle** and never touch other blocks.
- Cores are **exposed and easy to find** — dig to the center and you will see them.
- Four core tiers, each with its own crystalline texture (amethyst-style faceted design in cyan / blue / purple / gold).

### Absorbable qi, faster than amethyst
- Cores are registered as real qi sources in Xiaoxiang Cultivation's qi system.
- They spawn the same **absorbable qi orbs** as amethyst blocks, but at a much higher rate:

- Cores also emit many ambient qi particles.

### Self-repairing veins
- As long as **at least one core remains**, the vein continuously regenerates mined spirit stone ore.
- Repair speed and amount scale with tier: Giant veins refill the fastest and in the largest batches.
- The central hollow is protected, so cores always stay floating and lit.

### Light and no mob spawning
- Cores emit light (12 / 13 / 14 / 15 by tier).
- The whole central hollow is filled with invisible level-15 light blocks, so it stays bright and mobs cannot spawn inside the hollow.

### Sect proximity bonus
- Veins near a sect settlement generate larger, denser and repair faster.
- The bonus scales with the sect's size/level.

### Locator friendly
- Registered as four separate structure entries (Small / Medium / Large / Giant), so **Explorer's Compass and similar locators can name and locate each size**.

## Requirements
- Minecraft **1.20.1**
- **Forge 47.x**
- **Xiaoxiang Cultivation 0.3.328 or newer** (required)
- Java 17

## Notes
- Veins are generated **underground** (roughly 18–110 blocks below the surface, depending on tier).
- Like all world generation, veins only appear in **newly generated chunks** — existing chunks will not be retro-fitted.
- Built with balance-friendly defaults; vein size, repair speed, particle counts and light are configurable.

## Credits
- Author: **free_hupo**
- Addon for **Xiaoxiang Cultivation** by its respective author. All spirit stone ores, qi system and particles belong to the base mod.