{"id":14960930,"url":"https://github.com/mrlightful/unity-puzzlesystem-asset","last_synced_at":"2025-10-26T05:04:43.126Z","repository":{"id":165121633,"uuid":"166668710","full_name":"MrLightful/unity-puzzlesystem-asset","owner":"MrLightful","description":"The asset for the Unity Engine that allows to quickly create customisable puzzles.","archived":false,"fork":false,"pushed_at":"2019-03-20T21:53:26.000Z","size":12847,"stargazers_count":23,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-02T00:27:18.842Z","etag":null,"topics":["framework","modular","puzzle","puzzles","tool","unity","unity-asset","unity-editor","unity-scripts","unity3d"],"latest_commit_sha":null,"homepage":"https://puzzlesystem.gitbook.io","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/MrLightful.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}},"created_at":"2019-01-20T14:10:14.000Z","updated_at":"2024-05-17T09:52:26.000Z","dependencies_parsed_at":"2024-01-26T20:10:08.238Z","dependency_job_id":null,"html_url":"https://github.com/MrLightful/unity-puzzlesystem-asset","commit_stats":null,"previous_names":["mrlightful/unity-puzzlesystem-asset","romatallinn/unity-puzzlesystem-asset"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrLightful%2Funity-puzzlesystem-asset","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrLightful%2Funity-puzzlesystem-asset/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrLightful%2Funity-puzzlesystem-asset/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrLightful%2Funity-puzzlesystem-asset/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MrLightful","download_url":"https://codeload.github.com/MrLightful/unity-puzzlesystem-asset/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238030288,"owners_count":19404859,"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":["framework","modular","puzzle","puzzles","tool","unity","unity-asset","unity-editor","unity-scripts","unity3d"],"created_at":"2024-09-24T13:23:28.250Z","updated_at":"2025-10-24T20:30:57.328Z","avatar_url":"https://github.com/MrLightful.png","language":"C#","funding_links":["https://paypal.me/sirokov"],"categories":[],"sub_categories":[],"readme":"[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com)\n[![forthebadge](https://forthebadge.com/images/badges/made-with-c-sharp.svg)](https://forthebadge.com)\n\n[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/sirokov)\n![GitHub release](https://img.shields.io/github/release/romatallinn/unity-puzzlesystem-asset.svg)\n![GitHub repo size in bytes](https://img.shields.io/github/repo-size/romatallinn/unity-puzzlesystem-asset.svg)\n\n# Unity Asset: Puzzle System\n\n## Introduction\n\n![Logo](https://raw.githubusercontent.com/romatallinn/unity-puzzlesystem-asset/master/Meta%20Data/large.png?token=AOO4vC_ZA-4J7sn5MqJHwuc_UVEkQLLhks5cm-AFwA%3D%3D)\n\n\n**Puzzle System** is a highly customizable framework for the projects that contain any kind of puzzles. The framework provides you with the set of common, but yet customizable, solutions; as well as the basic classes that can be used in order to create unique puzzle experiences.\n\n\n\n## Table of contents\n\n- [Install](#install)\n  - [Unity Asset Package](#unity-asset-package)\n  - [Clone Repository](#clone-repository)\n\n- [Get Started](#get-started)\n  - [Puzzle Structure](#puzzle-structure)\n  - [Editor Utility](#editor-utility)\n\n- [Full Documentation](#full-documentation)\n\n- [Donation](#donation)\n\n\n\n## Install\n\n### Unity Asset Package\n\n- Download [PuzzleSystem_v1.unitypackage](https://github.com/romatallinn/unity-puzzlesystem-asset/blob/master/PuzzleSystem_v1.unitypackage)\n- Open Unity\n- Menu -\u003e Assets -\u003e Import Package -\u003e Custom Package\n- Choose the downloaded package, click Open\n\n### Clone Repository\n\n```\n// Clone this repository\n$ git clone https://github.com/romatallinn/unity-puzzlesystem-asset.git\n```\n\n\n\n## Get Started\n\n### Puzzle Structure\n\nA very critical to understand in the beginning is how the puzzles will be structured in your project.\n\nThere are 3 types of elements for every puzzle:\n- **Puzzle Handler** -- responsible for handling situations when the puzzle has been solved or failed. In other words, defines what actions will be taken on these critical events (e.g., solved puzzle -\u003e open gates for the player).\n\n- **Puzzle Logic** -- responsible for defining what kind of logic the puzzle is following; what  player must accomplish in order to solve the puzzle, and what player's actions will lead to the failed condition (e.g., task: activate all triggers).\n\n- **Puzzle Trigger** -- objects that the player will interact with in order to proceed with the puzzle (e.g., press a certain keyboard key in a dedicated zone). It should not contain any logic for puzzle solving. It can, however, contain the information for the Puzzle Logic, where it will be analyzed and the decision will then be given on whether or not this trigger helps to solve the puzzle.\n\n### Editor Utility\nThere is an editor tool that you can make use of.\n\nIn order to open it:\n`Menu -\u003e Tools -\u003e Puzzle System`\n\n\n![Open Editor Tool](https://blobscdn.gitbook.com/v0/b/gitbook-28427.appspot.com/o/assets%2F-LWSZAoTb0akZrStcZ8k%2F-LWc3kW9MHyHUx43orVx%2F-LWc3nyE4PwJCNn8ArCP%2FScreenshot%202019-01-19%20at%2022.44.35.png?alt=media\u0026token=8feda4cb-b3d8-4b4d-9eb1-d6060407a8f9)\n\n\u003cimg src=\"https://blobscdn.gitbook.com/v0/b/gitbook-28427.appspot.com/o/assets%2F-LWSZAoTb0akZrStcZ8k%2F-LWme9e3zpdRdaVUI-Oh%2F-LWc3t95nIJXM0TV82nF%2FScreenshot%202019-01-19%20at%2022.44.11.png?alt=media\u0026token=1d388944-71b1-4b54-8bcc-87f7e9f11273\" width=\"500px\" style=\"margin:20px;\"\u003e\n\n\n\n## Full Documentation\nYou can find an extensive documentation available online at\nhttps://puzzlesystem.gitbook.io.\n\nThere you can read more thorough material on all of the aspects and features available in the framework, as well as examples and other tips.\n\n\n\n## Donation\nI know, this project isn't something huge, but I'm a just passionate student of Computer Science \u0026 Engineering that wants to conquer the world with his dev skills. A small tip for a cup of coffee, so I can code all days and nights, would be highly appreciated and really helpful!\n\n[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://paypal.me/sirokov)\n\n\n\n## License\nThe MIT License (MIT) 2019 - [Roman Sirokov](https://flist.me/u/rsirokov). Please have a look at the [LICENSE.md]() for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrlightful%2Funity-puzzlesystem-asset","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrlightful%2Funity-puzzlesystem-asset","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrlightful%2Funity-puzzlesystem-asset/lists"}