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. Just drop the JAR and play.
Fully configurable via JSON files — admins can customize phases, blocks, shop items, quests, prices, and more without touching any code.
// 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
Complete currency system with player balances, island bank (shared team balance), /ob pay transfers, and daily rewards. All prices and rewards are configurable. - 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 (NEW)
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 (NEW)
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 (NEW)
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.0.jar into your Mods folder
2. Start the server — a void world is created automatically
3. Players type /ob create to get their island
4. Break the center block — a new one spawns from the current phase's block pool
5. 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
- 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 (standalone)
- Data Storage: JSON files (auto-save)
- 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
