OneBlock

OneBlock minigame plugin.

🌍 How to Start OneBlock?

1. Create the World

Generate a dedicated OneBlock world. For example, using Multiverse-Core: ``` /mv create OneBlock normal -g Oneblock ```

2. Set the Spawn Point

Initialize the OneBlock area: ``` /ob set ``` ``` /ob set 500 ``` - Sets the reference point using the current position of the player (admin) who used it, indicating a custom offset or with a default offset (100).

``` /ob set <offset> <x> <y> <z> [world] ``` - Alternative method. Sets the position and offset manually.

3. Join the Game

Players can teleport to their island by entering: ``` /ob join ``` or simply /ob

🔧 Command Reference

Core Commands:

- /ob IDreset - Join to your island - /ob IDreset - Invite player to your island - /ob IDreset - Remove player from your island - /ob IDreset - Accept island invitation - /ob IDreset - Resets your attachment to the island so that you can create a new island. (reset progress)

Settings Commands:

- /ob progress_bar settext <text> - Set the first block (admin only) - /ob progress_bar settext <text> - Set island spacing (e.g., 500 blocks) - /ob progress_bar settext <text> - Enable circular island generation - /ob progress_bar settext <text> - Auto-join players on world entry - /ob progress_bar settext <text> - Prevent leaving islands - /ob progress_bar settext <text> - Enable player borders - /ob progress_bar settext <text> - Toss items upward when dropped - /ob progress_bar settext <text> - Toggle block physics (e.g., falling gravel) - /ob progress_bar settext <text> - Set level multiplier formula - /ob progress_bar settext <text> - Reuse abandoned islands - /ob progress_bar settext <text> - Enable custom islands - /ob progress_bar settext <text> - Set your island as default template - /ob progress_bar settext <text> - Reset to default island - /ob progress_bar settext <text> - Enable island rebirth - /ob progress_bar settext <text> - Set color - /ob progress_bar settext <text> - Toggle progress bar - /ob progress_bar settext <text> - Progress_bar level mode - /ob progress_bar settext <text> - Progress_bar text change

Config Commands:

- /ob listlvl [level] - Reload configuration files - /ob listlvl [level] - List all levels - /ob listlvl [level] - Show blocks for specific level

Other Commands:

- /ob leave - Resets attachment to the island for the player. - /ob leave - Set ob level - /ob leave - Reset the player ob level and remove his island - /ob leave - /ob leave

🎨 Progress Bar Customization

You can display the level in the progress bar:

You can change the color of the progress bar:

use: /ob Progress_bar level

You can specify the color of the progress bar for each level separately! In the blocks.yml file, the second line (after the line with the name of the level)

📊 PlaceholderAPI Support

- %OB_ver% - %OB_lvl% - The player's level number. - %OB_next_lvl% - The number of the next level. - %OB_break_on_this_lvl% - The number of broken blocks at this level. - %OB_need_to_lvl_up% - The number of blocks that still need to be broken to level up. - %OB_player_count% - The number of players in the OneBlock world. - %OB_lvl_name% - The name of the player's current level. - %OB_lvl_lenght% - The length of the level. - %OB_next_lvl_name% - The name of the next level.​ - %OB_owner_name% - The name of the owner of your island. - %OB_owner_online% - Returns "online" if the island owner is currently online, otherwise "offline". - %OB_percent% - Percentage of level completion. - %OB_scale% - Proportional scale of level completion. - %OB_top_1_name% - The name of the player with the highest island level. - %OB_top_2_name% - ... - %OB_top_10_name% - %OB_top_1_lvl% - The level of the player with the highest island level. - %OB_top_2_lvl% - ... - %OB_top_10_lvl% - %OB_number_of_invited% - The number of people invited to your island.

🎯 Special Placeholder Modifier: _by_position

You can append _by_position to any placeholder to get information about the island at your current location instead of your own island.

Examples: - %OB_lvl_by_position% - Shows the level of the island at your current location. - %OB_owner_name_by_position% - Shows the owner name of the island at your current location. - %OB_visits_by_position% - Shows the visit count of the island at your current location. - %OB_break_on_this_lvl_by_position% - Shows blocks broken on the island at your current location.

This is especially useful when visiting other players' islands or when you want to display information about a specific island based on location rather than the player viewing the placeholder.

🕬 You can use placeholders in the progress bar text!

/ob progress_bar settext %OB_lvl% lvl now. Need block to next lvl %OB_need_to_lvl_up%.

🧱 Custom Blocks Support

ItemsAdder Blocks

Native id support in blocks.yml

Oraxen Blocks

Native id support in blocks.yml

Nexo Blocks

Native id support in blocks.yml

CraftEngine Blocks

Native id support in blocks.yml

Other

In addition, you can spawn custom blocks (from mods or plugins) using the commands specified in blocks.yml

for example: - command: /execute in minecraft:overworld run setblock %d %d %d IC2:blockOreCopper - command: /execute in minecraft:overworld run setblock %d %d %d IC2:blockOreTin - command: /execute in minecraft:overworld run setblock %d %d %d IC2:blockOreUran - command: /execute in minecraft:overworld run setblock %d %d %d ic2:resource 4

or

- command: execute in {world} run setblock %d %d %d IC2:blockOreCopper - command: execute in {world} run setblock %d %d %d IC2:blockOreTin - command: execute in {world} run setblock %d %d %d IC2:blockOreUran - command: execute in {world} run setblock %d %d %d ic2:resource 4

🏝️ Island Templates

Create custom default islands (7x12x7 area): ``` /ob islands set_my_by_def ``` - will save a copy of your island and install it for the players.

📈 Stats