{"id":16329248,"url":"https://github.com/josantonius/minecraft-ray","last_synced_at":"2025-05-15T08:33:54.845Z","repository":{"id":165747520,"uuid":"640099285","full_name":"josantonius/minecraft-ray","owner":"josantonius","description":"Launches a lightning bolt to where the player is aiming, to specific players or to all players online","archived":false,"fork":false,"pushed_at":"2023-05-15T22:51:03.000Z","size":2250,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-17T10:13:15.453Z","etag":null,"topics":["minecraft","minecraft-lightning","minecraft-plugin","minecraft-ray"],"latest_commit_sha":null,"homepage":"https://josantonius.dev","language":"Kotlin","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/josantonius.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/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},"funding":{"github":["Josantonius"]}},"created_at":"2023-05-13T01:59:43.000Z","updated_at":"2023-06-08T05:13:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"ecca2216-f2c1-4a1e-97b1-05e99125e51b","html_url":"https://github.com/josantonius/minecraft-ray","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josantonius%2Fminecraft-ray","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josantonius%2Fminecraft-ray/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josantonius%2Fminecraft-ray/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josantonius%2Fminecraft-ray/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/josantonius","download_url":"https://codeload.github.com/josantonius/minecraft-ray/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254304763,"owners_count":22048459,"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":["minecraft","minecraft-lightning","minecraft-plugin","minecraft-ray"],"created_at":"2024-10-10T23:14:55.207Z","updated_at":"2025-05-15T08:33:54.801Z","avatar_url":"https://github.com/josantonius.png","language":"Kotlin","funding_links":["https://github.com/sponsors/Josantonius"],"categories":[],"sub_categories":[],"readme":"# Minecraft Ray Plugin\n\n[![License](https://img.shields.io/github/license/josantonius/minecraft-ray)](LICENSE)\n\nLaunches a lightning bolt to where the player is aiming, to specific players or to all players online.\n\nLightning strikes to players can be set as lethal or non-lethal.\n\n## [Watch demo on YouTube](https://www.youtube.com/watch?v=JJ9kkE0BY4s)\n\n## Requirements\n\n- Java 17 or higher.\n- Purpur server 1.19.3 or Bukkit/Spigot/Paper server compatible with the Purpur API version used.\n\n## Installation\n\n1. Download the JAR file: [ray-1.0.0-purpur-1.19.3.jar](/build/libs/ray-1.0.0-purpur-1.19.3.jar).\n\n1. Place the JAR file in the plugins folder of your Minecraft server.\n\n1. Restart the server to load the plugin.\n\n## Building\n\nTo build the plugin yourself, follow these steps:\n\n1. Make sure you have `Java 17` or higher and `Gradle` installed on your system.\n\n1. Clone the plugin repository on your local machine:\n\n    ```bash\n    git clone https://github.com/josantonius/minecraft-ray.git\n    ```\n\n1. Navigate to the directory of the cloned repository:\n\n    ```bash\n    cd minecraft-ray\n    ```\n\n1. Use Gradle to compile the plugin:\n\n    ```bash\n    gradle build\n    ```\n\n## Commands\n\n- `/ray` - Launches a lightning bolt to where the player is aiming\n\n- `/ray *` - Launches a lightning bolt to all players online\n\n- `/ray \u003cplayer\u003e` - Launches a lightning bolt to the player specified\n\n- `/ray \u003cplayer\u003e [player...]` - Launches a lightning bolt to the players specified\n\n- `/ray * mortal` - Launches a deadly lightning bolt to all players online\n\n- `/ray \u003cplayer\u003e mortal` - Launches a deadly lightning bolt to the player specified\n\n- `/ray \u003cplayer\u003e [player...] mortal` - Launches a deadly lightning bolt to the players specified\n\n- `/rayhelp` - Display help for the plugin commands\n\n- `/rayreload` - Reload the plugin\n\nAll commands requires the `ray.admin` permission to be used.\n\n## Configuration\n\nThe `plugins/Ray/config.yml` file contains specific plugin configurations.\n\n### Excluding players from the plugin's effects\n\nA list of player names who are considered safe and will not be affected by the plugin. Set this to\n'null' or an empty list '[]' if you don't want to have any safe players.\n\n```yaml\nsafePlayers: null\n```\n\n### Excluding operators from the plugin's effects\n\nA boolean value determining whether server operators (OPs) should be excluded from the plugin's\neffects. Set this to 'true' to exclude operators, or 'false' to include them\n\n```yaml\nexcludeOperators: false\n```\n\n## Messages\n\nThe `plugins/Ray/messages.yml` file contains all the messages that the plugin uses.\nYou can change the messages to your liking.\n\n## TODO\n\n- [ ] Add new feature\n- [ ] Create tests\n- [ ] Improve documentation\n\n## Changelog\n\nDetailed changes for each release are documented in the\n[release notes](https://github.com/josantonius/minecraft-ray/releases).\n\n## Contribution\n\nPlease make sure to read the [Contributing Guide](.github/CONTRIBUTING.md), before making a pull\nrequest, start a discussion or report a issue.\n\nThanks to all [contributors](https://github.com/josantonius/minecraft-ray/graphs/contributors)! :heart:\n\n## Sponsor\n\nIf this project helps you to reduce your development time,\n[you can sponsor me](https://github.com/josantonius#sponsor) to support my open source work :blush:\n\n## License\n\nThis repository is licensed under the [MIT License](LICENSE).\n\nCopyright © 2023-present, [Josantonius](https://github.com/josantonius#contact)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosantonius%2Fminecraft-ray","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosantonius%2Fminecraft-ray","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosantonius%2Fminecraft-ray/lists"}