{"id":18419726,"url":"https://github.com/madmegsox1/polyscape-engine","last_synced_at":"2025-04-07T13:31:42.170Z","repository":{"id":209859978,"uuid":"664305227","full_name":"Madmegsox1/PolyScape-Engine","owner":"Madmegsox1","description":"PolyScape-Engine is a multiplatform 2D render/game engine written in java. With an easy to use UI for level design and development","archived":false,"fork":false,"pushed_at":"2024-08-20T19:30:25.000Z","size":940,"stargazers_count":5,"open_issues_count":13,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-08-20T21:37:43.533Z","etag":null,"topics":["2d-game-engine","box2d","game","game-engine","game-engine-2d","java","lwjgl","multiplatform","opengl"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Madmegsox1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2023-07-09T15:07:32.000Z","updated_at":"2024-08-20T19:30:28.000Z","dependencies_parsed_at":"2024-04-01T12:25:50.554Z","dependency_job_id":"5ffb5579-d05d-4403-b68b-89c8c156cfce","html_url":"https://github.com/Madmegsox1/PolyScape-Engine","commit_stats":null,"previous_names":["madmegsox1/polyscape-engine"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Madmegsox1%2FPolyScape-Engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Madmegsox1%2FPolyScape-Engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Madmegsox1%2FPolyScape-Engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Madmegsox1%2FPolyScape-Engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Madmegsox1","download_url":"https://codeload.github.com/Madmegsox1/PolyScape-Engine/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247661761,"owners_count":20975112,"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":["2d-game-engine","box2d","game","game-engine","game-engine-2d","java","lwjgl","multiplatform","opengl"],"created_at":"2024-11-06T04:18:03.850Z","updated_at":"2025-04-07T13:31:41.085Z","avatar_url":"https://github.com/Madmegsox1.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Polyscape: A 2D Java Game Engine\n\nWelcome to Polyscape, a 2D game engine built in Java, designed to make game development accessible and enjoyable for\nbeginners, while still offering powerful features for more experienced developers. Leveraging libraries such as LWJGL,\nBox2D, and Pkl, Polyscape aims to provide a comprehensive toolset for creating engaging 2D games.\n\n\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Dependencies](#dependencies)\n- [Configuration](#configuration)\n- [Examples](#examples)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Introduction\n\n\nPolyscape is currently under development, with a focus on simplifying the game development process. It features an\neasy-to-use GUI, known as the Polyscape-Editor, which allows developers to design custom UIs and levels directly within\nthe engine. Our mission is to lower the barrier to entry for game development and provide a flexible platform for\ncreating 2D games.\n\n## Features\n\n- Beginner-Friendly: An intuitive interface and workflow, making game development accessible to newcomers.\n- Polyscape-Editor: A built-in editor for creating and editing UIs and levels without needing to write code.\n- Customizable UIs: Tools to design your game's interface exactly how you envision it.\n- Level Creation: Easily design levels with our drag-and-drop editor.\n- Sprite Sheet Friendly: Easily add your own sprite sheet's to objects with no hassle.\n- Powered by LWJGL and Box2D: Leverages these powerful libraries for graphics, physics, and more.\n\n## Installation\n\nPolyscape uses Gradle for building the project, ensuring a smooth setup process. To get started, follow these steps:\n\n1. Clone the repository:\n     ```bash\n    git clone https://github.com/Madmegsox1/PolyScape-Engine.git\n     ```\n2. Navigate to the Polyscape directory:\n     ```bash\n     cd polyscape\n     ```\n3. Build the project with Gradle:\n\n     ```bash\n    ./gradlew build\n     ```\n4. If you are running on a Mac please add this JVM argument `-XstartOnFirstThread` \n\n## Usage\n\nAfter installing Polyscape, you can start using the engine by launching the Polyscape-Editor. Here's a quick start\nguide:\n\n1. Launch the Polyscape-Editor from your build directory.\n2. Use the GUI to create your first project.\n3. Begin designing your game's UI and levels using the editor's tools.\n4. Test your game directly within the editor.\n\nFor detailed instructions, refer to the [Documentation](#documentation) section.\n\n## Dependencies\n\nPolyscape depends on the following libraries:\n\n- [LWJGL](https://www.lwjgl.org/) (Lightweight Java Game Library)\n- [Box2D](https://box2d.org/) for physics simulations\n- [Pkl](https://pkl-lang.org/) for additional functionalities\n\nEnsure these are correctly set up in your project. Gradle should handle most of the dependency management for you.\n\n## Configuration\n\nMost configuration in Polyscape can be done directly through the Polyscape-Editor. For advanced configurations, please\nrefer to the configuration files in the config directory. Or Download Polyscape-engine Jar and import the library into a Java Project\n\n## Examples\n\nCheck out the [examples directory](https://github.com/Madmegsox1/PolyScape-Engine/tree/master/src/test/java/org/polyscape/test) for sample projects demonstrating how to use Polyscape for various types of games.\n\nHere is a video preview of the polyscape editor\n\n\nhttps://github.com/Madmegsox1/PolyScape-Engine/assets/68086870/1ca76a3e-e7a9-44b1-8ece-883cb789de0b\n\n\n\n## Contributing\n\nContributions are welcome! Whether you're fixing bugs, adding new features, or improving the documentation, your help is\ngreatly appreciated. Please refer to our [contributing guidelines](https://github.com/Madmegsox1/PolyScape-Engine/blob/master/CONTRIBUTING.md) for more information on how to contribute.\n\n## License\n\nPolyscape is licensed under the Polyscape Engine License (PEL) Version 1.0. See the [LICENSE file](https://github.com/Madmegsox1/PolyScape-Engine/blob/master/LICENSE.md) for more details.\n\n[comment]: # (This actually is the most platform independent comment)\n\n\n\n[comment]: # (## Troubleshooting TODO)\n\n[comment]: # (For common issues and their solutions, see the Troubleshooting section of our documentation. If you encounter any)\n\n[comment]: # (problems not covered there, please open an issue on our GitHub repository.)\n\n[comment]: # (## Documentation TODO)\n\n[comment]: # (Comprehensive documentation is available here link to documentation. It includes detailed guides on getting started,)\n\n[comment]: # (using the Polyscape-Editor, and developing your first game.)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmadmegsox1%2Fpolyscape-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmadmegsox1%2Fpolyscape-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmadmegsox1%2Fpolyscape-engine/lists"}