🧱 OneBlock (Fabric 1.21.10)

⚡ Major Update Notice (v2.1.0 and up)
This version of OneBlock marks a major leap forward — introducing true multiplayer support, smarter dynamic block weighting, and a refined progression system.
It’s smoother, more balanced, and ready for both solo and server adventures.
⚡ Fully backwards compatible! Any solo progress will be carried over to the new world and new system!

Highlights:

• 🏝 Multiplayer Islands: Each player can now have their own island and OneBlock.
• ⚖️ Dynamic Weighting System: Block rarity smoothly shifts as you progress — early game favors useful materials like wood and ores, late game becomes fully random.
• 💾 Global Save Migration: Old saves automatically import legacy data and remain fully playable.
• 🌊 Aquatic Spawns: Friendly mobs can now spawn underwater when a nearby water pool is present.
• 🔥 Improved Progression Curve: Block variety, event frequency, and mob scaling now adapt seamlessly to your world’s difficulty.

---

🌍 Overview

Start your journey on a small floating island centered around the regenerating OneBlock.
Every time you break it, a new block appears — from dirt and wood to rare ores and nether materials.
Progress unlocks new tiers, and random events keep every break unpredictable.

Now, with multiplayer mode, each player can carve out their own island or share one collaboratively, depending on the datapack configuration.

---

🧱 Installation & Setup

Installing OneBlock (Fabric 1.21.10) is easy!

💻 Singleplayer (Client-Hosted)

1. Install Fabric for Minecraft 1.21.10.
   👉 Download Fabric Loader
2. Install Fabric API from Modrinth:
   👉 Fabric API on Modrinth
3. Place the downloaded OneBlock-<version>.jar into your Minecraft mods folder.
4. Launch Minecraft using the Fabric profile.
5. Create a new world and choose the OneBlock world type.
6. (Optional) Enable the built-in Nether and End datapacks for void-style dimensions.

🎮 That’s it! You’ll spawn on your small island with the regenerating OneBlock at its center.

---

🌐 Multiplayer (Server-Hosted)

1. Set up a Fabric server for Minecraft 1.21.10.
2. Install Fabric API and place it alongside the OneBlock mod in your mods folder.
3. To enable multiplayer mode, add oneblock:oneblock_multiplayer to initial-enabled-packs in your server’s server.properties file. Without the multiplayer pack, everyone will share the same central OneBlock — perfect for cooperative play.
4. Start the server once to generate world data.
5. Play and enjoy!

---

🌴 Starting Island

Instead of a single floating block, you now start on a two-layer island, providing a safe, natural beginning.

• 🟩 Overworld: Grass at Y=63, dirt beneath at Y=62.
• 🔥 Nether: Netherrack island.
• 🪨 End: End Stone island.

Your OneBlock sits at Y=64 — the heart of your world.

If multiplayer mode is enabled, every player gets their own island 1000 blocks apart in a cross-patterned grid.

---

⚖️ Dynamic Block Weighting

A new weighting system controls which blocks spawn as you progress:

• Early game (0–2,500 breaks): Mostly useful materials — wood, ores, planks.
• Mid game (2,500–5,000): Balanced mix of structural and resource blocks.
• Late game (5,000–10,000): Weighting fades out — rare blocks become common.
• 10,000+ breaks: Fully random. Every allowed block has equal chance to appear.

Stage	Useful Materials	Structural	Rare	Random
0 – 2,500	70%	25%	5%	0%
2,500 – 5,000	50%	35%	5%	10%
5,000 – 7,500	30%	40%	5%	25%
7,500 – 10,000	10%	35%	5%	50%
10,000+	0%	0%	0%	100%

The weighting fades linearly, ensuring natural progression and less grind.

For a detailed breakdown of the math behind weighting and drop groups, visit the
👉 OneBlock GitHub Repository.

---

🎲 Random Events

Every block break can trigger something unexpected:

• 🪙 Item Drop: Spawns a random item nearby.
• 💀 Monster Attack: Instantly spawns enemies around your island.
• 🐑 Friendly Visit: Summons peaceful mobs, or even a trader with llamas.

Event frequency and danger scale with your world difficulty.

---

💀 Monster Waves

Monster waves are now instant events — no countdowns or delay.

• Easy: Waves are rare and small.
• Normal: Balanced threat and reward.
• Hard: Frequent, large, and dangerous waves.
• Scales with your total OneBlock breaks and difficulty.
• Spawns are validated to avoid air or unsafe blocks.
• Works in all dimensions.

Stage	Typical Enemies
Early	Zombies, Spiders
Mid	Skeletons, Creepers, Husks
Late	Strays, Endermen, mixed chaos waves

---

🐾 Friendly & Aquatic Mobs

Your island evolves with life as you play:

• 🐮 Farm Animals: Cows, pigs, sheep, chickens, rabbits.
• 🐝 Neutrals: Wolves, llamas, bees, foxes.
• 🦜 Ambient: Parrots, cats, turtles.
• 🐠 Aquatic: Fish, axolotls, frogs, and dolphins (if your island has a 5×5 pool of water).
• 🧙 Wandering Traders: Occasionally visit with llamas and unique trades.

---

💾 Compatibility & Save Migration

OneBlock v2.1.0 is backward-compatible with older saves.
When you load an older world:

• Your old statistics (totalOneBlockBreaks, MobSpawnSet, etc.) are automatically migrated into the new global format.
• Multiplayer worlds use per-player islands and persistent stats.
• Legacy saves are announced with a server message confirming import.

You can safely continue your existing progress without data loss.

---

⚙️ Gameplay Summary

• You start on a stable island with a regenerating OneBlock.
• Each break can trigger instant events — both good and bad.
• Difficulty and block progression evolve as you play.
• Friendly mobs, aquatic life, and traders bring new life to your island.
• Multiplayer support adds personal islands for every player.

---

🧩 Features Overview

• 🏝 Per-Player Islands: Unique spawns for each player in multiplayer mode.
• ⚖️ Dynamic Weighting: Gradually shifts block rarity and type over time.
• 💾 Automatic Legacy Migration: Old saves are upgraded on load.
• 💀 Instant Monster Waves: Reactive combat encounters.
• 🐾 Friendly & Aquatic Spawns: Adds variety and color to the void.
• 🌋 Nether & End Support: Optional void-style dimensions.
• 🧱 Tiered Progression: Unlocks materials as you advance.
• 🪙 Random Events: Keeps gameplay unpredictable.
• 💬 Update Checker: Notifies you if a new version is available on Modrinth.
• 💾 Persistent Data: Tracks stats per player or globally, depending on pack mode.

---

🗺️ Development Roadmap

✨ Upcoming Additions

• ⚔️ Boss Waves: Rare high-difficulty encounters with custom drops.
• 🧱 Custom Structures: Random ruins, shrines, and loot islands.
• 🧙 Mystery Blocks: Special blocks with unique one-time effects.
• 💬 Quest Log & Achievements: Milestone-based rewards.

🧭 Long-Term Goals

• 🌌 Endgame Realms: Post-End survival dimensions.
• 🕹️ Multiplayer Events: Cooperative and competitive challenges.
• 🧠 Adaptive Scaling: Difficulty that reacts to player behavior.
• 🔧 Mod Support: Broader Fabric ecosystem compatibility.

---

💬 A Note from the Developer

Version 2.1.0 builds on everything we’ve learned from OneBlock’s evolution.
The goal was to make the experience smoother, fairer, and more expandable — for both singleplayer and multiplayer.

Your feedback shaped this update, from weighted block balancing to full legacy migration.
Thank you for continuing to support and enjoy the project. 💙

---

💬 Support & Feedback

Found a bug or have an idea? Let’s make OneBlock better together!

• 📜 Full changelog:
  👉 Changelog

• 🐛 Report issues or request features:
  👉 GitHub Issues

• 💬 Join the community on Discord:
  👉 Join the OneBlock Discord Channel

---

“It all begins on one small island — what you build from there is entirely up to you.”