{"id":25732017,"url":"https://github.com/huzvanec/weeklyreward","last_synced_at":"2025-09-19T00:04:10.056Z","repository":{"id":55872616,"uuid":"444127913","full_name":"huzvanec/WeeklyReward","owner":"huzvanec","description":"Plugin to give players rewards every week","archived":false,"fork":false,"pushed_at":"2023-08-01T14:33:57.000Z","size":48,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-07-23T13:49:29.061Z","etag":null,"topics":["minecraft-plugin"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huzvanec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2022-01-03T16:30:10.000Z","updated_at":"2024-07-23T13:49:38.908Z","dependencies_parsed_at":"2024-07-23T13:49:38.225Z","dependency_job_id":"09fd5b05-a71c-4928-a160-f488c8a7c234","html_url":"https://github.com/huzvanec/WeeklyReward","commit_stats":null,"previous_names":["huzvanec/weeklyreward"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzvanec%2FWeeklyReward","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzvanec%2FWeeklyReward/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzvanec%2FWeeklyReward/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huzvanec%2FWeeklyReward/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huzvanec","download_url":"https://codeload.github.com/huzvanec/WeeklyReward/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240788749,"owners_count":19857691,"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-plugin"],"created_at":"2025-02-26T03:38:54.758Z","updated_at":"2025-09-19T00:04:09.902Z","avatar_url":"https://github.com/huzvanec.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **Weekly Reward**\n\n## **Table of contents**\n\n[What is Weekly Reward?](#what-is-weekly-reward)\n\n[What platforms are supported?](#what-platforms-are-supported)\n\n[Configuration](#configuration)\n\n[How it works?](#how-it-works)\n\n[Build](#Build)\n\n## **What is Weekly Reward?**\n\nIt's a simple minecraft plugin for giving custom rewards to players every week.\n\n## **What platforms are supported?**\n\nPaper based minecraft servers 1.19.4+\u003cbr\u003e\n**Spigot and Bukkit is not supported!**\n\n## **Configuration**\n\nAll the configuration is in `WeeklyReward/config.yml`\u003cbr\u003e\n[Default config.yml](https://github.com/Mandlemankiller/WeeklyReward/blob/master/src/main/resources/config.yml)\n\n### Rewards:\n\n```yml\n    { item: \u003citem_name\u003e, amount: \u003camount\u003e, chance: \u003cchance\u003e }\n```\nFor example:\n\n```yml\nrewards:\n  - { item: diamond, amount: 20, chance: 1 }\n  - { item: emerald, amount: 10, chance: 5 } # Five times more common than diamonds\n  - { item: iron_ingot, amount: 128, chance: 5 } # Same chance as emeralds\n```\n\nThe chance works based on **`bigger number =\u003e bigger chance of gaining`**\n\nTo apply your configuration, restart your server or use ```/weeklyreward reload```\n\n## **How it works?**\n\n### Reward check\n\nWhen player logs on the server, the plugin checks the last week number in the year, the player logged on and got the\nreward (read from the file `WeeklyReward/reward-log.yml`, **I do not recommend writing in this file manually**). If the\ncurrent week number is different from the saved one, it gives the player his random reward and overwrites the week\nnumber in weekslog.yml.\n\n### Random\n\nThe \"chance number\" is actually a number of times the item will be added to a list from which it will be randomly\nchosen. That means if we create:\n\n````yml\nrewards:\n  - { item: diamond, amount: 3, chance: 1 }\n  - { item: emerald, amount: 20, chance: 5 }\n````\n\nIt will create a list with **1× 3 diamonds** and **5× 20 emeralds** like this:\n\n````yml\n3× diamond\n20× emerald\n20× emerald\n20× emerald\n20× emerald\n20× emerald\n````\n\n... and then it chooses random one of these (that means we have 5× more chance of receiving emeralds, than diamonds).\n\n## Build\nRequirements: [Git](https://git-scm.com/), [Maven](https://maven.apache.org/)\u003cbr\u003e\nClone the repository\n```bash\ngit clone https://github.com/Mandlemankiller/WeeklyReward.git\n```\nMove to the WeeklyReward folder\n```bash\ncd WeeklyReward\n```\nPackage with Maven\n```bash\nmvn package\n```\nDone! The built jar is now located in ```target``` directory, it's called ```WeeklyReward-1.0-SNAPSHOT.jar```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuzvanec%2Fweeklyreward","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuzvanec%2Fweeklyreward","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuzvanec%2Fweeklyreward/lists"}