P E R F E C T ONEBLOCK
The ultimate OneBlock gamemode for Hytale servers
// WHY PERFECTONEBLOCK?
PerfectOneBlock is a complete, standalone OneBlock gamemode for Hytale. Break one block, a new one spawns. Progress through 5 unique phases, unlock mobs, earn money, upgrade your island, and compete with other players.
Everything is built-in: economy, shop, quests, auction house, prestige, scoreboard, teams — no dependencies required. Or plug it into your existing network currency via the new external economy bridges (PerfectEconomy, EliteEssentials, Ecotale).
Fully configurable via JSON files — admins can customize phases, blocks, shop items, quests, prices, and more without touching any code.
// NEW IN v1.2
- EXTERNAL ECONOMY BRIDGES
PerfectOneBlock can now delegate every balance operation (deposit, withdraw, balance query) to an external economy plugin. Three providers supported out of the box: PerfectEconomy, EliteEssentials and Ecotale. Perfect for network owners who want a single unified currency across all their servers. - AUTO-DETECTION AT STARTUP
By default the plugin tries PerfectEconomy > EliteEssentials > Ecotale and falls back to the internal JSON economy if none is present. Zero configuration if you already run one of them. Look for a boot log line like "Economy bridge connected: Ecotale" to confirm. - NEW CONFIG OPTION
economyProvider in config.json accepts: "auto" (default), "perfecteconomy", "eliteessentials", "ecotale", or "self" / "internal" to force the built-in JSON economy regardless of what else is installed. - CURRENCY SYMBOL PROPAGATION
When an external bridge is active, the currency symbol from that provider (e.g. Ecotale's HUD prefix) is used across the entire PerfectOneBlock UI for a consistent look.
// FEATURES
- 5-Phase Progression System
Progress through Emerald Grove, Underground, Howling Sands, Borea, and Devastated Lands. Each phase has its own weighted block pool, mob spawns, and chest loot. Fully configurable via phases.json. - Built-in Economy + External Bridges
Complete currency system with player balances, island bank (shared team balance), /ob pay transfers, and daily rewards. Use the internal JSON economy or delegate to PerfectEconomy, EliteEssentials or Ecotale for network-wide currency. - Grid Shop
Beautiful 5x3 grid layout with item icons, names, and prices. Category navigation, pagination, and a x1/x10 buy toggle. Sell items back too. All items and prices configurable via shop.json. - Auction House
Player-to-player trading system. List items for sale, browse listings, buy from other players. Auto-expiry cleanup and full UI. - Quest System
Daily quests with automatic rotation + milestone quests for long-term goals. 7 quest types: mine blocks, kill mobs, sell items, reach phase, earn money, upgrade island, prestige. Configurable via quests.json. - Prestige System
6 prestige levels — reset your island, keep your team, earn permanent sell multipliers (x1.0 to x3.0). Configurable multipliers and costs. - Island Upgrades
6 island tiers that increase your build area (50 to 300 blocks). Each tier has a configurable cost. - Team System
Invite players, manage members with promote/demote/kick. Roles with permissions. Shared island and bank balance. - Live Scoreboard
Always-visible HUD showing island level, phase, blocks, money, prestige, fly timer, combo streak, quest progress, and border proximity warning. Updates every second. - Combo System
Break blocks fast to build a combo multiplier! x1.5 at 5 combo, x2.0 at 15, x2.5 at 30, x3.0 at 50+. Bonus coins and visual feedback. - Island Level System
Calculated from blocks mined, prestige level, and island tier. Displayed on the scoreboard and leaderboard. - Lucky Blocks
Configurable chance for special blocks that give coin jackpots, rare items, or nothing. 10 default rewards with weighted chances. - Purchasable Fly
Players buy temporary flight with /ob fly. Configurable cost and duration. Timer shown on scoreboard. Auto-reactivates on rejoin. - Island Protection
Build boundaries, void fall protection (auto-respawn), PvP toggle, visitor build toggle, mob spawning toggle, OneBlock lock (owner only). - Homes, Warps & Spawn
Multiple named home points (5 for owner, 2 for members), warp system, and /ob setspawn for the island spawn point. - Holograms
Floating text above each island's center block showing phase name, block count, and progress. Auto-respawns on reconnect. - Leaderboard & Visiting
Top islands ranked by block count. Browse and visit public islands from other players. - 13 Custom UI Pages
Full in-game UI for everything: main menu, welcome, phase info with block icons, grid shop, sell, team, quests, auction, prestige, upgrades, top, visit, settings.
// PLAYER COMMANDS
- /ob — Open the main menu UI
- /ob create — Create your island
- /ob home [name] — Teleport to a home
- /ob sethome [name] — Set a home point
- /ob setspawn — Set island spawn (owner only)
- /ob level — View island level
- /ob balance — Check your balance
- /ob pay <player> <amount> — Send money
- /ob daily — Claim daily reward
- /ob fly — Purchase temporary flight
- /ob shop — Open the shop (grid UI)
- /ob quests — View your quests
- /ob prestige — Prestige your island
- /ob upgrade — Upgrade island tier
- /ob top — View leaderboard
- /ob visit <player> — Visit another island
- /ob name <name> — Rename your island
- /ob team — invite / kick / leave / list / promote / demote
- /ob auction — list / sell / buy / cancel / my
- /ob settings — pvp / visibility / mobs / welcome
- /ob warp — set / delete / list / <name>
- /ob bank — deposit / withdraw / bal
// ADMIN COMMANDS
- /ob reload — Reload configuration
- /ob delete <player> — Delete a player's island
- /ob setbalance <player> <amount> — Set player balance
- /ob setphase <player> <phase> — Set player phase
- /ob setlang <lang> — Change language
// HOW IT WORKS
1. Drop PerfectOneBlock-1.2.0.jar into your Mods folder
2. Start the server — a void world is created automatically
3. (Optional) Install PerfectEconomy, EliteEssentials or Ecotale — it will be auto-detected. Or set economyProvider in config.json to force a specific one.
4. Players type /ob create to get their island
5. Break the center block — a new one spawns from the current phase's block pool
6. Earn money, buy items, complete quests, prestige, and climb the leaderboard!
// CONFIGURATION
- config.json — Language, world name, island spacing, fly cost/duration, prestige multipliers, upgrade costs, lucky block chance, daily rewards, economyProvider
- phases.json — Phase names, block thresholds, weighted block pools, mob pools, mob spawn chance, chest intervals, chest loot tables
- shop.json — Shop categories, items with buy/sell prices and display names
- quests.json — Daily and milestone quests with type, target, and reward
- lucky_blocks.json — Reward pool with types (COINS/ITEM/NOTHING), amounts, and weights
// PERMISSIONS
- perfectoneblock.team — Access team commands
- perfectoneblock.shop — Access the shop
- perfectoneblock.prestige — Use prestige
- perfectoneblock.auction — Access auction house
- perfectoneblock.fly — Purchase fly
- perfectoneblock.admin — Admin commands (reload, delete, setbalance, setphase)
// TECHNICAL DETAILS
- Platform: Hytale Dedicated Server
- Java: 21+
- Dependencies: None hard. Optional external economy: PerfectEconomy, EliteEssentials or Ecotale (auto-detected via reflection).
- Data Storage: JSON files (auto-save). Balances stored internally OR delegated to the external economy provider if one is active.
- Performance: Async world loading, threaded scheduler, ConcurrentHashMap for thread safety
- Void World: Auto-created on first run (VoidWorldGenProvider)
- Multi-player: Designed for multiple simultaneous players with independent islands
Developed by KatsuyaTV
If you encounter any issues or have feature requests,
don't hesitate to reach out via DM or the discussion tab.
// LINKS
