{"id":24749941,"url":"https://github.com/calebschmetzer/rblx-magic-orb-system","last_synced_at":"2025-03-23T03:16:06.378Z","repository":{"id":274377484,"uuid":"920132280","full_name":"CalebSchmetzer/rblx-magic-orb-system","owner":"CalebSchmetzer","description":"Simple Roblox magical orb attack system","archived":false,"fork":false,"pushed_at":"2025-01-26T22:56:53.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-23T03:16:01.573Z","etag":null,"topics":["lua","lua-script","lua-scripts","roblox","roblox-lua","roblox-script","roblox-scripts"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/CalebSchmetzer.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":"2025-01-21T16:09:26.000Z","updated_at":"2025-01-26T22:56:57.000Z","dependencies_parsed_at":"2025-01-26T23:35:16.323Z","dependency_job_id":null,"html_url":"https://github.com/CalebSchmetzer/rblx-magic-orb-system","commit_stats":null,"previous_names":["calebschmetzer/rblx-magic-orb-system"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CalebSchmetzer%2Frblx-magic-orb-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CalebSchmetzer%2Frblx-magic-orb-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CalebSchmetzer%2Frblx-magic-orb-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CalebSchmetzer%2Frblx-magic-orb-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CalebSchmetzer","download_url":"https://codeload.github.com/CalebSchmetzer/rblx-magic-orb-system/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245048279,"owners_count":20552483,"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":["lua","lua-script","lua-scripts","roblox","roblox-lua","roblox-script","roblox-scripts"],"created_at":"2025-01-28T08:52:50.869Z","updated_at":"2025-03-23T03:16:06.345Z","avatar_url":"https://github.com/CalebSchmetzer.png","language":"Lua","readme":"# Roblox Magic Orb System\n\n## Project Documentation\n\n## About\n\nThis project is a simple, versatile, and customizable magical attack mechanic that can be implemented into Roblox games. It is designed to be easily altered to suit any game's mechanics.\n\n## Key Features\n\n* **Magic orb projectile:** Visually customizable orb with particle, light, and sound effects.\n* **Collision system:** Customizable collision effects and requirements.\n* **Mechanics:** Customizable gameplay mechanics such as orb speed, damage amount, and cooldown length.\n\n## Fast Setup Guide\n\n1. **Tool Setup:** Create a `Tool` object inside of a game in Roblox Studio. Create a `Part` object named Handle and set it as a child of the tool.\n2. **Script Insertion:** Add the *MagicOrbServerScript* to your game's `ServerScriptService` as a 'Script' and add the *MagicOrbLocalScript* as a child of the tool you created as a 'LocalScript'.\n3. **Customization:** Customize the orb's visual or gameplay mechanics however you see fit.\n\n## Visual Customization\n\n**The magic orb's visual appearance can be customized to fit your game's aesthetics in various ways:**\n\n* **Base Effects**\n    * **Size:** The size of the orb can be changed by editing the `orbSize` variable in the server script. _Note: Changing the size of the orb will also affect its collision detection._\n    * **Color:** The color of the orb can be changed by altering the `BrickColor` of `orb` in the server script.\n    * **Material:** The material of the orb can be changed by altering the `Material` of `orb` in the server script.\n\n* **Particle Effects**\n    * **Particle Texture:** The texture of the particles emitted by the orb can be changed by editing the `TextureId` of `particleEmitter` in the server script.\n    * **Particle Color:** The color of the particles can be changed by editing the `ColorSequence` of `particleEmitter` in the server script. _Note: Depending on the texture you use, the color may not change much._\n    * **Particle Size:** The size of the particles can be changed by editing the `NumberSequence` of `particleEmitter` in the server script.\n\n* **Explosion Particle Effects**\n    * **Explosion Texture:** The texture of the particles emitted whenever the orb successfully collides can be changed by editing the `TextureId` of `explosionEmitter` in the server script.\n    * **Explosion Color:** The color of the explosion particles can be changed by editing the `ColorSequence` of `explosionEmitter` in the server script. _Note: Depending on the texture you use, the color may not change much._\n    * **Explosion Size:** The size of the particles can be changed by editing the `NumberSequence` of `explosionEmitter` in the server script.\n\n* **Light Effects**\n    * **Light Color:** The color of the light emitted by the orb can be changed by editing the `Color` value of `light` in the server script.\n    * **Light Brightness:** The brightness of the light emitted by the orb can be changed by editing the `Brightness` value of `light` in the server script.\n    * **Light Range:** The range of the light emitted by the orb can be changed by editing the `Range` value of `light` in the server script.\n\n* **Sound Effects**\n    * **Cast Sound:** The sound played when the player activates the attack can be altered by editing the `SoundID` and `Volume` of `castSound` in the server script.\n    * **Explosion Sound:** The sound played when the orb successfully collides can be altered by editing the `SoundID` and `Volume` of `explosionSound` in the server script.\n\n## Gameplay Customization\n\n**The gameplay mechanics of the magic orb system can be customized to fit your game's needs:**\n\n* **Size:** The size of the orb can be changed by editing the `orbSize` variable in the server script. _Note: Changing the size of the orb will also affect its visual size._\n* **Speed:** The speed of the orb can be changed by editing the `orbSpeed` variable in the local script.\n* **Cooldown:** The number of seconds it takes a player to recharge the ability after use can be changed by editing the `cooldownTime` variable in the local script.\n* **Collisions:** What the orb collides with can be changed within the `onTouch()` function in the server script. It can be edited to only collide with players or to collide with players and additional objects based on name (such as objects named `Barrier`).\n\n## Reusability\n\n**The magic system is designed to be reusable.** If you want to create multiple types of magic attacks (e.g., fireballs and frostbolts), simply follow the setup guide again, but change the name of the `Remote Event` and then customize the new orb as desired. Remember to change the name of the `Remote Event` in both the local and server scripts.\n\n## Ideas for Future Features\n\n* **Changing the shape of the orb:** A special mesh could be added to `orb` in order to give the orb a different visual appearance (e.g., an Ice Spike).\n* **Changing damage mechanics:** The orb could be altered to apply a damage-over-time effect rather than instant damage.\n* **Adding healing mechanics:** The orb could be changed to apply healing rather than damage to players who are on the same team as the caster.\n* **Implementing an autofire system:** The orb could be changed to be autofired as long as the player holds down a button instead of needing to be manually activated every time.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalebschmetzer%2Frblx-magic-orb-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcalebschmetzer%2Frblx-magic-orb-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalebschmetzer%2Frblx-magic-orb-system/lists"}