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.

Villager Spawn Egg 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. EnderWorld Eggs let you move or attempt to capture NPCs.

Auction House Black Market Quest System Egg Mechanic
Iron Pickaxe 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
Grass Block Top Island Management

Island Permissions & Co-Op

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

4 Visit Modes Co-Op Trust Guest Book Shared Progression
Totem Of Undying 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
Fishing Rod 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
Barrel Top Quality of Life

Storage & Automation

Sign-programmed filter hoppers, sortable chests, wireless hopper routing, a void item vacuum surfaced through the Guest Book, a material compactor, and up to 3 island waypoints.

Filter Signs Sortable Chests Wireless Hoppers Material Compactor
Paper
Feather
Iron Pickaxe
Anvil
Blaze Powder
Compass 00
Apple
Hopper
Wheat Seeds
Player Inventory

Scrolls & Enchantments

Browse the implemented consumable scrolls and stackable custom 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 spend an EnderWorld Egg on them - shapes your entire economy.

Villager Spawn Egg 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 fully tradeable
  • Relocate with an EnderWorld Egg
Witch Spawn Egg Black Market

The Thief

Server-to-player contraband shop. Every 30 minutes the Black Market rolls one global offer from black-market.yml, with rare spawner offers acting as the server's primary money sink.

  • One random global offer every 30 minutes
  • Spawner offers with configurable rare odds
  • Merchant Discount Scroll integration
  • Relocate with an EnderWorld Egg
Written Book Quest Master

The Clerk

Hands out gather, break, craft, and fishing 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.

  • Quest types: gather, break, craft, fish
  • Max 3 concurrent quests per player (configurable)
  • Rewards: currency, XP, and items
  • Repeatable, daily, weekly, and monthly schedules
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.

Barrel Top

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.

Redstone

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.

Fishing Rod

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.

Anvil

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.

Hopper

Smart hopper caching

Hopper filters and wireless routing are controlled by nearby signs. Receiver lookups are cached by island code, so repeated hopper moves stay light.

Ender Pearl

Stacked item drops

Nearby similar item entities merge into labelled mega-stacks, then split back into normal inventory stacks during pickup. Large farms create fewer ground entities.

Spawner

Stacked spawners

Players combine spawners by right-clicking an existing spawner with another one. Holograms show the count, stacked spawns scale output, and Silk Touch removes one at a time.

Iron Chestplate

Modular by design

Every scroll duration, enchantment trigger, quest reward, price limit, and generator weight is configurable in split YAML files - 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 or forks required; MySQL schema changes are handled by bundled migrations.

PaperMC

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

Coming Soon

Spigot

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

Coming Soon

Purpur

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

Coming Soon

Folia

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

Coming Soon

Requires Java 21+ and Paper 1.21.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.

Nether Star

Star the Repo

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

Book

Report & Test

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

Emerald

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.