{"id":16253024,"url":"https://github.com/digitsensitive/juno","last_synced_at":"2025-07-30T20:09:04.212Z","repository":{"id":57287284,"uuid":"147010775","full_name":"digitsensitive/juno","owner":"digitsensitive","description":"Juno is a simple and lightweight 2D game framework written in TypeScript for making tiny pixel style HTML5 Games","archived":false,"fork":false,"pushed_at":"2020-08-09T11:46:37.000Z","size":482,"stargazers_count":24,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-17T23:43:37.203Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/digitsensitive.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-01T15:37:52.000Z","updated_at":"2024-12-07T00:28:54.000Z","dependencies_parsed_at":"2022-09-20T02:11:32.727Z","dependency_job_id":null,"html_url":"https://github.com/digitsensitive/juno","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/digitsensitive/juno","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitsensitive%2Fjuno","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitsensitive%2Fjuno/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitsensitive%2Fjuno/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitsensitive%2Fjuno/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/digitsensitive","download_url":"https://codeload.github.com/digitsensitive/juno/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/digitsensitive%2Fjuno/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267931223,"owners_count":24167579,"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-07-30T02:00:09.044Z","response_time":70,"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":[],"created_at":"2024-10-10T15:15:42.394Z","updated_at":"2025-07-30T20:09:04.178Z","avatar_url":"https://github.com/digitsensitive.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=100% src=\"https://github.com/digitsensitive/juno/blob/master/assets/github/juno.png\"\u003e\n\u003c/p\u003e\n\n[![dependencies status badge](https://david-dm.org/digitsensitive/juno/status.svg)](https://david-dm.org/digitsensitive/juno)\n[![GitHub issues](https://img.shields.io/github/issues/digitsensitive/juno.svg)](https://github.com/digitsensitive/juno/issues)\n[![GitHub stars](https://img.shields.io/github/stars/digitsensitive/juno.svg)](https://github.com/digitsensitive/juno/stargazers)\n![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)\n[![GitHub license](https://img.shields.io/github/license/digitsensitive/juno.svg)](https://github.com/digitsensitive/juno)\n\nJuno is a simple and lightweight 2D game framework written in TypeScript for\nmaking tiny pixel style HTML5 Games. The structure of Juno is similar to that of\n[fantasy consoles](https://github.com/paladin-t/fantasy) with a simple API.\nCreating prototypes has never been easier.\n\nThe framework is still in an early stage of development.\n\nWhat are you waiting for? Start with Juno and create games in a nutshell!\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eCreated with ❤︎ by \u003ca href=\"https://github.com/digitsensitive\"\u003edigitsensitive\u003c/a\u003e\u003c/sub\u003e\n\u003c/div\u003e\n\n## Getting started\n\n### Installation\n\n```sh\nnpm install juno-console --save\nyarn add juno-console\nbower install juno-console --save\n```\n\n## Usage\n\nFor a boilerplate and examples have a look at the\n[Juno examples](https://github.com/digitsensitive/juno-examples).\n\n## API\n\nFor more details see comments in the code.\n\n`ipal`\n\nInit your own color palette.\n\n`cls`\n\nClear the screen.\n\n`pix`\n\nDraw a pixel.\n\n`pget`\n\nGet pixel color index from 2D position.\n\n`load`\n\nLoad your spritesheet.\n\n`spr`\n\nAdd a sprite.\n\n`map`\n\nLoad a Tilemap.\n\n`mget`\n\nGet map tile index.\n\n`mset`\n\nSet map tile index.\n\n`circ`\n\nDraw a filled circle.\n\n`circb`\n\nDraw a circle outline.\n\n`line`\n\nDraw a line.\n\n`rect`\n\nDraw a filled rect.\n\n`rectb`\n\nDraw a rectangle outline.\n\n`print`\n\nDraw some text.\n\n`trace`\n\nTrace a variable for it's value.\n\n`key`\n\nCheck if a key is currently pressed.\n\n`keyp`\n\nCheck if a key was pressed in the frame before (only once).\n\n`mouse`\n\nGet the mouse coordinates.\n\n`ggw`\n\nGet the game width.\n\n`ggh`\n\nGet the game height.\n\n`ticks`\n\nGet the ticks since start of the game.\n\n`rnd`\n\nGet a random number between min and max value.\n\n`crc`\n\nSimple circle-rectangle-collision.\n\n`rrc`\n\nSimple rectangle-rectangle collision.\n\n`anim`\n\nAnimate your sprite.\n\n\n## FAQ\n\n**How is the basic setup?**\n\nHave a look at the [Juno examples](https://github.com/digitsensitive/juno-examples).\nYou will find a boilerplate.\n\nBasically, only three functions are required. The `init()` function can be used\nto initiate the color palette, load the sprites or the json map file and define variables.\nWith the `update()` function parameters are adjusted and the `render()`\nfunction draws your masterpieces.\n\n**How do I load my sprites?**\n\nMake a call of the `load()` function in your `init()`. The path is relative\nto your root folder. You can then draw your sprites in the `render()` function.\n\n```typescript\ninit(): void {\n  this.api.load(\"sprites\", \"./src/assets/sprites.png\", 8);\n}\n\nrender(): void {\n  this.api.spr(0, 10, 10);\n}\n```\n\n\u003e Be aware: Currently you can only load one sheet (spritesheet and Tileset together)\n\n**How do I load my JSON map?**\n\nSimilar as loading your sprites. Be sure to load your tiles before.\n\n```typescript\ninit(): void {\n  this.api.load(\"tiles\", \"./assets/tiles.png\", 8);\n  this.api.load(\"map\", \"./assets/map.json\", 8);\n}\n\nrender(): void {\n  this.api.spr(0, 10, 10);\n}\n```\n\n\u003e Be aware: Currently you can only load one sheet (spritesheet and Tileset together)\n\n**How do I load my own color palette?**\n\nOne palette comprises a total of 16 colours. By default, a predefined palette\nis loaded. Your own palette can be loaded using a chain of hex strings (6 x 16 = 96 characters).\n\n```typescript\ninit(): void {\n  this.api.ipal(1a1c2c572956b14156ee7b58ffd079a0f07238b86e276e7b29366f405bd04fa4f786ecf8f4f4f493b6c1557185324056);\n}\n```\n\n**OK, so I have chosen a color palette, but how do I get the colors into my graphics editor?**\n\nThe easiest way is to load the already defined\n[.css swatch](https://github.com/digitsensitive/juno-examples/tree/master/assets/swatches)\ndirectly into your graphics editor. Et voilà!\n\n## Changelog\n\n[Learn about the latest improvements](https://github.com/digitsensitive/juno/blob/master/CHANGELOG.md)\n\n## Contributing\n\nWant to correct a bug, contribute some code, or improve the codes? Excellent! Let me know!\n\n## License\n\nThis project is licensed under the MIT License - see the\n[LICENSE.md](https://github.com/digitsensitive/juno/blob/master/LICENSE.md) file for details.\n","funding_links":[],"categories":["Code","Table of Contents","GameEngine Design"],"sub_categories":["Engines and Frameworks"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitsensitive%2Fjuno","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitsensitive%2Fjuno","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitsensitive%2Fjuno/lists"}