README.md

   1 # BoundingBoxOutlineReloaded
   2
   3 BoundingBoxOutlineReloaded is a mod for Minecraft 1.8 using Forge API.
   4
   5 # Why did I make it?
   6
   7 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!
   8
   9 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.
  10
  11 # What it does
  12
  13 This mod highlights in a variety of colours and styles the different structures & features of the game:-
  14 - Nether Fortresses; red boxes bound each individual area where Blaze, Wither Skeletons & normal Skeletons will spawn. Time for a beacon methinks!
  15 - Witch Huts; blue boxes reveal everywhere only witches spawn. Witch farm anyone?
  16 - Desert Temples; orange boxes envelop the pyramid and towers. Go grab some loot but beware TNT boobie traps!
  17 - Jungle Temples; green boxes surround the temple. Indianna Jones would've love these!
  18 - Ocean Monuments; cyan boxes indicate where guardians spawn. New sea lantern and prismarine block types FTW.
  19 - Strongholds; yellow boxes show each room in the stronghold. Does anyone make anything with silverfish spawners?
  20 - Mine Shafts; light gray boxes illustrate each of the mine shafts. Cobwebs... grrr!
  21 - Villages; multicoloured spheres encircle  the village, with boxes marking if and where iron golems will spawn. You should see the iron titan... CRAZY!
  22 - Slime chunks; bright green boxes highlight where slimes will spawn, with a dynamic box that rises to where the players feet are to help find them from the surface. Bouncy... bouncy...
  23
  24 # How it works
  25
  26 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.
  27
  28 To toggle the rendering of the bounding boxes press B.
  29
  30 # Installing
  31
  32 Make sure you have Forge 1.8 installed then drop the jar file into the mods/1.8 folder.  Remember this will need to be installed on client and server in an SMP scenario.
  33
  34 # Using
  35
  36 Press B, sit back and enjoy the goodness flowing onto your screen.
  37
  38 # Configuring
  39
  40 The keyboard shortcut can be configured in the standard Controls screen.
  41
  42 There are two ways to edit the config - in game or cfg file editing (although cfg editing is the only option on SMP servers.)
  43
  44 The following options are available for configuration
  45
  46 Option | Client/Server | Description | Cfg File Key | Cfg File Values | Default
  47 --- | --- | --- | --- | --- | ---
  48 Nether Fortresses | Both | Process/Render Nether Fortresses | drawDesertTemples | true/false | true
  49 Witch Huts | Both | Process/Render Witch Huts | drawWitchHuts | true/false | true
  50 Desert Temples | Both | Process/Render Desert Temples | drawDesertTemples | true/false | true
  51 Jungle Temples | Both | Process/Render Jungle Temples | drawJungleTemples | true/false | true
  52 Ocean Monuments | Both | Process/Render Ocean Monuments | drawOceanMonuments | true/false | true
  53 Strongholds | Both | Process/Render Strongholds | drawStrongholds | true/false | false
  54 Mine Shafts | Both | Process/Render Mine Shafts | drawMineShafts | true/false | false
  55 Villages | Both | Process/Render Villages | drawVillages | true/false | true
  56 Village spheres | Client | Render Villages as spheres instead of cuboids | renderVillageAsSphere | true/false | true
  57 Village Iron Golem Spawn Area | Client | Render Iron Golem Spawn Area within valid Villages | drawIronGolemSpawnArea | true/false | true
  58 Slime Chunks | Both | Process/Render Slime Chunks | drawSlimeChunks | true/false | true
  59 Slime Chunks Maximum Y | Client | Maximum Y value of the dynamic slime chunk boxes | slimeChunkMaxY | 0/40-255 (0 = no limit) | 0
  60 Fill | Client | Fill the bounding boxes (except village ones) | fill | true/false | false
  61 Always Visible | Client | Bounding boxes are visible through blocks - kinda messes with perspective tho! | alwaysVisible | true/false | false
  62
  63 ### In game
  64
  65 *Note: In game editing is incomplete.*
  66
  67 Forge provides a UI to edit configuration of mods - this mod provides the ability to control many aspects of the mods behaviour.  On the home screen of Minecraft select the Mods button, select this mod and click on the config button.
  68
  69 ### Cfg file editing
  70
  71 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.
  72
  73 # Links
  74 - Forge 1.8 - [Download](http://files.minecraftforge.net/minecraftforge/1.8)
  75 - 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)
  76 - KaboPC's VillageMarker mod - [Forum](http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-mods/1288327-village-marker-mod)