improve help info and move to new namespace

README.md

@@ -58,7 +58,7 @@ Modpacks can override a provider with `config/<modid>-orespawn.json`. A present
 override is authoritative and fails closed when invalid, so a broken pack file
 cannot silently disable another mod's native ore generation.
 
-Only `com.mcmoddev.orespawn.api` is supported Java API. API major version `1`
+Only `zone.moddev.mc.orespawn.api` is supported Java API. API major version `1`
 is also recorded in the jar manifest as `OreSpawn-API-Version`.
 
 Start with:

docs/AGENTS.md

@@ -1,7 +1,7 @@
 # OreSpawn Integration Notes For Coding Agents
 
 OreSpawn 4.0 is a required Forge mod and declarative world-generation engine.
-Public API major version 1 consists only of `com.mcmoddev.orespawn.api`. Treat
+Public API major version 1 consists only of `zone.moddev.mc.orespawn.api`. Treat
 every other Java package as internal and unstable.
 
 Integration entry points:
@@ -68,7 +68,7 @@ Compatibility defaults:
 - The Overworld is the conventional geology target, but a provider must opt it
   in. Nether and End terrain remain untouched unless explicitly configured.
 - Mineralogy 6 is a provider, not a public-API compatibility facade. Do not use
-  removed `com.mcmoddev.mineralogy.api` classes.
+  removed `zone.moddev.mc.mineralogy.api` classes.
 
 Common tasks are documented in `API.md`, `PROVIDERS.md`, `FEATURES.md`,
 `TEMPLATES.md`, `BIOMES.md`, and `DIMENSIONS.md`. Start with

docs/API.md

@@ -1,6 +1,6 @@
 # Java API
 
-Only `com.mcmoddev.orespawn.api` is supported API. Every other package is an
+Only `zone.moddev.mc.orespawn.api` is supported API. Every other package is an
 implementation detail. API major version is available as
 `OreSpawnApi.API_VERSION` and in the jar manifest as
 `OreSpawn-API-Version`.

docs/DEVELOPER_GUIDE.md

@@ -79,12 +79,12 @@ side="BOTH"
 Submit immutable definitions during `InterModEnqueueEvent`:
 
 ```java
-import com.mcmoddev.orespawn.api.GeologyFamily;
-import com.mcmoddev.orespawn.api.OreHeightDistribution;
-import com.mcmoddev.orespawn.api.OreDimensionSelector;
-import com.mcmoddev.orespawn.api.OrePattern;
-import com.mcmoddev.orespawn.api.OreSpawnApi;
-import com.mcmoddev.orespawn.api.WorldgenProvider;
+import zone.moddev.mc.orespawn.api.GeologyFamily;
+import zone.moddev.mc.orespawn.api.OreHeightDistribution;
+import zone.moddev.mc.orespawn.api.OreDimensionSelector;
+import zone.moddev.mc.orespawn.api.OrePattern;
+import zone.moddev.mc.orespawn.api.OreSpawnApi;
+import zone.moddev.mc.orespawn.api.WorldgenProvider;
 import net.minecraft.resources.ResourceLocation;
 import net.minecraftforge.fml.event.lifecycle.InterModEnqueueEvent;
 
@@ -107,7 +107,7 @@ private void enqueueWorldgen(InterModEnqueueEvent event) {
 }
 ```
 
-Only `com.mcmoddev.orespawn.api` is stable. Do not call classes in
+Only `zone.moddev.mc.orespawn.api` is stable. Do not call classes in
 `worldgen`, `integration`, `client`, or other implementation packages.
 
 Use `.quantity(8)` when every attempt should have a fixed budget. The selector

docs/PLAYER_GUIDE.md

@@ -12,6 +12,10 @@ For a normal game:
 3. Open **Help & Guide** for a plain-language tour of the controls.
 4. Press **Done**, then create the world normally.
 
+Hover over unfamiliar controls for a short explanation. The same explanations
+are collected in **Help & Guide**, so a setting can be learned either while
+editing it or one topic at a time.
+
 There is no requirement to use rock strata. Ore-only mods can use OreSpawn to
 place ores in ordinary vanilla stone while every geology control remains idle.
 When no provider supplies rocks, **Configure Rock Strata...** starts with a
@@ -50,6 +54,12 @@ safely instead of breaking world creation.
   style. Namespace scope protects other biome mods unless a pack deliberately
   opts them in.
 
+**World Materials** applies across an entire dimension. **Aquifer Fluid**
+changes the normal below-sea-level fluid, while **Deep Aquifer** can use a
+second fluid below a chosen Y level. Snow and ordinary ice can also be replaced.
+Use **Fluid Deposits**, not World Materials, for occasional underground lakes
+or pockets.
+
 ## Rocks, Ores, And Other Mods
 
 The material picker lists blocks from installed mods by full registry ID, for

gradle.properties

@@ -52,7 +52,7 @@ mod_version=4.0.1
 # The group ID for the mod. It is only important when publishing as an artifact to a Maven repository.
 # This should match the base package used for the mod sources.
 # See https://maven.apache.org/guides/mini/guide-naming-conventions.html
-mod_group_id=com.mcmoddev
+mod_group_id=zone.moddev.mc.orespawn
 # The authors of the mod. This is a simple text string that is used for display purposes in the mod list.
 mod_authors=SkyBlade1978, dshadowwolf, the MMD Team
 # The description of the mod. This is a simple multiline text string that is used for display purposes in the mod list.

src/main/java/com/mcmoddev/orespawn/OreSpawn.java → src/main/java/zone/moddev/mc/orespawn/OreSpawn.java

@@ -1,24 +1,24 @@
-package com.mcmoddev.orespawn;
-
-import com.mcmoddev.orespawn.integration.WorldgenIntegrationManager;
-import com.mcmoddev.orespawn.init.OreSpawnPatterns;
-import com.mcmoddev.orespawn.worldgen.OreSpawnOreGeneration;
-import com.mcmoddev.orespawn.worldgen.GeomeConfig;
-import com.mcmoddev.orespawn.worldgen.GeomeDistributionSampler;
-import com.mcmoddev.orespawn.worldgen.FluidDepositFeature;
-import com.mcmoddev.orespawn.worldgen.StoneReplacer;
-import com.mcmoddev.orespawn.worldgen.WorldGeologyProfileManager;
-import com.mcmoddev.orespawn.worldgen.FormationSettings.Preset;
-import com.mcmoddev.orespawn.OreSpawnConfig.GeologyMode;
-import com.mcmoddev.orespawn.worldgen.WorldGeologyProfile;
-import com.mcmoddev.orespawn.worldgen.WorldgenBenchmark;
-import com.mcmoddev.orespawn.worldgen.FlatBedrockFeature;
-import com.mcmoddev.orespawn.worldgen.OreRetrogenManager;
-import com.mcmoddev.orespawn.worldgen.BiomeSurfaceFeature;
-import com.mcmoddev.orespawn.worldgen.BiomeWorldgenBootstrap;
-import com.mcmoddev.orespawn.worldgen.WorldMaterialWeather;
-import com.mcmoddev.orespawn.commands.OreSpawnCommands;
-import com.mcmoddev.orespawn.documentation.DocumentationExporter;
+package zone.moddev.mc.orespawn;
+
+import zone.moddev.mc.orespawn.integration.WorldgenIntegrationManager;
+import zone.moddev.mc.orespawn.init.OreSpawnPatterns;
+import zone.moddev.mc.orespawn.worldgen.OreSpawnOreGeneration;
+import zone.moddev.mc.orespawn.worldgen.GeomeConfig;
+import zone.moddev.mc.orespawn.worldgen.GeomeDistributionSampler;
+import zone.moddev.mc.orespawn.worldgen.FluidDepositFeature;
+import zone.moddev.mc.orespawn.worldgen.StoneReplacer;
+import zone.moddev.mc.orespawn.worldgen.WorldGeologyProfileManager;
+import zone.moddev.mc.orespawn.worldgen.FormationSettings.Preset;
+import zone.moddev.mc.orespawn.OreSpawnConfig.GeologyMode;
+import zone.moddev.mc.orespawn.worldgen.WorldGeologyProfile;
+import zone.moddev.mc.orespawn.worldgen.WorldgenBenchmark;
+import zone.moddev.mc.orespawn.worldgen.FlatBedrockFeature;
+import zone.moddev.mc.orespawn.worldgen.OreRetrogenManager;
+import zone.moddev.mc.orespawn.worldgen.BiomeSurfaceFeature;
+import zone.moddev.mc.orespawn.worldgen.BiomeWorldgenBootstrap;
+import zone.moddev.mc.orespawn.worldgen.WorldMaterialWeather;
+import zone.moddev.mc.orespawn.commands.OreSpawnCommands;
+import zone.moddev.mc.orespawn.documentation.DocumentationExporter;
 
 import net.minecraftforge.common.MinecraftForge;
 import net.minecraftforge.fml.common.Mod;

src/main/java/com/mcmoddev/orespawn/OreSpawnConfig.java → src/main/java/zone/moddev/mc/orespawn/OreSpawnConfig.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn;
+package zone.moddev.mc.orespawn;
 
 import org.apache.commons.lang3.tuple.Pair;
 

src/main/java/com/mcmoddev/orespawn/api/BiomePlacementMode.java → src/main/java/zone/moddev/mc/orespawn/api/BiomePlacementMode.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Locale;
 

src/main/java/com/mcmoddev/orespawn/api/BiomeRegionSize.java → src/main/java/zone/moddev/mc/orespawn/api/BiomeRegionSize.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Locale;
 

src/main/java/com/mcmoddev/orespawn/api/BiomeReplacementScope.java → src/main/java/zone/moddev/mc/orespawn/api/BiomeReplacementScope.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Locale;
 

src/main/java/com/mcmoddev/orespawn/api/CompiledOrePattern.java → src/main/java/zone/moddev/mc/orespawn/api/CompiledOrePattern.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 /**
  * Immutable, pre-decoded ore pattern used during chunk generation.

src/main/java/com/mcmoddev/orespawn/api/FormationPreset.java → src/main/java/zone/moddev/mc/orespawn/api/FormationPreset.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 /** Named formation scales accepted by the world profile. */
 public enum FormationPreset {

src/main/java/com/mcmoddev/orespawn/api/GeologyAlgorithm.java → src/main/java/zone/moddev/mc/orespawn/api/GeologyAlgorithm.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 /** Supported terrain formation algorithms. */
 public enum GeologyAlgorithm {

src/main/java/com/mcmoddev/orespawn/api/GeologyColumn.java → src/main/java/zone/moddev/mc/orespawn/api/GeologyColumn.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Optional;
 

src/main/java/com/mcmoddev/orespawn/api/GeologyFamily.java → src/main/java/zone/moddev/mc/orespawn/api/GeologyFamily.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 /** Geological families understood by OreSpawn's declarative engines. */
 public enum GeologyFamily {

src/main/java/com/mcmoddev/orespawn/api/GeologyProfileView.java → src/main/java/zone/moddev/mc/orespawn/api/GeologyProfileView.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Collections;
 import java.util.LinkedHashSet;

src/main/java/com/mcmoddev/orespawn/api/GeologySampler.java → src/main/java/zone/moddev/mc/orespawn/api/GeologySampler.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 /** Reusable, read-only sampler for the active world's baked geology. */
 public interface GeologySampler {

src/main/java/com/mcmoddev/orespawn/api/OreDimensionSelector.java → src/main/java/zone/moddev/mc/orespawn/api/OreDimensionSelector.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Locale;
 

src/main/java/com/mcmoddev/orespawn/api/OreHeightDistribution.java → src/main/java/zone/moddev/mc/orespawn/api/OreHeightDistribution.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 /** Vertical distributions supported by OreSpawn-managed ores. */
 public enum OreHeightDistribution {

src/main/java/com/mcmoddev/orespawn/api/OrePattern.java → src/main/java/zone/moddev/mc/orespawn/api/OrePattern.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 /** Shapes supported by OreSpawn's bounded ore generator. */
 public enum OrePattern {

src/main/java/com/mcmoddev/orespawn/api/OrePatternType.java → src/main/java/zone/moddev/mc/orespawn/api/OrePatternType.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Objects;
 import java.util.function.Function;

src/main/java/com/mcmoddev/orespawn/api/OrePlacementContext.java → src/main/java/zone/moddev/mc/orespawn/api/OrePlacementContext.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Random;
 

src/main/java/com/mcmoddev/orespawn/api/OreSpawnApi.java → src/main/java/zone/moddev/mc/orespawn/api/OreSpawnApi.java

@@ -1,11 +1,11 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Optional;
 
-import com.mcmoddev.orespawn.OreSpawn;
-import com.mcmoddev.orespawn.integration.WorldgenIntegrationManager;
-import com.mcmoddev.orespawn.worldgen.WorldGeologyProfileManager;
-import com.mcmoddev.orespawn.worldgen.GeomeConfig;
+import zone.moddev.mc.orespawn.OreSpawn;
+import zone.moddev.mc.orespawn.integration.WorldgenIntegrationManager;
+import zone.moddev.mc.orespawn.worldgen.WorldGeologyProfileManager;
+import zone.moddev.mc.orespawn.worldgen.GeomeConfig;
 
 import net.minecraft.server.MinecraftServer;
 import net.minecraft.server.level.ServerLevel;

src/main/java/com/mcmoddev/orespawn/api/OreSpawnBiomes.java → src/main/java/zone/moddev/mc/orespawn/api/OreSpawnBiomes.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Objects;
 import java.util.function.Consumer;

src/main/java/com/mcmoddev/orespawn/api/OreSpawnGeologySampler.java → src/main/java/zone/moddev/mc/orespawn/api/OreSpawnGeologySampler.java

@@ -1,16 +1,16 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Locale;
 import java.util.Optional;
 
-import com.mcmoddev.orespawn.OreSpawnConfig.GeologyMode;
-import com.mcmoddev.orespawn.worldgen.BakedGeomeConfig;
-import com.mcmoddev.orespawn.worldgen.Geology;
-import com.mcmoddev.orespawn.worldgen.GeomeConfig;
-import com.mcmoddev.orespawn.worldgen.GeomeGeology;
-import com.mcmoddev.orespawn.worldgen.RockFamily;
-import com.mcmoddev.orespawn.worldgen.WorldGeologyProfile;
-import com.mcmoddev.orespawn.worldgen.WorldGeologyProfileManager;
+import zone.moddev.mc.orespawn.OreSpawnConfig.GeologyMode;
+import zone.moddev.mc.orespawn.worldgen.BakedGeomeConfig;
+import zone.moddev.mc.orespawn.worldgen.Geology;
+import zone.moddev.mc.orespawn.worldgen.GeomeConfig;
+import zone.moddev.mc.orespawn.worldgen.GeomeGeology;
+import zone.moddev.mc.orespawn.worldgen.RockFamily;
+import zone.moddev.mc.orespawn.worldgen.WorldGeologyProfile;
+import zone.moddev.mc.orespawn.worldgen.WorldGeologyProfileManager;
 
 import net.minecraft.core.BlockPos;
 import net.minecraft.core.Holder;

src/main/java/com/mcmoddev/orespawn/api/OreSpawnOreIntegration.java → src/main/java/zone/moddev/mc/orespawn/api/OreSpawnOreIntegration.java

@@ -1,9 +1,9 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.Set;
 
 import com.google.gson.JsonObject;
-import com.mcmoddev.orespawn.integration.WorldgenIntegrationManager;
+import zone.moddev.mc.orespawn.integration.WorldgenIntegrationManager;
 
 /**
  * Compatibility facade for the initial ore-provider status API.

src/main/java/com/mcmoddev/orespawn/api/OreSpawnPatternRegistry.java → src/main/java/zone/moddev/mc/orespawn/api/OreSpawnPatternRegistry.java

@@ -1,8 +1,8 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.function.Supplier;
 
-import com.mcmoddev.orespawn.OreSpawn;
+import zone.moddev.mc.orespawn.OreSpawn;
 
 import net.minecraft.resources.ResourceLocation;
 import net.minecraftforge.registries.IForgeRegistry;
@@ -16,10 +16,10 @@ private OreSpawnPatternRegistry() {
 	}
 
 	public static IForgeRegistry<OrePatternType> registry() {
-		return com.mcmoddev.orespawn.init.OreSpawnPatterns.registry();
+		return zone.moddev.mc.orespawn.init.OreSpawnPatterns.registry();
 	}
 
 	public static Supplier<IForgeRegistry<OrePatternType>> registrySupplier() {
-		return com.mcmoddev.orespawn.init.OreSpawnPatterns.registrySupplier();
+		return zone.moddev.mc.orespawn.init.OreSpawnPatterns.registrySupplier();
 	}
 }

src/main/java/com/mcmoddev/orespawn/api/ProviderStatus.java → src/main/java/zone/moddev/mc/orespawn/api/ProviderStatus.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 /** Lifecycle state of a OreSpawn world-generation provider. */
 public enum ProviderStatus {

src/main/java/com/mcmoddev/orespawn/api/StandardPatternSettings.java → src/main/java/zone/moddev/mc/orespawn/api/StandardPatternSettings.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import com.mojang.serialization.Codec;
 import com.mojang.serialization.codecs.RecordCodecBuilder;

src/main/java/com/mcmoddev/orespawn/api/WorldgenProvider.java → src/main/java/zone/moddev/mc/orespawn/api/WorldgenProvider.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;
 
 import java.util.ArrayList;
 import java.util.Collection;

src/main/java/com/mcmoddev/orespawn/api/package-info.java → src/main/java/zone/moddev/mc/orespawn/api/package-info.java

@@ -4,4 +4,4 @@
  * <p>Classes outside this package are implementation details and may change
  * between releases without an API-version change.</p>
  */
-package com.mcmoddev.orespawn.api;
+package zone.moddev.mc.orespawn.api;

src/main/java/com/mcmoddev/orespawn/client/AdvancedGeologySettingsScreen.java → src/main/java/zone/moddev/mc/orespawn/client/AdvancedGeologySettingsScreen.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.client;
+package zone.moddev.mc.orespawn.client;
 
 import com.mojang.blaze3d.vertex.PoseStack;
 

src/main/java/com/mcmoddev/orespawn/client/BiomePaletteScreen.java → src/main/java/zone/moddev/mc/orespawn/client/BiomePaletteScreen.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.client;
+package zone.moddev.mc.orespawn.client;
 
 import java.util.List;
 

src/main/java/com/mcmoddev/orespawn/client/BiomePickerScreen.java → src/main/java/zone/moddev/mc/orespawn/client/BiomePickerScreen.java

@@ -1,4 +1,4 @@
-package com.mcmoddev.orespawn.client;
+package zone.moddev.mc.orespawn.client;
 
 import java.util.ArrayList;
 import java.util.List;