Multiplayer Island Plugin - In Development

Wake up.
Build your empire.

You wake up on a small patch of land with nothing but a chest and three strangers. Craft, gather, fight, trade. Every choice shapes the island you leave behind. WoSBlock is the multiplayer server plugin for players tired of the same old island grind.

3Core NPCs
20Custom Scrolls
20Enchantments
10+Major Systems
Explore the plugin

Every system. Documented.

From your first cobblestone to your island's first trade deal, every system was built to reward progress. Click any card to see how it works.

🧑‍💞 Economy Core

The Three NPCs

Three invulnerable merchant NPCs spawn from your starter chest. An Auctioneer who enforces price limits, a Thief running the black market, and a Clerk handing out quests. Throw an egg at any of them and the whole dynamic shifts.

Auction House Black Market Quest System Egg Mechanic
⛏ïļ Performance Core

Cobblestone Generator

Progressive ore generation with O(1) flat-array weight caching. Block events fire thousands of times per minute - generator lookups never slow your TPS. Levels up through mining and XP Scrolls.

O(1) Cache Ore Weighting Gen XP Shared Island Level
🏝ïļ Island Management

Island Permissions & Co-Op

Four visit modes from Friendly to FFA, a co-op trust system with shared generator progress, and a physical Enchanting Table "Guest Book" that tracks and displays full island stats to every visitor.

4 Visit Modes Co-Op Trust Guest Book Shared Progression
🏆 Ranking System

Trophy Hall

Five rarity tiers of physical achievement trophy heads. Place them on your island to climb the leaderboard - remove them and your rank drops. The server always knows what you've actually earned.

5 Rarity Tiers Live Leaderboard Physical Heads Milestone Rewards
ðŸŽĢ Custom Fishing

RPG Fishing Mechanics

Vanilla fishing is fully intercepted within island boundaries. Five loot tiers (Common → Legendary) with weight tables cached at startup for high-population performance. Two custom rod enchantments.

5 Loot Tiers Custom Items Startup Cache Rod Enchants
ðŸ“Ķ Quality of Life

Storage & Automation

Filter hoppers with whitelist/blacklist modes, one-click auto-sorting chests, a void item vacuum that reroutes drops to the Guest Book buffer, a material compactor, and up to 3 island waypoints.

Filter Hoppers Auto-Sort Void Vacuum Material Compactor
📜
ðŸŠķ
⛏ïļ
🔧
⚡
ðŸ§ē
🍎
ðŸ“Ą
ðŸŒŋ
Player Inventory

Scrolls & Enchantments

Browse all 20 consumable scrolls and 20 permanent enchantments laid out in classic Minecraft inventory slots - hover any item for full stats and rarity.

Meet the cast

Every island starts with three strangers

Crack open your starter chest and you'll find three spawn eggs. What you do with them - trade through them, take quests from them, or chuck a regular egg at them - shapes your entire economy.

🏛ïļ Player Market

The Auctioneer

Your island's localized auction house. A GUI enforces server-configured min and max prices per item so nobody corners the market on day one - and nobody undercuts it into worthlessness either.

  • Player-to-player GUI trading
  • Per-item min/max price limits
  • Mob drops & eggs fully tradeable
  • Relocate with a thrown vanilla egg
ðŸĶđ Black Market

The Thief

Server-to-player contraband shop. Sells items the Auctioneer won't touch. His spawner sub-menu rotates daily with 1% spawn odds and luxury prices - the server's primary money sink.

  • Contraband items blocked on Auction House
  • Spawner sub-menu (configurable â‰Ī1% rotation)
  • Merchant Discount Scroll integration
  • Relocate with a thrown vanilla egg
📋 Quest Master

The Clerk

Hands out gather, break, craft, aquatic, and resource quests - up to 3 active at once per player, tracked completely individually even on a shared co-op island. Turn one in, claim the reward, take the next.

  • 5 quest types: gather, break, craft, fish, collect
  • Max 3 concurrent quests per player (configurable)
  • Rewards: currency, XP, items, or console commands
  • Relocate with a thrown vanilla egg
Under the hood

Drop it in. Let 200 players loose.

Every system was benchmarked against one scenario: a full multiplayer server with 200 players mining, fishing, and trading at the same time. Here's how we kept TPS stable.

🗄ïļ

Async storage, either way

Flat-file (YAML/JSON) or MySQL via HikariCP connection pooling, toggled with one storage-type line in config.yml. Every query runs off the main thread via BukkitRunnable#runTaskAsynchronously.

⚡

O(1) generator lookups

Cobble gen chances pre-baked into a flat 100-element array at plugin init. BlockFromToEvent fires thousands of times per minute - there's zero file I/O or weight math inside the event loop.

ðŸŽĢ

Cached fishing tables

Loot tier weights are parsed once on startup and cached into an optimised index array. When hundreds of players are fishing at once, the system stays fast.

🔧

Zero physics waste

Block state updates inside the fluid generation event pass false to the physics update flag, disabling unneeded neighbourhood checks and saving meaningful CPU cycles per event.

ðŸ“Ķ

Smart hopper caching

Filter hoppers use metadata lookups over iterative runtime matrix scans. Item pass-through chains never lock up - items are pushed down the line when a container is full.

ðŸ›Ąïļ

Modular by design

Every scroll duration, enchantment trigger, quest reward, price limit, and generator weight is configurable in config.yml - no code changes required to balance the entire economy.

Server compatibility

One plugin. Every major server platform.

WoSBlock is a standard Bukkit plugin. Drop the JAR into your plugins/ folder and restart. No extra dependencies, no config migrations, no forks required.

PaperMC

Primary target. Full support for Paper's async chunk API and event optimisations.

Comming Soon

Spigot

Built against the Bukkit API. Runs on Spigot with no changes to the JAR.

Comming Soon

Purpur

Purpur extends Paper. WoSBlock runs on Purpur out of the box.

Comming Soon

Folia

Regionalised threading support is on the roadmap for the post-launch milestone.

Comming Soon

Requires Java 17+ and Minecraft 1.20.4+. Coming soon to Hangar, SpigotMC, and Modrinth.

100% Free & Open Source

Support this free plugin's development

WoSBlock is built and maintained entirely for free. No paywalls, no premium tiers, no locked features. Every system in this spec will be publicly released. Donate to speed up development and get early access when the plugin launches.

⭐

Star the Repo

Help others discover the project and show your support - takes 2 seconds.

🐛

Report & Test

Find bugs, test new builds, and open issues on GitHub. Essential during active development.

💸

Donate

Back the project on PayPal to speed up development and get early access when WoSBlock launches.

Donate via PayPal →
Get involved

Your island is waiting. Where do you start?

Join the Discord to follow development, share feedback, and be among the first to set foot on your island when WoSBlock launches.