]> git.mxchange.org Git - shipsimu.git/blobdiff - application/ship-simu/templates/de/game/building/base_building.xml
Huge rewrite of all base templates, added base_ship.xml (unfinished)
[shipsimu.git] / application / ship-simu / templates / de / game / building / base_building.xml
index 10dd1a2c9ae972d38568c3da48d72cf1d844b29d..c9815d249dbf7055ac049f8251f42db41f384eb1 100644 (file)
@@ -24,20 +24,44 @@ along with this program. If not, see <http://www.gnu.org/licenses/>
 <building>
        <!-- General building data //-->
        <building-data>
-               <dimension width="{?building_width?}" length="{?building_length?}" height="{?building_height?}" />
+               <!-- Estimated dimensions of the building. //-->
+               <dimension>
+                       <!-- Width of the building. //-->
+                       <width>{?width?}</width>
+                       <!-- Height of the building. //-->
+                       <height>{?height?}</height>
+                       <!-- Length of the building. //-->
+                       <length>{?length?}</length>
+               </dimension>
+               <!-- A full description of this building. //-->
                <description>
-                       <![CDATA[{?building_description?}]]>
+                       <![CDATA[{?description?}]]>
                </description>
-               <general-data id="{?building_id?}" name="{?building_name?}">
-                       <owner id="{?owner_id?}" owned-start="{?owner_start_timestamp?}" owned-end="{?owner_end_timestamp?}" />
-                       <occupant id="{?occupant_id?}" owned-start="{?occupant_start_timestamp?}" owned-end="{?occupant_end_timestamp?}" />
+               <!-- General data, like short name, type, level and many more. //-->
+               <general-data>
+                       <id>{?id?}</id>
+                       <name>{?name?}</name>
+                       <type>{?type?}</type>
+                       <level>{?level?}</level>
+                       <!-- The owner of this building. //-->
+                       <owner id="{?owner_id?}" type="{?owner_type?}" owned-start="{?owner_start_timestamp?}" owned-end="{?owner_end_timestamp?}" />
+                       <!-- The occupant of this building. //-->
+                       <occupant id="{?occupant_id?}" type="{?occupant_type?}" owned-start="{?occupant_start_timestamp?}" owned-end="{?occupant_end_timestamp?}" />
+                       <!-- When this building was constructed. //-->
                        <constructed>
+                               <!-- When construction has started. //-->
                                <construction-started timestamp="{?construction_start_timestamp?}" />
+                               <!-- And when it was finished. //-->
                                <construction-finished timestamp="{?construction_end_timestamp?}" />
                        </constructed>
+                       <!-- When this building was destructed. //-->
                        <destructed>
+                               <!-- When destruction has started. //-->
                                <destruction-started timestamp="{?destruction_start_timestamp?}" />
+                               <!-- And when it was finished. //-->
                                <destruction-finished timestamp="{?destruction_end_timestamp?}" />
+                               <!-- A short reason why this building must be destructed or
+                                    demolished. //-->
                                <destruction-reason>
                                        <![CDATA[{?destruction_reason?}]]>
                                </destruction-reason>
@@ -50,18 +74,32 @@ along with this program. If not, see <http://www.gnu.org/licenses/>
                <land-price currency="{?land_currency?}" />
                <!-- Construction costs may be empty when this building is bougth from
                     an other user e.g. a broker //-->
-               <construction-costs currency="{?construction_currency?}">
+               <construction-costs>
+                       <currency>{?construction_currency?}</currency>
                        <construction-company extends="{?construction_template?}">
-                               <company id="{?construct_id?}">
+                               <!-- The construction company. //-->
+                               <company>
+                                       <id>{?construct_id?}</id>
+                                       <!-- A construction of a building requires personel. We
+                                            summary their salery here for simplicy. //-->
                                        <personel-costs currency="{?personel_currency?}" />
-                                       <resources extends="{?resources_template?}">
-                                               <resource id="{?resource_id?}">
+                                       <!-- A lot resources like steel and concrete are required
+                                            for new high buildings. Some older or futuristic may
+                                            require different resources. //-->
+                                       <resource-list extends="{?resources_template?}">
+                                               <!-- A single resource and its amount to construct this
+                                                    building. //-->
+                                               <resource>
+                                                       <id>{?resource_id?}</id>
+                                                       <amount>{?resource_amount?}</amount>
+                                                       <!-- The merchant dealing with this resource. //-->
                                                        <resource-merchant extends="{?merchant_template?}">
                                                                <merchant id="{?merchant_id?}" />
                                                        </resource-merchant>
                                                </resource>
-                                       </resources>
+                                       </resource-list>
                                </company>
+                               <!-- The construction contract for constructing this building. //-->
                                <construction-contract extends="{?contract_template?}">
                                        <construction-contract id="{?construct_contract_id?}" />
                                </construction-contract>
@@ -71,29 +109,45 @@ along with this program. If not, see <http://www.gnu.org/licenses/>
                     it like house cleaning. simplified repair costs and in some way
                     taxes. //-->
                <running-costs>
+                       <!-- Taxes for the occupied lot. //-->
                        <taxes currency="{?taxes_currency?}" />
-                       <maintenance currency="{?maintenance_currency?}">
+                       <!-- A building has mostly maintenance costs. //-->
+                       <maintenance>
+                               <!-- Almost all buildings needs to be cleaned. //-->
                                <cleaning-costs>
+                                       <currency>{?cleaning_currency?}</currency>
+                                       <!-- The cleaning company. //-->
+                                       <cleaning-company id="{?cleaning_id?}" />
+                                       <!-- The contract for cleaning this building. //-->
                                        <cleaning-contract contract_id="{?cleaning_contract_id?}" />
                                </cleaning-costs>
                                <repair-costs>
+                                       <currency>{?repair_currency?}</currency>
                                        <repair contract_id="{?repair_contract_id?}" />
                                </repair-costs>
                        </maintenance>
                </running-costs>
                <!-- For constructing a building you sometimes need to take mortgage to
                     fund the construction costs. //-->
-               <mortgage currency="{?mortgage_currency?}">
+               <mortgage>
+                       <currency>{?mortgage_currency?}</currency>
+                       <!-- The bank paying the mortage, if not provided, the following
+                            mortage broker must be provided. //-->
                        <bank id="{?bank_id?}" />
+                       <!-- A mortage broker who has payed the mortage. //-->
                        <mortgage-broker id="{?broker_id?}" />
-                       <agreement id="{?mortage_id?}">
+                       <!-- The contract behind the mortage. //-->
+                       <contract id="{?mortage_id?}" />
                </mortgage>
        </costs>
-       <!-- We also have technology and research denpencies for a building. These
-            must be understand by construction companies who made contracts with
-            the shipping company to construct this building. //-->
+       <!-- We also have technology denpencies for a building. These must be
+            understand by construction companies who made contracts with the
+            shipping company to construct this building. //-->
        <depencies>
-               <technology id="{?technology_id?}" level="{?technology_level?}" />
-               <research id="{?research_id?}" level="{?research_level?}" />
+               <!-- A list of required technology to construct this building. //-->
+               <technology-depency-list>
+                       <!-- A single required technology to construct this building. //-->
+                       <technology-depency id="{?technology_id?}" level="{?technology_level?}" />
+               </technology-depency-list>
        </depencies>
 </building>