Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Creators
Details
SkyblockCraft
A classic Skyblock experience for Minecraft 1.21.1 (Fabric), with a virtual coin economy and custom Sky Merchant villagers you can spawn anywhere.
⚠ This is an early alpha (v0.1.0-alpha.1). It is feature-functional but has not been battle-tested in production multiplayer. Please report any issues on the GitHub tracker.
Features
🏝 Generate your starter island
Run /island create and a classic Skyblock island appears, with you teleported on top: a small grass platform, an oak tree, a sand block with cactus, and a starter chest containing the essentials (lava bucket, ice, melon/pumpkin/sugar cane/wheat seeds, mushrooms, bone meal, oak saplings).
Use /island home to teleport back any time. If enabled in config, /island visit <player> lets you visit other players' islands.
Each island is placed on a spaced grid (default 512 blocks apart) centered at a configurable origin, so multiple players can have their own islands in the same world without overlap.
💰 Virtual coin economy
Every player has a coin balance, persisted at the world level (saved with the world, not the player file). You start with 100 coins by default — configurable.
/balance(alias/bal) — show your balance/balance <player>— check another player's balance (OP)/pay <player> <amount>— send coins to a friend
An optional max balance can be set per player; setting it to 0 means unlimited.
🧑🌾 Sky Merchant villagers
Spawn a custom merchant with /skyblock spawn merchant (OP). The villager is invulnerable, has its AI disabled (no wandering off), and is named "Sky Merchant" above its head.
Right-click the merchant and a chat-based shop appears with clickable [BUY] buttons next to each offer — for example 64× Dirt for 5 coins, 1× Iron Ingot for 30 coins, 1× Diamond for 150 coins. Clicking a [BUY] deducts the price from your balance and gives you the item.
Default offers cover everything a Skyblock player typically needs: dirt, oak logs, cobblestone, iron, gold, diamond, emerald, water bucket, lava bucket. The full list (and prices) is fully configurable in config/skyblockcraft.json — add your own offers, change prices, or remove the defaults. Use /skyblock reload to apply changes without restarting the server.
⚙️ Mod Menu + Cloth Config
If you have Mod Menu and Cloth Config installed, an in-game config screen with five categories appears (Islands, Economy, Merchant, UI, 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 (the one published here):
/skyblock debug …commands are completely unavailable, the Debug config category is hidden, and the build refuses to enable debug flags from the JSON config file even if an admin edits it. - Debug build (not published, available on GitHub Actions artifacts): all debug helpers enabled for testing.
The public build refuses to enable debug flags from the config file, even if a server admin manually edits skyblockcraft.json to flip enableDebugCommands to true. A warning appears in the server log and the flag is reset to false in memory. This means the public JAR has zero hidden cheat surface — you can trust it on production servers.
Commands cheat sheet
| Command | Permission | Effect |
|---|---|---|
/island create |
player | Generate your starter island and teleport you |
/island home (or /is home) |
player | Teleport to your island |
/island visit <player> |
player | Visit another player's island (if enabled) |
/island delete <player> |
OP | Delete a player's island record |
/balance (or /bal) |
player | Show your balance |
/balance <player> |
OP | Show another player's balance |
/pay <player> <amount> |
player | Transfer coins to another player |
/skyblock spawn merchant |
OP | Spawn a Sky Merchant at your position |
/skyblock buy <offerId> |
player | Used by the [BUY] click — usually not typed |
/skyblock reload |
OP | Reload skyblockcraft.json from disk |
/skyblock version |
player | Print mod version + build type |
Requirements
- Minecraft 1.21.1
- Fabric Loader ≥ 0.16.5
- Fabric API (required)
- Cloth Config (optional — enables the in-game config GUI)
- Mod Menu (optional — exposes the config GUI in the mod list)
- Java 21
- Mod must be installed on both client and server
Roadmap
Planned for v0.2:
- Real
ScreenHandler-based merchant GUI (instead of chat-based shop) - Island protection (other players can't break/place blocks on your island)
- Multiple merchant categories (Farmer, Miner, Adventurer…)
- Per-player starter island in a dedicated dimension
If you have feature requests, please open an issue on GitHub!
Bug reports & contributions
Made with ❤ by Remilulz_91.