SkyblockCraft

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.