{"id":16374961,"url":"https://github.com/sovdeeth/skript-particle","last_synced_at":"2026-01-03T05:19:44.194Z","repository":{"id":60035511,"uuid":"529758156","full_name":"sovdeeth/skript-particle","owner":"sovdeeth","description":"Skript addon for creating complex particle effects with minimal hassle","archived":false,"fork":false,"pushed_at":"2024-09-30T19:41:25.000Z","size":3210,"stargazers_count":11,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-12T03:18:55.181Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sovdeeth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2022-08-28T04:06:04.000Z","updated_at":"2024-09-30T19:41:29.000Z","dependencies_parsed_at":"2023-11-14T02:27:35.921Z","dependency_job_id":"258de9d0-2b76-472b-993e-a87daba417ec","html_url":"https://github.com/sovdeeth/skript-particle","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sovdeeth%2Fskript-particle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sovdeeth%2Fskript-particle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sovdeeth%2Fskript-particle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sovdeeth%2Fskript-particle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sovdeeth","download_url":"https://codeload.github.com/sovdeeth/skript-particle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221811250,"owners_count":16884284,"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-10-11T03:18:58.259Z","updated_at":"2026-01-03T05:19:44.188Z","avatar_url":"https://github.com/sovdeeth.png","language":"Java","funding_links":[],"categories":["Addons"],"sub_categories":["Display and Special Effects"],"readme":"# skript-particle\n Skript addon for creating complex particle effects with minimal hassle.\n \n **Requires Skript 2.10+, Java 17, Paper 1.19.4+**\n \n Download at the [releases page.](https://github.com/sovdeeth/skript-particle/releases) \n\nYou can find help, give suggestions, or voice complaints in the [Issues tab here](https://github.com/sovdeeth/skript-particle/issues/new/choose), or on the [skript-chat discord here](https://discord.gg/v9dXfENDnk).\n \n Skript-Particle is intended to provide syntax for creating complex shapes with particles. Competent and powerful particle syntaxes exist in addons like SkBee, but creating shapes requires a lot more effort and know-how. \n They're also inherently slower and less performant than Java, even without considering the usual need to re-calculate the shape each time it's drawn.\n \n The goal for Skript-Particle is to provide easy-to-use, flexible, and powerful syntax to create particle shapes. \n The basic structure is a set of various shapes, like circles, lines, polygons, and more. These shapes are relative to a center point and aren't positioned anywhere specific. \n The drawing syntax takes a set of shapes and a location and draws all the shapes relative to that location. \n This allows the definition of a bunch of shapes that only need to be defined once and can then be drawn in many places and in many rotations. \n Since shapes can be rotated as a group, it's also very simple to change the rotation and orientation of your shapes with a single line.\n\n ### Syntax available on [skUnity](https://docs.skunity.com/syntax/search/addon:skript-particle) and [SkriptHub](http://skripthub.net/docs/?addon=Skript-Particle)\n\nHere's some example code:\n```\ncommand /magic:\n    trigger:\n        set {_shapes::outer-circle} to a circle of radius 2.225\n        set {_shapes::inner-circle} to a circle of radius 2\n        set {_shapes::tiny-circle} to a circle of radius 0.875\n\n        set {_shapes::triangle-1} to a triangle with radius 2\n        set {_shapes::triangle-2} to a triangle with radius 2\n        rotate shapes {_shapes::triangle-2} around y axis by 60 degrees\n\n        set particle of {_shapes::*} to electric spark\n\n        loop 200 times:\n            set {_view} to vector from yaw player's yaw and pitch player's pitch\n            set {_yaw} to yaw of {_view}\n            # figure out the rotation needed to rotate the shape \n            set {_rotation} to rotation from vector(0, 1, 0) to {_view}\n            draw shapes {_shapes::*} at player's eye location ~ {_view}:\n                # only happens for this draw call, the original shape is not modified\n                # note that this is called once for each shape, hence `drawn shape` and not `drawn shapes`\n                rotate shape drawn shape by {_rotation}\n                # the shape takes the shortest path to rotate to the desired rotation, but that causes it to appear to rotate as we turn.\n                # so we'll correct for it by rotating the shape around the y axis by the yaw of the player\n                rotate shape drawn shape around relative y axis by -1 * {_yaw}\n\n            wait 1 tick \n```\n \n## Current Features:\n- Shapes:\n  - Circles, Ellipses, Spheres, and Ellipsoids\n  - Cylinders and Elliptical Cylinders\n  - Arcs and Spherical Caps\n  - Helices\n  - Lines\n  - 2D Regular and Irregular Polygons and Prisms\n  - Regular polyhedra\n  - Rectangles and cuboids\n  - Bezier Curves\n- Drawing:\n  - Three styles: outline, surface, and filled. Some shapes only support one or two of these styles.\n  - Rotation to any orientation.\n  - Scaling and offsetting.\n  - Drawing multiple shapes at once.\n  - Options for who sees the particles (player specific)\n  - Custom particle data and density per shape\n    - Full support for SkBee's particle data syntaxes\n  - Debug axes for clear visualization of the orientation of your shape.\n  - Shapes are only calculated when they actually change, so you can draw the same shape many times without any performance hit.\n  - Option to make all calculation and drawing synchronous (async by default)\n     - Ability to continuously draw a shape for a timespan (async only)\n  - Dynamic locations, so particles can follow an entity with no additional user effort\n- Particles:\n  - Expression for custom particles\n  - Section for custom particles\n- Animation\n  - Ability to stretch out drawing a shape over a timespan\n\n ## Planned Features:\n - Shapes:\n   - Custom shapes defined by a function\n   - \"Common but difficult to code\" shapes like hearts, stars, and more\n - Drawing:\n   - Combining shapes into a custom shape to be drawn as a single shape.\n   - Gradient colour fields, with custom colour nodes.\n - Animation:\n   - Set up a pre-made animation in a custom structure, play back with one draw call \n\n![2022-08-28_00 10 57](https://user-images.githubusercontent.com/10354869/187062233-5f51ba7b-60f4-44f8-bf6b-862a4e2381fd.png)\n\n\nhttps://user-images.githubusercontent.com/10354869/187062241-d3c51f86-4129-4f8b-9ce3-2d0037779e4e.mp4\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsovdeeth%2Fskript-particle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsovdeeth%2Fskript-particle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsovdeeth%2Fskript-particle/lists"}