{"id":20349553,"url":"https://github.com/csharpredottools/examplemod","last_synced_at":"2025-03-04T16:25:12.176Z","repository":{"id":246414004,"uuid":"821060026","full_name":"CSharpRedotTools/ExampleMod","owner":"CSharpRedotTools","description":"Example Mod for ValksGodotTools/Template","archived":false,"fork":false,"pushed_at":"2024-08-07T00:27:17.000Z","size":46,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-14T23:45:56.643Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CSharpRedotTools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-27T18:19:52.000Z","updated_at":"2024-08-07T00:27:21.000Z","dependencies_parsed_at":"2024-06-27T21:41:27.675Z","dependency_job_id":"bb722be8-3d60-459e-b4bc-e387a65bcdb1","html_url":"https://github.com/CSharpRedotTools/ExampleMod","commit_stats":null,"previous_names":["valksgodottools/examplemod","csharpredottools/examplemod"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CSharpRedotTools%2FExampleMod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CSharpRedotTools%2FExampleMod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CSharpRedotTools%2FExampleMod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CSharpRedotTools%2FExampleMod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CSharpRedotTools","download_url":"https://codeload.github.com/CSharpRedotTools/ExampleMod/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241878769,"owners_count":20035684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-14T22:26:24.034Z","updated_at":"2025-03-04T16:25:12.146Z","avatar_url":"https://github.com/CSharpRedotTools.png","language":"C#","readme":"## What is this?\nThis is the example mod for ValksGodotTools/Template. Mods can add and replace assets as well as execute C# scripts.\n\n\u003e [!CAUTION]\n\u003e In order to execute scripts across several mods properly, [this issue](https://github.com/ValksGodotTools/Template/issues/15) needs to get resolved. In the meantime mods adding scripts to mods should be avoided.\n\n\u003e [!WARNING]\n\u003e Every mod needs a `mod.json` file. The `id` should be unique to your mod and only your mod.\n```json\n{\n    \"name\": \"Example Mod\",\n    \"id\": \"example_mod\",\n    \"modVersion\": \"1.0\",\n    \"gameVersion\": \"*\",\n    \"description\": \"Example description.\",\n    \"author\": \"valkyrienyanko\",\n    \"dependencies\": {},\n    \"incompatibilities\": {}\n}\n```\n\n## How to Replace Game Assets\nGame assets include things like sounds, pictures, shaders and models. In order to even start replacing game assets, you will need to know where they are in the game. Only the developer who made the game will be able to tell you this.\n\nIn [ValksGodotTools/Template](https://github.com/ValksGodotTools/Template), a path to one of the assets is `res://Template/Sprites/Concept Art/elk-skull-lodge.jpg`. If you would like to replace this you will need to recreate the exact folder structure in this mod. That is create a new folder named `Template` and then create a folder inside that named `Sprites` and then `Concept Art` and finally a image with the same file name and file extension, that is `elk-skull-lodge.jpg`. \n\n\u003e [!CAUTION]\n\u003e C# Scripts are the only kind of assets that cannot be replaced\n\n## How to Add C# Scripts\nDue to the way how assemblies are loaded in ValksGodotTools/Template, all scripts will be need to be in unique locations for each mod. If two scripts are in the same location from two different mods, both mods will fail to load.\n\nPut your scripts in `res://\u003cauthor\u003e/\u003cid\u003e` where `\u003cauthor\u003e` and `\u003cid\u003e` are what you set in `mod.json`. Making sure these are the same is very important otherwise your mod will fail to load.\n\nYou must have a scene in `res://\u003cauthor\u003e/\u003cid\u003e` named `mod.tscn` and the first node in the scene must have the following script attached.\n```cs\nusing Godot;\n\npublic partial class Mod : Node\n{\n    public override void _Ready()\n    {\n        \n    }\n}\n```\n\u003e [!NOTE]\n\u003e The `Mod` node will get added as a child when the mod loads in, so any built-in node functions like `_Ready()` and `_PhysicsProcess()` will act as the entry point to your mod.\n\n## Exporting the Mod\n1. Export the mod via `Project \u003e Export...`\n2. Create a new folder for your mod. The mod should contain at least 3 files.\n    - `mod.json` *(the file you created earlier)*\n    - `mod.pck` *(generated from the export)*\n    - `Mod.dll` *(generated inside `.godot\\mono\\temp\\bin\\Debug`)*\n3. Put this folder inside the `Mods/` folder of the game\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsharpredottools%2Fexamplemod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcsharpredottools%2Fexamplemod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsharpredottools%2Fexamplemod/lists"}