{"id":21610779,"url":"https://github.com/liebki/simplepushevents","last_synced_at":"2025-03-18T16:00:12.771Z","repository":{"id":243355610,"uuid":"812207660","full_name":"liebki/SimplePushEvents","owner":"liebki","description":"Stay informed with free real-time Minecraft server push notifications using SimplePushEvents!","archived":false,"fork":false,"pushed_at":"2024-06-16T19:10:37.000Z","size":29,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-24T19:47:35.370Z","etag":null,"topics":["java","minecraft","push-notifications","spigot-plugin"],"latest_commit_sha":null,"homepage":"https://www.spigotmc.org/resources/simplepushevents.117183/","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/liebki.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":"2024-06-08T08:37:56.000Z","updated_at":"2024-06-16T19:09:07.000Z","dependencies_parsed_at":"2024-06-16T20:28:54.911Z","dependency_job_id":"6a004090-1a42-476f-9fe0-2a04742038b1","html_url":"https://github.com/liebki/SimplePushEvents","commit_stats":null,"previous_names":["liebki/simplepushevents"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liebki%2FSimplePushEvents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liebki%2FSimplePushEvents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liebki%2FSimplePushEvents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liebki%2FSimplePushEvents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liebki","download_url":"https://codeload.github.com/liebki/SimplePushEvents/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244257279,"owners_count":20424130,"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":["java","minecraft","push-notifications","spigot-plugin"],"created_at":"2024-11-24T21:09:36.202Z","updated_at":"2025-03-18T16:00:12.717Z","avatar_url":"https://github.com/liebki.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SimplePushEvents Plugin\n\n## Description\nThis Spigot plugin, for use with the latest Minecraft version, automatically sends notifications to a push service (ntfy.sh), when players join, leave, execute specific commands, do certain things or the server starts/shuts down.\nThis helps server owners and players stay informed about server activities in real-time.\n\n\n## Ideas\nIf you have ideas for more events, open an issue.\n\n\n## Java Version\nCompatible with Minecraft 1.20.6 and requires Java 21.\n\n\n## Features\n- Notifies when the server starts up or shuts down.\n- Sends push notifications when\n    - a player joins or leaves the server.\n    - a player unlocks an advancement.\n    - a player creates a portal.\n    - a player dies (including the death message).\n    - executes `/spe [message content]` for custom notifications (with custom permissions).\n- Change the message format or disable/enable them entirely.\n- Easy integration with the ntfy.sh push service.\n- Quick setup with minimal configuration required.\n- Checks and notifies for specific player commands:\n    - `/op`\n    - `/deop`\n    - `/ban`\n    - `/banip`\n    - `/pardon`\n    - `/pardonip`\n    - `/whitelist`\n\n\n## Setup\nTo set up the SimplePushEvents plugin, follow these steps:\n\n1. **Install the Plugin**: Download and place the SimplePushEvents plugin in your Spigot Minecraft server's plugins directory.\n\n2. **Configure the Plugin**: On the first run, the plugin will generate a configuration file (`options.yml`) in the `plugins/simplepushevents` directory. Edit this file to customize your messages and settings.\n\n3. **Download the ntfy.sh App**: Visit the [ntfy.sh](https://ntfy.sh/) website and download the ntfy app from the Play Store or App Store. The ntfy.sh service is completely free to use.\n\n4. **Subscribe to the Push Channel**: Open the ntfy app and subscribe to the topic specified in the `donottouch.pushchannel` configuration setting. This will allow you to receive notifications sent by the plugin.\n\n5. **Restart/Reload Server**: Restart or reload your Spigot Minecraft server to apply the configuration changes.\n\n6. **Receive Notifications**: The plugin will now automatically send notifications according to your configured settings whenever players join, leave, or the server starts up or shuts down.\n\n\n## Plugin Configuration\nBefore deploying the plugin, ensure you configure the following parameters in the `options.yml` file:\n\n```yaml\ndonottouch:\n  configexists: true\n  pushchannel: 7fc647dd98\nmessages:\n  general:\n    title: 'Minecraft Server:'\n    startup:\n      status: true\n      content: The server is online now!\n    poweroff:\n      status: true\n      content: The server is shutting down!\n    chatcommand:\n      status: true\n      content: '[%PLAYER%] wrote: %MESSAGE%'\n      permission: spe.usechatcommand\n  player:\n    advancement:\n      status: true\n      content: 'The player %PLAYER% unlocked the advancement: %NAME%'\n    join:\n      status: true\n      content: The player %PLAYER% joined!\n    leave:\n      status: true\n      content: The player %PLAYER% left!\n    count:\n      status: true\n      content: 'Players online right now: %ONLINE%/%MAX%'\n    death:\n      status: true\n      content: 'The Player %PLAYER% died: %MESSAGE%'\n    portalcreation:\n      status: true\n      content: The Player %PLAYER% created a portal at %LOCATION%\n    command:\n      disableall: false\n      op:\n        status: true\n        content: The player %PLAYER% executed /op for %TARGET% !\n      deop:\n        status: true\n        content: The player %PLAYER% executed /deop for %TARGET% !\n      ban:\n        status: true\n        content: The player %PLAYER% executed /ban for %TARGET% !\n      banip:\n        status: true\n        content: The player %PLAYER% executed /ban-ip for %TARGET% !\n      pardon:\n        status: true\n        content: The player %PLAYER% executed /pardon for %TARGET% !\n      pardonip:\n        status: true\n        content: The player %PLAYER% executed /pardon-ip for %TARGET% !\n      whitelist:\n        status: true\n        content: 'The player %PLAYER% used a whitelist command: %CONTENT%'\n```\n\n\n## Note\nEnsure the ntfy.sh push service is accessible from your server, as this plugin depends on it to send notifications. The service is free and only requires you to download the app and subscribe to the specific push channel topic.\n\n\n## Disclaimer\nThis plugin is provided as-is without any warranty. The developer holds no responsibility for any issues or damages arising from its usage.\n\n\n##### Enjoy real-time notifications with the SimplePushEvents plugin for your Spigot Minecraft server!     ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliebki%2Fsimplepushevents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliebki%2Fsimplepushevents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliebki%2Fsimplepushevents/lists"}