PerfectOneBlock

The ultimate OneBlock gamemode for Hytale servers. Break one block, a new one spawns. Progress through 5 phases, earn money, upgrade your island, and compete with other players. Everything built-in: economy, shop, quests, auction house, prestige, scoreboard, teams.

Buy on BuiltByBit

Installation

1. Drop PerfectOneBlock-1.0.jar into your UserData/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 and play!

Features

• 5-Phase Progression -- Each phase has weighted block pools, mob spawns, and chest loot
• Built-in Economy -- Player balances, island bank, transfers, daily rewards
• Grid Shop -- 5x3 grid with icons, categories, x1/x10 toggle
• Auction House -- Player-to-player trading with auto-expiry
• Quest System -- Daily rotation + milestone quests, 7 types
• Prestige -- 6 levels with sell multipliers (x1.0 to x3.0)
• Island Upgrades -- 6 tiers expanding build area (50 to 300 blocks)
• Team System -- Invite, kick, promote, demote, shared bank
• Live Scoreboard -- HUD with level, phase, money, fly timer, combo, quest progress
• Combo System -- Break fast for x1.5 to x3.0 multiplier
• Island Level -- Based on blocks mined + prestige + tier
• Lucky Blocks -- Coin jackpots, rare items, configurable
• Purchasable Fly -- Timed flight, auto-reactivates on rejoin
• Island Protection -- Boundaries, void protection, PvP, visitor build, mob spawning toggles
• Homes, Warps & Spawn -- Multiple homes, warps, custom island spawn
• Holograms -- Floating info above center block, auto-respawn
• Leaderboard & Visiting -- Top islands, visit public islands
• 13 Custom UI Pages -- Full in-game UI for every feature

Phases

The plugin comes with 5 default phases. Each phase is defined in phases.json and can be fully customized.

Each phase contains:

• Blocks -- Weighted pool of blocks that can spawn (e.g. "Ore_Iron_Stone": 15)
• Mobs -- Weighted pool of mobs with a spawn chance percentage
• Chest Loot -- Items given every N blocks with min/max quantities

Commands

Player Commands

Admin Commands

Permissions

Configuration

All files are in the plugin data folder: UserData/Saves/MODDING/mods/KatsuyaTV_PerfectOneBlock/

config.json

{
  "lang": "EN",
  "worldName": "oneblock_world",
  "islandSpacing": 1000,
  "islandY": 100,
  "luckyBlockChance": 0.5,
  "prestigeMultipliers": [1.0, 1.2, 1.5, 1.8, 2.2, 3.0],
  "upgradeCosts": [0, 10000, 30000, 75000, 150000, 300000],
  "upgradeSizes": [50, 75, 100, 150, 200, 300],
  "dailyRewardAmount": 500,
  "flyCost": 1000,
  "flyDurationMinutes": 30
}

Shop Setup

Edit shop.json to add categories and items:

{
  "Blocks": [
    { "itemId": "Wood_Softwood_Log", "displayName": "Softwood Log", "buyPrice": 50, "sellPrice": 10 },
    { "itemId": "Rock_Stone", "displayName": "Stone", "buyPrice": 25, "sellPrice": 5 }
  ],
  "Ores": [
    { "itemId": "Ore_Iron_Stone", "displayName": "Iron Ore", "buyPrice": 200, "sellPrice": 50 }
  ]
}

Quests Setup

Edit quests.json to customize quests. Supported types:

Example quest definition:

{
  "id": "daily_mine_50",
  "name": "Mine 50 Blocks",
  "type": "MINE_BLOCKS",
  "target": 50,
  "reward": 200,
  "daily": true
}

Lucky Blocks

Edit lucky_blocks.json to configure rewards. Supported types: COINS, ITEM, NOTHING.

{
  "chance": 0.5,
  "rewards": [
    { "type": "COINS", "amount": 500, "weight": 30, "message": "You found 500 coins!" },
    { "type": "COINS", "amount": 5000, "weight": 5, "message": "MEGA JACKPOT! 5,000 coins!" },
    { "type": "ITEM", "itemId": "Ore_Diamond", "amount": 1, "weight": 10, "message": "You found a diamond!" },
    { "type": "NOTHING", "weight": 20, "message": "Better luck next time!" }
  ]
}

Scoreboard

The scoreboard is built-in and shows automatically when a player joins the OneBlock world. It displays:

• Island Level -- Calculated from blocks + prestige + tier
• Phase -- Current phase name
• Blocks -- Total blocks mined + progress to next phase
• Money -- Player balance with separator formatting
• Prestige -- Current prestige level
• Fly Timer -- Minutes and seconds remaining (if active)
• Combo -- Current combo streak and multiplier (if >= 5)
• Quest -- Active quest name and progress
• Border Warning -- Shows distance when near island edge

The scoreboard refreshes every second automatically.

FAQ

The void world doesn't create?

Make sure the server has write access to the worlds folder. Check config.json for the worldName setting.

Can I add more phases?

Yes! Edit phases.json and add new entries with a higher threshold. Reload with /ob reload.

Can multiple players play simultaneously?

Yes. Each player gets their own island on a grid spaced 1000 blocks apart (configurable). They can also form teams.

How does prestige work?

When you complete the final phase, use /ob prestige to reset your island. You keep your team but get a permanent sell multiplier bonus.

Items don't appear in shop?

Make sure the itemId in shop.json matches a valid Hytale item ID. Check with /give to verify the item exists.