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

• 🐛 Open an issue
• ⭐ Star the project on GitHub

Made with ❤ by Remilulz_91.