Skip to content

Commit 6722f44

Browse files
committed
Bump version to 1.0.6
1 parent b672e76 commit 6722f44

3 files changed

Lines changed: 73 additions & 56 deletions

File tree

README.md

Lines changed: 69 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# BoundingBoxOutlineReloaded
22

3-
BoundingBoxOutlineReloaded is a mod for Minecraft Vanilla, Forge, LiteLoader, Rift and Fabric
3+
BoundingBoxOutlineReloaded is a mod for Minecraft Vanilla, Forge, LiteLoader, Rift, and Fabric
44

5-
# Why did I make it?
5+
## Why did I make it?
66

77
I loved 4poc's BBOutline mod but the only version I could get to work consistently was for Minecraft 1.6.4. This is fine if you want Nether Fortress bounding boxes but if you need witch huts the new block types can cause Minecraft 1.6.4 to crash horribly; and don't get me started on item frames crashing Minecraft 1.6.4!
88

99
In addition to this not working with newer worlds, the way it bounds villages lacks the finesse of KaboPC's VillageMarker mod, and any new structures introduced in Minecraft like Ocean Monuments are missing entirely.
1010

11-
# What it does
11+
## What it does
1212

1313
This mod highlights in a variety of colours and styles the different structures & features of the game:-
1414
- Nether Fortresses; red boxes bound each individual area where Blaze, Wither Skeletons & normal Skeletons will spawn. Time for a beacon methinks!
@@ -30,75 +30,89 @@ This mod highlights in a variety of colours and styles the different structures
3030
- Mob Spawners; bright green boxes show where mob spawners are, where mobs will be spawned, and red/orange/green lines help the player see if a spawner is nearby and activated.
3131
- Pillager Outposts; grey boxes outline where crossbow wielding pillagers will spawn. Beware of bad omens tho!
3232

33-
(*) Due to how Minecraft generates these structures they will initially float above where they should be, however upon re-logging they should drop down to the correct height. Unfortunately (or fortunately?) buried treasure will always appear at y-90 (unless Mojang change something that is!)
33+
(*) Due to how Minecraft generates these structures they will initially float above where they should be, however upon re-logging they should drop down to the correct height. Unfortunately (or fortunately?) buried treasure will always appear at y-90 (unless Mojang change something that is!)
3434

35-
# How it works
35+
## How it works
3636

37-
As chunks are loaded the game provides metadata about all the different structures & features in those chunks. The mod interprets this meta data, caches the results, and renders the bounding boxes to the screen. In an SMP environment this data is not present on the clients so the mod needs to run on the server where the processing happens and then the relevant metadata is sent to the clients for them to render.
37+
As chunks are loaded the game provides metadata about all the different structures & features in those chunks. The mod interprets this meta data, caches the results, and renders the bounding boxes to the screen. In an SMP environment this data is not present on the clients so the mod needs to run on the server where the processing happens and then the relevant metadata is sent to the clients for them to render.
3838

39-
# Installing (Forge/LiteLoader/Rift/Fabric)
39+
## Installing (Forge/LiteLoader/Rift/Fabric)
4040

41-
Make sure you have the relevant mod loader installed then drop the mod file into the appropriate mods folder. [Forge Only] If you want to use client/server with your SMP server then make sure the mod is installed on both client and server.
41+
Make sure you have the relevant mod loader installed then drop the mod file into the appropriate mods folder. This approach can be used for client and server deployments where needed.
4242

43-
# Installing (Vanilla)
43+
## Installing (Vanilla)
4444

45-
Double-click the jar file and a profile for the relevant version of Minecraft will be created/updated in the launcher. In a SMP scenario you'll need to use local dat files - see below.
45+
Double-click the jar file and a client profile for the relevant version of Minecraft will be created/updated in the launcher.
4646

47-
# Configuring
47+
## Running a server (Vanilla)
48+
49+
To start a vanilla server with the mod loaded, copy the relevant jar file to a folder, and run:-
50+
```
51+
java -jar BBOutlineReloaded-{version}.jar --server
52+
```
53+
54+
Running this will download the necessary pre-requisities and start the server.
55+
56+
## Configuring
4857

4958
The keyboard shortcuts can be configured in the standard Controls screen.
5059

51-
The following options are available for configuration
52-
53-
Option | Client/Server | Description | Cfg File Key | Cfg File Values | Default
54-
--- | --- | --- | --- | --- | ---
55-
Nether Fortresses | Both | Process/Render Nether Fortresses | drawNetherFortresses | true/false | true
56-
Witch Huts | Both | Process/Render Witch Huts | drawWitchHuts | true/false | true
57-
Desert Temples | Both | Process/Render Desert Temples | drawDesertTemples | true/false | true
58-
Jungle Temples | Both | Process/Render Jungle Temples | drawJungleTemples | true/false | true
59-
Ocean Monuments | Both | Process/Render Ocean Monuments | drawOceanMonuments | true/false | true
60-
End Cities | Both | Process/Render End Cities | drawEndCities | true/false | true
61-
Strongholds | Both | Process/Render Strongholds | drawStrongholds | true/false | false
62-
Woodland Mansions | Both | Process/Render Mansions | drawMansions | true/false | true
63-
Mine Shafts | Both | Process/Render Mine Shafts | drawMineShafts | true/false | false
64-
Igloos | Client | Process/Render Igloos | drawIgloos | true/false | true
65-
Shipwrecks | Client | Process/Render Shipwrecks | drawShipwrecks | true/false | true
66-
Ocean Ruins | Client | Process/Render Ocean Ruins | drawOceanRuins | true/false | true
67-
Buried Treasure | Client | Process/Render Buried Treasure | drawBuriedTreasure | true/false | true
68-
Mob Spawner | Client | Process/Render Mob Spawners | drawMobSpawners | true/false | true
69-
Mob Spawner Spawn Area | Client | Render where mobs will be spawned | renderMobSpawnerSpawnArea | true/false | true
70-
Mob Spawner Activation Lines | Client | Render red/orange/green lines to show nearby spawners and if they are active | renderMobSpawnerActivationLines | true/false | true
71-
Pillager Outposts | Client | Process/Render Pillager Outpoints | drawPillagerOutposts | true/false | true
72-
Villages | Both | Process/Render Villages | drawVillages | true/false | true
73-
Village spheres | Client | Render Villages as spheres instead of cuboids | renderVillageAsSphere | true/false | true
74-
Village Iron Golem Spawn Area | Client | Render Iron Golem Spawn Area within valid Villages | drawIronGolemSpawnArea | true/false | true
75-
Village doors | Client | Render lines between village centre and doors | drawVillageDoors | true/false | false
76-
Slime Chunks | Client | Process/Render Slime Chunks | drawSlimeChunks | true/false | true
77-
Slime Chunks Maximum Y | Client | Maximum Y value of the dynamic slime chunk boxes | slimeChunkMaxY | -1-255 (see below) | -1
78-
World Spawn | Client | Process/Render World Spawn & Spawn Active Chunks | drawWorldSpawn | true/false | true
79-
World Spawn Maximum Y | Client | Maximum Y value of the world spawn & spawn chunk boxes | worldSpawnMaxY | -1-255 (see below) | -1
80-
Lazy Spawn Chunks | Client | Process/Render Lazy Spawn Chunks | drawLazySpawnChunks | true/false | false
81-
Fill | Client | Fill the bounding boxes (except village ones) | fill | true/false | true
82-
Always Visible | Client | Bounding boxes are visible through blocks - kinda messes with perspective tho! | alwaysVisible | true/false | false
83-
Keep Cache Between Sessions | Client | Bounding box caches are not cleared when disconnecting from single or multiplayer worlds. | keepCacheBetweenSessions | true/false | false
60+
The following options are available for configuration on the client through a configuration Gui. On Vanilla, Rift & Fabric there is a BBOR button on the options screen, alternatively press and hold B key when in game.
61+
62+
Option | Description | Cfg File Key | Cfg File Values | Default
63+
--- | --- | --- | --- | ---
64+
Nether Fortresses | Process/Render Nether Fortresses | drawNetherFortresses | true/false | true
65+
Witch Huts | Process/Render Witch Huts | drawWitchHuts | true/false | true
66+
Desert Temples | Process/Render Desert Temples | drawDesertTemples | true/false | true
67+
Jungle Temples | Process/Render Jungle Temples | drawJungleTemples | true/false | true
68+
Ocean Monuments | Process/Render Ocean Monuments | drawOceanMonuments | true/false | true
69+
End Cities | Process/Render End Cities | drawEndCities | true/false | true
70+
Strongholds | Process/Render Strongholds | drawStrongholds | true/false | false
71+
Woodland Mansions | Process/Render Mansions | drawMansions | true/false | true
72+
Mine Shafts | Process/Render Mine Shafts | drawMineShafts | true/false | false
73+
Igloos | Process/Render Igloos | drawIgloos | true/false | true
74+
Shipwrecks | Process/Render Shipwrecks | drawShipwrecks | true/false | true
75+
Ocean Ruins | Process/Render Ocean Ruins | drawOceanRuins | true/false | true
76+
Buried Treasure | Process/Render Buried Treasure | drawBuriedTreasure | true/false | true
77+
Mob Spawner | Process/Render Mob Spawners | drawMobSpawners | true/false | true
78+
Mob Spawner Spawn Area | Render where mobs will be spawned | renderMobSpawnerSpawnArea | true/false | true
79+
Mob Spawner Activation Lines | Render red/orange/green lines to show nearby spawners and if they are active | renderMobSpawnerActivationLines | true/false | true
80+
Pillager Outposts | Process/Render Pillager Outpoints | drawPillagerOutposts | true/false | true
81+
Villages | Process/Render Villages | drawVillages | true/false | true
82+
Village spheres | Render Villages as spheres instead of cuboids | renderVillageAsSphere | true/false | true
83+
Village sphere dot size | The size of the dots used when rendering village as sphere | villageSphereDotSize | 1-5 | 3
84+
Village sphere density | The density of the dots used when rendering village as sphere | villageSphereDensity | 1-5 | 3
85+
Village Iron Golem Spawn Area | Render Iron Golem Spawn Area within valid Villages | drawIronGolemSpawnArea | true/false | true
86+
Village doors | Render lines between village centre and doors | drawVillageDoors | true/false | false
87+
Slime Chunks | Process/Render Slime Chunks | drawSlimeChunks | true/false | true
88+
Slime Chunks Maximum Y | Maximum Y value of the dynamic slime chunk boxes | slimeChunkMaxY | -1-255 (see below) | -1
89+
World Spawn | Process/Render World Spawn & Spawn Active Chunks | drawWorldSpawn | true/false | true
90+
World Spawn Maximum Y | Maximum Y value of the world spawn & spawn chunk boxes | worldSpawnMaxY | -1-255 (see below) | -1
91+
Lazy Spawn Chunks | Process/Render Lazy Spawn Chunks | drawLazySpawnChunks | true/false | false
92+
Fill | Fill the bounding boxes (except village ones) | fill | true/false | true
93+
Always Visible | Bounding boxes are visible through blocks - kinda messes with perspective tho! | alwaysVisible | true/false | false
94+
Keep Cache Between Sessions | Bounding box caches are not cleared when disconnecting from single or multiplayer worlds. | keepCacheBetweenSessions | true/false | false
95+
Outer Boxes Only | Render outer bounding boxes only | outerBoxesOnly | true/false | false
8496

8597
The Maximum Y value configuration options have some special values, these are:-
8698
* -1 = the Y value of the players feet when the bounding boxes were activated.
8799
* 0 = the current Y value of the players feet.
88100

89-
Open the config/BBOutlineReloaded.cfg file with your text editor of choice and change the settings. Simples! Minecraft (including servers) will need to be restarted for the settings to take effect.
101+
Another option to configure is to open the config/BBOutlineReloaded.cfg file with your text editor of choice and change the settings. Simples! Minecraft Client will need to be restarted for the settings changed this way to take effect.
90102

91-
# Using
103+
## Using
92104

93-
Press B, sit back and enjoy the goodness flowing onto your screen.
94-
Press O to switch the "Display Outer Boxes Only" mode on and off, this will allow you to see the full boundary of Nether Fortresses, End Cities, Strongholds and Mineshafts
105+
- Press B, sit back and enjoy the goodness flowing onto your screen.
106+
- Press and hold B to open the configuration Gui.
107+
- Press O to switch the "Display Outer Boxes Only" mode on and off, this will allow you to see the full boundary of Nether Fortresses, End Cities, Strongholds and Mineshafts
95108

96-
# Bounding boxes when connected to vanilla servers
109+
## Bounding boxes when connected to servers
97110

98-
There are two options when you want bounding boxes to show whilst accessing vanilla servers:-
111+
There are a few options when you want bounding boxes to show whilst accessing servers:-
99112

100-
1. Keep cache - With the "Keep Cache Between Sessions" config setting enabled, Open a copy of the world in single player and move around to capture all the structures you want in the cache. Once you are happy with the structures you have cached, quit the single player game and connect to the server without closing Minecraft. You will see all the structures from the cache.
101-
2. Load dat files - Copy the dat files listed below into config/BBOutlineReloaded/{host}/{port} and these will be loaded when you connect to the vanilla server. {host} is the name or ip you use to connect to the server; {port} is the port you specify when connecting. The mod will load any/all of following files:-
113+
- Use a modded server - Ensure the server is running with this mod loaded (as described above), and connect to the server with a client with this mod loaded.
114+
- Keep cache - With the "Keep Cache Between Sessions" config setting enabled, Open a copy of the world in single player and move around to capture all the structures you want in the cache. Once you are happy with the structures you have cached, quit the single player game and connect to the server without closing Minecraft. You will see all the structures from the cache.
115+
- Load dat files(*) - Copy the dat files listed below into config/BBOutlineReloaded/{host}/{port} and these will be loaded when you connect to the vanilla server. {host} is the name or ip you use to connect to the server; {port} is the port you specify when connecting. The mod will load any/all of following files:-
102116
- level.dat; include this for world spawn, spawn and slime chunks to be rendered.
103117
- Fortress.dat; include this for Nether Fortresses to be rendered.
104118
- EndCities.dat; include this for EndCities to be rendered.
@@ -108,9 +122,11 @@ There are two options when you want bounding boxes to show whilst accessing vani
108122
- Mansion.dat; include this for Mansions to be rendered.
109123
- Temple.dat; include this for Desert & Jungle Temples and witch huts to be rendered.
110124

125+
(*) This is becoming more and more irrelevant as dat files are being phased out, and this feature may be removed/replaced in the future.
126+
111127
It is also possible to include the villages.dat, villages_end.dat & villages_nether.dat files and it will render villages however these files only contain the villages that were loaded when the files were copied and will not handle any changes that occur with villages such as when doors are added/removed or villager population changes.
112128

113-
# Links
129+
## Links
114130
- Forge - [Download](https://files.minecraftforge.net/)
115131
- 4poc's BBOutline mod - [Forum](http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-mods/1286555-bounding-box-outline) | [Source](http://www.github.com/4poc/bboutline)
116132
- KaboPC's VillageMarker mod - [Forum](http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-mods/1288327-village-marker-mod)

gradle.properties

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
name = bbor
2-
buildVersion = 1.0.5
2+
buildVersion = 1.0.6
33
mcVersion = 1.13

src/main/resources/profile.json

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,12 @@
1313
"mainClass": "net.minecraft.launchwrapper.Launch",
1414
"libraries": [
1515
{
16-
"name": "com.irtimaled:bbor:${version}"
16+
"name": "com.irtimaled:bbor:${version}",
17+
"url": "https://github.com/irtimaled/maven/releases/download/"
1718
},
1819
{
1920
"name": "org.spongepowered:mixin:0.7.11-SNAPSHOT",
20-
"url": "https://github.com/irtimaled/Mixin/releases/download/"
21+
"url": "https://github.com/irtimaled/maven/releases/download/"
2122
},
2223
{
2324
"name": "org.ow2.asm:asm:6.2",

0 commit comments

Comments
 (0)