NodeCraft - Resource Nodes & Extraction System

100% server-side mod introducing advanced resource nodes (iron, gold, diamond, emerald, netherite) featuring progressive extraction, cooldowns, and automatic respawning. Players do not need to install anything.

✨ Key Features

• Progressive Extraction & Cooldown: Dynamic nodes that deplete after multiple extractions, enter a cooldown state, and automatically respawn.
• Absolute Generation Control (Zero Automated Generation): If you are creating a new world or running an existing one and want to prevent any automated generation entirely (neither via native worldgen on terrain creation nor through the hot-exploration fallback for new chunks), you must explicitly disable both configuration parameters. If only one is disabled, the mod will still place nodes automatically. Set both to false:

  "enabled": false,
  "chunk_loading_enabled": false

  By doing this, your map remains completely clean and untouched, giving you absolute control to populate and delimit zones manually on-demand via commands (populate, fill, etc.).
• Extreme Surface & Air Versatility: By default, ores only spawn inside standard stone or deepslate. However, this mod is extremely versatile, allowing you to configure nodes anywhere, including right on the surface or suspended in mid-air. To achieve this:
  1. Add "minecraft:air" (or your desired surface blocks) into the resource's allowed_blocks list (for example, under iron).
  2. Configure the vertical layer boundaries properly (such as y_range or minimum/maximum height limits) so the resource is permitted to spawn at the target surface or altitude levels.
• Powerful Administrative Commands: Includes flexible tools like /rustnode populate, /rustnode fill (for community quarries or custom mining zones), /rustnode pregenerate, and /rustnode clear.
• Ghost Mode & Advanced Visuals: Fully compatible with traditional physical blocks or inert visual entities (advanced_visuals) that leave world blocks completely unaffected.
• Validation & Hot-Reload System: Strict syntax checks via /rustnode validate and instant configuration reloading with /rustnode reload without needing a server restart.

⚙️ Key Commands

• /rustnode populate radius <n>: Fills a region using the world's default density.
• /rustnode fill <from> <to> <resource|mixed> <amount>: Distributes an exact quantity of nodes within a precise cuboid zone.
• /rustnode pregenerate radius <n>: Generates terrain in optimized batches to prevent lag spikes.
• /rustnode reload: Instantly updates configuration changes at runtime.

📦 Compatibility & Installation

• Requirements: Minecraft 1.20.1, Forge (JDK 17).
• Place the .jar file into your dedicated server's mods/ directory. On its first launch, it will automatically generate a clean directory structure under config/rust_nodes/.

Support the Project
Nodecraft is provided free of charge to help server owners. If you would like to support its continued development and maintenance, voluntary contributions are welcome:
👉 Donate via PayPal