SkyblockCraft

A classic Skyblock experience for Minecraft 1.21.1 (Fabric): generate your island, earn coins with passive generators, trade with four types of custom Sky Merchant villagers, and protect your build with a co-op trust system.

⚠ Still in alpha — feature-complete for its current scope and tested in solo/small-multi, but expect the occasional edge case. Bug reports and feedback very welcome (form linked below).

---

Features

🏝 Islands with protection and leveling

• /island create generates a classic starter island (grass platform, oak tree, sand + cactus, starter chest with lava bucket, ice, seeds, bone meal, saplings) and teleports you to it.
• /island home brings you back any time. /island visit <player> to see friends' builds.
• Automatic protection in a configurable zone around each island (default 49×49) — only the owner and trusted players can build or break. Chests, doors and other interactions stay free so visitors can look around.
• Co-op trust with /island trust <player> / /island untrust <player> / /island trusted — trusted players get owner-level build rights on your island.
• Island level derived from placed blocks (default: 1 level per 100 blocks). /island level shows your progress. /island top lists the top 10 islands server-wide, owner names resolved even for offline players.
• Islands sit on a spaced grid (default 512 blocks apart) so many players coexist in the same world without overlap.

💰 Virtual coin economy

• Persistent per-player balance, saved with the world.
• /balance (alias /bal) shows your funds. /pay <player> <amount> transfers to another player.
• Starting balance, max balance, minimum /pay amount all configurable.

🧑‍🌾 Sky Merchant villagers — four types, real GUI, buy AND sell

Spawn a merchant with /skyblock spawn merchant <type> (OP). Four flavors:

• Farmer — seeds, crops, farm produce
• Miner — stone, ores, ingots, diamond, emerald
• Adventurer — torches, food, buckets, ender pearls, blaze rods, mob loot
• General — bulk building blocks + coin generators

Right-click a merchant to open a real chest-style GUI (6 rows × 9 slots). Top row has tabs: BUY (emerald) and SELL (gold). Click any offer to buy or sell in one click — hover shows the price. Each merchant has its own set of buys and buybacks, all configurable in config/skyblockcraft.json and reloadable via /skyblock reload.

Merchants are truly invulnerable (blocked at damage-event level, works even against creative players). To remove one, use /skyblock remove merchant — it removes the nearest merchant within 20 blocks.

⛏ Coin generators — three tiers of passive income

Custom blocks sold by the General merchant. Place one on your island and it generates coins directly into your balance while you're online:

Tier	Rate	Price
Basic (emerald-textured)	1 coin / min	500 coins
Advanced (gold-textured)	5 coins / min	3 000 coins
Elite (diamond-textured)	15 coins / min	15 000 coins

Rules:

• Only the placer earns coins (even if the generator sits on a friend's island).
• Offline placers' generators stop paying (no infinite AFK farming).
• Capped at 5 generators per island by default (configurable).
• Break with any tool — the block drops normally.

⚙️ Mod Menu + Cloth Config

If Mod Menu and Cloth Config are installed, an in-game config screen exposes all settings across five categories: Islands, Economy, Merchant, Interface, and Debug (visible only in the debug build).

🔒 Public + Debug dual build with hardened security

Two JAR variants are produced from the same source:

• Public build (published here): /skyblock debug … commands don't exist, the Debug config category is hidden, and debug flags are refused at runtime even if a server admin edits skyblockcraft.json to enable them. A warning is logged and the flag is reset.
• Debug build (not published, available as GitHub Actions artifact): all debug helpers enabled for testing.

Zero hidden cheat surface on production servers.

---

Commands cheat sheet

Command	Permission	Effect
/island create	player	Generate your starter island and teleport there
/island home (or /is home)	player	Teleport to your island
/island visit <player>	player	Visit another player's island
/island level	player	Show your island level and placed-block count
/island top	player	List the top 10 islands by level
/island trust <player>	player	Allow a player to build on your island
/island untrust <player>	player	Revoke build rights
/island trusted	player	List trusted players
/island delete <player>	OP	Delete a player's island record
/balance (or /bal)	player	Show your balance
/pay <player> <amount>	player	Send coins to another player
/skyblock spawn merchant <type>	OP	Spawn a Farmer / Miner / Adventurer / General
/skyblock remove merchant	OP	Remove the nearest merchant within 20 blocks
/skyblock reload	OP	Reload skyblockcraft.json from disk
/skyblock version	player	Show mod version + build type

---

Requirements

• Minecraft 1.21.1 (exact — the mod refuses to load on other 1.21.x versions)
• Fabric Loader ≥ 0.16.5
• Fabric API (required)
• Cloth Config + Mod Menu (optional — enable the in-game config GUI)
• Java 21
• Installed on both client and server

---

Roadmap

Ideas for the next versions (subject to feedback):

• Permanent HUD (balance + island level always visible)
• Bank with daily interest + connection bonus + /baltop
• Paid island upgrades (extend protection radius, regenerate starter chest, alternative starter templates — desert, snow, nether)
• Custom sounds and particles on merchant/generator interactions

Got a feature idea or found a bug? Fill out this Google Form — takes 30 seconds.

---

Made with ❤ by Remilulz_91.