{"id":16210042,"url":"https://github.com/ashblue/unity-simple-settings","last_synced_at":"2025-08-12T18:12:38.339Z","repository":{"id":38017652,"uuid":"234633156","full_name":"ashblue/unity-simple-settings","owner":"ashblue","description":"Access static serialized files in Unity from your resources folder. Automatically initializes a runtime safe copy when the game starts.","archived":false,"fork":false,"pushed_at":"2023-03-04T05:44:04.000Z","size":1058,"stargazers_count":13,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-08-09T03:30:23.058Z","etag":null,"topics":["unity","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashblue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2020-01-17T20:46:22.000Z","updated_at":"2025-01-30T16:58:31.000Z","dependencies_parsed_at":"2024-06-21T14:27:17.285Z","dependency_job_id":null,"html_url":"https://github.com/ashblue/unity-simple-settings","commit_stats":{"total_commits":17,"total_committers":2,"mean_commits":8.5,"dds":"0.47058823529411764","last_synced_commit":"4849d7552607399b3acc1822963e3589d1ff83a1"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ashblue/unity-simple-settings","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashblue%2Funity-simple-settings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashblue%2Funity-simple-settings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashblue%2Funity-simple-settings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashblue%2Funity-simple-settings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashblue","download_url":"https://codeload.github.com/ashblue/unity-simple-settings/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashblue%2Funity-simple-settings/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270109912,"owners_count":24528930,"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","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["unity","unity3d"],"created_at":"2024-10-10T10:34:57.324Z","updated_at":"2025-08-12T18:12:38.280Z","avatar_url":"https://github.com/ashblue.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Settings\n\nA micro-framework for creating ScriptableObject settings files that automatically create an automatic copy when initialized. Useful for settings, one time setup, object references and more. Only meant for runtime usage.\n\n## Quickstart\n\nSimply create a settings file and add your data fields after installing the [package](#installation). Please note that under the hood this is just a simple `ScriptableObject` with a light wrapper.\n\n```c#\n[CreateAssetMenu(fileName = \"ExampleSettings\", menuName = \"Fluid/Example Settings\")]\npublic class ExampleSettings : SettingsBase\u003cExampleSettings\u003e {\n    public bool myBool;\n}\n```\n\nNow generate your settings menu from the project window and place it in the root of any `Resources` folder. Note the name of the file must match the `*.cs` file.\n \nWhen called at runtime a new instance will automatically be generated of the settings file if it doesn't already exist.\n\n```c#\npublic class ExampleSettingsUsage : MonoBehaviour {\n    private void Start () {\n        Debug.Log($\"Initial example settings value: {ExampleSettings.Current.myBool}\");\n    }\n}\n```\n\nFull working example can be found by cloning this repo and opening `Assets/Example/Example.unity`.\n\n## Installation\n\nSimple Settings is used through [Unity's Package Manager](https://docs.unity3d.com/Manual/CustomPackages.html). In order to use it you'll need to add the following lines to your `Packages/manifest.json` file. After that you'll be able to visually control what specific version of Simple Settings you're using from the package manager window in Unity. This has to be done so your Unity editor can connect to NPM's package registry.\n\n```json\n{\n  \"scopedRegistries\": [\n    {\n      \"name\": \"NPM\",\n      \"url\": \"https://registry.npmjs.org\",\n      \"scopes\": [\n        \"com.fluid\"\n      ]\n    }\n  ],\n  \"dependencies\": {\n    \"com.fluid.simple-settings\": \"1.0.0\"\n  }\n}\n```\n\n## Releases\n\nArchives of specific versions and release notes are available on the [releases page](https://github.com/ashblue/unity-simple-settings/releases).\n\n## Nightly Builds\n\nTo access nightly builds of the `develop` branch that are package manager friendly, you'll need to manually edit your `Packages/manifest.json` as so. \n\n```json\n{\n    \"dependencies\": {\n      \"com.fluid.simple-settings\": \"https://github.com/ashblue/unity-simple-settings.git#nightly\"\n    }\n}\n```\n\nNote that to get a newer nightly build you must delete this line and any related lock data in the manifest, let Unity rebuild, then add it back. As Unity locks the commit hash for Git urls as packages.\n\n## Development Environment\n\nIf you wish to run to run the development environment you'll need to install the latest [node.js](https://nodejs.org/en/). Then run the following from the root once.\n\n`npm install`\n\nIf you wish to create a build run `npm run build` from the root and it will populate the `dist` folder.\n\n### Making Commits\n\nAll commits should be made using [Commitizen](https://github.com/commitizen/cz-cli) (which is automatically installed when running `npm install`). Commits are automatically compiled to version numbers on release so this is very important. PRs that don't have Commitizen based commits will be rejected.\n\nTo make a commit type the following into a terminal from the root\n\n```bash\nnpm run commit\n```\n\n---\n\nThis project was generated with [Oyster Package Generator](https://github.com/ashblue/oyster-package-generator).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashblue%2Funity-simple-settings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashblue%2Funity-simple-settings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashblue%2Funity-simple-settings/lists"}