{"id":16377189,"url":"https://github.com/mrmicky-fr/fastparticles","last_synced_at":"2025-08-09T07:24:15.833Z","repository":{"id":62158510,"uuid":"148915787","full_name":"MrMicky-FR/FastParticles","owner":"MrMicky-FR","description":"Lightweight particle API for Bukkit plugins, with 1.7.10 to 1.21 support.","archived":false,"fork":false,"pushed_at":"2024-05-04T17:40:06.000Z","size":61,"stargazers_count":47,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-14T22:33:40.719Z","etag":null,"topics":["api","bukkit","minecraft","particles","spigot"],"latest_commit_sha":null,"homepage":"","language":"Java","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/MrMicky-FR.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":"2018-09-15T15:44:40.000Z","updated_at":"2025-02-04T13:12:59.000Z","dependencies_parsed_at":"2024-10-27T10:58:55.105Z","dependency_job_id":"75ff8a59-074c-4347-a962-aadb5373e4a8","html_url":"https://github.com/MrMicky-FR/FastParticles","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrMicky-FR%2FFastParticles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrMicky-FR%2FFastParticles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrMicky-FR%2FFastParticles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MrMicky-FR%2FFastParticles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MrMicky-FR","download_url":"https://codeload.github.com/MrMicky-FR/FastParticles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243822310,"owners_count":20353498,"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":["api","bukkit","minecraft","particles","spigot"],"created_at":"2024-10-11T03:42:34.338Z","updated_at":"2025-08-09T07:24:15.814Z","avatar_url":"https://github.com/MrMicky-FR.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FastParticles\n\n[![JitPack](https://jitpack.io/v/fr.mrmicky/FastParticles.svg)](https://jitpack.io/#fr.mrmicky/FastParticles)\n\nLightweight particle API for Bukkit plugins, compatible with all Minecraft versions starting with 1.7.10!\n\n\u003e [!IMPORTANT]\n\u003e If you don't need 1.7/1.8 support, this library is not required, and you should just use the Bukkit methods [`Player#spawnParticle`](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/Player.html#spawnParticle(org.bukkit.Particle,org.bukkit.Location,int)) and [`World#spawnParticle`](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/World.html#spawnParticle(org.bukkit.Particle,org.bukkit.Location,int)).\n\n## Features\n\n* Easy to use\n* No reflection on compatible Bukkit versions\n* Support all particle data on all versions for legacy particles\n* Works on 1.13 and higher servers, with and without legacy particles\n\n### Installation\n\n#### Maven\n```xml\n\u003cbuild\u003e\n    \u003cplugins\u003e\n        \u003cplugin\u003e\n            \u003cgroupId\u003eorg.apache.maven.plugins\u003c/groupId\u003e\n            \u003cartifactId\u003emaven-shade-plugin\u003c/artifactId\u003e\n            \u003cversion\u003e3.3.0\u003c/version\u003e\n            \u003cexecutions\u003e\n                \u003cexecution\u003e\n                    \u003cphase\u003epackage\u003c/phase\u003e\n                    \u003cgoals\u003e\n                        \u003cgoal\u003eshade\u003c/goal\u003e\n                    \u003c/goals\u003e\n                \u003c/execution\u003e\n            \u003c/executions\u003e\n            \u003cconfiguration\u003e\n                \u003crelocations\u003e\n                    \u003crelocation\u003e\n                        \u003cpattern\u003efr.mrmicky.fastparticles\u003c/pattern\u003e\n                        \u003c!-- Replace this with the package of your plugin! --\u003e\n                        \u003cshadedPattern\u003ecom.yourpackage.fastparticles\u003c/shadedPattern\u003e\n                    \u003c/relocation\u003e\n                \u003c/relocations\u003e\n            \u003c/configuration\u003e\n        \u003c/plugin\u003e\n    \u003c/plugins\u003e\n\u003c/build\u003e\n\n\u003crepositories\u003e\n    \u003crepository\u003e\n        \u003cid\u003ejitpack.io\u003c/id\u003e\n        \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n    \u003c/repository\u003e\n\u003c/repositories\u003e\n\n\u003cdependencies\u003e\n    \u003cdependency\u003e\n        \u003cgroupId\u003efr.mrmicky\u003c/groupId\u003e\n        \u003cartifactId\u003eFastParticles\u003c/artifactId\u003e\n        \u003cversion\u003e2.0.2\u003c/version\u003e\n    \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\n### Gradle\n```groovy\nplugins {\n    id 'com.gradleup.shadow' version '8.3.0'\n}\n\nrepositories {\n    maven { url 'https://jitpack.io' }\n}\n\ndependencies {\n    implementation 'fr.mrmicky:FastParticles:2.0.2'\n}\n```\n\n### Manual (not recommended)\n\nCopy all the classes in your plugin.\n\n## Usage\n\n### Spawning particles\n\nUse a method from `FastParticle`:\n```java\n// Get a ParticleType\nParticleType flame = ParticleType.of(\"FLAME\");\nParticleType redstone = ParticleType.of(\"REDSTONE\");\nParticleType blockCrack = ParticleType.of(\"BLOCK_CRACK\");\n\n// Spawn particle for a player\nflame.spawn(player, loc, 1);\n\n// Spawn particle for all players in the world\nflame.spawn(world, loc, 1);\n\n// Spawn colored particle to a player\nredstone.spawn(player, loc, 1, ParticleData.createDustOptions(Color.BLUE, 1));\n\n// Spawn block crack particle to a player\nblockCrack.spawn(player, loc, 1, ParticleData.createBlockData(Material.DIAMOND));\n```\n\nWhen you need to spawn a large number of particles, you can cache instances of `ParticleType` and `ParticleData` to slightly improve performances.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrmicky-fr%2Ffastparticles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrmicky-fr%2Ffastparticles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrmicky-fr%2Ffastparticles/lists"}