From 0f40e37d1c11d3be2d93775a2f445d9caedb7aea Mon Sep 17 00:00:00 2001 From: Ben C Date: Sat, 23 Jul 2022 17:01:30 -0400 Subject: [PATCH] Start on docs redo --- docs/content/pages/home.md | 111 +------- docs/content/pages/tutorials/api.md | 47 ---- docs/content/pages/tutorials/details.md | 167 ------------ docs/content/pages/tutorials/dialogue.md | 164 ----------- .../pages/tutorials/getting_started.md | 255 ++++++++++++++++++ docs/content/pages/tutorials/planet_gen.md | 148 ++++++++++ .../pages/tutorials/reading_schemas.md | 78 ++++++ docs/content/pages/tutorials/star_system.md | 46 ---- docs/content/pages/tutorials/translation.md | 34 --- .../pages/tutorials/update_existing.md | 34 --- .../mod_manager_show_in_explorer.webp | Bin 0 -> 14312 bytes .../images/reading_schemas/body_schema_1.webp | Bin 0 -> 16008 bytes .../images/reading_schemas/body_schema_2.webp | Bin 0 -> 5756 bytes .../images/reading_schemas/body_schema_3.webp | Bin 0 -> 16610 bytes .../images/reading_schemas/body_schema_4.webp | Bin 0 -> 12050 bytes 15 files changed, 483 insertions(+), 601 deletions(-) delete mode 100644 docs/content/pages/tutorials/api.md delete mode 100644 docs/content/pages/tutorials/details.md delete mode 100644 docs/content/pages/tutorials/dialogue.md create mode 100644 docs/content/pages/tutorials/getting_started.md create mode 100644 docs/content/pages/tutorials/planet_gen.md create mode 100644 docs/content/pages/tutorials/reading_schemas.md delete mode 100644 docs/content/pages/tutorials/star_system.md delete mode 100644 docs/content/pages/tutorials/translation.md delete mode 100644 docs/content/pages/tutorials/update_existing.md create mode 100644 docs/content/static/images/getting_started/mod_manager_show_in_explorer.webp create mode 100644 docs/content/static/images/reading_schemas/body_schema_1.webp create mode 100644 docs/content/static/images/reading_schemas/body_schema_2.webp create mode 100644 docs/content/static/images/reading_schemas/body_schema_3.webp create mode 100644 docs/content/static/images/reading_schemas/body_schema_4.webp diff --git a/docs/content/pages/home.md b/docs/content/pages/home.md index 534cda0c..fa228b44 100644 --- a/docs/content/pages/home.md +++ b/docs/content/pages/home.md @@ -8,118 +8,11 @@ Sort_Priority: 100 # Outer Wilds New Horizons -This is the official documentation for [New Horizons](https://github.com/xen-42/outer-wilds-new-horizons), a framework for creating custom planets in the game [Outer Wilds](https://www.mobiusdigitalgames.com/outer-wilds.html) by Mobius Digital. Planets are created using simple JSON and XML files and are loaded at runtime. An [API]({{ "API"|route }}) is also provided for more advanced use-cases. +This is the official documentation for [New Horizons](https://github.com/xen-42/outer-wilds-new-horizons), a framework for creating custom planets in the game [Outer Wilds](https://www.mobiusdigitalgames.com/outer-wilds.html) by Mobius Digital. Planets are created using simple JSON and XML files and are loaded at runtime. An [API]({{ "API"|route }}) is also provided for more advanced use-cases. ## Getting Started -Before starting, go into your in-game mod settings for New Horizons and switch Debug mode on. This allows you to: - -- Use the [Prop Placer tool]({{ "detailing"|route }}#using-the-prop-placer). This convienence tool allows you to place details in game and save your work to your config files. -- Print the position of what you are looking at to the logs by pressing "P". This is useful for determining locations to place props the Prop Placer is unable to, such as signal scope points or dialogue triggers. -- Use the "Reload Configs" button in the pause menu. This will restart the current solar system and update all the planets. Much faster than quitting and relaunching the game. - -!!! alert-danger "Get VSCode" - Please get [VSCode](https://code.visualstudio.com/){ target="_blank" } or some other advanced text editor, as it will help highlight common errors. - -Planets are created using a JSON file format structure, and placed in a folder called planets (or in any subdirectory of it) in the location where New Horizons is installed (by default this folder doesn't exist, you have to create it within the xen.NewHorizons directory). You can learn how the configs work by picking apart the [Real Solar System](https://github.com/xen-42/outer-wilds-real-solar-system){ target="_blank" } mod or the [New Horizons Examples](https://github.com/xen-42/ow-new-horizons-examples){ target="_blank" } mod. - -To locate this directory, click the "⋮" symbol next to "New Horizons" in the Outer Wilds Mod Manager and then click " -show in explorer" in the pop-up. - -![Click the three dots in the mod manager]({{ "images/home/mod_manager_dots.webp"|static }}) - -![Create a new folder named "planets"]({{ "images/home/create_planets.webp"|static }}) - -Planets can also be placed in a folder called planets within a separate mod, if you plan on releasing your planets on the mod database. The [Config Template](https://github.com/xen-42/ow-new-horizons-config-template){ target="_blank" } is available if you want to release your own planet mod using configs. - -Now that you have created your planets folder, this is where you will put your planet config files. A config file will -look something like this: - -```json -{ - "name": "Wetrock", - "$schema": "https://raw.githubusercontent.com/xen-42/outer-wilds-new-horizons/main/NewHorizons/Schemas/body_schema.json", - "starSystem": "SolarSystem", - "Base": { - "groundSize": 100, - "surfaceSize": 101, - "surfaceGravity": 12, - "hasMapMarker": true - }, - "Orbit": { - "semiMajorAxis": 1300, - "inclination": 0, - "primaryBody": "TIMBER_HEARTH", - "isMoon": true, - "isTidallyLocked": true, - "longitudeOfAscendingNode": 0, - "eccentricity": 0, - "argumentOfPeriapsis": 0 - }, - "Atmosphere": { - "size": 150, - "fogTint": { - "r": 200, - "g": 255, - "b": 255, - "a": 255 - }, - "fogSize": 150, - "fogDensity": 0.2, - "hasRain": true - }, - "Props": { - "scatter": [ - { - "path": "DreamWorld_Body/Sector_DreamWorld/Sector_DreamZone_1/Props_DreamZone_1/OtherComponentsGroup/Trees_Z1/DreamHouseIsland/Tree_DW_M_Var", - "count": 12 - } - ] - } -} -``` - -The first field you should have in any config file is the `name`. This should be unique in the solar system. If it -isn't, the mod will instead try to modify the planet that already has that name. - -After `name` is `starSystem`. You can use this to place the planet in a different system accessible using a black-hole or via the ship's warp drive (accessible from the ship log computer). To ensure compatibility with other mods this name should be unique. After setting a value for this, the changes in the config will only affect that body in that star system. By default, it is "SolarSystem", which is the scene from the stock game. - -Including the "$schema" line is optional, but will allow your text editor to highlight errors and auto-suggest words in your config. I recommend using VSCode as a text editor, but anything that supports Json files will work. Something as basic as notepad will work but will not highlight any of your errors. - -The config file is then split into modules, each one with its own fields that define how that part of the planet will be generated. In the example above I've used the `Base`, `Orbit`, `Atmosphere`, and `Props` modules. A config file must have a `Base` and `Orbit` module, the rest are optional. - -Each `{` must match up with a closing `}` to denote its section. If you don't know how JSONs work then check Wikipedia. - -Modules look like this: - -```json -{ - "Star": { - "size": 3000, - "tint": { - "r": 201, - "g": 87, - "b": 55, - "a": 255 - } - } -} -``` - -In this example the `Star` module has a `size` field and a `tint` field. Since the colour is a complex object it needs -another set of `{` and `}` around it, and then it has its own fields inside it : `r`, `g`, `b`, and `a`. Don't forget to put -commas after each field. - -Most fields are either true/false, a decimal number, and integer number, or a string (word with quotation marks around -it). - -To see all the different things you can put into a config file check out the [Celestial Body schema]({{ 'Celestial Body Schema'|route}}). - -Check out the rest of the site for how to format [star system]({{ 'Star System Schema'|route}}), [dialogue]({{ 'Dialogue Schema'|route}}), [ship log]({{ 'Shiplog Schema'|route}}), and [translation]({{ 'Translation Schema'|route}}) files! - -## Publishing Your Mod - -Once your mod is complete, you can use the [planet creation template](https://github.com/xen-42/ow-new-horizons-config-template#readme){ target="_blank" } GitHub template. +For a guide on getting started an getting familiar with New Horizons, go to the [Getting Started]({{ "Getting Started"|route }}) page. ## Helpful Resources diff --git a/docs/content/pages/tutorials/api.md b/docs/content/pages/tutorials/api.md deleted file mode 100644 index 8689943c..00000000 --- a/docs/content/pages/tutorials/api.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -Title: API -Sort_Priority: 40 ---- - -## How to use the API - -First create the following interface in your mod: - -```cs -public interface INewHorizons -{ - void LoadConfigs(IModBehaviour mod); - - GameObject GetPlanet(string name); - - string GetCurrentStarSystem(); - - UnityEvent GetChangeStarSystemEvent(); - - UnityEvent GetStarSystemLoadedEvent(); - - GameObject SpawnObject(GameObject planet, Sector sector, string propToCopyPath, Vector3 position, Vector3 eulerAngles, float scale, bool alignWithNormal); - - string[] GetInstalledAddons(); -} -``` - -In your main `ModBehaviour` class you can get the NewHorizons API like so: - -```cs -public class MyMod : ModBehaviour -{ - void Start() - { - INewHorizons NewHorizonsAPI = ModHelper.Interaction.GetModApi("xen.NewHorizons"); - } -} -``` - -You can then use the APIs `LoadConfigs()` method to load from a "planets" folder, or use the `GetPlanet()` method to get planets and do whatever with them. Just make sure you create planets in the `Start()` method or at least before the SolarSystem scene loads, or they will not be created. - -The `GetChangeStarSystemEvent` and `GetStarSystemLoadedEvent` events let you listen in for when the player starts changing to a new system (called when entering a black hole or using the warp drive) and when the system is fully loaded in, respectively. - -You can also use the `GetInstalledAddons` method to get a list of addons that are installed and enabled. - -You can also use `SpawnObject` to directly copy a base-game GameObject to the specified position and rotation. diff --git a/docs/content/pages/tutorials/details.md b/docs/content/pages/tutorials/details.md deleted file mode 100644 index 41f704b3..00000000 --- a/docs/content/pages/tutorials/details.md +++ /dev/null @@ -1,167 +0,0 @@ ---- -Title: Detailing -Sort_Priority: 85 ---- - -# Details/Scatterer - -For physical objects there are currently two ways of setting them up: specify an asset bundle and path to load a custom asset you created, or specify the path to the item you want to copy from the game in the scene hierarchy. Use the [Unity Explorer](https://outerwildsmods.com/mods/unityexplorer){ target="_blank" } mod to find an object you want to copy onto your new body. Some objects work better than others for this. Good luck. Some pointers: - -- Use "Object Explorer" to search -- Do not use the search functionality on Scene Explorer, it is really, really slow. Use the "Object Search" tab instead. -- Generally you can find planets by writing their name with no spaces/punctuation followed by "_Body". -- There's also [this community-maintained list of props](https://docs.google.com/spreadsheets/d/1VJaglB1kRL0VqaXhvXepIeymo93zqhWex-j7_QDm6NE/edit?usp=sharing) which you can use to find interesting props and check to see if they have collision. - -## Using the Prop Placer - -The Prop Placer is a convenience tool that lets you manually place details from inside the game. Once enabled, press "G" and your currently selected prop will be placed wherever your crosshair is pointing. - -### Enabling - -1. Pause the game. You will see an extra menu option titled "Toggle Prop Placer Menu". Click it -2. The prop placer menu should now be open. At the bottom of the menu, you will see a list of mods. Click yours. - 1. This menu scrolls. If you do not see your mod, it may be further down the list. -3. The Prop Placer is now active! Unpause the game and you can now place Nomai vases using "G" - -### How to Save - -1. In the Prop Placer Menu, you will see a greyed out button titled "Update your mod's configs". -2. Click the small button to the left of it. -3. Click "Update your mod's configs" to save! - -!!! alert-danger "IMPORTANT" - Your updated configs will save *only* to your mod's build folder, eg "AppData\Roaming\OuterWildsModManager\OWML\Mods\you.yourModName" - -!!! alert-warning "WARNING" - Dying in-game will cause you to lose all work since you last saved. Make sure to save often. - -What's that? You want to place something other than just vases? Well I can't say I agree with your choices, but here's how you would do that. - -### How to Select Props - -1. Pause the game again. The prop placer menu should still be visible. -2. At the top of the menu, you'll see a text box contianing the path for the vase. Replace this with the path for the prop you want to place. For example: `DreamWorld_Body/Sector_DreamWorld/Sector_DreamZone_1/Props_DreamZone_1/OtherComponentsGroup/Trees_Z1/DreamHouseIsland/Tree_DW_M_Var` -3. Tip: use the Unity Explorer mod to find the path for the object you want to place. You only have to do this once. -4. Unpause the game and press "G". Say hello to your new tree! -5. Pause the game again. You will now see the prop you just placed on the list of recently placed props just below the "path" text box. -6. Click on the button titled "Prefab_NOM_VaseThin". You can now place vases again. - -### Extra features - -1. Made a mistake? **Press the "-" key to undo.** Press the "+" key to redo. -2. If you have the Unity Explorer mod enabled, you can use this to tweak the position, rotation, and scale of your props. Your changes will be saved. -3. Want to save some recently placed props between game launches? On the recently placed props list, click the star next to the prop's name to favorite it. -4. Found a bug that ruined your configs? Check `AppData\Roaming\OuterWildsModManager\OWML\Mods\xen.NewHorizons\configBackups` for backup saves of your work. Folders are titled "\[date\]T\[time\]". -5. Want to add props to Ember Twin but don't feel like making a config file for it? We got you! Place that prop and the config file will be created automatically on your next save. -6. This even works for planets that were created by other mods! - -## Asset Bundles - -Here is a template project: [Outer Wilds Unity Template](https://github.com/xen-42/outer-wilds-unity-template){ target="_blank" } - -The template project contains ripped versions of all the game scripts, meaning you can put things like DirectionalForceVolumes in your Unity project to have artificial gravity volumes loaded right into the game. - -If for whatever reason you want to set up a Unity project manually instead of using the template, follow these instructions: - -1. Start up a Unity 2017 project (I use Unity 2017.4.40f1 (64-bit), so if you use something else I can't guarantee it will work). The DLC updated Outer Wilds to 2019.4.27 so that probably works, but I personally haven't tried it. -2. In the "Assets" folder in Unity, create a new folder called "Editor". In it create a file called "CreateAssetBundle.cs" with the following code in it: - -```cs -using UnityEditor; -using UnityEngine; -using System.IO; - -public class CreateAssetBundles -{ - [MenuItem("Assets/Build AssetBundles")] - static void BuildAllAssetBundles() - { - string assetBundleDirectory = "Assets/StreamingAssets"; - if (!Directory.Exists(Application.streamingAssetsPath)) - { - Directory.CreateDirectory(assetBundleDirectory); - } - BuildPipeline.BuildAssetBundles(assetBundleDirectory, BuildAssetBundleOptions.None, BuildTarget.StandaloneWindows64); - } -} -``` - -3. Create your object in the Unity scene and save it as a prefab. -4. Add all files used (models, prefabs, textures, materials, etc.) to an asset bundle by selecting them and using the dropdown in the bottom right. Here I am adding a rover model to my "rss" asset bundle for the Real Solar System add-on. -![setting asset bundle]({{ 'images/detailing/asset_bundle.webp'|static }}) - -5. In the top left click the "Assets" drop-down and select "Build AssetBundles". This should create your asset bundle in a folder in the root directory called "StreamingAssets". -6. Copy the asset bundle and asset bundle .manifest files from StreamingAssets into your mod's "planets" folder. If you did everything properly they should work in game. To double-check everything is included, open the .manifest file in a text editor to see the files included and their paths. - -## Importing a planet's surface from Unity - -Making a planet's entire surface from a Unity prefab is the exact same thing as adding one single big detail at position (0, 0, 0). - -## Examples - -To add a Mars rover to the red planet in [RSS](https://github.com/xen-42/outer-wilds-real-solar-system), its model was put in an asset bundle as explained above, and then the following was put into the `Props` module: - -```json -{ - "Props": { - "Details": [ - { - "assetBundle": "planets/assetbundle/rss", - "path": "Assets/RSS/Prefabs/Rover.prefab", - "position": { - "x": 146.5099, - "y": -10.83688, - "z": -36.02736 - }, - "alignToNormal": true - } - ] - } -} -``` - -To scatter 12 trees from the Dream World around Wetrock in [NH Examples](https://github.com/xen-42/ow-new-horizons-examples) , the following was put into the `Props` module: - -```json -{ - "Props": { - "Scatter": [ - { - "path": "DreamWorld_Body/Sector_DreamWorld/Sector_DreamZone_1/Props_DreamZone_1/OtherComponentsGroup/Trees_Z1/DreamHouseIsland/Tree_DW_M_Var", - "count": 12 - } - ] - } -} -``` - -You can swap these around too. The following would scatter 12 Mars rovers across the planet and place a single tree at a given position: - -```json -{ - "Props": { - "Details": [ - { - "path": "DreamWorld_Body/Sector_DreamWorld/Sector_DreamZone_1/Props_DreamZone_1/OtherComponentsGroup/Trees_Z1/DreamHouseIsland/Tree_DW_M_Var", - "position": { - "x": 146.5099, - "y": -10.83688, - "z": -36.02736 - }, - "alignToNormal": true - } - ], - "Scatter": [ - { - "assetBundle": "planets/assetbundle/rss", - "path": "Assets/RSS/Prefabs/Rover.prefab", - "count": 12 - } - ] - } -} -``` - -## Use the schema - -To view additional options for detailing, check [the schema]({{ "Celestial Body Schema"|route}}#Props_details) diff --git a/docs/content/pages/tutorials/dialogue.md b/docs/content/pages/tutorials/dialogue.md deleted file mode 100644 index 63a7fbb7..00000000 --- a/docs/content/pages/tutorials/dialogue.md +++ /dev/null @@ -1,164 +0,0 @@ ---- -Title: Dialogue -Description: Guide to making dialogue in New Horizons -Sort_Priority: 50 ---- - -# Dialogue - -This page goes over how to use dialogue in New Horizons. - -# Understanding Dialogue - -## Dialogue Tree - -A dialogue tree is an entire conversation, it's made up of dialogue nodes. - -## Dialogue Node - -A node is a set of pages shown to the player followed by options the player can choose from to change the flow of the conversation. - -## Condition - -A condition is a yes/no value stored **for this loop and this loop only**. It can be used to show new dialogue options, stop someone from talking to you (looking at you Slate), and more. - -## Persistent Condition - -A persistent condition is similar to a condition, except it *persists* through loops, and is saved on the player's save file. - -## Remote Trigger - -A remote trigger is used to have an NPC talk to you from a distance; ex: Slate stopping you for the umpteenth time to tell you information you already knew. - -# Example XML - -Here's an example dialogue XML: - -```xml - - - - EXAMPLE NPC - - - Start - DEFAULT - - Start - Start Part 2 - - - - - Goto 1 - 1 - - - - Goto 2 - 2 - - - Goto End - End - - - - - - 1 - - - This is 1 - - - - - Goto 2 - 2 - - - Goto End - End - - - - - - 2 - - This is 2 - - - - - Goto 1 - 1 - - - Goto End - End - - - - - - End - - This is the end - - - - -``` - -# Using the XML - -To use the dialogue XML you have created, you simply need to reference it in the `dialogue` prop - -```json -{ - "Props": { - "dialogue": [ - { - "position": {"x": 5, "y": 10, "z": 0}, - "xmlFile": "planets/path/to/your_file.xml" - } - ] - } -} -``` - -# Dialogue Config - -To view the options for the dialogue prop, check [the schema]({{ "Celestial Body Schema"|route }}#Props_dialogue) - -# Controlling Conditions - -You can set condition in dialogue with the `` and `` tags - -```xml - - - EXAMPLE_CONDITION - EXAMPLE_P_CONDITION - - -``` - -# Dialogue Options - -There are many control structures for dialogue options to hide/reveal them if conditions are met. Take a look at [the DialogueOption schema]({{ "Dialogue Schema"|route }}#DialogueTree-DialogueNode-DialogueOptionsList-DialogueOption-DialogueTarget) for more info. - -# Controlling Flow - -In addition to ``, there are other ways to control the flow of the conversation. - -## DialogueTarget - -Defining `` in the `` tag instead of a `` will make the conversation go directly to that target after the character is done talking. - -## DialogueTargetShipLogCondition - -Used in tandum with `DialogueTarget`, makes it so you must have a [ship log fact]({{ "Ship Log"|route }}#explore-facts) to go to the next node. diff --git a/docs/content/pages/tutorials/getting_started.md b/docs/content/pages/tutorials/getting_started.md new file mode 100644 index 00000000..8f06fcb8 --- /dev/null +++ b/docs/content/pages/tutorials/getting_started.md @@ -0,0 +1,255 @@ +--- +Title: Getting Started +Sort_Priority: 100 +--- + +# Getting Started + +Congrats on taking the first step to becoming an addon developer! +This tutorial will outline how to begin learning to use new horizons. + +## Recommended Tools + +It's strongly recommended you get [VSCode](https://code.visualstudio.com/){ target="_blank" } to edit your files, as it can provide syntax and error highlighting. + +## Using The Sandbox + +Making an entirely separate addon can get a little complicated, so New Horizons provides a way to play around without the need to set up a full addon. +To get started, navigate to your mod manager and click the ⋮ symbol, then select "Show In Explorer". + +![Select "Show in explorer"]({{ "images/getting_started/mod_manager_show_in_explorer.webp"|static }}) + +Now, in explorer and create a new folder named "planets". As the name suggests, New Horizons will search the files in this folder for planets to generate. + +## Making Your First Planet + +To get started, create a new file in this folder called `wetrock.json`, we'll explain what that .json at the end means soon. +Open this file in VSCode (you can do so by right-clicking the file and clicking "Open with Code") +Once in VSCode, paste this code into the file: + +```json +{ + "name": "Wetrock", + "$schema": "https://raw.githubusercontent.com/xen-42/outer-wilds-new-horizons/main/NewHorizons/Schemas/body_schema.json", + "starSystem": "SolarSystem", + "Base": { + "groundSize": 100, + "surfaceSize": 101, + "surfaceGravity": 12, + "hasMapMarker": true + }, + "Orbit": { + "semiMajorAxis": 1300, + "primaryBody": "TIMBER_HEARTH", + "isMoon": true, + "isTidallyLocked": true + }, + "Atmosphere": { + "size": 150, + "fogTint": { + "r": 200, + "g": 255, + "b": 255, + "a": 255 + }, + "fogSize": 150, + "fogDensity": 0.2, + "hasRain": true + } +} +``` + +This language is **J**ava**S**cript **O**bject **N**otation, or JSON. +It's a common way to convey data in many programs. + +## Understanding JSON + +All JSON files start out with an `object`, or a set of key value mappings, for example is we represent a person as JSON it might look like: + +```json +{ + "name": "Jim" +} +``` + +Those braces (`{}`) denote an object, and by doing `"name": "Jim"` we're saying that the name of this object (in this case person) is Jim +`"name"` is the key, and `"Jim"` is the value. + +Objects can have multiple keys as well, as long as you separate them by commas: + +```json +{ + "name": "Jim", + "age": 23 +} +``` + +But wait! why is `Jim` in quotation marks while `23` isn't? that's because of a little something called data types. +Each value has a datatype, in this case `"Jim"` is a `string`, because it represents a *string* of characters. +Age is a `number`, it represents a numerical value. If we put 23 in quotation marks, its data type switches from a number to a string. +And if we remove the quotation marks from `"Jim"` we get a syntax error. Datatypes are a common source of errors, which is why we recommend using an editor like VSCode. + +### JSON Data Types + +Here's a list of data types you'll use when making your addons: + +#### String + +A string of characters surrounded in quotation marks + +```json +"Im a string!" +``` + +If you need to use quotation marks within your string, place a backslash (`\`) before them + +```json +"\"Im a string!\" - Mr. String Stringerton" +``` + +#### Number + +A numerical value, can be negative and have decimals, **not** surrounded in quotation marks + +```json +-25.3 +``` + +#### Boolean + +A `true` or `false` value, think of it like an on or off switch + +```json +true +``` + +#### Array + +A set of values, values can be of any data type. Items are seperated by commas + +```json +[23, 45, 56] +``` + +```json +["Bob", "Suzy", "Mark"] +``` + +And they can be empty like so: + +```json +[] +``` + +#### Object + +A set of key value pairs, where each key is a string and each value can be of any data type (even other objects!) + +```json +{ + "name": "Jim", + "age": 23, + "isMarried": false, + "clothes": { + "shirtColor": "red", + "pantsColor": "blue" + }, + "friends": ["Bob", "Wade"], + "enemies": [] +} +``` + +## Back to Wetrock + +Now that we understand JSON better, let's look at that config file again: + +```json +{ + "name": "Wetrock", + "$schema": "https://raw.githubusercontent.com/xen-42/outer-wilds-new-horizons/main/NewHorizons/Schemas/body_schema.json", + "starSystem": "SolarSystem", + "Base": { + "groundSize": 100, + "surfaceSize": 101, + "surfaceGravity": 12, + "hasMapMarker": true + }, + "Orbit": { + "semiMajorAxis": 1300, + "primaryBody": "TIMBER_HEARTH", + "isMoon": true, + "isTidallyLocked": true + }, + "Atmosphere": { + "size": 150, + "fogTint": { + "r": 200, + "g": 255, + "b": 255, + "a": 255 + }, + "fogSize": 150, + "fogDensity": 0.2, + "hasRain": true + } +} +``` + +Here we can see we have a planet object, which name is "Wetrock", and is in the "SolarSystem" (Base-game) star system. +It has an object called Base, which has a groundSize of 100, and a surfaceSize of 101, and the list continues on. + +Alright so now that we understand how the file is structures, let's look into what each value actually does: + +- `name` simply sets the name of the planet +- `$schema` we'll get to in a second +- `starSystem` specifies what star system this planet is located in, in this case we're using the base game star system, so we put "SolarSystem" + - Then it has an object called `Base` + - Base has a `groundSize` of 100, this generates a perfect sphere that is 100 units in radius as the ground of our planet + - It also has a `surfaceSize` of 101, surface size is used in many calculations, it's generally good to set it to a bit bigger than ground size. + - `surfaceGravity` describes the strength of gravity on this planet, in this case it's 12 which is the same as Timber Hearth + - `hasMapMarker` tells new horizons that we want this planet to have a marker on the map screen + - Next it has another object called `Orbit` + - `semiMajorAxis` specifies the radius of the orbit (how far away the body is from its parent) + - `primaryBody` is set to TIMBER_HEARTH, this makes our planet orbit timber hearth + - `isMoon` simply tells the game how close you have to be to the planet in map mode before its name appears + - `isTidallyLocked` makes sure that one side of our planet is always facing timber hearth (the primary body) + - Finally, we have `Atmosphere` + - Its `size` is 150, this simply sets how far away from the planet our atmosphere stretches + - Its `fogTint` is set to a color which is an object with r, g, b, and a properties (properties is another word for keys) + - `fogSize` determines how far away the fog stretches from the planet + - `fogDensity` is simply how dense the fog is + - `hasRain` makes rainfall on the planet + +### What's a Schema? + +That `$schema` property is a bit special, it instructs VSCode to use a pre-made schema to provide a better editing experience. +With the schema you get: + +- Automatic descriptions for properties when hovering over keys +- Automatic error detection for incorrect data types or values +- Autocomplete, also called IntelliSense + +## Testing The Planet + +With the new planet created (*and saved!*), launch the game through the mod manager and click resume expedition. If all went well you should be able to open your map and see wetrock orbiting Timber Hearth. + +If you run into issues please make sure: + +- You placed the JSON file in a folder called `planets` in the New Horizons mod folder +- There are no red or yellow squiggly lines in your file + +## Experiment! + +With that, try tweaking some value like groundSize and semiMajorAxis, get a feel for how editing JSON works. + +## Reloading Configs + +It can get annoying when you have to keep closing and opening the game over and over again to test changes, that's why New Horizons has a "Reload Configs" feature. +To enable it, head to your Mods menu and select New Horizons and check the box that says Debug, this will cause a "Reload Configs" option to appear in your pause menu which will reload changes from your filesystem. +You may also notice blue and yellow logs start appearing in your console, this is New Horizons providing additional info on what it's currently doing, it can be helpful when you're trying to track down an issue. + +## More Objects + +Base, Atmosphere, and Orbit aren't all the objects (or "modules") there are to use, to learn about these other objects, you'll need to learn how to use the "Schemas" section of this site, which lists every possible property you can put in your files. + +**Next Up: [Reading Schemas]({{ "Reading Schemas"|route }})** diff --git a/docs/content/pages/tutorials/planet_gen.md b/docs/content/pages/tutorials/planet_gen.md new file mode 100644 index 00000000..a7c0e3ec --- /dev/null +++ b/docs/content/pages/tutorials/planet_gen.md @@ -0,0 +1,148 @@ +--- +Title: Planet Generation +Sort_Priority: 80 +--- + +# Planet Generation + +The first thing you'll need to create on a planet is its surface, this can be done in a variety of ways + +## Surface + +Ground of the planet + +### Ground Size + +`groundSize` is the absolute simplest way to make a planet's surface, you simply specify a radius and New Horizons will make a sphere for you. + +```json +{ + "name": "My Cool Planet", + "Base": { + "groundSize": 100 + } +} +``` + +### Heightmaps + +Heightmaps are a way to generate unique terrain on your planet. First you specify a maximum and minimum height, and then specify a [heightMap]({{ "Celestial Body Schema"|route }}#HeightMap_heightMap) image. The more white a section of that image is, the closer to `maxHeight` that part of the terrain will be. Finally, you specify a `textureMap` which is an image that gets applied to the terrain. + + + +```json +{ + "name": "My Cool Planet", + "HeightMap": { + "minHeight": 5, + "maxHeight": 100, + "heightMap": "planets/assets/my_cool_heightmap.png", + "textureMap": "planets/assets/my_cool_texturemap.png" + } +} +``` + +There are also tools to help generate these images for you such as [Textures For Planets](https://www.texturesforplanets.com/){ target="_blank" }. + +## Variable Size Modules + +The following modules support variable sizing, meaning they can change scale over the course of the loop. + +- Water +- Lava +- Star +- Sand +- Funnel +- Ring + +To do this, simply specify a `curve` property on the module + +```json +{ + "name": "My Cool Planet", + "Water": { + "curve": [ + { + "time": 0, + "value": 100 + }, + { + "time": 22, + "value": 0 + } + ] + } +} +``` + +This makes the water on this planet shrink over the course of 22 minutes. + +## Quantum Planets + +In order to create a quantum planet, first create a normal planet. Then, create a second planet config with the same `name` as the first and `isQuantumState` set to `true`. +This makes the second planet a quantum state of the first, anything you specify here will only apply when the planet is in this state. + +```json +{ + "name": "MyPlanet", + "Orbit": { + "semiMajorAxis": 5000, + "primaryBody": "Sun" + } +} +``` + +```json +{ + "name": "MyPlanet", + "isQuantumState": true, + "Orbit": { + "semiMajorAxis": 1300, + "primaryBody": "TIMBER_HEARTH" + } +} +``` + +## Barycenter (Focal Point) + +To create a binary system of planets (like ash twin and ember twin), first create a config with `FocalPoint` set + +```json +{ + "name": "My Focal Point", + "Orbit": { + "semiMajorAxis": 22000, + "primaryBody": "Sun" + }, + "FocalPoint": { + "primary": "Planet A", + "secondary": "Planet B" + } +} +``` + +Now in each config set the `primaryBody` to the focal point + +```json +{ + "name": "Planet A", + "Orbit": { + "primaryBody": "My Focal Point", + "semiMajorAxis": 0, + "isTidallyLocked": true, + "isMoon": true + } +} +``` + +```json +{ + "name": "Planet B", + "Orbit": { + "primaryBody": "My Focal Point", + "semiMajorAxis": 440, + "isTidallyLocked": true, + "isMoon": true + } +} +``` diff --git a/docs/content/pages/tutorials/reading_schemas.md b/docs/content/pages/tutorials/reading_schemas.md new file mode 100644 index 00000000..13a6a1cc --- /dev/null +++ b/docs/content/pages/tutorials/reading_schemas.md @@ -0,0 +1,78 @@ +--- +Title: Reading Schemas +Sort_Priority: 90 +--- + +# Reading Schema Pages + +Reading and understanding the schema pages are key to knowing how to create planets. While these tutorials may be helpful, they won't cover everything, and new features may be added before the tutorial on them can be written. + +## Celestial Body Schema + +The [celestial body schema]({{ "Celestial Body Schema"|route }}) is the schema for making planets, there are other schemas which will be explained later but for now let's focus on this one. + +![The Celestial Body Schema Page]({{ "images/reading_schemas/body_schema_1.webp"|static }}) + +As you can see the type of this is `object`, which we talked about in the previous section. +We can also observe a blue badge that says "No Additional Properties", this signifies that you can't add keys to the object that aren't in the schema, for example: + +```json +{ + "name": "Wetrock", + "coolKey": "Look at my cool key!" +} +``` + +Will result in a warning in VSCode. Now, this will *not* prevent the planet from being loaded, however you should still avoid doing it. + +## Simple Properties + +![The name property on the celestial body schema]({{ "images/reading_schemas/body_schema_2.webp"|static }}) + +Next up let's look at `name`, this field is required, meaning you *have* to have it for a planet to load. +When we click on name we first see a breadcrumb, this is essentially a guide of where you are in the schema, right now we're in the name property of the root (topmost) object. +We can also see it's description, its type is `string`, and that it requires at least one character (so you can't just put `""`). + +Badges can also show stuff such as the default value, the minimum and maximum values, and more. + +## Object Properties + +![The Base object on the celestial body schema]({{ "images/reading_schemas/body_schema_3.webp"|static }}) + +Next let's look at an `object` withing our root `object`, let's use `Base` as the example. + +Here we can see it's similar to our root object, in that it doesn't allow additional properties. +We can also see all of its properties listed out. + +## Array Properties + +Now let's take a look over at [removeChildren]({{ "Celestial Body Schema"|route }}#removeChildren) to see how arrays work (if you're wondering how you can get the page to scroll to a specific property, simply click on the property and copy the URL in your URL bar) + +![The curve property on a star in the celestial body schema]({{ "images/reading_schemas/body_schema_4.webp"|static }}) + +Here we can see that the type is an `array`, and each item in this array must be a `string` + +## Some Vocabulary + +- GameObject: Essentially just any object in, well, the game. You can view these object in a tree-like structure with the [Unity Explorer](https://outerwildsmods.com/mods/unityexplorer) mod. Every GameObject has a path, which is sort of like a file path in that it's a list of parent GameObjects seperated by forward slashes followed by the GameObject's name. +- Component: By themselves, a GameObject doesn't actually *do* anything, components provide stuff like collision, rendering, and logistics to GameObjects +- Config: Just another name for a JSON file "planet config" simply means a json file that describes a planet +- Module: A specific section of the config (e.g. Base, Atmosphere, etc), these usually start with capital letters + +## Note About File Paths + +Whenever a description refers to the "relative path" of a file, it means relative to the mod's directory, this means you **must** include the `planets` folder in the path: + +```json +"planets/assets/images/MyCoolImage.png" +``` + +## Other Schemas + +There are other schemas available, some are for JSON, and some are for XML. + +## Moving Forward + +Now that you know how to read the schema pages, you can understand the rest of this site. A lot of the other tutorials here will often tell you to take a look at schemas to explain what certain properties do. + +**Next Up: [Planet Generation]({{ "Planet Generation"|route }})** diff --git a/docs/content/pages/tutorials/star_system.md b/docs/content/pages/tutorials/star_system.md deleted file mode 100644 index 734a9b61..00000000 --- a/docs/content/pages/tutorials/star_system.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -Title: Star System -Description: A guide to editing a custom star system in New Horizons -Sort_Priority: 90 ---- - -# Intro - -Welcome! This page outlines how to edit a custom star system. - -## Getting Started - -Star Systems are placed in a folder called systems within your mod folder. - -The name of your star system config must be the same as the unique id used in the `starSystem` field of your planet configs. Example: `xen.RealSolarSystem.json`. - -A star system config file will look something like this: - -```json -{ - "$schema": "https://raw.githubusercontent.com/xen-42/outer-wilds-new-horizons/main/NewHorizons/Schemas/star_system_schema.json", - "coords": { - "x": [ 4, 0, 3, 1 ], - "y": [ 0, 5, 4 ], - "z": [ 5, 4, 0, 3, 1 ] - }, - "vesselPosition": { - "x": 0, - "y": 0, - "z": 8000 - } -} -``` - -To see all the different things you can put into a config file check out the [Star System Schema]({{ 'Star System Schema'|route}}). - -## Vessel Coordinates - -You can warp to custom star systems via the Nomai vessel. Each coordinate has to be 2-6 points long. -These are the points for each coordinate node. When making your unique coordinate you should only use each point once. -![nomaiCoordinateIndexes]({{ "images/star_system/nomai_coordinate_indexes.webp"|static }}) - -### Hearthian Solar System Vessel Coordinates - -You can use these coordinates to warp back to the hearthian solar system. -![hearthianSolarSystemCoordinates]({{ "images/star_system/hearthian_solar_system_coordinates.webp"|static }}) \ No newline at end of file diff --git a/docs/content/pages/tutorials/translation.md b/docs/content/pages/tutorials/translation.md deleted file mode 100644 index a4702901..00000000 --- a/docs/content/pages/tutorials/translation.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -Title: Translations -Sort_Priority: 60 ---- - -## Translations - -There are 12 supported languages in Outer Wilds: english, spanish_la, german, french, italian, polish, portuguese_br, japanese, russian, chinese_simple, korean, and turkish. - -All translations must go in a folder in the root directory called "translations". - -In this folder you can put json files with the name of the language you want to translate for. Inside this file just follow the translation schema. - -Here's an example, for `russian.json`: - -```json -{ - "$schema": "https://raw.githubusercontent.com/xen-42/outer-wilds-new-horizons/main/NewHorizons/Schemas/translation_schema.json", - "DialogueDictionary" : - { - "Fred" : "Фред", - "You looking at something?" : "Ты что-то искал?", - "Aren't you guys all supposed to be dead?" : "А разве номаи не вымерли?", - "OH MY GOD A LIVING NOMAI AHHH WHAT HOW?!" : "ААААА, ЖИВАЯ НОМАИ?!" - }, - "ShipLogDictionary" : - { - "Unexpected guests" : "Незванные гости", - "Visitors" : "Гости", - "When I went to sleep by the campfire only Slate was here, who are these characters?" : "Когда я ложился спать у костра здесь был только Сланец. Кто все остальные?", - "I met a talking jellyfish. His name is Geswaldo!" : "Я встретил говорящую медузу. Его зовут Гесвальдо!" - } -} -``` diff --git a/docs/content/pages/tutorials/update_existing.md b/docs/content/pages/tutorials/update_existing.md deleted file mode 100644 index 7e67ea0a..00000000 --- a/docs/content/pages/tutorials/update_existing.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -Title: Update Planets -Sort_Priority: 80 ---- - -## Update Existing Planets - -Similar to above, make a config where "Name" is the name of the planet. The name should be able to just match their in-game english names, however if you encounter any issues with that here are the in-code names for planets that are guaranteed to work: `SUN`, `CAVE_TWIN` (Ember Twin), `TOWER_TWIN` (Ash Twin), `TIMBER_HEARTH`, `BRITTLE_HOLLOW`, `GIANTS_DEEP`, `DARK_BRAMBLE`, `COMET` (Interloper), `WHITE_HOLE`, `WHITE_HOLE_TARGET` (Whitehole station I believe), `QUANTUM_MOON`, `ORBITAL_PROBE_CANNON`, `TIMBER_MOON` (Attlerock), `VOLCANIC_MOON` (Hollow's Lantern), `DREAMWORLD`, `MapSatellite`, `RINGWORLD` (the Stranger). - -Only some of the above modules are supported (currently) for existing planets. Things you cannot modify for existing planets include: heightmaps, procedural generation, gravity, or their orbits. You also can't make them into stars or binary focal points (but why would you want to, just delete them and replace them entirely). However this still means there are many things you can do: completely change their atmospheres, give them rings, asteroid belts, comet tails, lava, water, prop details, or signals. - -You can also delete parts of an existing planet. Here's part of an example config which would delete the rising sand from Ember Twin: -```json -{ - "name": "Ember Twin", - "removeChildren": [ - "SandSphere_Rising" - ] -} -``` - -In `childrenToDestroy` you list the relative paths for the children of the planet's gameObject that you want to delete. - -## Destroy Existing Planets - -You do this (but with the appropriate name) as its own config. -```json -{ - "name" : "Ember Twin", - "destroy" : true -} -``` - -Remember that if you destroy Timber Hearth you better put a `Spawn` module on another planet. If you want to entirely replace the solar system you can destroy everything, including the sun. Also, deleting a planet destroys anything orbiting it, so if you want to replace the solar system you can just destroy the sun. If you're making a brand new star system, you don't have to worry about deleting any existing planets; they won't be there. \ No newline at end of file diff --git a/docs/content/static/images/getting_started/mod_manager_show_in_explorer.webp b/docs/content/static/images/getting_started/mod_manager_show_in_explorer.webp new file mode 100644 index 0000000000000000000000000000000000000000..a54601f7be39bf8f8329b6d702ff839040b54778 GIT binary patch literal 14312 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

X{xwQe`&`5Ce1spHneXs-ws6 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
*JZJA0+f_1) z(`Ni@$N>GdX_6?#=_vp6)`N?gtm#llTYWN0iom+^2)JOK2$|Sldnbb(vP?H@{CFKzuslQ}LzpcSB*5pq8u8i6x&R=O`Xg1;lcDps7iKFp)$#1mYvg9V^GF zAF2UZDK{2gs^luY2TYyP3P8s)z46&RMgK=7g=?1-4AKF28oqo#<-MQHKa^ z1S|=*zID|PvKx&;@%^;iE}}6*H`b=AdF<<{)Z6ne{Gv^t^sJp(aJfE+yWk+qt3bYP zFMSB4?>*0x5hZb(Qd9AkC5&)V{cwpwm^~gPyr4SjivpFdwUVX;gNx}qrGcnZhizSc zkvg@!&K6q)4F$(>yE4&{FwxzLtWHBqP3*aBwceZh>ZpdNZ|zIGk6F^HRf;mMCwG-f zY63>%)%IKN*_OO6w`pBPD=9)18gS0yb)J<)ie@G;Yf&k-*B5HYg=m`CTS&_r>I(KpV3t z_!F|F?c<8F;yJx66QxKX?Ks`~NLd?G#+i6xKS1Qzh%R4SbM1j?tXBjKnR#E8eF-To ztE59)Klpb4gK&h3NYL7@kdalj{YvR~Wl>5f%JWrKZ;3|3_jG4EWPUFd?%yRzB`yD4_@fQ1AbB$GDJVnWd~24iY3V~u=rh2 zMiYvpvxB(WouaCr%jf&ugbvD6|HBuVmfNxJ;DD@8xC%soKkeC_ht06z2#C z6~26nj973Wz%;<>nL&`&1mkJel zBY3xc28W$v_9+MVhA)pGpN8WXkyo37<`g%5dbs$?7TK13S|U&9zuBat)e0WbACt;u zP&8d(l*DI;bqTFs$II$ee^lhq{|Wnos!YH!;uuqoAxf$pF=s2!cn8dCK%%QS8jkOI zDi#-tv6e8!MOFy7^HCe)je)M&2xde=%xw_X_I2mda$kEtr}&l|fyrm#3P zacyPwnmyPA`S#C=iI>L1oT^bu28At#girz^M}s&{C+0w|)tiHX=2CxNhQUfwT)xi@ z*Zl-{#Ti`ORn>XyZG~i=M*Ulz{@p_WaF^(NN{m{=h4eVykGQ;5R`prw(*i#{Mv~-h z(aNK{f^?Aixtn`wsh%*cpq_{3g2z3>SmGkPSdwq3x5M)!4)fFt=Og>CdKsXz>f-|j zks!Txhh4Qns?}_^OyehLYqf8~dkvheXek2WcB-$G1@dX*#Kt*@7FUTM%|B{7@mR|X zq2}-*@#AIWGe<%PN^yzLZpeS>%A;sd_$8)JDhxlf5(HX;1ALLKL0gxs6chR@T&PA&;78e zUX3p7N+sbN<6vPr>xj!>%lYgVqm&=TGczo5W|ghN|3=>6UG=LM-q((P zWqAgZccwb4X;h?oV^Llh#w~<}slTRL)KTL;#PzG60{PnJV9Zu5&kYj42+=7AQky;% zV3Z{VJ$z4N8fSOkXAh{BY4$Y*n4!6Mlj_(NHNA?PPxciGr+CqrhRQS5Y9uB0F;+9= zQ#KedC2~0EsQxBdTcgx<`rS;eu2Nls)FThhyUrWZ5-J%{VoKFki_6RA4|#cZ+U*5{ zi)M_#a!%BV%%oi*mDCn*8ktPXz1os; z8!Gy#Pbb&n<+qqePHZu=ZEakASwbNCe)FR~6U7qPa-5Ar;5Cn_KcTCh$M5b&=0of{ bPE@a3d}2hxjv9RZd+86uL}-}P{-5(d1c5z1 literal 0 HcmV?d00001 diff --git a/docs/content/static/images/reading_schemas/body_schema_3.webp b/docs/content/static/images/reading_schemas/body_schema_3.webp new file mode 100644 index 0000000000000000000000000000000000000000..3ca75b144517c9ec02dd049dff972086845b9885 GIT binary patch literal 16610 zcmb7rV|Zj+*KNgi(y^_M-LY-k?j#-Cwr$(Ct&VNmPVPDH_uc2-ANTZkZvCh+_fz}X zwbq(rjyY=WT?*nNBCC7=fU2;7oQfPf!PH-|+ze1A5S2Pu1PD*8SdLU-0WncdBL#a6 zGL-qxuj>;-DP8FC)-KB%&65|?%Iu5buL>NH{&Uf%P2RE~x9_N(z+b-~0AG$LOEWeX zM}i&+beA-L1zi)Gw7U#W%-mi1)9zt52J|>}@Z! zZojX>PstC2OVdV#sqX%-tuOLxxcBkb;`i(u@8gd<-mkZ?kM*yw%l0?Pudk;7#1`N& zvYb-KGPweJNKjxPfDa!5;-3S+XB_C}<~3r$q5unwAPI(@vaZ+1+tbxn_di2zFjuL; zP)iM5Rjm@@BCXG+?jkCMT&_SM^gjX%Z5rs|9?T5fq^U+BwBWxO*x!T4e<%i1GK(Qc z2_4wAW6zNJ7lBmZ5eQ#J+Ger)uU4fZYV@{2`6EomzBcoY*}|z2zVTJ+nxU4e*!zx^co(z6?Sy` zN4w{nz2RuQA1?n4$+YogQmKqaqkn<~SZy2|P-upHst-h$o@F?-X*A+K@}geqG%s;z zSY-wdB;x~tkJljw0KS1Q)_GG@TLZFVyaW1zc0wvZ=p}Nsp}Mqj^I4))=4j#rM=$g_ z?qSxVIUzKfTF=YzPfL1^b0~H0IRkI7#1Vx^zWe8a@(m_-E~nO2)0N|{PH(44Cl{Ny zMrYKqC@S*W*pkD4pA>;c`f~=)>1ib^Z+u#kuyWdwtAcf9fFEI6ZnSR=<8~--R9LcQ z*Yo%edwHvg)Cx+Ybkg#k5^ zmgVS%r^?(odl4A}SgM~Liu!_GmnE2(OkuzT`ABEATB$dg{0D#sZo=zeZu32xg{Pg> z8U4eVe_!RGDMD1xto`Pi?q5vnzo%X$S$3il|Kd`w^jG^S%-&>Udq!UfVP!IuQG&V_I1Y z?7#i!`~bsGPU#2?|3;%$YcTl#f;4dH9d{U9u^&9b2ai`o4(8$y%Oign6eMzNwXdhY zEtw8>@?RN^sr;Wa`k$#c$yFeW=q6Bb1_Jx?<;YQ>LWBK_pn5QZnb&BbfGcea2vY>v z9RM4%*cwixQGwGeNNGkjF(7j~n;MKwhni3`!LOl`r;^|LN4{hPRm@2kvrZ9`ra0h} z3m;Cl1c1jl(&I_00e{jXvvrOH%?x_5qX7{%%M%HOB9n;4{yzcJr~tFip~MKer%rQN zeBx*mh%cu;xZ+>wuceS$x68qaY~-Vcp2fdega4evpq8$RZ*|4KI+w&vlYHwg&Y4d_ z1V1BbRWV9PtyA|W8bKl=hkWRJka2>qGkIg;0%UC@1q{r~v1?4|A^<0*K6T3BrWV?>fuT`4U#QfIp zes8h54^Mvfg28pGOSjxN|?m z{!~`~^%=wmS;+GwcAC8(6{vtkyZCPwAjN%v$G*L_q$MZ7qNCvr;y;}DD0{A}s) zuH~N^^pcwmNP(2I^|VK`cp9G0wDd`$h08w>`oCEY9JWIvU$}#Hh5YZ$gbX>-g~m?G zHT!;(+b+fbhYw-9Ri0~#GQ{$qTlL3J@1|!9!4kv7RfYXQ%IGdYsbsv-vK$_k@h2v* zESs_LEf;i}(a*E-e7*JttY6EgDCV}~L$bpH{mDVtZf}S|^Ho!B z6-dvw+;>#w5tD|60{<%~#o{n|E5mJ$`)O12ue~G?z-vn9IUzwdc_#!b0Q4Tf_aY~c zTf*|^HVRL3kspyA)kL)3mM$m@hD_ER3n@);ko8=)fd?z57NaHYcIefGR*fFJ(=cMohM| z;E&!dW=-x};sv!ja7)K>D4x^<kp#z95$$N9zG z!ZwJgVU(QCm)MO949TMYru7Bd!3MuxP@;_)R!h15XYc#BFHUmGDWdFQo>b3B<`Ec{ zcl@9H*nb-r5lBzyu`O3Vz{l>|t{nclPi-7*Mh^%d0H|K9MWNIOYl_vHkeH`X zA9(ch7%b=|1uQ}V^hhCbfkhzz^D_5>-HL(B;%eUd7`=<)E6j*1caf-R>~@a)zW?!4 z;E43l(gatX6C;DO(d42cjE3Us3dV(OoFDN7PiCPPH{A94G_Maeycu+&C-V+k3zQ^q zd1@H;2eiRlkZT?Q#t&IW001p*g6MZ(iV2z;fO5jyqwlc0TXkC*go4Qqlkzs0Uv6Hx z4V5<3BWJwzSei-}`HIHBVil73(HM9%gfUx}sH~4w(AcNl%B{JR271fVEHW@^RrArQ z<9Q{31(l;Vw0<Qd(ZiM79tcX}pkeH^P0dAYX z6^m8R_%yz8wj|q~iQ$p7+7am_x<-PDd;vQ*c5^FH4UY(*;i;o=X5!w46I2aDKwnXn z|I9^sxN5YyX;feGx?y*88OB9yJPI!n;4@l%2?uuyj+r`*!YvU1 zO7-Fz$l|ZkWV<+HhsP%ubkWhR&w6-*m(UmY1vL<7q3uy2XfXHHAn9GvHN2kC$qnIu zHIO}Jhq7S}360HLFdLqgbK^*wpX(~u2;b|d+yhDaVDk589iD{HaUN5sKXT{X+k*ne z)t=a3x}7H+4yGrTp0E+jn@2hN%rGcp2RWN5lty>zBM`0@&Djj^7vPdnwxY?_EpP;s zvZJpM=Io{#bBbaiPVs-(JKKTVeIF4eH~4-AdISGdHgfU2eVaZ{e$1%N3u*L1g80_X(wY-x5xAmW zuW+)>D-?1YZ(sLw1<#8IzQCd^dXEc0xXGiz9nwOnWmCN7Fy?WlWNY{9FSh5T;uN`;RMxPkFZ0CRMe>Vel&f7f&lWT+X@na_ z#A5r)tXmR@l_k!FM-GI4#3t=|2cd&bE64D9cHvf`~79M8M87~MiF~3W>G%V+z^z8oWjnSEwY89Rp_>l(&iMRiRYlQ<$EzbsNMUSe`+`RPX~w}8 znjdO6-E2QpW>f;Kh32zYv?D+1lIFbAbI3QzaWre{IC@0gw!t zQ6eM&|MfzVrDsHK@w)z+`IrMsKh%98X;5S_XsenkF1twkWoM@S^ySrY( zv_ZRle~OLB*dTl9MeG;@tm%`@1!Py8nm((;7A9xoQSR&dPz$GJ_iPf#uF_#L;4MoY zD2+=2Q;n_8TQnMye1>~6KG>q^v39EZ8dviOh~&&you+Q@;E`t^)y+^5|p>XGNe+i3V~+15dvY(-D?>mrLlgIEd;>7i1dE?88Ay57oECxThk_E+5; zn#z@^NT>@FWRw-+G`9j;oG4Ow6?}LZ2ZdD60Sxy(ODm6jA=8uV@ZMq?jNfP>QC@G> zX-CAN?M&0TbxGcRr-GmXrm~cwI!FfX6KbPN%dEP}U{zb>$$b+Ju*1pIOnQx-qkT71 zna<8n%h;W-2GuENO)Zf- z=9HbPC#B!-52+sR@t1i*NC?POsmvo;QIk!?Hy>!IQpT-t;p1$zSqzOLpcxoSPE=t5Xp2OO zeGYbLd2>*?^*)u&zAF4K{Rtw!?4C@ooiuZxu@#>=En~!;>Tly*S zXxhq3uJ^dg#Ns3sz;X3n=>O`9xs(y6pVmnuj_0NYN#$y$c?K{*$4c8Ze(%LK1Rf@j z7S;eQX`=4__Rh5!N_lU5X^d!6O;$>7Nbq>pLr^X792nc8VHv$D3pV; zkMf}a5(s`#K?$JSAsF-9CWD%g%hb=~K_sPTysru3>z~9CTy{Fm?v@5wAh>+sa`$XV zcL;QW2dI9?vW;r+xj&^2VyPBc?;S<$-l%b@&mqH5qN}m?JP;g=q3zz%@RQ;;4OO;K zG}T(-*Ns>1>Q`#l>vlxaJ^hAFy=~tFukZ|JJmDodn5W#PR=GO2a=g?xssL7tJoEAC z=1hH-RE`NQ9N^sbpG+@XSwV%*Y31yeXGshK8$#odUc1ac8?-}j-ZIXIG4{IjQ%?kA zZ-kQf#~{k5c-}LrsN@KF`uYSkLY3hqi^l?b{z*jf}e>J9KYFl$@ z*_mZaC3d4w&Z;;!yv$F}t1MXWw`gE2MY!HC15em#<I+qc151x*4 zlocZgdFQt!EOcjxXLylq`-tnqHzO8VtePM^@(T%^5W*Ub?`_sUh4VuZKc8-#_D`;O z?5TtWuyI}u9MC)}ptc*H26NX3%!KLlXte`mrh>}LIcW1coohIt#h5uA!FtSepH^nzBzf{HC4 zyKr(Ey<*@A!~5m1P%SO&$Wlg=3pzGS3|tz5eEz&B|B$9@5Z>=aQ#i~iBSR=nF{XTn zNKIR_PC{PxeFbW)(~9%w!4VDp+2GpPqq4vd20yJ_!)KLa5BH8&Aq0}ircP6vAmp}+ z&s}Y+rI?MMuS^>wL6?=mlG%k|%p?@(8XaQJMli{`-I*nXX7wVSQ@9pzZxes2;hpdK z@oN}W?>1h#D`|*SHbc)6godMKCU>mDKn(uDj$?yK1!q?k{zI>*$Qchx`9ta%1DsHT zL!?U~+AV4i30t`~ULM(FaIyxaA{CSTtY|6JELM@Hd+YOJF|i5f)=z;g4}(4BGo6=Q z$7|%I7kDfS7`t#;(Pr;6q2?mD18|&q00>WQt=$T&GNK-a(oX#+9v3))qX*NCEYRXI z5N%6mZ$m4~@PLPLBggp8_sUX%#F6~Si~w}F#!a2OlbESn>vMr+TjkB%{N()%ya!?w zPTz!~L6*jTb0!~<%N9d5vfFgdXO^@8y*PwWx*@)%)`;LZ`4Z-9!HJ!EliZ0+Ro?>C z=R)ZcM(ctncwlm9vyl+Tl0C^0J0%-AKUqcN_NuoI2k4zjZZxGAj~5EpEG28$wX&5% z!!I!>=0bI6%A@`AdH#@~%c)W93w+2HaHW8kpXIBa?tTMA#%uz!jL-Gw*8_I#>YYDL z#Pq0qa}Slr1vG%8mOG^G{0KvVh`7~Cqz5yHktGzVh&4Fh^A2E2m3i4G@eCTtoy(pM;>bW4^6KAp|-a6L2Mt~$lQXf90U1KoOARxYRbmo@b zjA)v~#R{AsynB8#xXK#Zy|2ySed$uvjN2U?;|-i+wp~cZCo6( zN&}337l2Q)dqT2N;@MGH9aWbV)gs?(#b<>#49@(DDv}f1MSNlDSBq0TiZ_F}4x?32 zHV0+e*OSa(8|I|y@3_eps!o)*42k;X_&C<(gC@;_tZ^V>ZrDryo12Io-)}~dgh-HR{uAka4Y=leM~4X5$dzOssE>vl~o(hW1rSa6UqcDZ|ObaRyd>bX^X zF|1Qo6uFn@W;Je#Q&38qJJOHjvH`=A)V5a0FYH>GI#mAkvT>KxY+#XYsfTS3O7WHg z1ym~27%b@(9uG$naM*80*O#$25$?ROEpxcQPnBvqicKHETZY4-#kvTD8veYIh}Dp0 zh|w*meYOzL5N@aMu)!QwlB#$df&!#!L|hD^0WqvS;|HaBQ~j1F*5~k&mU5#3lX&zg zd5G$0Sm|tatZvaAj1hCc7^7efa592a!V1uk4Wq^ng?pPM(XZkhLBq9?vjD~tK?IPnXS(*ZQbaMKBL<|%xtvcAq=hZoKqy|)M4}gQn)vf7A|g~- zfR>_e*-N{Ese(G-Hk_W3)f-L@4(B{u90GS_=ef~hQ~Y2yfJ{&8=|HGjo%CvNO1753~r6FD#WkY1l}A00O6t`JOksRH6VB9^Lx@-=TWRi(eptAg2M@@&-2>U zHQevtEbVy9HGj)TIED{%aQMR_cZ?P2nwa?frx>=$mIhYi8>uBg&09-N91*DRz2?^e zwEQP(9*sGGE~n#!5CA}E$b5Z1ce31UuAJL{F|kl3Ld#zS^M2D+7=GK2{MZQbRvj85 zkEC^-4|XoGu1K9I0%{;CeWa|5By#fzDxJB)b&f^Bl4n- zJcKt)!!JZ(xg*r?((PIgqs%9&{A6b1Gm8k~N6D8!S-7ZhvUq8(sYcic+$q!!U>{E~ z2kfLjE6K{Yrh_Frm&LCMV z${o~Gz9hYZnV{KT(C)aics4-YI13u#EW4z~g^X^mKQ^Y-m>sA|MKn+t(VAn!Sbb(+ zaAFODU;JqKbv}1UKMo$dCge0U+0au=Y&OD5lT%6@!lTp2ozumQT<+vN0@UiDVvEP#W_?v)0B+arp^8ec2xb-*>wsA zc2#BNDqgn{Oa)*4rRRv+YJWi{Va0hQMF8uRCLc^7vUr->Whh1xoj4pQKW7J69ozBd zt|RzdF7;))ZOXYe8SCd-#$baI&M{Jysc_ z{LoXDBUw#F_beL_TI2C;97lUw<@(4bs;+$yg$l_ve`kurcy5m2G#Rr(cOtEBnoRz8 zZA`f1w0#9s*6@&?_!MUC#;ta)ny8LsNgpxa@qmPcw(0g|c=hPkf#*tGq9ZujRWw;EcPZpJ+ z=O_w1qS~M?IJm1|@^=}jn=^5TS<*}+?WMZ`J=$XF!bLFmd{91&A5kOpyg6Q`A5>v) zYTqvv?;b^rnzSWHsmC9wT*{mb5bs01^)hO-(v zyRi8g%CX*=P0CNg>r&qT`iAfpce6!gGg|(W2Fq`p;vj%Q1;uS^o?-kgYMLSrIJ9DP zuIvaj3eMgL=>cnjB!>SsR*=wgND1`fi>Bq+WYcnXv1={t#bD(*O>=u~1%YwhH0DWv zM7Ni>%!0gcbHb0TAq%(As8_FUqp`0Am-#-s)|fYfS22p}G*GH)-3RU3-2C`^QYTOy zP%&<_316xH*Os~CGYiLh8HNG+URl@B8Fte{zz`kr=yK2A*qAfAn?3)Dv1`GEHFJ^o5{V1G5bP1S|iY`-HQG+9BSG=^~nJ6}-mVP0aWcKX_5v@8g zgA{)_f>Sr;5NWa{d-C4m1eLxlBmfk5#?Z$%0}mef*4_wX8cl608)XVg;pBr8!e7=& z5Gd)aVm+9ez<8(NFF08P$ZYW543FYg-1^0lXY6J{ z^BbG!#}tc*^PAPwR8KYfq+|1(RPQx-iG*20AJ9BZ;^dmM{Pot0URNQo}1>4`rEFL9apqVJb51s#GhXk)nOEUiEKlj(Q;V5+XPLj%FRNXsS_K*eVTVVH-pTxlMlZ* zV}a%S0h}!s_Re-PH4uP`&sb)7S1Bq zvdNttlQ>Ms0e|w-iD8Wa6%hyz4HT1t;s^1MBu~k^mA9?7qBs!?T>RE5zS(`0q6l#w zbcZeW9Zip7m+CG^az^#XJ$)@nEBDb&HB|*c>?dn<%rpL*-MUp>@vNQEaC6&W8hQ^u z+$elWP#d!Ebj#-~e!|3x-)tIyc` zddNGV;ARpT==-5F5-x2Ise2U1L<_Y131WZ0X+cj2!&2Npk7~z1W~|xJaQ9wRfZLLr zflPZ^fCNBKFPH&F9doUh?9QDXXpho05IJTe5LG%PGDQc`pm06a53^2_9q%qfaHcG5 z-5}HN88q|Jq0kMB>)8p!aod4D5=VBV^s@0O%FFXkr?M7m&U`zbO zxmu4HBn2jiVGLrlMB@SR7%;I5?zXcppcY*#&W*U3>%DV9%N6B1gwWa2#w=Gx17&HZZTA45Qs^#FYmy4^`V~{||&IbUX8^f>~DjlTc z1t`CB0*{&{=;wH(@s-X&V@ z8tT=XtpWheKB9na_fdDC5l&~B-<9?o@y?w2dRw_SGOCzw8_n1#wwr$1s`n+JmXQ1_}HT-a{zekz5>!G_Nk26 z9L36ATK@!wyXB?Ed!j$a-yqu^2lij6Ls**-0yK6><$B-R{v3IRAyV!lU)uM$PT_ze z6c6hKn|&3mBr{{>lqO_#R81IS#8iDMklP|uFzFQghNn2^Kz0jOn352j#j=jZIAM*cHj707|r<}iXcGL*?g7Io&L5$6NG{);ybAM+Ab!9GaFc)hjWoQwE_EJ^Wpun z9O#eho|?xY!^ISQizeB8@b_+s0|lLFc&=HNqa26yAKkn!zhmJ_yT+Rwr+V=(u2=P% zaTRR`$_{aqakDTPsizXKtRz0qEM{BP@$JtCY|14S+k}cehKO~dAS$AlDUSuQy4@%8{@T+ z{Jxo%uK$wTLufOmVf}Ss-{UA_R3F0sE_Mi zO>F*3sb%uAl{I_$pd4?OOQ4n;qS^*m-o1$`xPmmS|_e;kZ>J44?H z#^}jweitq0_mOGY@9FjHeaF)U3`aZNs~Y2ZP%DIvGp8uO!B2c9)AD-as2&KNYB$*@ zXt2yp27_PJ^Fj{sv0Tgy)%)R)gtbN7c~Cigzhj97J8+QySyv(fkAGAWvxP8k^Rs_N!ok1#x zT^d3NJr@xhPA{77*X!G^xw)PmaCwPCdjDqahA)PlpTx$>s_6JvNqYe+%4E@Ct-_#P zW?pFO<^HWCC`4BbYwj)}iW`qmr$B;C!J66FVYK>hE&~9_d`jyrBvt`}Y?W^l& zv{eO>l*eFPTBq)(rVUSLWXI2(yWu6)_<+Lc%nGBry__O%{+>_5)oY@=yNX~xb7I8iF;5Eg7A=6{CCx%nF5KY%?aV)>Q@)> zGFIjn0ic8Fu3?~oA1@0x@j5;}Tijwo?`Oy-o+5c&i~0xD7Y=jxTooo?Mj5RO0#n;u z6B}XsCHvhFw}j{k*1W>bxjS53!~36R0{idmD?#_)p)w>h7lj`aYqGA4-jv^EdVjjY z0tUjt4V5F%m$k%k&ytKFxl^r;Dwd|)DC0`_i>Um?lJwQ#dw^y&$5^q zRR;`eB>Oc$J}?lLwzuDGcKM{u_vMYZI*8l~5r1axS=DwC1F*vz#<`$3=ftUJ9M6Vj zf{7){$f3QuM~WsBRYs~0lNZc{8!23-S#a>JUlk!l&a60tSY34g`Zo-)sskTDP{1a~ z0dL~?bot(nD&VVa%dRkhZRM(H|7R3XV;RJK%+Px4)hI6$Dyfwk)v@isw zq)wO(uA^y;1On-4FO!#iU$MZjQ|_OMvcpSjacTy%34Z8UjIqu!Db)8 zO$;`^D=DC74ne@}u=qa){+g6aJZvCkh{4wp4zX)^iTa5{lW2j8I z9e!mpc|ZxOiE%AlJO~Bob(TdMxk~icN{P}s^Awg-E0tFEj~2x#+xTjVHY~k_@GlEPaHQ1|u4UGf1Cv{bd0P(LFqaJ%xw{ zV~kh=ljxS3`3sn@21w@ybjB;h7Z~+kJGErrq96JG8|A*3jYCm&61Z6O=`d~8+Y}aG zpfM~1e7~eShbQt^-duC3l#kf6SoWWBnYMI{H`jdtJ%Sd&+F}T$56R!+vc(`_akw^B z!`MOS(8#ESXSlVoT0*?s0026m!}Y(s${-AfcB(`&74E)qu>2zt0GO01H2kN6i=hp- z!N{GAHf?WB>Xl+qi?GNbn)jGgs&lXS(bP-lq1vls)ydwG{Ow$wKwb!{ki za)axIpAIFjlWSZKQ<_fYqxvD1ak4x8&S*BWIxLvnnpk$>#k;3@oUy6R)ZJ! zm;ix`Bos@1p4#66^n2C^`5pn&y3ga*ZOpLV5$GWKy9zp9wPAy=k5T0*rDI?@NWO@j zPXlY&WApWb6}y=jd0ZjatT-Dt4YTp4>AY_8EK$v33845yx{`H0I)mI9^`;L5+LY2O zXc|GnoN|vmhBkT&gNtbk0aqg20VzDhKn%P6^E>{!L_cEXH+Vv*+26v!49y8XDNB?) z^8+94ekOwG0M}3!HIvmN!nd@rGtv7Z)LP68KV2v!$DtUjLD6JguRF^$nc>l-1x!Ho zJsgnVS9sc`JF1g7dh$|tTFPUN(!UjYb*2_gEmlr~1to20Un9Ss^r>Xo%`X=>w#>*} zi`SK>c7}K5;#KSuO-bPLP@H;sHRS|y>$jo-Yq`3>W99JGlOzR_H z76sJ3aA(Tmiy$q%@@bU4gxK;h-bQmhl*BOB`+H z>0_S39dq$gE_#FW7JYMp`;#xu$IUsHupct$N2}nDg{JlO#Ypt-PB#U-UP_E-gT1x%>SL&RF zmMCZScje)oGj#l?6jqeCe%$d=O;>rZr3u;j?uG6@cL2&c(*zr`3!=j_hkxq_!I(}})t zd^a_DZB$QZ?2g12wc0aY35m4AD*I=?-Fijy_tJ-%x^h^cY3+t|7uNMTJApg%sdG4=Q^S%cZ%j+mDbTE-A z=EcYFSFqbw=5Kaw+sTP~7O(0RP4)~njbJJmtCm^T+G>JA<~odtuC@H8190flyJUN! z{<>PT0ywog*U7fkVp4lyRl6Anqg6o!phWS@D>Va^G;oJts)ebz0LQyvw<#K`3QwSH zXxu93_?GM+>scRifO+a@pM2|DgSN3S z5$I0gG%2{^Vl+{0gUP448G(qSJZy=uNY6ScV94!ts9`KPGXUF+o5}!p@$@gV?Q>Vb zeBsbg05D$ND?7-#5FzwE&=NL>@fx+W(7E{Y326n`iP zS^xlgjAc#<4gi4fT(E(n*dpwyI~_3;EP(IKAAS<>L7K4xMVZ0Z~f)(wi;Zt0n#Y0bfBit$YVNZh!=`}|_y zk=Vt&zB9-ZwF%3-ce3zHCUqD@lM|K2J}gOyX$9np)=aV4+!V!{)FHP=-3QUh+ih#< zi6;)rRX7bX^)62iG-XWn(IXcY8e|u=q+0~F?xnzxpx3cda#A?ohU;!+cSgyaUHZ-u z{Bu^NbCN5Vh|Pphx0yb;o2bbzdNSB5CnHGhM|58^4(2*DfZ^GucE|^)zIA{wwFaer z5#RyfwDYZ9Go{RNA2`*=?`0JOS8i=xO0?zR51JFWM@Brzj|R`8+>dp%;@Ir7gs2(5 zg68rTyvlsC!wX@@5EZ<^&U4+%lX(l3LXVIGrE;_A_dsw-$&+?zVcdW61RLEWO|AgE zX&zM~&PKC@`J?#k8xbqKT}rL7EwG@jO0zWy7njO^arU1H!?Ih)gdRMh#MYNv1WrpQ z>N$uGv8d>WPNxAzv$Q(<8u@12N+-zDVU z&;XlHW1qiUe?ycf*O$F{@=?)p;tbeUd4?14y4onF??N!7F~z1oka0I7cIpggoenFN zzyl)*8xu?>VUGGxqL#|BP&Nh(a75*(Sb?1#ijeIwo6pBJv;$K~u~*tweu}Y^~7{3@?$e*l65qH@ukXp8KP)fP^^D`B<+8 z1;*6oo!x!-czno`DuMuHyS%t_oX1eQJZjo?zd1$)m@E z*0=ZT>yqWe@MGw!`n4OdRoB(z`{AAFJMeY+ko?tt3i5Td2KNm0_1Wl?Q#5|qpdUc^Ze`U z$@JsT*C)!ULsS>ufu@h-87Fw+q8$uH#WsqZdJk!Ky`LnXDImdP5`^?26ZGGjCsus6 z!I9IG>`|NiD0jwL%F7Ed7?1jnQb{AyYaKpHi-*5p>1GJjQStc48d+ZmcEs99&WH^| zS6qs6NL~Qb)m4dkfRvcBIo&vnQbcghjN!V#oJRk6;;6iWG08K9trH3(%ORxrPc+SZ z{yK6_?^Fx(TY=t4Cy7PTA*8ws8Geapd2fd4+)BrBlfLD0PurL5wXYy1UTzK;pDwGn z%v$2f(cWPLHzymE53iLcE(5Ww*IB@*O&TBhyF+&8aUkYp=Q6PyDT->OeoDl_G8Q8Z=?AA{%(oXGu>2otqGNfHe} z%0jxB6I_uokj;OG0Y)K<0)8vXqm$B{BABCk^lefnyYahs^7`UV6b_PMNbn0JLj8~uc%DN?P)oaJ58{6 z^eV3#@NhxxGYitQz#=s&#`j80o!rkIHlcp~A2Cs|340w*+j-Rf?+jqsFQ&x{zB~tq zRa@7O>1YoUT7f)&`xc0P{Hjw{q63$J5I&=wY6!}-5Tf4+-{m3-w)RfhEb49a!|siK zes1447~?p$B0Pq`cs1QC_Bwy#+cOx7sH%LDs=I06vfPG+%qR2`!7c>%fc-7ZoPn|W!(7)-0J)Y1r*woN8+#aaRaK?E92oM8rQEwnBm zRK%QLr6AbjaTgnnq0)r|OWfYWb*Sn4K5)&x-0eNW*79W^ja{&nFd$rtrY{TiDZR-d zwNW%70*3CbO-RDD&wpLIPeCfP19ChcA(Ld!J`j-v(;|z!?g~(1zQ&(|Tx&0nvUxaN zXKVduENu>Ntg*E@Y2et_WE-rCd+)C9*MIQ%pXUFMI8{!G-LIrG>NJQvkwWYXU%1Z! zn8v{)pB0So*k8{7U0i1XZshQu9JO*hD#e6uqo(-0iJnCL1gb4)Sh}Lhm?{4@#!6EN zybZUs{5QSyTr{-HzULiNeY`}SZ=J_OIq=mdG54E7b;=O8R|x$~-m6Tf*D^%5Xr)D0 z8oFUwQYA%CE895Dn7SyaKB2}z#ssodK`N_b;|8_;-n8EdGYeuu5 z^P2pGskYq`HR@~GZ5^0-K(O}zE-s7zRfRfvURLY>j*I_9x5sRE3K3!#T!eE`k^&8# z`e3xZ3+LS$g!i3s=xO0;)j`quFG=4Q)TaFjT>$sJgt=-0G!c^fb8WV!qawTL*miJwwJx?7Cj z*R;FtgF=x0M}_=jRtX@l>jWom?nk|HaFxj~1VS3*j|v=h;hjl>rDjs!Ggd@5NB?WY z;_;-p@xK-FUzo*L+*Q94RNesWi3quAHs~qi>4$_tI-3R8G!q5W%55I z;TN}7OXCcN%)gW5|8i&#@;34>zW=rQ|8s5Uie~1denRX>|63jZcLM(*qXc>9G)v!g z2c7&1y%Mhe4`KbkUp>=lumgO4WhPBDJj*5QPBX5z+k zJCaiE30XZ@doNkKZ#1vz?6$Nr+_OSmr3t)e*Kc&2A$b1b(cq)cYN!mp);_7Quz!F76eV>nBv~*HC19PUYD9mSRM%~gX{={nq3>h|3D_<9r2=vK? zE=~t^7@NXPh88eQXuW*^0IFVlMKmQr>{w_hmt4g_LYC2YNx@sZ5pem`QJDqp)R9KrNd0%f=dsSO0{P9mfN-X{xg!oO2YJspA! zt*-wV%+yq>t*hT`#c~ag{YvM%?y5HST-mASK&riyk{O+!5Ad35oo>wq?P?~G0-UV(vVzwu1jnN?;Q-SfuY zc2k9&{!K#4m8^|VYJ4G4HqP;fR20!Ui^F3Xd#6Qi9soa+F~jZ7X!#fk9tiogd#C`x zp?~GP?788B|D+w-x%B@NctsT8mlFuq=>FlvD8aOVev#ZKTd1mZwk+4yI9*a{Yy6*} zQW_SEV6ClDrBCfV6c(t?!Z(rtTk3j7u__|?E&^iHymm(T%fm!~*0zxZ*=%$~&w$&% z+fcjC|3E9b(P2C}0?vfE7#1dx+5!nDN%w%%=~IJ>Vxt>dbL58lK9E4$alFg0$~dVG z>Dcm&gZuPJfODSBm%00!f$uUD=QBu6Hclb0VFn&k2`=$|C-cu%&CDm=?3q+(D4HO$ zK=|;5Fg|l{Dg-^rC%G;mmIZ8zi%~yzZ5KQmzWrsC962+mv`)=x1owQ?HN`2y6ZlN)uM8{%I22Szu)|cY=&kdpZbwk~(anpb z)i%r8(Kw4U-`lXGzMLSu^?QY+q5D;r>NFqkr$mN4y=HdpqLn1JU_EXL=cWiZ?!;iq zKA!W2RbHOZa!i9L@;{7A)w^8Bit1Dg%WQe{lijjQ&o-Ddq@Q{J z8|0vpx)~TpBr8GegqYT#f$g^JfdPXzc0Po$dUfyGhpG7OCoLu1=c&ts4s_hJsRIZMPvTEWr|fl{9ZuOI?XmcnVT* z-S|=o7@VcU;9i}<7jMGR0jCn|La}WgW4h*ueqK|i zXMT}Z``3Jmj>%=95s&BxRt>qH5#cPxx z+le!4S)^MX>ZR<;;$1%m5j4Xoj$$`!UB$U(6W0=95rQ+LnC1gGLv-jDpb18Ea1P6oxt&E?}p_RU231aUGpOl+{XXn}iJd0(SDOJkNY6*mX zXP?Jqt=`jB6U6!<-!q+qsdG(b-%)(PB!>BY1#Xr-ov`d^#iP|~_ekXY6;*LcXV`_E zrUxHIL-HuBhG5oxq&x?P&>XY9I_ZnK&lNMx=|_)`K+fYKy?oaa*=CdP{*MXY;+X)= zJNKM}tF|f)j~8L@s>F_hQua(CPX}@gIQa)c`M}AI%+kmpd}v$>lSc(vFE^wse@gK) zd5>zYv)CQNsaZ~hx}E?n{L^3J^5~O4JQ?~#V2a1Xr14u+VM!Hwg9Y}}fAv}#bvf#{ zLZLT*@aDQZUSjVjb{7H?+0)gclsT8EIUVk9#UZM5;e?+gpe?JH4^l>$?ZAJ<8VrIx z6U~t*Rdrx-h6}NL{p!Z>t`|bEx2*q^G`n_i*^ajAT0`iMta{osfMO}x!X9a+vJp!~ zs#@UoAe0Pf1e<+162eWrGlOp*(l6U29$He`x<9mp$3&iwf_9cU;j~AJ+O$Jm$uJ)b z)@DOav?3sH;~&x4amoj{q;s8bf?eC7nA%q@7?(UME#S03U9DYnNjfOCwimn-GH)b$ zVhv|e_R(KIFT{pgMLXFaU*Ds@eFG_ER9zdAzBKm7q5NCo+%I4Kn*MSBaSH%IOMCnM zWg*NWe$Z+>ktA?WMapUk2Qtuyva^qHX$9CnSe6GA)jQM`FsD{KjT}lXvuufa+w72< zXn^8|fz`|Mw3t(bTdk)}3`Z!^)^gNZR<}+MH)N-Vy0Wsp^ z#Pe=I?k6IP*T94qsv8GyX~-oe?DlWHroMH=RSr)%#1|+kVe3sB8WTkfug3X(Y=Mr*@2Vb7`+A z(I})*&?!etYZBEB1*aWcHgn-^5VR@B4a%AQfJRz-K;bSzLGK=Vhg%k zUv2hO5~vUqWU0mTnnWB=#{Oz<@UtLdcz{(?vN+k@IXG*Oi;ZBL3qgjO%ZojbP1}g; zv$QDAG?c`_qZ8y2uWvEw^Ci8SL4D^NiHkh8*Azm_2KG>Um};y+a2e_M3OxHcAzPiK zC&yLfpL(ZSPD|W8H#XlwyhpK6q#J!^U-GO672*CWW$W^_ zr=Eb0SXoH89cY7=PrN)1vz77i56?Y|dHz~oB|ZC-b%#86gW`o^$$H&=Q>zB#6UjlXKW6onJ#~HE-5ROJ-(JT)ohtTG^P3#V z7;z5O(eW%1mB5HanN28rbQv0~fQ)n4o#wST?XV;*0ti1*q@)To$D%CBApmL|-_c4% zh*S;*Suh~$X*P$OUz1S*JOVDXth)GEJty&W{+X=X5&K>lYI@@!w#mIfk1G0gNJ!`^>?=CM+OJl|q6 z)Fs8c=2OC+@J^?AMw?Z=+Vvdn7tF+*n1@U@ozA#KHe0AwA;aYNjhOnwG#tfk1`^TWyMAg2?B{rJRrQ$ zdSsm20+Dp*t zZJ4oovdyNtlsbi6c2q9+tygXY7O#w|vr}96>?}&01PkEIUNUy&_hwp5Pt$$e3|BR>G8W(|ZB{5E%Uuq%VN6E&~e`;U*>55TA(KHIb z_3h?KP|wB!-@Kzv$4z1|^jyK{ z{S}k<0oxF_QG-Pg0?)vJ%ypmGkyjV#Jlpqy`U!Js(raW(-{f7{Scz?OE8qEI$2iIX zUqOkMLc&1GidT2wm}Sb5(Ot#xY^QMOLnVL}(_JnnC!%*Y)FKZT627Ey+(30xB!{d% zHCfg3HclU-){Lf_(JFWLj>Ap%Q(nUQ%`JJ@;0DTJ1O6AAcRcVOd=4x$In8E!T9ENl z^}zzdc02*vly6vYN5Z6Hs`yH+s}+f~ZRKZ$5h7PTor;{c50N~OLc88fl1x^-pQNeu zh`sl1a|ab;%ykg~^08?4%F+$fS^PGFkfY&*VWU1H0=2=54bx+jj4G=by>`z+x}4ep zkx)&wAy}YlCDG2{ZW_TlPAp7vUdUlihoh}J4@=jB+bTTeo*9&iCXieSTXM$kE1ocW zO6Y#lFD|!oX8{HE>ACZBv9&pFf0B0oc50ZZ$Bskfpp-}U2i;pU90KJUc&3Ph%u*E^ z{H^5op|ARw<$~SgXc(30o^tNc=XMO}blyw3$+B^Oq{Dd8h5j)C<1Bf6Y!!XjbzNe? z3#gydLbNvKA~$nByB>WlPk2`$OQs@USY9eEH|?u0KT+663Dz8n#P7d;4wRPTrClCJ zs>yOKo5`l$W)(%j%>paEILbB3%X8!ka)WE0{Udfs3C`uTDSuiQhd&37DF0fkS~qh> zm}q)gO9r%)frUhctMLc8i3AMJX0VvZgY)!FZx~QR_%e#wP>(sLIU9R3Xn_par| zWMV6+;A^?1IK|cK)<=;P(Nlqwq@rR% zzYS-js{fWoc7reK82Hpcd z6Vy4Dm#s52MQFlDkcvh9mRF)T8{Vqqrq3JK zT+=Oj*FdX6;hS`Zvn;ah)Ab{mX7J~p(X8s^A;YBQ=i#sEeU`9!a7MiRyJz5!f1WDF zvQ*3(&WdOVf|KhP&Z-_;3mK#)PODe3@X^5v}Q3GPO5q zU#(xltaxRm+KmuDL%}Fp4OM)Jj8V^>mptE>^KzJyd&<0EYs7jCCqyMR{ees1(I1Wy z_|AmGzPpM{cI#$4yLeRZFD&~L$+nK1=+h#y79lR<0F!}}<2*+^rr_ZZeHO4iD|?CP zu4F~iZ`_x)04N=n@u@Xra2rMCsV(r zZt9iQsysbN%*DH*gi4HwX1*9J&GLC{*XUi{#+Ux-MxSW00Ue~+#gaNsP+76>yjHy5 z^~OJQ;z6W9IzZCYoP60j4XUU63IQy#?n8YqG3chb!%CWD+0t6$I(4j}e9XRqPZ&*X zB)42hP|xEgO5mxFE^ltw-x~xLdT&FTZh@8ILXP%`O3>&Vh|e+JwUY5ybG(7bysG8LPwGL`96K z_qY8O5Xo*ieYF{th64eZll~phHw~Ym*%3^Zn(WAF)l3I_;>_ z{b2pk!Ri-5jqt1bD4yo25cU445PiUNPqCdNV|#1MykjC$o8BE zKpBN7g9j;*tE@9KIIo-0%xz}!kneC2K3SLSpGKkrju6(|^UEA;iWX|k;{-6MHE=#u zmLcNxM$FKKd99$B_g06G(sSfekA5Fa`B-RC{)gi_T!?y>d}hf7j##!A&2B*4 z>Is4uJCqFmLD)u-p0~H)@8Z_JTe5-!&qHWpGDxkyL80H8x&eHYt?tmgb?)lVDwkJb zo(Z6D<}ZSUz{;|H?D{*)in^gl`%Le^W4LD>MtYVa_-WoPP>#wWaz^3v(Ht>-GDzEI z2cYiM*u&DIgZl(H(Z656TqHKpQp|=ir+V3Iz`O+00w**`NnJU{m)eg@mxDam^%hl8 zee*)rwu-|nL@BD65gez4r4sD#sFQze`7&?9T+LabmWSA~)L~>(`{9)l2ZYL6r}x)5 za>8x_YxU^XvT8!Crmh&>z%j!lHliYHG*cWP=ciolLl2o8$)IS~o{IeHl^ALYFTv-z zabYCQ<48*>@iR--Zv@U%!QzAUzRhcdRZMMArvJ{I2zsY ztw*&ERo5p9mtKt)RL{|I=)?lwzOS_Xb|{5J958?RMMJeGVC$vnWO#QrfhP~I|DC-w z2b*$!h6a~+g%J=1*S`0G`!!m4(lRgNK)>M{b@o#4M5cF8^UA5hiQX%(TwpUZow0_28zSW|X2JWp9#H{n7|;`={) zl=J8nB-D3u#5$NUZ6Cn7aaJV0fr6{6Do34GdQHd&!K0^?fPwif8b=G)^H$;Gp3Wb( zAEF@i7~O(LLh&t+F{B+MA0Q7ilN6B7kr?;gpuC|ra@#Hw4Vj0A*s(|j)#Pe&@8-pZ zEcyjpVD9g;$CkN=C?kw%V4RIoOcJ2+t!h_0>&q!}?+yl27~>LE*4M4kI>G2aO6&&QHZH9lT;fC_>i@vHffGPDwWto&Y2AjN zSlTi5gA69P14#Upr6!^9D}mCvzambAK;HT<4o)eVZYlU8XoY~tEE3u`{wdd6i&D3KSrtM zAD$8?IY`?q@<6KrFqZjQ_SUxiQ>?L@fX{R7+@_NEoWm;W(I%#ls8!muA6sC4m`HD- z%2|J$+owO^j?aFl_aCJ%(`W@@MNwOgSq*NkPqufmaM9W?HrpL{d*}vc6)Qj5Q*xx4 z1k7h0!jyr^d2pUy zvgKHn8tc!!SfoOC37sCbkng_dD)Ikp=G1JWE}cKxE}-yoXpz;Q>q6r$0^FNor*iy0 zq`f+tdW<{2*Uu;2FHu=bVWrm5|Gn)hQu*%1mkEvDbBr*l%@LqX(rOe!M{VRZQGV+z?+vG!W?&1!4-We-di zR9n&~btgfGv;wV=HC5kK9)>Gf97S{hn3OU$C&fUQpUme7s+(Cj9T=wmPKm-NY&Q%e zpWqr<8zup)M2R`E>#rxN>u6xYf*Q|!y0`St0b5w=2;)VH^8qmIORAGaf`PIX`$btG z5T4%GckG_Wxe(BvpzqC6y2`mbDf%}YmO>zeNqVE2L!j)PT1b|kYAd0tA?7ziUJKQ7 z2~<9ij1fc_WNSY$x7r9{gm<)eKPg&0=~FZ;>UsDM3jV@^>kJLomeroUOi1cIPSV%SVHR5-CttioUv}T@QM&;^&SK}>}%2?}dEAm~*aGhEyYR7N;^<*ET zrqBqlLs9aE7d|g1=oG-vFQP>F;h>zvzoff6>dM_+mU@+xW_DaN{c{`g8Up(TbGDm4 z;yySTe&_V5YoZMy=opfwvV^CFOA_4OR-+I>?*Py75xr`d_<)FqXvRx4=#d|<1J-UEOdDf*&a#Ks*p!h ze?ZOzKChie=1cj=uV#=cWn#NqP*hY)73kddvw{E zaw7gcT4eBi@Zs~+y)eIss|)!1J9G9G;P8S61tZrk#XYMSiToG z5LX82E-gqf|A!fS;4uTN$JK}S<~nDCZb?qWjq1?1F|I@1{`_ERJ z98Khk-N7 zsFiRNqQNmL@@J!FV`X4~om}QLPHiTm2vV&Z!|rq))Y10Q-FJ|W5_>*V3MnOyG2RZe zusdryF_PM(sBi+401B9e@}2zdNR{)Ii9FPpN%V2X@#=S z4_ERd&IM*br61ZBbaQy`*Xa!>1G!)w@|5D4hBHSwQ*1klA0@>qyTVYDc3Ls2V&BDQ zb_$>O>`J=K!gi)2Iw%PJFN#ury|718 zZa7-I+(+I2{N zjy3TZ!jw^&&}5{Lr4Zr$dbu8`W@Y>(VH@1lUvtt1T_GGzBOTC^L@H1`xt+{|YbRTEoqJbRh);M^;`E zC(&1DhSUmLNYWF>`9@yHHaFVCBQ7q#0;5rRl*MMF(9FuR1lulWshf58%p@6sk(CWk z$eE(Ak$9xE9lb2N#?$;1zRnV$n>PWX7xD`UCh2&@;ZUu{>7j7xLL>FXox7*5>ctw} zV8&qNJ5Qa>KI0Y>=^8E1fYE;U4JAV8m(bP^z|4XIl)u?gIu&T#l_vZC?-lhAr()SE z!U_1JtceUv7?iH*Cnz((*6BQM5+ALo5BwGP$0$M> z2j}R67*EGf=CL9WI11`G2K6)s6?VHUa#~jd8FG=oEjtI`&(`|a09TYFTtf>YLtYaX7z6>kg~`ZFT3|86lXJYOId6n7cZ z@CtfPkTp38jO^{za0L^rCSE<%+%H4`@9HD{qsNF4&Q^4NG!8l?4a;?0YXSqR5d7HH z(qdY2d1*5^Ou=QJ6BGQ;W8Y`$d)^daoDy(NZ#$)u$nAsMfQBbT6DedD`17ZyPf8Do zakt;|iv}U{$)W>Q)cV%3)GJe5vMH)75ftJq$A3eVQ zY8s#`QG1szr8$-6&`Q*yz{Bw4)+fx&9AxKl%`B+SMhyLTrjgk%5$&f@;ZeizML`Sx zu@Xxjo=EBVmDEzJe55+od5_DM8p1*WH6s!d zUHxc1J}y8fN+G0~3{~dsrJJ1w@_9ppy&m>7ywxCeHFD(%(rekFG^?65W&xYi+&6EPLEw+)lm zp7~iLuVH0RSLe09DTl>6x~H|hJo*4qEAm{GQNmz&ca7oc?HQZg)f4=qieA4uSW1qP jkGHFfCn(O`NAPd^@lO|#RA!0aUks6kLzwjXUxxn&t;>@X literal 0 HcmV?d00001