BonsaiTrees 🌳 🌴 🌲
A Minecraft mod adding a block that grows small trees in two block spaces.
You can grab the latest Travis build from here.
Here's a good spotlight for an older version of the mod that did not include the soil mechanics yet.
How to get started
- Craft a Bonsai Pot and place it somewhere with at least one block of air above it
- Find some soil to use in your pot. Dirt will do for now. Right-click it on the Bonsai Pot.
- Get a compatible sapling and right-click it on the Bonsai Pot
- Watch it grow.
- You can then optionally harvest the tree by right clicking it with an axe or breaking the block. The Bonsai Pot itself only breaks when there is no sapling growing at the moment.
- You can also upgrade your Bonsai Pot to a Hopping Bonsai Pot which automatically drops the items into inventories below the Pot. This might be disabled in the config though!
- Use dyes to color your pot. Just right-click the pot while holding any dye. This works on normal and on hopping pots!
A particular soil might be needed for some of the trees. And the different types of soil provide different boosts to the growth of your Bonsai. It is recommended to use JEI to look up compatible saplings and available soils. Waila and TheOneProbe will show what sapling is growing on what soil and its progress.
Integrated support @ 2017-10-03:
- All Vanilla trees
- All Forestry trees incl. mods utilizing the Forestry Tree system (i.e. ExtraTrees)
- All Pam's Harvestcraft trees
And in no particular order:
IndustrialCraft 2, Integrated Dynamics, Totemic, Rustic, PrimalCore, Traverse, Tinkers Construct, Natura, AbyssalCraft, Twilight Forest, Thaumcraft, Terraqueous
If you want to see more trees supported and are a tiny bit proficient with minecraft and git, please read the "Making a Sapling compatible yourself" section below and create a Pull Request.
Generating Missing Shapes
Newer versions of Forestry or Pams might add more trees that are invisible when planted in a Bonsai Pot. This is because there are two parts required for a tree being compatible:
- A TreeType definition, this can either be Java code or JSON
- Some shape descriptions for that tree type, these are all JSON In case of these mods their tree types are dynamically added via Java, so they are simply missing the corresponding shape files. The server log notifies you about these.
But it is relatively easy to auto-generate those shape files (and I appreciate pull requests for them so others can benefit of your work) in most cases:
- Create a new super-flat world, the following step will erase a 32x32 block area!
- Look somewhere on the ground and enter the command:
/bonsaitrees generateMissingShapes yes
- This will generate all the missing shapes in the
configs/bonsaitrees/shapes.dfolder, make sure to have them on both client and server.
- Restart the game and continue playing your normal world
If there is no way for Bonsai Trees to know how to actually grow a tree, you will need to create the shape JSON yourself. There is another command helping you with this:
/bonsaitrees saveTreeShape <tree-type-name>. So your process in case you want to define some shapes for
mytreemod:redstone_tree would be something like this:
- Grow a few of your trees or build a structure resembling your tree (maybe you want to grow bonsai redstone crystals?). Make sure all they are touching is dirt and air. This is really important or your shape will include whatever they were touching.
- Look at it directly and enter the command
/bonsaitrees saveTreeShape mytreemod:redstone_tree
- Repeat step 2 for the other shapes of your tree so you have more than one tree shape growing in your bonsai pots.
- After making sure you have the shape configs on the client as well as the server, restart the game and continue playing your normal world
Making a Sapling compatible yourself
Simple trees via JSON files
name: The name of the tree type, this must be unique and generally follows the ResourceLocation naming scheme. Only the first tree type with a given name will be loaded, all following tree types with the same name will be skipped.
mod: Specify this if this tree type is only available if the given mod is loaded.
sapling: Used to describe the sapling that grows into this tree type. This is simply the item registry name and the meta data.
growTimeMultiplier: A factor the default grow time (configureable via config) will be multiplied with. Use this to change the time required for a tree of this type to grow.
drops: Is an array of items being dropped. Each entry requires an item registry name and its metadata, but also a
typeit belongs to. You can think of this as a category of which there are 5:
STICK. These are used to determine the chance and amounts for this item to drop. You can also specify
CUSTOM, but then you'd also have to specify a
countproperty between 1 and 64 and a
chancebetween 0.0 and 1.0.
worldgen: Allows specifying a class extending WorldGenerator to be used when generating shapes. This can be used if the modded sapling does not extend BlockSapling or does not properly override the generateTree method of it.
compatibleSoilTags: An array of strings specifying on which types of soil this tree can grow. If you skip this entry it will default to 'dirt' and 'grass'. Read the Soil Compatibility section below for more details on how this affects your tree.
If you've created a new tree from scratch remember to create tree shapes for it as explained in the section above. Please consider creating a Pull Request for these, so other users can benefit from your work as well!
Saplings with NBT data
These currently require Java code to be integrated. There is a work-in-progress API, but I'm very certain that i'll change it again and it is not yet final. Please don't use it at this point.
Custom Soil using JSON files
You can easily add new soils to the mod using .json files, very similar to the way you add trees. Example: config/soils.d/dirt.json
name: The internal name of the soil, this must be unique and generally follows the ResourceLocation naming scheme. Only the first soil with a given name will be loaded, all following soils with the same name will be skipped.
mod: Specify this if this soil is only available if the given mod is loaded.
soil: Used to describe the item block used for this soil. This is simply the item registry name and the meta data. But note that only Block-based items are allowed! You can also specify a boolean
ignoreMetatag inside the soil object if necessary.
modifiers: Is a JSON object containing a key-value pair for each modifier this soil affects. Currently only
dropChanceare supported. Both are multipliers for the base values of the tree that's currently growing.
providedTags: Is a JSON array of strings specifying the types of soil this soil represents. If you skip this entry it will default to 'dirt' and 'grass'. Read the Soil Compatibility section below for more details on how this affects your soil.
Whether a tree can grow on a particular soil is determined by looking at the tags a soil provides and the tags a tree needs. If there is any match between the two the tree can grow on the soil. A tag can be any string. You can see which soil/tree is providing which tag using the
/bonsaiTrees listSoils and
/bonsaiTrees listTrees commands.
If you want to change which tree can grow on which soil, you will have to change the tags accordingly. The easiest way to do this to soils and trees that have no json files is by using CraftTweaker. Please see the section below for examples.
Alternatively it is possible to override soils using .json files in the same way as trees can be overridden: files in the configs/*.d/ folders always take precedence over native integrations, so putting files in there with the same internal name as an existing tree or soil will effectively override the original definition.
There is a settings.conf in your configs/bonsaitrees/ folder that can be used to tweak some of the gameplay settings of this mod:
*Chancefields allow setting the default drop chances of items.
*Amountfields allow setting the default drop amount of items.
maxTreeScaleis a client-side setting that applies this as a multiplier to the size of the bonsai trees. This is used to make them a little bit smaller than an actual block by default.
showChanceInJEIcan be used to prevent players from looking up drop chances in JEI
disabledIntegrationscan be used to disable individual Java based integrations, e.g. to disable Pam's Harvestcraft, you'd add
org.dave.bonsaitrees.integration.mods.PamsHarvestcraft. You can get a list of integrations here.
disabledTreeTypescan be used to disable individual tree types, e.g. to prevent users from growing Forestry's Hill Cherries in Bonsai Pots you'd add
forestry:hillCherry. To list all registered tree types you can use the command
disabledSoilscan be used to disable individual soils by name, e.g. to disable "grass" from being used as soil you would add
minecraft:grass. To list all registered soils you can use the command
disableHoppingBonsaiPot: Disable Hopping Bonsai Pots functionality.
You might need more precise control over which drops are being generated by the individual tree types. Bonsai Trees add a few methods to CraftTweaker allowing you to remove and add drops however you like. It also allows modifying the ticks it takes for a tree to fully grow.
Changing Tree Drops
The following zenscript example makes Vanilla Oak Trees drop buckets, but no leaves or sticks. It also makes it so it only takes 10% of the usual time to grow a Bonsai Oak Tree.
mods.bonsaitrees.TreeDrops.addTreeDrop("minecraft:oak", <minecraft:bucket>, 0.01); mods.bonsaitrees.TreeDrops.removeTreeDrop("minecraft:oak", <minecraft:leaves>); mods.bonsaitrees.TreeDrops.removeTreeDrop("minecraft:oak", <minecraft:stick>); mods.bonsaitrees.TreeGrowth.setTickMultiplier("minecraft:oak", 0.1);
If you want to change the drops of a Bonsai Tree, you have to remove the original drop first and then re-add it with the new amount and chance, for example to make Sky Orchard Iron Trees drop more Resin (4) with a higher chance (50%) use this:
mods.bonsaitrees.TreeDrops.removeTreeDrop("sky_orchard:iron", <sky_orchards:resin_iron>); mods.bonsaitrees.TreeDrops.addTreeDrop("sky_orchard:iron", <sky_orchards:resin_iron> * 4, 0.5);
Changing Soil Compatibility Tags
The following zenscript makes Vanilla Oak Trees only grow on end stone bonsai pots. It also adds the "magic" tag to the end_stone soil, but that has no effect since there is no tree with that tag. Finally it removes the "netherrack" tag from the Vanilla Netherrack soil.
mods.bonsaitrees.SoilCompatibility.addCompatibleTagToTree("minecraft:oak", "end_stone"); mods.bonsaitrees.SoilCompatibility.removeCompatibleTagFromTree("minecraft:oak", "dirt"); mods.bonsaitrees.SoilCompatibility.removeCompatibleTagFromTree("minecraft:oak", "grass"); mods.bonsaitrees.SoilCompatibility.addProvidedTagToSoil("minecraft:end_stone", "magic"); mods.bonsaitrees.SoilCompatibility.removeProvidedTagFromSoil("minecraft:netherrack", "netherrack");
Changing Soil Modifier Stats
This makes Vanilla End Stone overpowered Bonsai fertilizer by reducing grow time of trees to a fifth of the original time and making each drop three times as likely.
mods.bonsaitrees.SoilStats.setGrowTimeModifier("minecraft:end_stone", 0.2); mods.bonsaitrees.SoilStats.setDropChanceModifier("minecraft:end_stone", 3.0);