Revision as of 06:58, 4 October 2019

Introduction

In July 2017 the Trees Module underwent a rejuvenation.

OpenSimDefaults.ini

[Trees]
    ; enable the trees module. default true
    enabled = true
 
    ; active_trees allows module to change its trees in time.
    ; some will be deleted, others created and rest may grow
    ; default is false. You can change it with console comand tree active true|false later
    active_trees = false
    ; the trees change execution time rate (in ms)
    update_rate = 1000 
 
    ; allow the trees to grow.
    ; DANGER
    ; this option causes high network use on the order of 
    ; NumberOfTrees * NumberAvatars * 1000 / update_rate udp packets per second
    allowGrow = false

Oak.xml

<Copse>
  <m_name>Oak</m_name>
  <m_frozen>false</m_frozen>
  <m_tree_type>Oak</m_tree_type>
  <m_tree_quantity>100</m_tree_quantity>
  <m_treeline_low>21</m_treeline_low>
  <m_treeline_high>31</m_treeline_high>
  <m_seed_point>
    <X>128</X>
    <Y>128</Y>
    <Z>0</Z>
  </m_seed_point>
  <m_range>120</m_range>
  <m_initial_scale>
    <X>4</X>
    <Y>4</Y>
    <Z>4</Z>
  </m_initial_scale>
  <m_maximum_scale>
    <X>15</X>
    <Y>15</Y>
    <Z>20</Z>
  </m_maximum_scale>
  <m_rate>
    <X>0.01</X>
    <Y>0.01</Y>
    <Z>0.01</Z>
  </m_rate>
</Copse>

Usage

• copy the [Trees] section from opensimDefaults to opensim.ini
• create xml files, (copy the example above and edit) per each type of tree you want and locations.
• start region with the module enabled (like the default)

Then on console and for each of those files, also looking in world:

• do tree load oneXmlFilename.extension
• tree plant TheNameYouGaveOnThatXMLNameField

In world you should now have a new tree.

• tree active true

new trees are created wait a until most of the requested number is present (number is on xml)

• tree statistics shows the number.
• tree active false

look around to see if you like the result it not, type tree remove TheNameYouGaveOnThatXMLNameField and repeat from the load above.

if you are happy, type

• tree freeze TheNameYouGaveOnThatXMLNameField true

and go to next xml file

When done, keep active false. The trees are now normal in world prims.

If you have no plans to change for a long time, change enabled to false on opensim.ini

• shutdown region and restart

since module is out of the way, you can adjust some the trees to improve, like taking some out of houses

Note

So this module is really not very a practical one, even if you are the only user of a region. But can be useful to do initial creation of trees areas.