{"id":25131760,"url":"https://github.com/8aty/orelogger","last_synced_at":"2025-08-16T21:14:03.894Z","repository":{"id":276329331,"uuid":"928918692","full_name":"8aty/OreLogger","owner":"8aty","description":"Plugin designed to track ore mining activity on server","archived":false,"fork":false,"pushed_at":"2025-02-07T15:16:57.000Z","size":32,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"8aty","last_synced_at":"2025-02-07T15:37:47.229Z","etag":null,"topics":["anticheat","antixray","discord-webhook","free","minecraft","minecraft-plugin","spigot"],"latest_commit_sha":null,"homepage":"https://tomy.cc","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/8aty.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","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-02-07T13:31:17.000Z","updated_at":"2025-02-07T15:31:21.000Z","dependencies_parsed_at":"2025-02-07T15:37:51.529Z","dependency_job_id":"68feeacd-3a83-4d24-9b64-fcb187166a6b","html_url":"https://github.com/8aty/OreLogger","commit_stats":null,"previous_names":["8aty/orelogger"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8aty%2FOreLogger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8aty%2FOreLogger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8aty%2FOreLogger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8aty%2FOreLogger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/8aty","download_url":"https://codeload.github.com/8aty/OreLogger/tar.gz/refs/heads/8aty","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246911498,"owners_count":20853657,"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":["anticheat","antixray","discord-webhook","free","minecraft","minecraft-plugin","spigot"],"created_at":"2025-02-08T14:14:26.652Z","updated_at":"2025-04-03T00:11:04.121Z","avatar_url":"https://github.com/8aty.png","language":"Java","readme":"# OreLogger\n\n[![License](https://img.shields.io/badge/License-AGPL_3-4B0082?style=flat\u0026logo=gnu\u0026logoColor=white)](LICENSE)\n[![Version](https://img.shields.io/badge/Release-v1.2.2-9400D3?style=flat)](https://github.com/8aty/OreLogger/releases)\n[![JDK](https://img.shields.io/badge/JDK-21-0000FF?style=flat\u0026logo=openjdk\u0026logoColor=white)](https://github.com/8aty/OreLogger/releases)\n[![Maven](https://img.shields.io/badge/Built_with-Maven-00BFFF?style=flat\u0026logo=apache-maven\u0026logoColor=white)](https://maven.apache.org/)\n[![MC Support](https://img.shields.io/badge/Supports-1.21.x-87CEEB?style=flat)](https://github.com/8aty/OreLogger)\n\n\u003cdiv style=\"text-align:center\"\u003e\u003cimg alt=\"warning\" src=\"https://i.imgur.com/kInbBoZ.png\" /\u003e\u003c/div\u003e\n\nOreLogger is a lightweight Minecraft plugin that meticulously tracks ore mining on your server. It logs every ore mined by players and sends real-time alerts to both Discord and in-game chat for admins. With customizable settings, OreLogger helps prevent cheating like x-raying. It also supports cross-world teleportation, making it ideal for monitoring resource gathering and ensuring fair play across your server.\n\n---\n\n## Features\n\n- **Discord Integration**: Sends detailed embeds to a Discord webhook when ores are mined.\n- **Admin Alerts**: Sends clickable teleport messages to admins in-game for quick investigation.\n- **Configurable Ores**: Customize which ores are tracked via the `config.yml` file.\n- **Session Delay**: Group ore mining events into sessions with a configurable delay (default: 15 seconds).\n- **Cross-World Teleportation**: Admins can teleport directly to the world and coordinates where ores were mined.\n- **Alert Toggle**: Admins can enable/disable alerts using `/orelogger togglealerts`.\n- **Reload Command**: Reload the configuration dynamically with `/orelogger reload`.\n\n---\n\n## Changelog\n\nSee the full changelog [here](changelog.md).\n\n---\n\n## Requirements\n\n- Java 21 or higher\n- Discord Webhook\n- Minecraft Server 1.21.x\n- Permission plugin ([LuckyPerms](https://luckperms.net/) recommended)\n\n---\n\n## Installation\n\n1. **Download the Plugin**:\n   - Download the latest JAR file from the [Releases](https://github.com/8aty/OreLogger/releases) section.\n\n2. **Install the Plugin**:\n   - Place the JAR file in your server's `plugins/` folder.\n\n3. **Restart the Server**:\n   - Restart your server to generate the default `config.yml` file.\n\n4. **Configure the Plugin**:\n   - Edit the `config.yml` file to set up your Discord webhook URL, tracked ores, and session delay.\n\n---\n\n## Configuration\n\nThe `config.yml` file contains all configurable options for OreLogger. Here’s an example:\n\n```yaml\n# Discord webhook URL for sending alerts\nwebhook-url: \"https://discord.com/api/webhooks/...\"\n\n# List of ores to be tracked by the OreLogger\ntracked-ores:\n  - IRON_ORE\n  - DEEPSLATE_IRON_ORE\n  - GOLD_ORE\n  - DEEPSLATE_GOLD_ORE\n  - DIAMOND_ORE\n  - DEEPSLATE_DIAMOND_ORE\n  - EMERALD_ORE\n  - DEEPSLATE_EMERALD_ORE\n  - LAPIS_ORE\n  - DEEPSLATE_LAPIS_ORE\n  - REDSTONE_ORE\n  - DEEPSLATE_REDSTONE_ORE\n  - NETHER_GOLD_ORE\n  - ANCIENT_DEBRIS\n\n# Delay in seconds before a mining session is processed\n# Note: Setting this value too low may cause performance issues due to frequent processing.\n# It is recommended to use a reasonable delay to ensure optimal server performance.\nsession-delay: 15 #Default is 15 seconds\n```\n\n---\n\n## Commands\n\n| Command                  | Permission          | Description                                   |\n|--------------------------|---------------------|-----------------------------------------------|\n| `/orelogger reload`      | `orelogger.reload`  | Reload the configuration without restarting. |\n| `/orelogger togglealerts`| `orelogger.alerts`  | Toggle admin alerts on/off.                  |\n| `/orelogger tp`          | `orelogger.tp`      | Teleport to ore mining locations.            |\n\n---\n\n## Permissions\n\n| Permission           | Description                                                       | Default Value |\n|-----------------------|-------------------------------------------------------------------|---------------|\n| `orelogger.reload`    | Allows reloading the configuration.                               | op            |\n| `orelogger.alerts`    | Allows receiving admin alerts in-game.                            | op            |\n| `orelogger.tp`        | Allows teleporting to ore mining locations.                       | op            |\n| `orelogger.ignores`   | Prevents logging of ores mined by players with this permission.   | false         |\n\n---\n\n## Usage\n\n### Discord Webhook Alert\n\nWhen a player mines ores, the following embed will be sent to Discord:\n\n![Discord Webhook Embed](https://i.imgur.com/0WCTys0.png)\n\n---\n\n### In-Game Alert\n\nAdmins will see the following message in-game:\n\n![In-Game Alert](https://i.imgur.com/rXei8nX.gif)\n\nClicking the message will teleport the admin directly to the specified coordinates in the correct world.\n\n---\n\n\n## Support\n\nFor support or questions, contact the author or open an issue on GitHub.\n\n---\n\n## License\n\nThis project is licensed under the AGPL 3.0 License. See the [LICENSE](LICENSE) file for details.\n\n---\n\n### Developed by 8aty, personal website: [VISIT](https://tomy.cc/) \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8aty%2Forelogger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F8aty%2Forelogger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8aty%2Forelogger/lists"}