You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+79-17
Original file line number
Diff line number
Diff line change
@@ -24,31 +24,31 @@ The user command is `/ob`. The admin command is `/oba`.
24
24
25
25
Q: What phases are there?
26
26
27
-
A: There are 11 phases: Plains, Underground, Winter, Ocean, Jungle, Swamp, Dungeon, Desert, The Nether, Plenty, Desolation, and The End. Each phase features a set of blocks, items, and mobs appropriate for the setting.
27
+
A: There are 12 phases: Plains, Underground, Winter, Ocean, Jungle, Swamp, Dungeon, Desert, The Nether, Plenty, Desolation, Deep Dark, and The End. Each phase features a set of blocks, chests, items, and mobs appropriate for the setting.
28
28
29
-
Q: How many blocks are there in the 11 phases?
29
+
Q: How many blocks are there in the phases?
30
30
31
-
A: There are currently 11 thousand blocks!
31
+
A: There are currently 12 thousand blocks!
32
32
33
33
Q: What happens after the last phase?
34
34
35
35
A: The phases repeat.
36
36
37
37
Q: Why do I keep falling and dying!
38
38
39
-
A: There are tricks to surviving, but it might be difficult! You need to build defenses.
39
+
A: There are tricks to surviving, but it might be difficult! You need to build space so you don't fall.
40
40
41
41
Q: I can't catch the blocks when I mine them! How do I do that?
42
42
43
-
A: Yep. It's tough. You can't catch them all, but it *is* an infinite block!
43
+
A: You can't catch them all, but it *is* an infinite block!
44
44
45
45
Q: Why do certain blocks spawn more frequently than others?
46
46
47
-
A: They just do! You can set the relative probability in the config files in the phases folder.
47
+
A: They just do! It's random. You can set the relative probability in the config files in the phases folder. Admins can also set certain blocks to appear at certain times no matter what. Look out for the sponge for example!
48
48
49
49
Q. How do I know which is the magic block?
50
50
51
-
A. Hit it and it will give out green particles.
51
+
A. Hit it and it will give out green particles. It's also at the center of your island.
52
52
53
53
Q. My magic block is no longer there! How do I get another one?
54
54
@@ -68,15 +68,15 @@ A. Be prepared. Listen carefully when you mine a block and you will hear hostile
68
68
69
69
Q. When mobs spawn, my defenses are destroyed! Why?
70
70
71
-
A. Mobs make space to spawn. If there's anything in the way, it'll be broken and dropped. You'll have to build accordingly.
71
+
A. Mobs make space to spawn. If there's anything in the way, it'll be broken and dropped. You'll have to build accordingly. This is to prevent suffocation exploits.
72
72
73
73
Q: Do chests spawn?
74
74
75
75
A: Yes. Chests spawn with random items in them from the current phase. There are common, uncommon, rare and epic chests. Chests with sparkles are good.
76
76
77
77
Q: Is it possible to reach the Nether or End in this map?
78
78
79
-
A: The vanilla Nether exists by default but there is no End world.
79
+
A: The vanilla Nether exists by default but there is no End world, just an End Phase.
80
80
81
81
Q: What is the end goal?
82
82
@@ -100,14 +100,81 @@ The config files to make the phases are in the phases folder.
100
100
There are two files per phase - a file that contains the blocks and mobs, and a file that contains the chests.
101
101
102
102
The first number of any file is how many blocks need to be mined to reach that phase. This is the phase's key number.
103
-
Each phase also has a name, a biome and the following sections:
104
-
103
+
Each phase also has a name, an icon, a biome and the following sections:
104
+
105
+
- name
106
+
- icon
107
+
- fixedBlocks
108
+
- holograms
109
+
- biome
110
+
- start-commands
111
+
- end-commands
112
+
- end-commands-first-time
113
+
- requirements
105
114
- blocks
106
115
- mobs
107
116
108
117
In the chests file, it just has the phase number and a chests section.
109
118
110
-
119
+
### name
120
+
Name of the phase
121
+
122
+
### icon
123
+
The material for an icon to show
124
+
125
+
### fixedBlocks
126
+
List of blocks that will generate at these specific block counts. The numbers are relative to the phase and not the overall player's count.
127
+
If you define 0 here, then firstBlock is not required and firstBlock will be replaced with this block.
128
+
129
+
### holograms
130
+
131
+
Hologram Lines to Display. The key number is the block of the phase to show the hologram. Chat color codes can be used. A hologram plugin is not required for these holograms.
132
+
The First (Before Phase 1) Hologram is Located in your Locale.
133
+
134
+
### Biome
135
+
The biomes for this phase.
136
+
137
+
### Commands
138
+
A list of commands can be run at the start and end of a phase. Commands are run as the Console
139
+
unless the command is prefixed with [SUDO], then the command is run as the player
140
+
triggering the commands.
141
+
142
+
These placeholders in the command string will be replaced with the appropriate value:
143
+
*[island] - Island name
144
+
*[owner] - Island owner's name
145
+
*[player] - The name of the player who broke the block triggering the commands
146
+
*[phase] - the name of this phase
147
+
*[blocks] - the number of blocks broken
148
+
*[level] - your island level (Requires Levels Addon)
149
+
*[bank-balance] - your island bank balance (Requires Bank Addon)
150
+
*[eco-balance] - player's economy balance (Requires Vault and an economy plugin)
151
+
152
+
Examples:
153
+
```
154
+
start-commands:
155
+
- 'give [player] WOODEN_AXE 1'
156
+
- 'broadcast [player] just started OneBlock!'
157
+
end-commands:
158
+
- '[SUDO]summon minecraft:wither'
159
+
These are run only the first time a phase is completed
160
+
end-commands-first-time:
161
+
- 'broadcast &c&l[!] &b[player] &fhas completed the &d&n[phase]&f phase for the first time.'
162
+
```
163
+
### Requirements
164
+
165
+
You can stipulate a set of requirements to start the phase:
166
+
* economy-balance - the minimum player's economy balance (Requires Vault and an economy plugin)
167
+
* bank-balance - the minimum island bank balance (requires Bank Addon)
168
+
* level - the island level (Requires Levels Addon)
169
+
* permission - a permission string
170
+
Example:
171
+
```
172
+
requirements:
173
+
bank-balance: 10000
174
+
level: 10
175
+
permission: ready.for.battle
176
+
```
177
+
111
178
### blocks
112
179
113
180
The blocks section list Bukkit Materials followed by a relative probability. All the probability values are added up for the whole phase and the chance of the block being placed is the relative probability divided by the total of all the probabilities.
@@ -130,11 +197,6 @@ OneBlock is an add-on that uses the BentoBox API. Here are some other ones that
130
197
131
198
You can add all the usual addons to OneBlock, like Challeges, Likes, Level, Warps, etc. but it is not required.
132
199
133
-
### Other Plugins
134
-
135
-
* To use the Holographic phase names, you will need to install the [Holographic Displays plugin](https://dev.bukkit.org/projects/holographic-displays)
136
-
137
-
138
200
Bugs and Feature requests
139
201
=========================
140
202
File bug and feature requests here: https://github.com/BentoBoxWorld/OneBlock/issues
0 commit comments