HTSkyBlock
Please not this is early days and alot can change each update. If you want to support me i made a server list site the ads on it will help me with a passive trickle ;) hytale-server-list.nbt-data.com
Join our discord here:
https://discord.gg/y6RemcjSaD
Small Showcase video https://youtu.be/Vasb6i8pClo If you want to showcase mode please share link and ill add it here If you want to support me i made a server list site teh ad on it will help me witha passive trickle ;) Hytale Server List
Commands Table Command Permission Description /island htskyblock.island Main island command - shows help or creates island /island create htskyblock.island.create Create your personal island /island home htskyblock.island.home Teleport to your island /island sethome htskyblock.island.sethome Set your personal home location /island setspawn htskyblock.island.setspawn Set where visitors spawn /island reset htskyblock.island.reset Reset your island (with confirmation) /island settings htskyblock.island.settings Open island settings UI /island visit htskyblock.island.visit Browse public islands /island goto [player] htskyblock.island.goto Visit a specific player's island /island members htskyblock.island.members Manage island members /island leave htskyblock.island.leave Leave the island you are visiting /island top htskyblock.island.top View island leaderboard /island info htskyblock.island.info Show your island information /island calc htskyblock.island.calc Recalculate your island rank /island expel htskyblock.island.expel Expel all visitors from your island /island requests htskyblock.island.requests View pending visit requests /island accept [player] htskyblock.island.accept Accept a visit request /island deny [player] htskyblock.island.deny Deny a visit request /island denyall htskyblock.island.denyall Toggle auto-deny all requests /island fly htskyblock.island.fly Toggle fly mode on your island /island upgrade htskyblock.island.upgrade Upgrade island size (single-world mode) /island help htskyblock.island.help Show island commands /balance (or /bal) htskyblock.balance Check your balance /shop htskyblock.shop Open the shop UI /spawn htskyblock.spawn Teleport to spawn /htskyblock reload htskyblock.admin.reload Reload config and data /htskyblock help htskyblock.admin.help Show admin help /adminbalance add [player] [amount] htskyblock.admin.balance.add Add money to a player /adminbalance remove [player] [amount] htskyblock.admin.balance.remove Remove money from a player /adminbalance set [player] [amount] htskyblock.admin.balance.set Set a player's balance /adminbalance check [player] htskyblock.admin.balance.check Check a player's balance Configuration Guide
The config.json file is located in plugins/HTSkyBlock/ and is created automatically on first run.
Per-World vs Single-World Mode
The plugin supports two island modes controlled by the "mode" setting inside the "island" section:
per_world - Each player gets their own private world for their island. This gives maximum isolation and no limit on island size, but uses more server resources.
single_world - All islands exist in one shared world. Islands are placed on a grid with spacing between them. This uses fewer resources but requires boundary enforcement.
To switch between modes, change the "mode" value:
Set "mode": "perworld" for separate worlds per player Set "mode": "singleworld" for all islands in one world
When using single_world mode, you can configure:
"sharedWorldName": "skyblock_islands" - the name of the shared world "singleWorldSpacing": 500 - distance between island centers Island Tiers System (Single-World Mode Only)
Tiers control the buildable area size of each island. Players start at Tier 1 and can upgrade to larger tiers.
Tier Default Size Upgrade Cost Tier 1 50x50 blocks Starting tier Tier 2 100x100 blocks 10,000 Tier 3 150x150 blocks 50,000 Tier 4 200x200 blocks 200,000
You can customize these sizes in config:
"tier1Size": 50 "tier2Size": 100 "tier3Size": 150 "tier4Size": 200
And the upgrade costs:
"tier2UpgradeCost": 10000 "tier3UpgradeCost": 50000 "tier4UpgradeCost": 200000 Switching from Score to Economy for Upgrades
The "upgradeCurrencyType" setting controls what players spend to upgrade their island size.
score - Players spend their island score (points earned from placing blocks) to upgrade. The score is consumed when upgrading.
economy - Players spend in-game currency (coins) to upgrade.
To switch:
Set "upgradeCurrencyType": "score" to use island points Set "upgradeCurrencyType": "economy" to use money Economy Provider Options
The plugin can use its own built-in economy or connect to TheEconomy plugin.
self - Uses the built-in economy system. Player balances are stored in plugins/HTSkyBlock/playerdata.json
theeconomy - Uses TheEconomy plugin as the balance provider. HTSkyBlock will read/write balances through TheEconomy's API.
To switch economy providers, change the "provider" value in the "economy" section:
Set "provider": "self" for built-in economy Set "provider": "theeconomy" to use TheEconomy plugin
When using theeconomy provider, the /adminbalance commands will show a message directing you to use TheEconomy's admin commands instead.
You can also set:
"startingBalance": 0.0 - how much money new players receive "currencySymbol": "$" - displayed before amounts "currencyFormat": "#,##0.00" - number formatting pattern MC Color Codes Feature
The plugin supports standard color codes in all translation files and UI text.
Basic Color Codes
Use & or § followed by a code:
&0 = Black &1 = Dark Blue &2 = Dark Green &3 = Dark Aqua &4 = Dark Red &5 = Dark Purple &6 = Gold &7 = Gray &8 = Dark Gray &9 = Blue &a = Green &b = Aqua &c = Red &d = Light Purple &e = Yellow &f = White Formatting Codes &l = Bold &o = Italic &r = Reset all formatting Hex Colors
You can use custom hex colors in two formats:
Leading hex: Start any message with #RRGGBB Example: #FF6600This text is orange
Inline hex: Use &#RRGGBB anywhere in text Example: Hello &#FF0000red �FF00green text
Examples in Translation Files
"success_message": "&aSuccess! &7The action completed." This shows "Success!" in green followed by gray text.
"error_message": "&c&lERROR: &fSomething went wrong" This shows "ERROR:" in bold red followed by white text.
"custom_color": "#FF6600This is custom orange text" This shows the entire message in a custom orange color.
Translation System
All text in the plugin can be translated by editing language files.
Language Files Location
Language files are stored in: plugins/HTSkyBlock/lang/
The default file is en.json (English). The plugin creates this automatically.
Setting Your Language
In config.json, change the "language" setting:
"language": "en" for English "language": "de" for German "language": "es" for Spanish
Create a new JSON file for any language you want (example: fr.json for French).
Translation File Structure
The files use nested JSON with dot-notation keys internally. Here is how to structure entries:
For a simple message: "general": { "error": "#FF0000An error occurred: {error}", "no_permission": "#FF0000You do not have permission." }
For messages with placeholders, use {placeholder_name}: "island": { "sethome": { "success": "#00FF00Home set to {x}, {y}, {z}!" } }
Translating Commands and Descriptions
Commands can be fully translated in the "commands" section of the language file. This changes both the command name players type and the description shown in help.
Example structure:
"commands": { "island": { "name": "island", "description": "Island commands", "create": { "name": "create", "description": "Create your personal island" }, "home": { "name": "home", "description": "Teleport to your island" }, "goto": { "name": "goto", "description": "Visit a player's island", "args": { "player": "Player name" } } }, "balance": { "name": "balance", "aliases": "bal", "description": "Check your balance" }, "shop": { "name": "shop", "description": "Open the shop" }, "spawn": { "name": "spawn", "description": "Teleport to spawn" } }
To translate a command:
Change the "name" value to your translated command word Change the "description" value to your translated description For commands with arguments, translate the "args" values
Example translating to German:
"commands": { "island": { "name": "insel", "description": "Insel-Befehle", "create": { "name": "erstellen", "description": "Erstelle deine persönliche Insel" }, "home": { "name": "zuhause", "description": "Teleportiere zu deiner Insel" } }, "balance": { "name": "kontostand", "aliases": "geld", "description": "Überprüfe dein Guthaben" } }
After this translation, players would type /insel erstellen instead of /island create.
Creating a New Language Copy en.json and rename it to your language code (example: pt.json for Portuguese) Translate all the text values (keep the keys the same, only change the values) Set "language": "pt" in config.json Reload the plugin with /htskyblock reload
The plugin always loads English first as a fallback, so any missing translations will show in English.
0 Comments