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 [ore]
• /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.