User Tools

Site Tools


modtools:revieweditor

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
modtools:revieweditor [2017/07/13 00:06] – created adminmodtools:revieweditor [2022/02/15 18:00] (current) – external edit 127.0.0.1
Line 1: Line 1:
-The Magazine Review Editor+===== The Magazine Review Editor ===== 
  
 The in game magazine offers a number of interesting features, but probably the most used one is the  Magazine Reviews System. The review system is completely editable, and works much like a MadLibs™ game. Where as inside the main body of the review blank variables are placed that are later filled in with sentences or words based on the vehicle's ratings. The in game magazine offers a number of interesting features, but probably the most used one is the  Magazine Reviews System. The review system is completely editable, and works much like a MadLibs™ game. Where as inside the main body of the review blank variables are placed that are later filled in with sentences or words based on the vehicle's ratings.
Line 6: Line 7:
  
  
-Files And How It Works+==== Files And How It Works ====
  
-A base review is loaded from the Localization files (Word #???), then individual reviews segments for the 11 categories are loaded from the Reviews.xml file. See File Locations for location and file names.+Upon starting a new game, the reviews.xml file is saved into the save game file. When the player opens the in game magazine for the first time (that turn) the game will generate a new "issue" of the magazine, and populate the reviews and other data.  
 + 
 +review is made up of a base review text which is loaded from the Localization files (Word #???). Then individual reviews segments for the 11 categories are loaded from the save game file based on the ratings of the vehicle being reviewed.
  
 Each category has its own review segements, and these segments in turn have a value range in which the segment can be selected. If the rating for the specific category falls between the segment's values it will be eligible to be used in the review. The game will pick at random from the selection if more than one review segment are in range. Each category has its own review segements, and these segments in turn have a value range in which the segment can be selected. If the rating for the specific category falls between the segment's values it will be eligible to be used in the review. The game will pick at random from the selection if more than one review segment are in range.
  
-After the game has selected 11 reviews segments for each category, it will piece them together into a review.+After the game has selected 11 reviews segments for each category, it will piece them together into a review. It will use specific information about the vehicle and apply it to the review segment text based on the variables embedded into the review segments. The variables are called in the text with this symbol {#} where # is the number of the variable.
  
  
-The Editor+==== The Editor ==== 
  
  The edit is broken down into a series of tabs much like other editors in the mod tools. Each tab represents a category. The buttons at the very top are for managing the review file, including opening, and saving the file. The upper list, just below the tabs, are the reviews segments already added to reviews file, the bottom text box is where you will edit the text of the review segment. In between the list are the range of values the review segment  is used for. Which rating is used for the category is described below in Review Categories. On the right are the individual variables that must go into the review segment. A description of what each variable is, is located on the button and also below. Each variable on the side MUST be in the review segment, or the game may crash. Finally, on the bottom is the add and remove buttons that allow you to add or remove the review segment from the list.  The edit is broken down into a series of tabs much like other editors in the mod tools. Each tab represents a category. The buttons at the very top are for managing the review file, including opening, and saving the file. The upper list, just below the tabs, are the reviews segments already added to reviews file, the bottom text box is where you will edit the text of the review segment. In between the list are the range of values the review segment  is used for. Which rating is used for the category is described below in Review Categories. On the right are the individual variables that must go into the review segment. A description of what each variable is, is located on the button and also below. Each variable on the side MUST be in the review segment, or the game may crash. Finally, on the bottom is the add and remove buttons that allow you to add or remove the review segment from the list.
  
 +{{ :modtools:magazinereview_overview.png?600 |Magazine Review Editor}}
  
-1. Creates a new Review.xml file by clearing out any data currently in the mod tools. 
-2. Opens an existing Review.xml file. See File Locations for possible locations. 
-3. Save data in the editor to a Review.xml file. 
-4. Return to the main menu or previous editor. 
-5. Category tabs, each tab represents a dynamic part of the review that uses the ratings of the vehicle. See Review Categories for details on each category. 
-6. List of the reviews for the selected category that are already loaded into the editor. Selecting a review from this list will load the data below. 
-7. Minimum value for this category before this review segment can be selected by the game. 
-8. Maximum value for this category that this review segment can be selected by the game. 
-9. If selected, the text of the review will be in the localization file with the localization id corresponding with the number in the text box. 
-10. This is the where you enter the text of the review segment. The review segment must contain at least one of each of the variables on the right hand side (labeled with #11) . If the review is to be localized, enter the ID number of the localization text. 
-11. These are the variable buttons which contain sub review segments or specific information about the vehicle. The review segment must contain at least one of each variable. Clicking on a button will but the variable entry (the {#}) into the end of the review text. 
-12. This adds the review segment to the list of reveiws. 
-13. This removes the selected review segment from the reviews. 
  
 +  - Creates a new Review.xml file by clearing out any data currently in the mod tools.
 +  - Opens an existing Review.xml file. See File Locations for possible locations.
 +  - Save data in the editor to a Review.xml file.
 +  - Return to the main menu or previous editor.
 +  - Category tabs, each tab represents a dynamic part of the review that uses the ratings of the vehicle. See Review Categories for details on each category.
 +  - List of the reviews for the selected category that are already loaded into the editor. Selecting a review from this list will load the data below.
 +  - Minimum value for this category before this review segment can be selected by the game.
 +  - Maximum value for this category that this review segment can be selected by the game.
 +  - If selected, the text of the review will be in the localization file with the localization id corresponding with the number in the text box.
 +  - This is the where you enter the text of the review segment. The review segment must contain at least one of each of the variables on the right hand side (labeled with #11) . If the review is to be localized, enter the ID number of the localization text.
 +  - These are the variable buttons which contain sub review segments or specific information about the vehicle. The review segment must contain at least one of each variable. Clicking on a button will but the variable entry (the {#}) into the end of the review text.
 +  - This adds the review segment to the list of reveiws.
 +  - This removes the selected review segment from the reviews.
  
-Review Categories+ 
 +==== Review Categories ====
  
 The following are images of each review segment category, which rating is used for the category, and a listing of their variables and what they effect.  The following are images of each review segment category, which rating is used for the category, and a listing of their variables and what they effect. 
  
-Introduction+\\ 
 +\\ 
 +=== Introduction === 
 This is the introduction for the reviews. It is selected based on the specific vehicle rating. You must use each of the following variables at least once: This is the introduction for the reviews. It is selected based on the specific vehicle rating. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model +|Brand|This is the name of the vehicle Marque.| 
-Vehicle Type +|Model|This is the model name of the vehicle being reviewed.| 
-Leading Competition +|Vehicle Type|This is the type of vehicle being reviewed.| 
-Worst Competition+|Leading Competition|This is the marque/model name name of the best vehicle currently for sale in the vehicle class.| 
 +|Worst Competition|This is the marque/model name name of the worst vehicle currently for sale in the vehicle class.|
  
-Performance+\\ 
 +\\ 
 +=== Performance === 
 This review segment is about the performance of the vehicle. It is selected based on the performance rating of the vehicle. You must use each of the following variables at least once: This review segment is about the performance of the vehicle. It is selected based on the performance rating of the vehicle. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model +|Brand|This is the name of the vehicle Marque.| 
-HP +|Model|This is the model name of the vehicle being reviewed.| 
-Top Speed +|HP|This is the horse power rating of the vehicle in Horse Power units.| 
-0-60 +|Top Speed|This is the top speed of the vehicle in mph and kmh| 
-Engine +|0-60|This is the acceleration time in seconds, from 0 to 60 mph.| 
-Vehicle Type +|Engine|This is the name, displacement, layout, and cylinder count of the engine.| 
-Power Review +|Vehicle Type|This is the type of vehicle being reviewed.| 
-Driveability Review+|Power Review|This inserts the power review segment.| 
 +|Driveability Review|This inserts the driveability/handling review segment.|
  
-Driveability+\\ 
 +\\ 
 + 
 +=== Driveability === 
 This review segment is about the handling of the vehicle. It is selected based on the driveability rating of the vehicle, and is loaded from the performance review segment. You must use each of the following variables at least once: This review segment is about the handling of the vehicle. It is selected based on the driveability rating of the vehicle, and is loaded from the performance review segment. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model +|Brand|This is the name of the vehicle Marque.| 
-Vehicle Type +|Model|This is the model name of the vehicle being reviewed.| 
-Rating+|Vehicle Type|This is the type of vehicle being reviewed.| 
 +|Rating|This inserts an adjective based on the Driveability rating. | 
 + 
 +\\ 
 +\\
  
-Luxury+=== Luxury === 
 This review segment is about the luxury of the vehicle. It is selected based on the luxury rating of the vehicle. You must use each of the following variables at least once: This review segment is about the luxury of the vehicle. It is selected based on the luxury rating of the vehicle. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model +|Brand|This is the name of the vehicle Marque.| 
-Luxury Adjective+|Model|This is the model name of the vehicle being reviewed.| 
 +|Luxury Adjective|This inserts an adjective based on the Luxury rating.|
  
-Safety+\\ 
 +\\ 
 + 
 +=== Safety === 
 This review segment is about the safety of the vehicle. It is selected based on the safety rating of the vehicle. You must use each of the following variables at least once: This review segment is about the safety of the vehicle. It is selected based on the safety rating of the vehicle. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model+|Brand|This is the name of the vehicle Marque.| 
 +|Model|This is the model name of the vehicle being reviewed.| 
  
 +\\
 +\\
  
-Fuel+=== Fuel === 
 This review segment is about the fuel economy of the vehicle. It is selected based on the fuel rating of the vehicle. You must use each of the following variables at least once: This review segment is about the fuel economy of the vehicle. It is selected based on the fuel rating of the vehicle. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model +|Brand|This is the name of the vehicle Marque.| 
-City Fuel Consumption +|Model|This is the model name of the vehicle being reviewed.| 
-Highway Fuel Consumption+|City Fuel Consumption|This is the fuel consumption numbers for city driving.| 
 +|Highway Fuel Consumption|This is the fuel consumption numbers for highway driving.|
  
-Power+\\ 
 +\\ 
 + 
 +=== Power === 
 This review segment is about the power of the vehicle. It is selected based on the power rating of the vehicle, and is loaded from the performance review segment. You must use each of the following variables at least once: This review segment is about the power of the vehicle. It is selected based on the power rating of the vehicle, and is loaded from the performance review segment. You must use each of the following variables at least once:
-Torque +^Name^Description^ 
-Towing weight+|Torque|This is the amount of torque the engine has in ft-lbs and nm.| 
 +|Towing weight|This is the maximum amount of weight that the engine/chassis/gearbox is able to pull. Even if the vehicle is not used for towing, this is a good indication of engine torque, vehicle traction, and structural integrity of the vehicle.| 
  
 +\\
 +\\
  
-Cargo+=== Cargo === 
 This review segment is about the cargo capacity of the vehicle. It is selected based on the cargo rating of the vehicle. You must use each of the following variables at least once: This review segment is about the cargo capacity of the vehicle. It is selected based on the cargo rating of the vehicle. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model +|Brand|This is the name of the vehicle Marque.| 
-Cargo Space Spec+|Model|This is the model name of the vehicle being reviewed.| 
 +|Cargo Space Spec|This is the amount of cargo and passenger space in both L and CI in the vehicle.|
  
-Quality+\\ 
 +\\ 
 + 
 +=== Quality === 
 This review segment is about the quality of the vehicle. It is selected based on the quality rating of the vehicle. You must use each of the following variables at least once: This review segment is about the quality of the vehicle. It is selected based on the quality rating of the vehicle. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model+|Brand|This is the name of the vehicle Marque.| 
 +|Model|This is the model name of the vehicle being reviewed.|
  
-Dependability+\\ 
 +\\ 
 + 
 +=== Dependability === 
 This review segment is about the dependability of the vehicle. It is selected based on the dependability rating of the vehicle. You must use each of the following variables at least once: This review segment is about the dependability of the vehicle. It is selected based on the dependability rating of the vehicle. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model+|Brand|This is the name of the vehicle Marque.| 
 +|Model|This is the model name of the vehicle being reviewed.|
  
-Overall+\\ 
 +\\ 
 + 
 +=== Overall === 
 This review segment is about the overall final thought about the vehicle. It is selected based on the overall rating of the vehicle. You should conclude your review with this review segment. You must use each of the following variables at least once: This review segment is about the overall final thought about the vehicle. It is selected based on the overall rating of the vehicle. You should conclude your review with this review segment. You must use each of the following variables at least once:
-Brand +^Name^Description^ 
-Model +|Brand|This is the name of the vehicle Marque.| 
-Vehicle Type+|Model|This is the model name of the vehicle being reviewed.| 
 +|Vehicle Type|This is the type of vehicle being reviewed.| 
 + 
 +\\ 
 +\\ 
 + 
 +==== Examples ==== 
 + 
 +Videos coming some day. 
 + 
 +\\ 
 +\\ 
 + 
 +==== Troubleshooting ==== 
 + 
 +=== My New Review or Changes Are Not in the Game === 
 +Start a new save game. Reviews are stored inside the save game file, thus any changes require a new save game to go into effect. 
 + 
 +=== Game Crashes ===
  
 +Most likely you are missing one of the required variables for a review segment. Double check the reviews segments. Each review segment must have the variables on the right of the editor at least once.
  
-Examples+=== Review doesn't generate ===
  
-Troubleshooting+Either you are missing one of the required variables for a review segment, or you did not escape a single quote character. ('), as of v1.22, reviews should have an escaped single quote character (two single quote characters) so that the information can be properly saved into the save game file. In future builds (hopefully v1.23) we will remove the character escaping requirements.
modtools/revieweditor.1499918781.txt.gz · Last modified: 2022/02/15 17:58 (external edit)