Act as a senior Minecraft game designer, plugin architect, and UX designer.
Create a full concept and implementation plan for a highly polished Advanced OneBlock Minecraft gamemode with modern features, progression depth, and a clean, premium UX/UI.
Project goal:
Build an addictive, replayable OneBlock experience that feels modern, rewarding, balanced, and professional. It should go far beyond basic OneBlock by adding layered progression systems, intelligent menus, quality-of-life tools, automation, economy, quests, events, and clean INVENTORY GUI design.
Core requirements:
- Base gameplay
- The player starts on a single regenerating block.
- Breaking the block advances progression, unlocks phases, and spawns resources, mobs, structures, and rare rewards.
- Progression should feel smooth in early game, strategic in mid game, and content-rich in late game.
- Include solo and multiplayer support.
- Advanced features
Design advanced systems such as:
- Phase-based progression with unique block pools, mobs, biomes, and bosses
- Daily and weekly quests
- Island levels and prestige/rebirth system
- Custom upgrades for generator speed, loot quality, mob spawn rate, and automation
- Skill tree or tech tree
- Economy with coins/tokens/gems
- Shops, auction house, trading, and player market support
- Custom crafting and unlockable recipes
- Crates, loot tables, and rare drops balanced properly
- Seasonal events and rotating challenges
- PvE content like dungeons, mini-bosses, invasions, or elite waves
- Coop/team island management
- Missions, achievements, collections, and milestones
- Automation systems such as auto-collectors, compactors, sorters, and generators
- AFK-safe balancing and anti-exploit protections
- Leaderboards and competitive progression
- Optional cosmetics and visual progression systems
- UX/UI design
Create a clean, intuitive, premium-feeling INVENTORY GUI/UX.
Design principles:
- Minimal clutter
- Clear category structure
- Consistent button positions
- Strong visual hierarchy
- Color-coded progression and rarity
- Helpful tooltips
- Fast navigation with as few clicks as possible
- Mobile-like clarity but adapted for Minecraft inventory GUIs
Include INVENTORY GUI concepts for:
- Main menu
- Profile menu
- Progression/phase tracker
- Quest menu
- Upgrades menu
- Skills/tech tree
- Shop menu
- Prestige menu
- Team/co-op menu
- Event menu
- Collections/achievements menu
- Admin menu
For every INVENTORY GUI, explain:
- Slot layout
- Button purpose
- Icon suggestions
- Navigation flow
- Text/lore style
- UX reasoning
- Balance and retention
Make the gamemode highly replayable and sticky without feeling pay-to-win or grindy.
Explain:
- Core gameplay loop
- Reward loop
- Retention mechanics
- New player onboarding
- Mid-game depth
- Late-game goals
- Social/coop hooks
- Fair monetization ideas limited to cosmetic or convenience-only options
- Technical design
Assume this is being built as a modern Minecraft server project.
Provide:
- Recommended server stack (Paper/Purpur/Velocity, etc.)
- Plugin architecture or module structure
- Data storage suggestions
- Performance considerations
- Anti-lag strategy
- Anti-duplication / anti-abuse protections
- Permission structure
- Config structure
- Scalability considerations for many players
- Admin and developer friendliness
Include:
- Modular config files
- Easy-to-edit loot tables
- Editable phase definitions
- Event toggles
- Permission nodes
- Debug/admin tools
- Reload-safe design where possible
- Logging and analytics suggestions
- Deliverables
Structure the answer in this exact format:
A. Game vision summary B. Core gameplay loop C. Full progression design D. Advanced systems list E. INVENTORY GUI/UX design breakdown F. Economy and reward design G. Multiplayer/co-op systems H. Anti-exploit and balancing plan I. Technical architecture J. Recommended file/config structure K. Monetization rules that avoid pay-to-win L. Roadmap for MVP, V2, and V3 M. Example commands, permissions, and menu flow N. 10 unique feature ideas that make this OneBlock stand out from typical servers
- Style requirements
- Be specific, not generic
- Make it feel like a real premium server product
- Use clean formatting
- Give practical examples
- Prioritize player experience and clean UX
- Avoid outdated Minecraft design patterns
- Focus on depth, polish, and retention
- Make the design feel commercially viable and production-ready
Optional project context:
- Minecraft version: 1.21+
- Audience: players who enjoy progression, automation, economy, and long-term grinding with polish
- Tone: modern, sleek, premium, highly replayable
Now generate the complete design document.
Continue
Iโd be happy to create a new Minecraft plugin project! However, you havenโt told me what youโd like to build yet.
Please describe your plugin idea, including:
๐ฏ What it does โ core functionality/purpose
โ๏ธ Key features โ mechanics, systems, commands
๐ Integrations โ any other plugins (Vault, LuckPerms, PlaceholderAPI, etc.)
๐ฎ Target audience โ survival, minigame, RPG server, etc.
The more detail you provide, the better I can tailor the implementation to your needs!
Act as a senior Minecraft game designer, plugin architect, and UX designer.
Create a full concept and implementation plan for a highly polished Advanced OneBlock Minecraft gamemode with modern features, progression depth, and a clean, premium UX/UI.
Project goal:
Build an addictive, replayable OneBlock experience that feels modern, rewarding, balanced, and professional. It should go far beyond basic OneBlock by adding layered progression systems, intelligent menus, quality-of-life tools, automation, economy, quests, events, and clean INVENTORY GUI design.
Core requirements:
- Base gameplay
- The player starts on a single regenerating block.
- Breaking the block advances progression, unlocks phases, and spawns resources, mobs, structures, and rare rewards.
- Progression should feel smooth in early game, strategic in mid game, and content-rich in late game.
- Include solo and multiplayer support.
- Advanced features
Design advanced systems such as:
- Phase-based progression with unique block pools, mobs, biomes, and bosses
- Daily and weekly quests
- Island levels and prestige/rebirth system
- Custom upgrades for generator speed, loot quality, mob spawn rate, and automation
- Skill tree or tech tree
- Economy with coins/tokens/gems
- Shops, auction house, trading, and player market support
- Custom crafting and unlockable recipes
- Crates, loot tables, and rare drops balanced properly
- Seasonal events and rotating challenges
- PvE content like dungeons, mini-bosses, invasions, or elite waves
- Coop/team island management
- Missions, achievements, collections, and milestones
- Automation systems such as auto-collectors, compactors, sorters, and generators
- AFK-safe balancing and anti-exploit protections
- Leaderboards and competitive progression
- Optional cosmetics and visual progression systems
- UX/UI design
Create a clean, intuitive, premium-feeling INVENTORY GUI/UX.
Design principles:
- Minimal clutter
- Clear category structure
- Consistent button positions
- Strong visual hierarchy
- Color-coded progression and rarity
- Helpful tooltips
- Fast navigation with as few clicks as possible
- Mobile-like clarity but adapted for Minecraft inventory GUIs
Include INVENTORY GUI concepts for:
- Main menu
- Profile menu
- Progression/phase tracker
- Quest menu
- Upgrades menu
- Skills/tech tree
- Shop menu
- Prestige menu
- Team/co-op menu
- Event menu
- Collections/achievements menu
- Admin menu
For every INVENTORY GUI, explain:
- Slot layout
- Button purpose
- Icon suggestions
- Navigation flow
- Text/lore style
- UX reasoning
- Balance and retention
Make the gamemode highly replayable and sticky without feeling pay-to-win or grindy.
Explain:
- Core gameplay loop
- Reward loop
- Retention mechanics
- New player onboarding
- Mid-game depth
- Late-game goals
- Social/coop hooks
- Fair monetization ideas limited to cosmetic or convenience-only options
- Technical design
Assume this is being built as a modern Minecraft server project.
Provide:
- Recommended server stack (Paper/Purpur/Velocity, etc.)
- Plugin architecture or module structure
- Data storage suggestions
- Performance considerations
- Anti-lag strategy
- Anti-duplication / anti-abuse protections
- Permission structure
- Config structure
- Scalability considerations for many players
- Admin and developer friendliness
Include:
- Modular config files
- Easy-to-edit loot tables
- Editable phase definitions
- Event toggles
- Permission nodes
- Debug/admin tools
- Reload-safe design where possible
- Logging and analytics suggestions
- Deliverables
Structure the answer in this exact format:
A. Game vision summary B. Core gameplay loop C. Full progression design D. Advanced systems list E. INVENTORY GUI/UX design breakdown F. Economy and reward design G. Multiplayer/co-op systems H. Anti-exploit and balancing plan I. Technical architecture J. Recommended file/config structure K. Monetization rules that avoid pay-to-win L. Roadmap for MVP, V2, and V3 M. Example commands, permissions, and menu flow N. 10 unique feature ideas that make this OneBlock stand out from typical servers
- Style requirements
- Be specific, not generic
- Make it feel like a real premium server product
- Use clean formatting
- Give practical examples
- Prioritize player experience and clean UX
- Avoid outdated Minecraft design patterns
- Focus on depth, polish, and retention
- Make the design feel commercially viable and production-ready
Optional project context:
- Minecraft version: 1.21+
- Audience: players who enjoy progression, automation, economy, and long-term grinding with polish
- Tone: modern, sleek, premium, highly replayable
Now generate the complete design document.
ADVANCED ONEBLOCK โ COMPLETE DESIGN & IMPLEMENTATION DOCUMENT
A. GAME VISION SUMMARY
Advanced OneBlock is a premium, standalone Minecraft gamemode where a single block is the engine of an entire civilization. Every break of that block is a decision, a reward, and a step forward. The game is designed to feel like a prestige idle-RPG fused with classic SkyBlock depth โ but faster, cleaner, and more modern.
Pillars:
Rewarding โ Every session produces tangible progress with visible milestones
Strategic โ Players choose upgrade paths, skill routes, and automation investments
Social โ Co-op islands, trading, leaderboards, and events keep players connected
Polished โ Every menu, message, and interaction feels intentional and premium
Replayable โ Prestige resets allow infinite progression loops with meaningful carry-over rewards
Target Feel: If Hypixel SkyBlock had a baby with a modern incremental game, this is it.
B. CORE GAMEPLAY LOOP
Break Block โ Receive Drop/Event โ Gain Resources/XP/Coins
โ
Advance Phase Counter โ Phase Threshold Reached โ Phase Unlock
โ
Spend Coins/Tokens โ Upgrades / Skills / Shop / Crafting
โ
Complete Quests โ Earn Gems / Crate Keys / Rare Items
โ
Automation Investments โ Passive Generation
โ
Island Level Up โ Leaderboard Progress โ Prestige Option
โ
Prestige Reset โ Bonus Multipliers โ Start Again, Faster
The 3-Layer Loop:
Layer | Timeframe | Content |
|---|---|---|
Micro | Seconds | Breaking blocks, receiving drops, mob kills |
Meso | MinutesโHours | Quests, phase progression, upgrades, crafting |
Macro | DaysโWeeks | Prestige, leaderboard competition, events, collections |
Session Hook Structure:
Opening: Daily quest refresh + event check = immediate reason to log in
Middle: Clear upgrade target + active quest progress = reason to stay
Closing: โJust one more phaseโ + daily reward claim = reason to return
C. FULL PROGRESSION DESIGN
Phase System โ 12 Phases + Prestige
Each phase has a break count threshold, a visual biome identity, a unique block pool, custom drops, special mobs, a mini-boss, and an unlockable reward.
Phase | Name | Breaks Required | Biome Theme | Boss |
|---|---|---|---|---|
1 | The Grasslands | 0โ500 | Plains/Grass | Giant Slime King |
2 | The Depths | 501โ1,500 | Cave/Stone | Cave Troll |
3 | The Forest | 1,501โ3,000 | Dark Oak Forest | Woodland Sentinel |
4 | The Desert | 3,001โ5,500 | Desert/Mesa | Sand Pharaoh |
5 | The Ocean | 5,501โ9,000 | Ocean/Prismarine | Drowned Admiral |
6 | The Nether | 9,001โ14,000 | Nether | Blaze Overlord |
7 | The Corruption | 14,001โ21,000 | Dark/Purple | The Wither Shade |
8 | The Arctic | 21,001โ30,000 | Ice/Snow | Frost Titan |
9 | The Jungle Temple | 30,001โ42,000 | Jungle | Ancient Guardian |
10 | The End | 42,001โ57,000 | End/Void | Ender Sovereign |
11 | The Void Rift | 57,001โ75,000 | Dimensional | Rift Colossus |
12 | Ascension | 75,001โ100,000 | Celestial/Gold | The Eternal |
Phase Transition Events:
Screen-wide title sequence with phase name + lore snippet
Firework burst from the OneBlock
Server-wide announcement for phase 6+
Chest reward spawned adjacent to the block
Temporary 60-second multiplier: 2x coins
Block Pool Design (Phase 1 example):
Block | Weight | Special |
|---|---|---|
Grass Block | 35 | โ |
Dirt | 20 | โ |
Stone | 15 | โ |
Oak Log | 10 | โ |
Oak Leaves | 8 | โ |
Gravel | 5 | โ |
Rare Chest | 3 | Contains: coins, seeds, tools |
Mob Spawn Event | 3 | Spawns: Zombie, Spider, Skeleton |
Dungeon Event | 1 | Spawns mini-platform with loot |
Block pools progressively reduce filler blocks and increase exotic materials, mobs, and event density.
Island Level System
Island XP is earned from:
Breaking the OneBlock (+1 base XP, scalable by upgrades)
Placing blocks on the island (+0.5 XP per unique block type, first time only)
Killing mobs on the island (+5โ50 XP by mob tier)
Completing quests (+100โ5,000 XP)
Crafting items (+2โ20 XP per craft)
Island Level | XP Required | Reward |
|---|---|---|
1 | 0 | Starting perks |
10 | 5,000 | +1 Island expansion plot |
25 | 25,000 | Coin Multiplier +5% |
50 | 100,000 | Skill Slot Unlock |
100 | 500,000 | Prestige eligible |
200 | 2,500,000 | Cosmetic title unlocked |
Prestige System
Prestige resets phase progress and island resources but grants Prestige Points and permanent multipliers.
Prestige | Requirement | Bonus |
|---|---|---|
P1 | Level 100 | +10% XP gain permanently |
P2 | Level 100 ร P2 | +10% Coin gain + exclusive cosmetic |
P3 | Level 100 ร P3 | Access to Prestige-Only Phase 13 content |
P5 | Level 100 ร P5 | Prestige Aura cosmetic (particle effect) |
P10 | Level 100 ร P10 | Legendary Title + permanent 2x drop rate |
Carry-over on prestige: Cosmetics, Prestige Points, Collections, Achievement history, Gem balance (50% kept), Skill tree (1 tier kept per prestige level)
D. ADVANCED SYSTEMS LIST
1. Upgrade System (6 Trees)
Each upgrade tree has 10 tiers, costs increasing in coins/tokens, and provides mechanical benefits:
Tree | Effect | Max Bonus |
|---|---|---|
Block Speed | Reduces regeneration time | 0.5s โ 0.05s delay |
Loot Quality | Increases rare drop weight | +200% rare chance |
Mob Bounty | Increases mob drop value | +300% mob coins |
Auto-Collector | Auto-picks up drops in radius | 3 block โ 15 block radius |
XP Booster | Island XP multiplier | ร1 โ ร4 |
Luck | Triggers bonus events | +150% event chance |
2. Skill Tree
Skills are earned by spending Skill Points (1 per 5 island levels). The tree has 4 branches:
Warrior Branch โ Combat damage, mob loot bonuses, boss damage multipliers
Miner Branch โ Mining speed, vein detection, ore multipliers
Merchant Branch โ Shop discount, sell bonus, auction fee reduction
Sage Branch โ XP multiplier, quest reward bonus, crafting speed
Each branch has 15 nodes, arranged in a diamond pattern in a 54-slot inventory.
3. Quest System
Daily Quests (3 active, refresh at midnight):
Break X blocks of type Y
Kill X mobs
Earn X coins from sales
Craft X items
Open X crates
Weekly Quests (2 active, refresh Monday):
Reach phase X
Complete Y daily quests
Beat the phase boss
Earn X island XP in a week
Story Quests (permanent, 50 total):
Narrative-driven quests tied to each phase
Lore delivery through quest book UI
Reward: Gems, keys, cosmetics, skill points
Quest Rarity:
Common (green) โ Easy, small rewards
Uncommon (blue) โ Medium, decent rewards
Rare (purple) โ Hard, Gem rewards
Legendary (gold) โ Weekly challenges, crate key rewards
4. Economy
Three currencies:
Currency | Earn Method | Spend On |
|---|---|---|
Coins (โฌ) | Selling drops, mob kills, quests | Upgrades, shop, auction |
Tokens (โ) | Phase completions, boss kills, prestige | Skill tree, special upgrades |
Gems (โฆ) | Rare quests, events, voting, real-money cosmetic shop | Cosmetics, crate keys, convenience |
Economy Sinks:
Upgrade costs scale exponentially
Auction house listing fee (2% of sale)
Crate key purchases cost Gems
Island expansion costs Tokens
Name/cosmetic changes cost Gems
5. Shop System
Four shop sections:
General Store โ Basic materials, tools, food, building blocks
Phase Shop โ Items unlocked per phase (faction-specific gear, special blocks)
Black Market โ Rotates every 6 hours, deeply discounted or rare items
Prestige Shop โ Prestige Points only, exclusive rewards
6. Crate System
Four crate tiers:
Crate | Key Source | Top Prize |
|---|---|---|
Common Crate | Phase milestone, daily login | Coins, basic materials |
Rare Crate | Boss kill, weekly quest | Rare blocks, Tokens, boosters |
Legendary Crate | Gem purchase, event reward | Exclusive cosmetics, permanent boosters |
Prestige Crate | Prestige Point purchase only | Prestige titles, aura cosmetics |
7. Automation Systems
Automation | Unlock | Effect |
|---|---|---|
Auto-Collector | Phase 3 | Picks up drops automatically |
Compactor | Phase 4 | Converts items to blocks automatically |
Sorter | Phase 5 | Routes items to chests by category |
Auto-Seller | Phase 7 | Sells designated items to shop passively |
Mob Grinder | Phase 6 | Auto-kills spawned mobs in a radius |
XP Bottle | Phase 8 | Converts XP to bottles passively |
Generator | Phase 9 | Generates a side resource every 10 min |
8. Events & Dungeons
Rotating World Events:
Invasion Wave โ Waves of elite mobs attack the island, defend for rewards
Treasure Hunt โ 10 hidden items spawn around the island, first to find all wins
Double XP Weekend โ Every weekend, 2รXP globally
Boss Raid Week โ Phase bosses have enhanced loot tables
Seasonal Events โ Halloween, Christmas, Summer, etc.
Dungeon System (Phase 5+):
Mini-dungeon platforms can spawn from the OneBlock during special events
3-room dungeon with locked doors (key from mob drops)
Final room has a mini-boss and a loot chest
Solo or team entry
10-minute time limit, failure resets dungeon
9. PvE Boss Fights
Phase bosses are fought in a dedicated arena accessed via command once the phase threshold is reached. Bosses use custom AI patterns:
Phase 1 Boss (Slime King): Splits into smaller slimes, area-of-effect slam attack
Phase 6 Boss (Blaze Overlord): Creates fire rings, immune to melee sometimes, spawns blazes
Phase 12 Boss (The Eternal): Three phase fight, reality-warping mechanics, server announcement
Boss mechanics use Bukkit scheduler-driven AI, not plugins, for full control.
10. Collections & Achievements
Collections: Breaking/receiving 100+ unique item types unlocks collection bonuses (permanent stat boosts, cosmetics).
Achievements: 200 total achievements across categories โ Combat, Mining, Economy, Social, Exploration, Prestige, Events.
Milestones: Visible progress bars in-GUI for long-term goals (1,000 boss kills, 1,000,000 blocks broken, etc.)
E. INVENTORY GUI/UX DESIGN BREAKDOWN
Design Philosophy
54-slot (6-row) inventory used for all major GUIs
Border rows (top and bottom) are navigation/decoration strips โ never functional items
Glass pane borders use phase-color coding (green for Phase 1, red for Nether, purple for End, etc.)
Center area (rows 2โ5, cols 2โ8) is the active content zone
Bottom-left always has a Back button
Bottom-center always has a Home button
Bottom-right always has a Close/Info button
Every itemโs lore uses a consistent 3-line format: Title, Description, Action hint in gray italic
GUI 1 โ Main Menu (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ] โ Phase-colored glass pane border
[โ ][P][Q][U][S][K][E][C][โ ] โ Main action buttons, row 2
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ] โ Spacer
[โ ][โ ][โ ][ONE BLOCK INFO][โ ] โ Center highlight
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ] โ Spacer
[โ ][โฆ][โ ][โ ][โ][โ ][โ ][โ][โ ] โ Bottom nav
Slot Assignments:
Slot | Icon | Label | Purpose |
|---|---|---|---|
10 | Player Head | Your Profile | Opens profile menu |
11 | Book | Quests | Opens quest menu |
12 | Anvil | Upgrades | Opens upgrades menu |
13 | Emerald | Shop | Opens shop menu |
14 | Blaze Powder | Skills | Opens skill tree |
15 | Calendar | Events | Opens event status |
16 | Chest | Collections | Opens collections menu |
22 | Orange Glass | Phase Progress | Shows current phase info inline (no new GUI) |
46 | Star | Leaderboard | Opens leaderboard menu |
49 | House | Island | Opens island management |
52 | X | Close | Closes menu |
Lore Example (Profile button):
ยง8โธ ยงfYour Profile
ยง7View your stats, balance,
ยง7prestige, and settings.
ยง8[Click to open]
UX Reasoning: The main menu is a hub, not a feature. Keep it categorized. Players should reach any feature in โค2 clicks. The OneBlock info slot at center gives at-a-glance status without opening a sub-menu.
GUI 2 โ Profile Menu (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][HD][โ ][โ ][BAL][โ ][โ ][PS][โ ] Head, Balance, Prestige
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][S1][S2][S3][S4][S5][S6][โ ][โ ] Stats row
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ][โ ][โ ][โ ][โ][โ ][โ ][โ ][โ ]
Slot | Icon | Content |
|---|---|---|
10 | Player Head | [PlayerName] โ Level / Prestige badge |
13 | Gold Ingot | Balance โ Coins: X, Tokens: X, Gems: X |
16 | Nether Star | Prestige โ Current prestige tier, next requirement |
28 | Sword | Combat Stats โ Kills, boss kills, deaths |
29 | Pickaxe | Mining Stats โ Total breaks, phase, efficiency |
30 | Emerald | Economy Stats โ Total earned, total spent |
31 | Scroll | Quest Stats โ Completed daily/weekly/story |
32 | Trophy | Achievements โ Completed count, rare/legendary count |
33 | Clock | Playtime โ Total time, session time |
45 | Arrow Left | Back โ Returns to main menu |
49 | House | Main Menu |
Lore Style:
ยง6โฆ ยงlBalance
ยง7Coins: ยงf1,482,000 โฌ
ยง7Tokens: ยงf3,200 โ
ยง7Gems: ยงf45 โฆ
ยง8Last earned: 2 minutes ago
GUI 3 โ Quest Menu (54 slots)
[โ ][โ ][D][D][D][W][W][S][โ ] โ Tab selector row
[โ ][Q1][Q2][Q3][โ ][โ ][Q4][Q5][โ ] โ Active quests
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][PROG BAR ITEMS - 7 WIDE][โ ] โ Visual progress
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ][โ ][โ ][โ ][โ][โ ][โ ][โ][โ ]
Tab System (top row):
Slots 11โ13: Daily (Paper icon) โ 3 daily quests
Slots 14โ15: Weekly (Book icon) โ 2 weekly quests
Slot 16: Story (Enchanted Book icon) โ Story quest log
Quest Item Lore:
ยงaโ [COMMON] ยงfBreak 100 Grass Blocks
ยง7Progress: ยงa87ยง7/ยงf100
ยง7Reward:
ยง7 ยง641,500 Coins
ยง7 ยงb1ร Common Key
ยง8Click to track this quest
Progress Bar Visual:
7 Green/Gray glass panes representing % completion
Updates in real-time on GUI open
UX Notes:
Active tracking marks quest with a glowing outline (enchantment glint)
Completed quests shown with lime green background and โCLAIMโ prompt
Unclaimed rewards pulse (updated on GUI open with visual cue in lore)
GUI 4 โ Upgrades Menu (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][U1][U2][U3][U4][U5][U6][โ ][โ ] โ 6 upgrade categories
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][DETAIL PANEL - 5 WIDE][โ ][โ ][โ ] โ Click category to see tiers
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ][โ ][โ ][โ ][โ][โ ][โ ][โ ][โ ]
Category Icons:
Block Speed: Feather (speed enchant glow)
Loot Quality: Diamond (purple glow)
Mob Bounty: Golden Sword
Auto-Collector: Hopper
XP Booster: Bottle oโ Enchanting
Luck: Rabbitโs Foot
Category Detail Sub-GUI (when clicked):
Shows all 10 tiers in a horizontal strip (row 3)
Unlocked = bright icon, locked = gray stained glass
Current tier has an arrow pointer below it
Cost shown in lore of each tier icon
Tier Lore Format:
ยงeโฌ Block Speed โ Tier 4
ยง7Current: 0.4s regen delay
ยง7Next: ยงf0.3s regen delay
ยง7Cost: ยง622,000 โฌ ยง7+ ยงb150 โ
ยง8ยงo[Locked โ Requires Tier 3]
ยงa[Click to Upgrade] ยง7โ if affordable
ยงc[Cannot Afford] ยง7โ if not
GUI 5 โ Skills / Tech Tree (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][WARRIOR][MINER][MERCHANT][SAGE][โ ][โ ][PT][โ ] โ Branches + Points
[โ ][N1][N2][N3][N4][N5][โ ][โ ][โ ]
[โ ][N6][N7][N8][N9][N10][โ ][โ ][โ ]
[โ ][N11][N12][N13][N14][N15][โ ][โ ][โ ]
[โ][โ ][โ ][โ ][โ][โ ][โ ][โ ][โ ]
Clicking a branch tab (slots 10โ13) filters the tree view to that branch
Available points shown at slot 16
Nodes are shown in a 5ร3 grid (rows 3โ5)
Locked nodes = gray, available = glowing, maxed = golden head icon
Node Lore:
ยงbโ Critical Strike ยง8[Warrior โ Node 3]
ยง7Deal ยงf+15% ยง7critical hit damage
ยง7to all mobs.
ยง7Requires: ยงfNode 2 unlocked
ยง7Cost: ยงf1 Skill Point
ยงa[Click to unlock]
GUI 6 โ Shop Menu (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][GEN][PHS][BLK][MKT][โ ][BAL][โ ][โ ] โ Shop tabs + balance display
[โ ][I1][I2][I3][I4][I5][I6][I7][โ ]
[โ ][I8][I9][I10][I11][I12][I13][I14][โ ]
[โ ][I15][I16][I17][I18][I19][I20][I21][โ ]
[โ][โ ][โ ][PG-][โ][PG+][โ ][โ ][โ ]
21 items per page, paginated
Tab bar switches between General / Phase / Black Market / Prestige shops
Balance summary in top-right always visible
Black Market tab shows timer until next rotation
Item Lore:
ยงfOak Log
ยง7A sturdy piece of wood.
ยง7Buy Price: ยงa120 โฌ ยง7per stack
ยง7Sell Price: ยงc80 โฌ ยง7per stack
ยงaLeft-click: Buy 1
ยงeShift+Left: Buy 64
ยงcRight-click: Sell 1
ยง6Shift+Right: Sell all in inventory
GUI 7 โ Prestige Menu (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][CURR][โ ][โ ][INFO][โ ][โ ][NEXT][โ ]
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][BONUS DISPLAY - 5 WIDE][โ ][โ ][โ ]
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ][โ ][โ ][โ ][PRESTIGE BTN][โ ][โ ][โ ][โ ]
Current prestige badge at slot 10 (custom colored head)
Info panel at 13: Requirements and warnings
Next prestige at 16: Preview of bonuses
Bonus display (row 4): Shows all accumulated permanent bonuses
Prestige button at 49: Confirmation required (opens confirm dialog GUI)
Confirm Dialog (27-slot):
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][โ ][CONFIRM][โ ][โ ][CANCEL][โ ][โ ][โ ]
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
Confirm = Lime Wool with prestige summary lore
Cancel = Red Wool
Auto-close if player moves (anti-misclick)
GUI 8 โ Team / Co-op Menu (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][H][M1][M2][M3][M4][M5][INV][โ ] โ Members (head icons)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][PERMS][BANK][LOG][LEAVE][โ ][โ ][โ ][โ ]
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ][โ ][โ ][โ ][โ][โ ][โ ][โ ][โ ]
Owner head at slot 10 (H) with crown particle in-world
Each member head shows role, online status, contribution this week
Invite button at slot 16
Permissions sub-GUI lets owner set roles (Co-owner, Member, Guest)
Bank: Shared coin storage, deposit/withdraw with limits by role
Log: Recent island activity (last 20 actions)
GUI 9 โ Event Menu (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][ACTIVE][โ ][UPCOMING][โ ][HISTORY][โ ][โ ][โ ]
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][EVENT DETAIL PANEL - 5 WIDE][โ ][โ ][โ ]
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ][โ ][โ ][โ ][โ][โ ][JOIN BTN][โ ][โ ]
Active event at top-left with countdown timer in lore
Upcoming shows next 2 scheduled events
History shows past event completions (personal)
Join button enabled only when event is live and player is eligible
Event Item Lore:
ยงc๐ฅ ยงlINVASION WAVE ยงrยงc[ACTIVE]
ยง7Waves of elite mobs are attacking!
ยง7Survive all ยงf10 waves ยง7to win.
ยง7Time remaining: ยงe6:42
ยง7Your wave: ยงf4/10
ยง7Reward: ยงbLegendary Crate Key
ยงa[Click JOIN to teleport]
GUI 10 โ Collections / Achievements (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][ALL][COMBAT][MINING][ECON][SOCIAL][PRESTIGE][EVENT][โ ]
[โ ][A1][A2][A3][A4][A5][A6][A7][โ ]
[โ ][A8][A9][A10][A11][A12][A13][A14][โ ]
[โ ][PROGRESS SUMMARY][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ][โ ][PG-][โ ][โ][โ ][PG+][โ ][โ ]
Achievement items: Gold if complete, gray if not
Clicking shows detailed requirement and reward
Progress summary row shows: X/200 achievements, X/12 phases collected, total bonus % earned
Achievement Lore:
ยง6๐ ยงlFirst Blood
ยง7Kill your first mob on the island.
ยง7Reward: ยงa500 โฌ ยง7+ ยงb50 XP
ยง8Achievement #4 of 200
ยงaยงl[COMPLETED] ยง8โ 3 days ago
GUI 11 โ Admin Menu (54 slots)
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][RELOAD][PHASES][PLAYERS][EVENTS][ECONOMY][โ ][โ ][โ ]
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][DETAIL PANEL][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ][โ ]
[โ][โ ][โ ][โ ][โ][โ ][โ ][โ ][โ ]
Reload: Hot-reload configs (phases, loot, quests, shop)
Phases: View/set any playerโs phase manually
Players: Search player by name โ view full profile โ modify
Events: Force-start any event, toggle event eligibility
Economy: Add/remove currencies from player, view transaction log
F. ECONOMY AND REWARD DESIGN
Earning Rates (Tuned for Phase 1 new player)
Action | Coin Rate | Notes |
|---|---|---|
Break OneBlock | 1โ5 coins | Base rate, upgraded later |
Sell common drop | 50โ200 coins | Grass, dirt, stone |
Sell rare drop | 500โ5,000 coins | Phase-specific materials |
Kill mob | 20โ500 coins | By mob tier |
Complete daily quest | 1,000โ10,000 coins | By rarity |
Boss kill | 10,000โ100,000 coins | By phase boss |
Spending Sinks
Sink | Amount | Frequency |
|---|---|---|
Tier 1 upgrades | 1,000โ10,000 | Early game |
Tier 5 upgrades | 100,000โ1,000,000 | Mid game |
Tier 10 upgrades | 10,000,000+ | Late game |
Auction listings | 2% fee | Per transaction |
Phase shop items | 50,000โ5,000,000 | Per phase |
Prestige shop items | Prestige Points only | Exclusive |
Anti-Inflation Mechanics
Auto-seller has a daily sell cap (removes infinite AFK farming)
Auction house items expire after 7 days (returned to seller, fee not refunded)
Black market items have quantity limits per player per rotation
High-value crafting recipes act as coin sinks (cost coins + materials)
G. MULTIPLAYER / CO-OP SYSTEMS
Island Sizes
Solo: 100ร100 area
2-player co-op: 150ร150
Up to 5-player team: 200ร200
Island expansion purchasable with Tokens
Team Roles
Owner โ Full permissions, can disband, transfer ownership
Co-owner โ Can invite/kick members, manage bank
Member โ Full island access, can use automation, contribute to bank
Guest โ Visit-only, cannot break/place blocks or use automation
Shared Progression
Phase progress is island-wide (all members contribute)
Quests are personal (each player has their own)
Island XP is shared pool
Bank is shared coin pool with role-based withdrawal limits
Co-op Anti-Exploit
Newly joined members cannot claim OneBlock drops for 10 minutes (anti-loot-hop)
Leaving mid-boss-fight locks you from re-entry for that fight
Vote-kick system: 3/4 of members must agree to kick someone
H. ANTI-EXPLOIT AND BALANCING PLAN
Block Break Anti-Exploit
Minimum 200ms between valid break registrations (eliminates autoclicker advantage)
If block break is registered without standing on/near the island, reject it
Rate-limit monitoring: Flag if player breaks >20 blocks/second consistently
AFK Balancing
Automation systems work while offline, but at 50% efficiency
Auto-seller daily cap: 500,000 coins/day maximum passive income
AFK kicker after 30 minutes of inactivity (configurable per server)
Automation upgrades require active phase, not auto-progressing phases
Economy Anti-Inflate
Server-wide sell price adjustment: if total daily sales exceed threshold, prices auto-compress 5%
Item blacklist from auction house (prevents duplication exploits)
Coin transfer limits between players (prevent multi-account funneling)
Dupe Protections
All inventory transactions logged
Block break tracking per-session
Crate animation locks inventory during spin (prevents item extraction)
All GUI click events cancel item movement by default
Permission Structure
oneblock.play โ Basic gameplay access
oneblock.shop โ Shop access
oneblock.auction โ Auction house access
oneblock.team.create โ Create a team island
oneblock.team.invite โ Invite players to team
oneblock.prestige โ Prestige ability
oneblock.event.join โ Join live events
oneblock.admin โ Full admin access
oneblock.admin.reload โ Reload configs
oneblock.admin.setphase โ Manually set player phase
oneblock.admin.economy โ Modify player economy
oneblock.admin.event โ Force-start events
oneblock.bypass.afk โ Bypass AFK kick
oneblock.bypass.cap โ Bypass daily sell cap (VIP)
oneblock.vip.double_keys โ VIP crate key bonus
I. TECHNICAL ARCHITECTURE
Server Stack
Server: Paper 1.21+ (for async chunk loading, better entity optimization)
Proxy: Velocity (if multi-server setup โ lobby โ oneblock server)
Database: MySQL (via HikariCP) for persistent player data, SQLite fallback for dev
Cache: In-memory HashMap cache for active player data, write-through on change, flush on logout
Plugin Module Structure
AdvancedOneBlock/
โโโ core/
โ โโโ OneBlockPlugin.java (Main class)
โ โโโ manager/
โ โ โโโ OneBlockManager.java (Phase + block logic)
โ โ โโโ PlayerDataManager.java (Load/save player data)
โ โ โโโ IslandManager.java (Island creation, sizing, teams)
โ โ โโโ QuestManager.java (Daily/weekly/story quest logic)
โ โ โโโ UpgradeManager.java (Upgrade tree logic)
โ โ โโโ SkillManager.java (Skill tree logic)
โ โ โโโ ShopManager.java (Shop price/item handling)
โ โ โโโ EconomyManager.java (Coin/Token/Gem transactions)
โ โ โโโ CrateManager.java (Crate keys, animations, rewards)
โ โ โโโ EventManager.java (Rotating server events)
โ โ โโโ BossManager.java (Phase boss spawning + AI)
โ โ โโโ AutomationManager.java (Auto-collector, compactor, etc.)
โ โ โโโ LeaderboardManager.java (Cached rankings)
โ โ โโโ AchievementManager.java (Achievement tracking)
โ โโโ data/
โ โ โโโ PlayerData.java
โ โ โโโ IslandData.java
โ โ โโโ TeamData.java
โ โ โโโ QuestData.java
โ โ โโโ UpgradeData.java
โ โโโ listener/
โ โ โโโ BlockBreakListener.java
โ โ โโโ MobSpawnListener.java
โ โ โโโ PlayerJoinListener.java
โ โ โโโ ItemPickupListener.java
โ โโโ command/
โ โ โโโ OneBlockCommand.java
โ โ โโโ AdminCommand.java
โ โโโ inventory/
โ โ โโโ InventoryGUI.java
โ โ โโโ InventoryButton.java
โ โ โโโ InventoryHandler.java
โ โ โโโ gui/
โ โ โ โโโ GUIManager.java
โ โ โ โโโ GUIListener.java
โ โ โโโ impl/
โ โ โโโ MainMenuGUI.java
โ โ โโโ ProfileGUI.java
โ โ โโโ QuestGUI.java
โ โ โโโ UpgradesGUI.java
โ โ โโโ SkillTreeGUI.java
โ โ โโโ ShopGUI.java
โ โ โโโ PrestigeGUI.java
โ โ โโโ TeamGUI.java
โ โ โโโ EventGUI.java
โ โ โโโ CollectionsGUI.java
โ โ โโโ LeaderboardGUI.java
โ โ โโโ AdminGUI.java
โ โโโ util/
โ โโโ ItemBuilder.java
โ โโโ ColorUtil.java
โ โโโ TimeUtil.java
โ โโโ NumberUtil.java
โ โโโ IslandUtil.java
โโโ resources/
โโโ plugin.yml
โโโ config.yml
โโโ messages.yml
โโโ phases/
โ โโโ phase_1.yml
โ โโโ phase_2.yml
โ โโโ ... phase_12.yml
โโโ quests/
โ โโโ daily_quests.yml
โ โโโ weekly_quests.yml
โ โโโ story_quests.yml
โโโ shop/
โ โโโ general_shop.yml
โ โโโ phase_shop.yml
โ โโโ prestige_shop.yml
โโโ upgrades.yml
โโโ skills.yml
โโโ crates.yml
โโโ achievements.yml
โโโ events.yml
Performance Considerations
Chunk Loading: Islands are in isolated regions, pre-generated on creation
Leaderboard Caching: Refreshed every 5 minutes via async Bukkit scheduler, never queried on-demand
Database Writes: Queued async write-batch every 30 seconds + on logout
Block Regeneration: Uses single scheduled task per island, not per-player
Mob Cleanup: Orphaned mobs checked every 60s, auto-removed if island empty
GUI Caching: Static GUIs (shop pages) cached on load, invalidated on config reload
Entity Limits: Per-island mob cap (configurable, default 50 entities)
Anti-Lag Strategy
All database I/O on async threads (HikariCP pool, 5 connections default)
Phase loot table lookups use pre-built weighted random (no runtime sorting)
Block regeneration timer minimum 50ms to prevent tick overflow
Automation systems tick every 5 seconds, not every tick
Event wave spawning uses BukkitScheduler spread across multiple ticks
J. RECOMMENDED FILE / CONFIG STRUCTURE
config.yml (master settings)
oneblock:
world: "oneblock_world"
island-spacing: 200
max-team-size: 5
default-island-size: 100
afk-kick-minutes: 30
block-regen-base-ms: 500
economy:
starting-coins: 1000
starting-tokens: 0
starting-gems: 5
auto-seller-daily-cap: 500000
auction-fee-percent: 2
performance:
leaderboard-refresh-seconds: 300
data-save-interval-seconds: 30
mob-cleanup-interval-seconds: 60
entity-limit-per-island: 50
debug:
enabled: false
log-block-breaks: false
log-economy: false
phases/phase_1.yml (example)
phase:
id: 1
name: "The Grasslands"
display-color: "GREEN"
break-start: 0
break-end: 500
boss:
name: "Slime King"
health: 200
arena-radius: 20
rewards:
on-complete:
coins: 5000
tokens: 50
items:
- "DIAMOND:2"
- "IRON_SWORD:1"
crate-keys:
common: 2
rare: 0
block-pool:
- material: "GRASS_BLOCK"
weight: 35
- material: "DIRT"
weight: 20
- material: "STONE"
weight: 15
- material: "OAK_LOG"
weight: 10
- material: "GRAVEL"
weight: 8
- type: "CHEST"
weight: 5
loot-table: "phase1_chest"
- type: "MOB_SPAWN"
weight: 5
mobs: ["ZOMBIE", "SPIDER", "SKELETON"]
- type: "STRUCTURE"
weight: 2
structure: "grass_platform"
mob-drops:
ZOMBIE:
coins: 25
items:
- material: "ROTTEN_FLESH"
chance: 0.8
amount: "1-3"
upgrades.yml (excerpt)
upgrades:
block_speed:
display-name: "Block Speed"
icon: "FEATHER"
tiers:
1:
cost-coins: 1000
cost-tokens: 0
regen-ms: 450
2:
cost-coins: 5000
cost-tokens: 10
regen-ms: 400
10:
cost-coins: 10000000
cost-tokens: 1000
regen-ms: 50
K. MONETIZATION RULES (COSMETIC ONLY)
Allowed (EULA compliant, not pay-to-win):
Cosmetic particle auras (Prestige Aura, Event Aura)
Custom island themes / terrain skins
Furniture and decor packs for the island
Chat name cosmetics (colors, symbols, animated)
Pet cosmetics (visual-only companions)
Crate key bundles (keys available through gameplay too)
Gem bundles (Gems only purchasable for cosmetics)
Title packs (display-only)
XP booster (convenience, not power) โ weekly limited, capped
Never Allowed:
Coins, Tokens, or gameplay-impacting currencies for real money
Upgrade tiers locked behind paywall
Phase skips
Power-boosting items exclusive to paid players
Private auctions or market advantages
Exclusive content not achievable through gameplay
Store Structure:
Monthly cosmetic pass: Island theme + particle + title
One-time bundles: Themed cosmetic sets
Vote rewards: Crate keys, XP boosters (keeps free-to-play loop engaging)
L. DEVELOPMENT ROADMAP
MVP (Month 1โ2)
Core OneBlock mechanic (regenerating block, phase 1โ4)
Basic economy (Coins only)
3 upgrades (Speed, Loot Quality, Auto-Collector)
Solo island creation and management
Daily quests (basic)
Shop (general only)
Common Crate
Commands: /ob, /upgrades, /quests, /shop
Basic GUI suite (Main menu, Profile, Upgrades, Shop)
V2 (Month 3โ4)
Phases 5โ8 + full phase boss system
Tokens currency + Skill Tree (2 branches)
Weekly quests + Story Quests (Phase 1โ4 arc)
Team/co-op islands (up to 3 players)
Automation systems (Auto-Collector, Compactor, Sorter)
Auction house
Rare + Legendary Crates
Leaderboard (Island XP ranking)
Events (Invasion Wave, Double XP)
Full GUI suite
V3 (Month 5โ6)
Phases 9โ12 + Prestige system
Gems currency + Prestige Shop
Story Quests complete (all 50)
Full Skill Tree (all 4 branches)
Dungeon system
Seasonal events (Halloween, Christmas)
Collections + Achievements (all 200)
Cosmetic shop (auras, titles, island themes)
Analytics dashboard (admin-side)
Discord webhook integration (boss kills, prestige announcements)
M. COMMANDS, PERMISSIONS, AND MENU FLOW
Player Commands
Command | Description | Permission |
|---|---|---|
/ob or /oneblock | Open main menu | oneblock.play |
/ob menu | Open main menu | oneblock.play |
/ob profile | Open profile | oneblock.play |
/ob quests | Open quest menu | oneblock.play |
/ob upgrades | Open upgrades menu | oneblock.play |
/ob skills | Open skill tree | oneblock.play |
/ob shop | Open shop | oneblock.shop |
/ob prestige | Open prestige menu | oneblock.prestige |
/ob team | Open team menu | oneblock.team.create |
/ob events | Open event menu | oneblock.event.join |
/ob leaderboard | Open leaderboard | oneblock.play |
/ob collections | Open collections | oneblock.play |
/ob home | Teleport to island | oneblock.play |
/ob create | Create new island | oneblock.play |
Admin Commands
Command | Description | Permission |
|---|---|---|
/oba reload | Reload all configs | oneblock.admin.reload |
/oba setphase <player> <phase> | Set player phase | oneblock.admin.setphase |
/oba addcoins <player> <amount> | Add coins | oneblock.admin.economy |
/oba removecoins <player> <amount> | Remove coins | oneblock.admin.economy |
/oba addtokens <player> <amount> | Add tokens | oneblock.admin.economy |
/oba addgems <player> <amount> | Add gems | oneblock.admin.economy |
/oba event start <event> | Force start event | oneblock.admin.event |
/oba event stop | Stop current event | oneblock.admin.event |
/oba player <player> | Open admin player view | oneblock.admin |
/oba givekey <player> <type> <amount> | Give crate keys | oneblock.admin |
Menu Flow Diagram
/ob
โโโ Main Menu
โโโ Profile
โ โโโ [View stats, close]
โโโ Quests
โ โโโ Daily Quests
โ โโโ Weekly Quests
โ โโโ Story Quests
โ โโโ Quest Detail โ [Track / Claim]
โโโ Upgrades
โ โโโ Category โ Tier List โ [Upgrade]
โโโ Shop
โ โโโ General โ Item โ [Buy/Sell]
โ โโโ Phase โ Item โ [Buy/Sell]
โ โโโ Black Market โ Item โ [Buy]
โโโ Skills
โ โโโ Branch โ Node โ [Unlock]
โโโ Events
โ โโโ Event Detail โ [Join]
โโโ Collections
โ โโโ Category โ Achievement Detail
โโโ Prestige
โ โโโ Prestige Detail โ [Confirm dialog]
โโโ Team
โ โโโ Members โ [Manage]
โ โโโ Bank โ [Deposit/Withdraw]
โ โโโ Log โ [View]
โโโ Leaderboard
โโโ [View rankings, click player for profile]
N. 10 UNIQUE STAND-OUT FEATURES
1. Phase Memory / Phase Lore System
Each phase has a 3-sentence lore snippet displayed as progressive โjournal entriesโ in the playerโs Profile. As they complete each phase, a new page is added, building a narrative of the playerโs journey. This gives emotional attachment to progression.
2. Living Island Ecosystem
The island visually transforms with each phase milestone. Trees grow, water appears, the terrainโs palette shifts, particles change color based on biome. The island feels alive and reactive to your progress without needing a separate world editor.
3. Combo Break System
Breaking blocks in rapid succession builds a Combo Multiplier (ร1 โ ร5). Stopping for more than 3 seconds resets it. This makes active play more rewarding than pure AFK automation โ gives keyboard players an edge and a reason to be engaged.
4. Phase Mirror Events
Every time a player completes a phase boss, a server-side echo event fires: all online players get a notification, the boss kill is logged to a โHall of Fameโ accessible via the Leaderboard GUI, and the player gets a special โBoss Slayerโ glow for 5 minutes.
5. Volatile Blocks
Every 1,000 breaks (scalable), a โVolatile Blockโ spawns in place of the normal block. It has a visual warning (particles, sound). Breaking it gives ร10 rewards but also triggers a risk event: mob ambush, resource drain, or a random positive/negative modifier for 60 seconds. This creates high-tension moments in routine gameplay.
6. Daily Discovery System
Each day, 3 โundiscoveredโ items are flagged in the block pool. When a player receives that item for the first time that day, they get a bonus reward and a โDiscovery Token.โ Discovery Tokens spent in a rotating Discovery Shop for rare rewards. Encourages daily engagement without feeling like a chore.
7. Island Personalities / Loadouts
At prestige, players can select an Island Personality โ a preset bonus profile (Warrior, Merchant, Scholar, Explorer). This gives a light RPG identity layer, allowing different playstyles without breaking balance. Cosmetically reinforced with different HUD colors, particle themes, and NPC chat lines.
8. Social Challenge System
Players can issue direct challenges to other players: โI bet I can reach Phase 6 before you.โ Challenges are accepted in-game, tracked by the plugin, and the winner gets a bonus reward. Challenge history is logged in the Profile menu, building a social competitive record.
9. Seasonal Phase Skins
During seasonal events, block pool entries change flavor: Grass becomes Pumpkin in October, Stone becomes Ice Bricks in December. The visual identity of the phases shifts without changing gameplay mechanics โ creating a shared seasonal experience that makes the world feel alive and time-sensitive.
10. The Archive โ End-Game Discovery Layer
At Phase 12, instead of the game ending, an โArchiveโ system unlocks โ a procedurally seeded collection of hidden lore items scattered across the block pool. Finding all 50 Archive Fragments unlocks a secret Phase 13 meta-narrative experience. This is the true end-game, rewarding deep players who have mastered everything else. Works as both a retention hook and a prestige status symbol.
Now Iโll implement the full plugin codebase:
The complete AdvancedOneBlock plugin has been implemented. Hereโs a summary of everything built:
Core Systems: 12-phase progression with weighted block pools, combo multiplier system, and anti-exploit rate limiting. Islands are isolated in a flat world with 200-block spacing.
Economy: Three currencies (Coins, Tokens, Gems) with daily sell caps, spend sinks, and an economy manager handling transactions, transfers, and prestige resets.
Upgrade & Skill Trees: 6 upgradeable trees (Block Speed, Loot Quality, Mob Bounty, Auto-Collector, XP Booster, Luck) each with 10 tiers, plus a 4-branch skill tree (Warrior, Miner, Merchant, Sage) with 16 skills and prerequisite chains.
Quest System: Daily (3), Weekly (2), and Story quests with auto-reset, progress tracking, multi-type objectives, and per-rarity rewards.
GUI Suite: 12 fully functional inventory GUIs (Main Menu, Profile, Quests, Upgrades, Skills, Shop, Prestige, Team, Events, Collections, Leaderboard, Crates, Admin) using the framework pattern with lazy initialization and button-based event handling.
Data: YAML-based flat file storage with in-memory caching, async leaderboard refresh, and session-end flushing โ zero external database dependencies for MVP.
Can you compile it?
package com.advancedoneblock;
import com.advancedoneblock.command.AdminCommand;
import com.advancedoneblock.command.OneBlockCommand;
import com.advancedoneblock.inventory.gui.GUIListener;
import com.advancedoneblock.inventory.gui.GUIManager;
import com.advancedoneblock.listener.BlockBreakListener;
import com.advancedoneblock.listener.MobDropListener;
import com.advancedoneblock.listener.PlayerJoinListener;
import com.advancedoneblock.listener.PhysicsListener;
import com.advancedoneblock.manager.AchievementManager;
import com.advancedoneblock.manager.AutomationManager;
import com.advancedoneblock.manager.BossManager;
import com.advancedoneblock.manager.CrateManager;
import com.advancedoneblock.manager.EconomyManager;
import com.advancedoneblock.manager.EventManager;
import com.advancedoneblock.manager.IslandManager;
import com.advancedoneblock.manager.LeaderboardManager;
import com.advancedoneblock.manager.OneBlockManager;
import com.advancedoneblock.manager.PlayerDataManager;
import com.advancedoneblock.manager.QuestManager;
import com.advancedoneblock.manager.ShopManager;
import com.advancedoneblock.manager.SkillManager;
import com.advancedoneblock.manager.UpgradeManager;
import lombok.Getter;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;
public class AdvancedOneBlock extends JavaPlugin {
@Getter private static AdvancedOneBlock instance;
@Getter private GUIManager guiManager;
@Getter private PlayerDataManager playerDataManager;
@Getter private IslandManager islandManager;
@Getter private OneBlockManager oneBlockManager;
@Getter private QuestManager questManager;
@Getter private UpgradeManager upgradeManager;
@Getter private SkillManager skillManager;
@Getter private ShopManager shopManager;
@Getter private EconomyManager economyManager;
@Getter private CrateManager crateManager;
@Getter private EventManager eventManager;
@Getter private BossManager bossManager;
@Getter private AutomationManager automationManager;
@Getter private LeaderboardManager leaderboardManager;
@Getter private AchievementManager achievementManager;
@Override
public void onEnable() {
instance = this;
saveDefaultConfig();
this.guiManager = new GUIManager();
this.playerDataManager = new PlayerDataManager(this);
this.islandManager = new IslandManager(this);
this.oneBlockManager = new OneBlockManager(this);
this.questManager = new QuestManager(this);
this.upgradeManager = new UpgradeManager(this);
this.skillManager = new SkillManager(this);
this.shopManager = new ShopManager(this);
this.economyManager = new EconomyManager(this);
this.crateManager = new CrateManager(this);
this.eventManager = new EventManager(this);
this.bossManager = new BossManager(this);
this.automationManager = new AutomationManager(this);
this.leaderboardManager = new LeaderboardManager(this);
this.achievementManager = new AchievementManager(this);
Bukkit.getPluginManager().registerEvents(new GUIListener(guiManager), this);
Bukkit.getPluginManager().registerEvents(new BlockBreakListener(this), this);
Bukkit.getPluginManager().registerEvents(new MobDropListener(this), this);
Bukkit.getPluginManager().registerEvents(new PlayerJoinListener(this), this);
Bukkit.getPluginManager().registerEvents(new PhysicsListener(this), this);
OneBlockCommand oneBlockCommand = new OneBlockCommand(this);
getCommand("oneblock").setExecutor(oneBlockCommand);
getCommand("oneblock").setTabCompleter(oneBlockCommand);
AdminCommand adminCommand = new AdminCommand(this);
getCommand("oba").setExecutor(adminCommand);
getCommand("oba").setTabCompleter(adminCommand);
leaderboardManager.startRefreshTask();
automationManager.startAutomationTask();
eventManager.startScheduler();
getLogger().info("AdvancedOneBlock enabled successfully.");
}
@Override
public void onDisable() {
if (playerDataManager != null) {
playerDataManager.saveAll();
}
getLogger().info("AdvancedOneBlock disabled.");
}
public void reloadPlugin() {
reloadConfig();
oneBlockManager.reload();
shopManager.reload();
questManager.reload();
upgradeManager.reload();
skillManager.reload();
crateManager.reload();
eventManager.reload();
achievementManager.reload();
}
}