From 907d480a12a10ce97d4e937f3511f44b72d54932 Mon Sep 17 00:00:00 2001 From: Ben C Date: Wed, 21 Sep 2022 12:15:12 -0400 Subject: [PATCH] Delete Cache Stuff Oops --- docs/.m_cache/hashes.json | 1 - docs/.m_cache/out_cache/base.min.js | 1 - docs/.m_cache/out_cache/browserconfig.xml | 7 ------- docs/.m_cache/out_cache/guides/getting_started.html | 4 ---- docs/.m_cache/out_cache/index.html | 1 - docs/.m_cache/out_cache/manifest.webmanifest | 1 - docs/.m_cache/out_cache/robots.txt | 4 ---- docs/.m_cache/out_cache/schema.min.css | 1 - docs/.m_cache/out_cache/schema.min.js | 5 ----- docs/.m_cache/out_cache/sitemap.xml | 1 - docs/out/base.min.js | 1 - docs/out/browserconfig.xml | 7 ------- docs/out/guides/getting_started.html | 4 ---- docs/out/index.html | 1 - docs/out/manifest.webmanifest | 1 - docs/out/robots.txt | 4 ---- docs/out/schema.min.css | 1 - docs/out/schema.min.js | 5 ----- docs/out/sitemap.xml | 1 - 19 files changed, 51 deletions(-) delete mode 100644 docs/.m_cache/hashes.json delete mode 100644 docs/.m_cache/out_cache/base.min.js delete mode 100644 docs/.m_cache/out_cache/browserconfig.xml delete mode 100644 docs/.m_cache/out_cache/guides/getting_started.html delete mode 100644 docs/.m_cache/out_cache/index.html delete mode 100644 docs/.m_cache/out_cache/manifest.webmanifest delete mode 100644 docs/.m_cache/out_cache/robots.txt delete mode 100644 docs/.m_cache/out_cache/schema.min.css delete mode 100644 docs/.m_cache/out_cache/schema.min.js delete mode 100644 docs/.m_cache/out_cache/sitemap.xml delete mode 100644 docs/out/base.min.js delete mode 100644 docs/out/browserconfig.xml delete mode 100644 docs/out/guides/getting_started.html delete mode 100644 docs/out/index.html delete mode 100644 docs/out/manifest.webmanifest delete mode 100644 docs/out/robots.txt delete mode 100644 docs/out/schema.min.css delete mode 100644 docs/out/schema.min.js delete mode 100644 docs/out/sitemap.xml diff --git a/docs/.m_cache/hashes.json b/docs/.m_cache/hashes.json deleted file mode 100644 index fa74edb0..00000000 --- a/docs/.m_cache/hashes.json +++ /dev/null @@ -1 +0,0 @@ -{"version": "0.1.10", "config": "7b4948d16a2627d3903b1ef851c06e5b7500062e917f6494e7d40573a6083ac4", "meta": "39b61a0dc258fbac66858ccd3b093c9a6ec8f9303b698ac00b70b47ba2eec50b", "items": {"pages/index.md": "350f501e814ed937bd9f9e58a7782fd79cbd3ec1042526fe3b5a78159f4a4ccb", "pages/guides/getting_started.md": "0edb6584e5be4a2d89bb96dd32b2dc7ea963b41863722db51df22faa72c33755", "sitemap.jinja2": "ef0e792c8eb1aff229c5b09ba9370b28bd0243d7536437b9f823a0964e1aff56", "browserconfig.jinja2": "a7828adea3eb4da18c0896c73966a7896b618cfdb8d05a1c4f75cf046cdfe59d", "manifest.jinja2": "0e7f65439ae5f818b9d9b8b3d75991c49d5b536bf9101ca840bee7c2768d67d6", "base.js": "7c652f4af5b7010825df706173564825673a8246361f60f817e02bd497938fad", "schema.js": "f1dffe78ef5d8767612d531858f1279dc2d929807a1775c4d4e87789ba779aa0", "schema.css": "db790dd2b813f128881c1c63bb41ac02cea0505aa63218e941dacc95b08c1081", "robots.jinja2": "7f29ef46361e2fd723cdfd9e635f85bf154e9dc716c9b4e47cdcf80eea16c4a5"}} \ No newline at end of file diff --git a/docs/.m_cache/out_cache/base.min.js b/docs/.m_cache/out_cache/base.min.js deleted file mode 100644 index a6296d25..00000000 --- a/docs/.m_cache/out_cache/base.min.js +++ /dev/null @@ -1 +0,0 @@ -$(document).ready(()=>{$(".menagerie-copy-button").click((e)=>{const text=$(e.currentTarget).siblings("code").text();navigator.clipboard.writeText(text);});}); \ No newline at end of file diff --git a/docs/.m_cache/out_cache/browserconfig.xml b/docs/.m_cache/out_cache/browserconfig.xml deleted file mode 100644 index d39dfefd..00000000 --- a/docs/.m_cache/out_cache/browserconfig.xml +++ /dev/null @@ -1,7 +0,0 @@ -#ffffff \ No newline at end of file diff --git a/docs/.m_cache/out_cache/guides/getting_started.html b/docs/.m_cache/out_cache/guides/getting_started.html deleted file mode 100644 index 51f2cc98..00000000 --- a/docs/.m_cache/out_cache/guides/getting_started.html +++ /dev/null @@ -1,4 +0,0 @@ -Getting Started - Outer Wilds Mod Loader

Getting Started

This page will outline how to get a working mod that will simply log a message to the console when the game starts.

Choosing an IDE

An IDE will help`provide the ability to create, edit, and build your mod.

The recommended IDE for modding is Visual Studio, however, stuff like Rider and VSCode can also work. This tutorial will assume you're using Visual Studio.

Installing Visual Studio

Head to the Visual Studio downloads page and select community 2022, after downloading and launching the installer, follow instructions until you reach this screen:

TODO: Installer Image

We want the "Desktop development with .NET" module, this will provide us with the tools we need to build the mod.

After installing Visual Studio, launch it once an then close it, this will ensure certain files are generated.

Installing the Template

We provide a template to make creating mods easier, this template will handle renaming files and changing the manifest.

Open up the windows search box and search for "Developer Command Line for Visual Studio 2022", it should look like this:

TODO: DEV CMD

To install the template, run the following command:

dotnet new --install Bwc9876.OuterWildsModTemplate
-

This will give an output similar to this:

TODO: OUTPUT
-

Once installed, you can close the developer command prompt and re-open Visual Studio.

Using the Template

Now that we have the template installed, open Visual Studio and select "New Project" from the welcome screen. Then search "Outer Wilds" and the template should appear in the list.

Set the project name to the name of your mod, please note this should NOT have spaces or special characters in it. The standard casing for projects is PascalCase, which involves capitalizing the start of every word and removing spaces.

On the next sreen, set author name to the name you want to appear in the manager and on the website, this should also not contain spaces

Finally, click "Create Project"

General Mod Layout

The general layout of an Outer Wilds mod is as follows:

manifest.json

This file contains metadata about your mod, such as its name, author, and version.

{YourProjectName}.cs

This file should have been renamed to your project name, it acts as the entry point for the mod.

default-config.json

This file is used by OWML to generate the settings menu for your mod, we'll go over it in another guide

{YourProjectName}.csproj

This file tell Visual Studio about your project, it determines stuff like dependencies and versions, you shouldn't need to touch this.

Viewing The C# File

Double-click {YourProjectName}.cs, it should open up in the main editor pane.

This file should contain a class that has the same name as your project and some methods within that class.

We'll focus on Start(). In this method we do two things:

  1. We output a message to the console alerting the user that the mod has loaded
  2. We subscribe to the scene loaded event in order to output a message to the log when the SolarSystem scene is loaded.

You may have noticed we use the ModHelper field to achieve console output, ModHelper is a collecton of utilities your mod can use to do a variety of things. It will be covered more in a seperate guide.

Building The Mod

Now that we know what the mod should do, let's make sure it actually does it. Building your mod should be as simple as pressing "Solution -> Build Solution" in the menu bar, if you get an error involving Visual Studio not being able to find a path, please see the section below, otherwise skip to "Running The Game"

Fixing .csproj.user

Your mod contains a special file called {YourProjectName}.csproj.user, this file tells Visual Studio where to build the mod to, if you've installed the manager in a non-standard loction, this file will be incorrect. To fix this, open the manager and select settings, then copy the path in the "OWML Path" field. Copy and paste this value between the <OutputPath> and </OutputPath>, and add \Mods to the end of the path. Then open up your manifest file and copy the uniqueName field (don't include the quotes). Paste this value preceded by a \ a the end of the path.

For example, if my mod's uniqueName is Bwc9876.CoolMod, my file would look like:

<OutputPath>C:\MyCoolFolder\DifferentManagerInstallFolderBcImAHacker\Mods\Bwc9876.CoolMod</OutputPath>
-

Running The Mod

Now the mod should have appeared in your mod manager at the very bottom, notice how the download count is a dash.

You mod should now be ready to run!

Click start game and wait for the title screen to load in. Now search your manager logs (there's a search box) for a message along the lines of "My mod {YourProjectName} is loaded!". This means your mod was loaded successfully! You can also try loading into the main game and checking the logs for another message from your mod.

Next Steps

You've successfully created and built your first Outer Wilds mod, moving forward may require a bit of knowledge in unity and will depend on what exactly you're trying to do. These guides will provide information on how to use various aspects of OWML, but it won't cover everything. If you ever need help, or even just want to chat about modding, feel free to join our Discord. There's almost always someone available to help.

\ No newline at end of file diff --git a/docs/.m_cache/out_cache/index.html b/docs/.m_cache/out_cache/index.html deleted file mode 100644 index ed222434..00000000 --- a/docs/.m_cache/out_cache/index.html +++ /dev/null @@ -1 +0,0 @@ -Outer Wilds Mod Loader

Outer Wilds Mod Loader

This is the documentation site for the Outer Wilds Mod Load (commonly shortened to OWML), a framework for creating and running Outer Wilds mods.

Getting Started

To get started with modding, head to our getting started guide. This is a guide for those familiar with Unity and C# who want to learn how to mod Outer Wilds.

\ No newline at end of file diff --git a/docs/.m_cache/out_cache/manifest.webmanifest b/docs/.m_cache/out_cache/manifest.webmanifest deleted file mode 100644 index 495ed292..00000000 --- a/docs/.m_cache/out_cache/manifest.webmanifest +++ /dev/null @@ -1 +0,0 @@ -{"$schema":"https://json.schemastore.org/web-manifest-combined.json","name":"Outer Wilds Mod Loader","short_name":"OWML","categories":[],"start_url":".","theme_color":"#333333","background_color":"#ffffff","lang":"en-US","description":"The mod loader and mod framework for outer wilds","icons":[{"src":"/images/fav/android-icon-36x36.png","sizes":"36x36","type":"image/png","density":"0.75"},{"src":"/images/fav/android-icon-48x48.png","sizes":"48x48","type":"image/png","density":"1.0"},{"src":"/images/fav/android-icon-72x72.png","sizes":"72x72","type":"image/png","density":"1.5"},{"src":"/images/fav/android-icon-96x96.png","sizes":"96x96","type":"image/png","density":"2.0"},{"src":"/images/fav/android-icon-144x144.png","sizes":"144x144","type":"image/png","density":"3.0"},{"src":"/images/fav/android-icon-192x192.png","sizes":"192x192","type":"image/png","density":"4.0"}]} \ No newline at end of file diff --git a/docs/.m_cache/out_cache/robots.txt b/docs/.m_cache/out_cache/robots.txt deleted file mode 100644 index 8f15e6f3..00000000 --- a/docs/.m_cache/out_cache/robots.txt +++ /dev/null @@ -1,4 +0,0 @@ -User-Agent: * -Allow: / - -Sitemap: /sitemap.xml \ No newline at end of file diff --git a/docs/.m_cache/out_cache/schema.min.css b/docs/.m_cache/out_cache/schema.min.css deleted file mode 100644 index 09809ff4..00000000 --- a/docs/.m_cache/out_cache/schema.min.css +++ /dev/null @@ -1 +0,0 @@ -.jsfh-animated-property{animation:eclair;animation-iteration-count:1;animation-fill-mode:forwards;animation-duration:0.75s}@keyframes eclair{0%,100%{transform:scale(1)}50%{transform:scale(1.03)}} \ No newline at end of file diff --git a/docs/.m_cache/out_cache/schema.min.js b/docs/.m_cache/out_cache/schema.min.js deleted file mode 100644 index 1aae3f49..00000000 --- a/docs/.m_cache/out_cache/schema.min.js +++ /dev/null @@ -1,5 +0,0 @@ -$(document).ready(()=>{anchorOnLoad()});$(document).on('click','a[href^="#"]',function(event){if(this.href.split("#")[1]==="top"){return} -event.preventDefault();history.pushState({},'',this.href)});function flashElement(elementId){let myElement=document.getElementById(elementId).parentNode;myElement.classList.add("jsfh-animated-property");setTimeout(function(){myElement.classList.remove("jsfh-animated-property")},1000)} -function setAnchor(anchorLinkDestination){history.pushState({},'',anchorLinkDestination)} -function anchorOnLoad(){let linkTarget=window.location.hash.split("?")[0].split("&")[0];if(linkTarget[0]==="#"){let idTarget=linkTarget.substring(1);if(idTarget!=="top"){anchorLink(idTarget)}}} -function anchorLink(linkTarget){const target=$("#"+linkTarget);target.parents().addBack().filter(".collapse:not(.show), .tab-pane, [role='tab']").each(function(index){if($(this).hasClass("collapse")){$(this).collapse("show")}else if($(this).hasClass("tab-pane")){const tabToShow=$("a[href='#"+$(this).attr("id")+"']");if(tabToShow){tabToShow.tab("show")}}else if($(this).attr("role")==="tab"){$(this).tab("show")}});setTimeout(function(){let targetElement=document.getElementById(linkTarget);if(targetElement){targetElement.scrollIntoView({block:"center",behavior:"smooth"});setTimeout(function(){flashElement(linkTarget)},500)}},1000)} \ No newline at end of file diff --git a/docs/.m_cache/out_cache/sitemap.xml b/docs/.m_cache/out_cache/sitemap.xml deleted file mode 100644 index 23ebe7e6..00000000 --- a/docs/.m_cache/out_cache/sitemap.xml +++ /dev/null @@ -1 +0,0 @@ -index.html1.0guides/getting_started.html0.9 \ No newline at end of file diff --git a/docs/out/base.min.js b/docs/out/base.min.js deleted file mode 100644 index a6296d25..00000000 --- a/docs/out/base.min.js +++ /dev/null @@ -1 +0,0 @@ -$(document).ready(()=>{$(".menagerie-copy-button").click((e)=>{const text=$(e.currentTarget).siblings("code").text();navigator.clipboard.writeText(text);});}); \ No newline at end of file diff --git a/docs/out/browserconfig.xml b/docs/out/browserconfig.xml deleted file mode 100644 index d39dfefd..00000000 --- a/docs/out/browserconfig.xml +++ /dev/null @@ -1,7 +0,0 @@ -#ffffff \ No newline at end of file diff --git a/docs/out/guides/getting_started.html b/docs/out/guides/getting_started.html deleted file mode 100644 index 51f2cc98..00000000 --- a/docs/out/guides/getting_started.html +++ /dev/null @@ -1,4 +0,0 @@ -Getting Started - Outer Wilds Mod Loader

Getting Started

This page will outline how to get a working mod that will simply log a message to the console when the game starts.

Choosing an IDE

An IDE will help`provide the ability to create, edit, and build your mod.

The recommended IDE for modding is Visual Studio, however, stuff like Rider and VSCode can also work. This tutorial will assume you're using Visual Studio.

Installing Visual Studio

Head to the Visual Studio downloads page and select community 2022, after downloading and launching the installer, follow instructions until you reach this screen:

TODO: Installer Image

We want the "Desktop development with .NET" module, this will provide us with the tools we need to build the mod.

After installing Visual Studio, launch it once an then close it, this will ensure certain files are generated.

Installing the Template

We provide a template to make creating mods easier, this template will handle renaming files and changing the manifest.

Open up the windows search box and search for "Developer Command Line for Visual Studio 2022", it should look like this:

TODO: DEV CMD

To install the template, run the following command:

dotnet new --install Bwc9876.OuterWildsModTemplate
-

This will give an output similar to this:

TODO: OUTPUT
-

Once installed, you can close the developer command prompt and re-open Visual Studio.

Using the Template

Now that we have the template installed, open Visual Studio and select "New Project" from the welcome screen. Then search "Outer Wilds" and the template should appear in the list.

Set the project name to the name of your mod, please note this should NOT have spaces or special characters in it. The standard casing for projects is PascalCase, which involves capitalizing the start of every word and removing spaces.

On the next sreen, set author name to the name you want to appear in the manager and on the website, this should also not contain spaces

Finally, click "Create Project"

General Mod Layout

The general layout of an Outer Wilds mod is as follows:

manifest.json

This file contains metadata about your mod, such as its name, author, and version.

{YourProjectName}.cs

This file should have been renamed to your project name, it acts as the entry point for the mod.

default-config.json

This file is used by OWML to generate the settings menu for your mod, we'll go over it in another guide

{YourProjectName}.csproj

This file tell Visual Studio about your project, it determines stuff like dependencies and versions, you shouldn't need to touch this.

Viewing The C# File

Double-click {YourProjectName}.cs, it should open up in the main editor pane.

This file should contain a class that has the same name as your project and some methods within that class.

We'll focus on Start(). In this method we do two things:

  1. We output a message to the console alerting the user that the mod has loaded
  2. We subscribe to the scene loaded event in order to output a message to the log when the SolarSystem scene is loaded.

You may have noticed we use the ModHelper field to achieve console output, ModHelper is a collecton of utilities your mod can use to do a variety of things. It will be covered more in a seperate guide.

Building The Mod

Now that we know what the mod should do, let's make sure it actually does it. Building your mod should be as simple as pressing "Solution -> Build Solution" in the menu bar, if you get an error involving Visual Studio not being able to find a path, please see the section below, otherwise skip to "Running The Game"

Fixing .csproj.user

Your mod contains a special file called {YourProjectName}.csproj.user, this file tells Visual Studio where to build the mod to, if you've installed the manager in a non-standard loction, this file will be incorrect. To fix this, open the manager and select settings, then copy the path in the "OWML Path" field. Copy and paste this value between the <OutputPath> and </OutputPath>, and add \Mods to the end of the path. Then open up your manifest file and copy the uniqueName field (don't include the quotes). Paste this value preceded by a \ a the end of the path.

For example, if my mod's uniqueName is Bwc9876.CoolMod, my file would look like:

<OutputPath>C:\MyCoolFolder\DifferentManagerInstallFolderBcImAHacker\Mods\Bwc9876.CoolMod</OutputPath>
-

Running The Mod

Now the mod should have appeared in your mod manager at the very bottom, notice how the download count is a dash.

You mod should now be ready to run!

Click start game and wait for the title screen to load in. Now search your manager logs (there's a search box) for a message along the lines of "My mod {YourProjectName} is loaded!". This means your mod was loaded successfully! You can also try loading into the main game and checking the logs for another message from your mod.

Next Steps

You've successfully created and built your first Outer Wilds mod, moving forward may require a bit of knowledge in unity and will depend on what exactly you're trying to do. These guides will provide information on how to use various aspects of OWML, but it won't cover everything. If you ever need help, or even just want to chat about modding, feel free to join our Discord. There's almost always someone available to help.

\ No newline at end of file diff --git a/docs/out/index.html b/docs/out/index.html deleted file mode 100644 index ed222434..00000000 --- a/docs/out/index.html +++ /dev/null @@ -1 +0,0 @@ -Outer Wilds Mod Loader

Outer Wilds Mod Loader

This is the documentation site for the Outer Wilds Mod Load (commonly shortened to OWML), a framework for creating and running Outer Wilds mods.

Getting Started

To get started with modding, head to our getting started guide. This is a guide for those familiar with Unity and C# who want to learn how to mod Outer Wilds.

\ No newline at end of file diff --git a/docs/out/manifest.webmanifest b/docs/out/manifest.webmanifest deleted file mode 100644 index 495ed292..00000000 --- a/docs/out/manifest.webmanifest +++ /dev/null @@ -1 +0,0 @@ -{"$schema":"https://json.schemastore.org/web-manifest-combined.json","name":"Outer Wilds Mod Loader","short_name":"OWML","categories":[],"start_url":".","theme_color":"#333333","background_color":"#ffffff","lang":"en-US","description":"The mod loader and mod framework for outer wilds","icons":[{"src":"/images/fav/android-icon-36x36.png","sizes":"36x36","type":"image/png","density":"0.75"},{"src":"/images/fav/android-icon-48x48.png","sizes":"48x48","type":"image/png","density":"1.0"},{"src":"/images/fav/android-icon-72x72.png","sizes":"72x72","type":"image/png","density":"1.5"},{"src":"/images/fav/android-icon-96x96.png","sizes":"96x96","type":"image/png","density":"2.0"},{"src":"/images/fav/android-icon-144x144.png","sizes":"144x144","type":"image/png","density":"3.0"},{"src":"/images/fav/android-icon-192x192.png","sizes":"192x192","type":"image/png","density":"4.0"}]} \ No newline at end of file diff --git a/docs/out/robots.txt b/docs/out/robots.txt deleted file mode 100644 index 8f15e6f3..00000000 --- a/docs/out/robots.txt +++ /dev/null @@ -1,4 +0,0 @@ -User-Agent: * -Allow: / - -Sitemap: /sitemap.xml \ No newline at end of file diff --git a/docs/out/schema.min.css b/docs/out/schema.min.css deleted file mode 100644 index 09809ff4..00000000 --- a/docs/out/schema.min.css +++ /dev/null @@ -1 +0,0 @@ -.jsfh-animated-property{animation:eclair;animation-iteration-count:1;animation-fill-mode:forwards;animation-duration:0.75s}@keyframes eclair{0%,100%{transform:scale(1)}50%{transform:scale(1.03)}} \ No newline at end of file diff --git a/docs/out/schema.min.js b/docs/out/schema.min.js deleted file mode 100644 index 1aae3f49..00000000 --- a/docs/out/schema.min.js +++ /dev/null @@ -1,5 +0,0 @@ -$(document).ready(()=>{anchorOnLoad()});$(document).on('click','a[href^="#"]',function(event){if(this.href.split("#")[1]==="top"){return} -event.preventDefault();history.pushState({},'',this.href)});function flashElement(elementId){let myElement=document.getElementById(elementId).parentNode;myElement.classList.add("jsfh-animated-property");setTimeout(function(){myElement.classList.remove("jsfh-animated-property")},1000)} -function setAnchor(anchorLinkDestination){history.pushState({},'',anchorLinkDestination)} -function anchorOnLoad(){let linkTarget=window.location.hash.split("?")[0].split("&")[0];if(linkTarget[0]==="#"){let idTarget=linkTarget.substring(1);if(idTarget!=="top"){anchorLink(idTarget)}}} -function anchorLink(linkTarget){const target=$("#"+linkTarget);target.parents().addBack().filter(".collapse:not(.show), .tab-pane, [role='tab']").each(function(index){if($(this).hasClass("collapse")){$(this).collapse("show")}else if($(this).hasClass("tab-pane")){const tabToShow=$("a[href='#"+$(this).attr("id")+"']");if(tabToShow){tabToShow.tab("show")}}else if($(this).attr("role")==="tab"){$(this).tab("show")}});setTimeout(function(){let targetElement=document.getElementById(linkTarget);if(targetElement){targetElement.scrollIntoView({block:"center",behavior:"smooth"});setTimeout(function(){flashElement(linkTarget)},500)}},1000)} \ No newline at end of file diff --git a/docs/out/sitemap.xml b/docs/out/sitemap.xml deleted file mode 100644 index 23ebe7e6..00000000 --- a/docs/out/sitemap.xml +++ /dev/null @@ -1 +0,0 @@ -index.html1.0guides/getting_started.html0.9 \ No newline at end of file