# 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:
| Core | Qi capacity | Qi regen | Orb spawn rate |
|---|---|---|---|
| Low | 1,000 | 5 /s | ~200× amethyst |
| Mid | 5,000 | 15 /s | ~400× |
| High | 20,000 | 60 /s | ~600× |
| Supreme | 100,000 | 200 /s | ~1000× |
- 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.