Fatsan-Ore-Generation

# Fatsan Ore Generation Fatsan Ore Generation, or `FUG`, is a focused world generation plugin for Folia-based and Paper-compatible Minecraft `1.21.11` servers. Its goal is simple: let you rebalance and customize ore generation without replacing terrain, cave, biome, or structure generation. Instead of acting like a custom chunk generator, FUG works as an ore-only post-processing layer for newly generated chunks. This makes it a practical choice for survival servers that want better control over ore distribution while keeping their existing world style, datapacks, and generator setup intact. ## Features - Folia-first design with Paper `1.21.11` compatibility - Changes ore generation without replacing the world’s terrain, caves, biomes, or structures - Uses a safe `BlockPopulator` + `LimitedRegion` approach instead of NMS or a custom generator - Supports rewriting vanilla ore blocks in newly generated chunks - Can also place additional configured ore veins into valid host materials - Per-ore tuning for rarity, frequency, attempts, vein size, density, irregularity, and spawn chance - Rule inheritance system for global, profile, environment, world, and biome-based control - Host material restrictions and stone/deepslate-aware placement behavior - Realism-oriented options such as biome bonuses, cave context checks, air exposure rules, and host validation - Separate handling for special cases like Ancient Debris - Preset examples included for simple, advanced, realistic, performance-first, and hard survival setups - English and Turkish language support - Debug and inspection commands for checking active ore rules at runtime ## Commands - `/fug reload` - `/fug info` - `/fug debug` - `/fug inspect ` - `/fug stats` - `/fug dump-rule <world> <biome> <ore>` ## Configuration The plugin is designed to be flexible without forcing you into a full custom worldgen stack. You can control things like: - which ores are enabled or disabled - whether existing vanilla ore blocks should be rewritten - whether extra ore veins should be generated - rarity, attempts, spawn chance, and frequency scaling - vein size, density, and irregularity - biome-based, world-based, and environment-based overrides - realism-related behavior such as air exposure handling and host restrictions - safety, compatibility, and performance settings The main configuration is split into separate files for cleaner management: - `config.yml` for general settings, safety, compatibility, and performance - `worlds.yml` for world filters and world-specific behavior - `ores.yml` for ore rules, profiles, and biome/environment overrides ## Requirements - Java 21 - Folia or Paper `1.21.11` ## Notes This plugin is designed for ore control only. It does not replace the server’s chunk generator and does not take ownership of terrain, biome, cave, or structure generation. FUG mainly affects newly generated chunks. Already generated chunks are not automatically regenerated or updated retroactively. Because it avoids replacing the base world generation pipeline, it is a good fit for servers using vanilla-style generation or compatible datapack/generator setups such as Terralith, Tectonic, Incendium, and similar worldgen packs.