{"id":26865834,"url":"https://github.com/midnighttale/hyeconomy","last_synced_at":"2025-08-26T16:28:06.945Z","repository":{"id":197158030,"uuid":"698095128","full_name":"MidnightTale/hyeconomy","owner":"MidnightTale","description":"Hyeconomy is a diamond economy plugin uses MariaDB for database storage","archived":false,"fork":false,"pushed_at":"2023-10-01T19:59:30.000Z","size":134,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-10-02T08:34:43.180Z","etag":null,"topics":["asynchronous","asyncio","bukkit","bukkit-plugin","economy","folia","folia-plugin","folia-supported","mariadb","minecraft","minecraft-plugin","minecraft-server","paper","paper-plugin","papermc","plugin"],"latest_commit_sha":null,"homepage":"https://hynse.xyz","language":"Java","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/MidnightTale.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}},"created_at":"2023-09-29T06:36:27.000Z","updated_at":"2023-09-30T03:41:34.000Z","dependencies_parsed_at":"2023-09-29T08:46:33.905Z","dependency_job_id":null,"html_url":"https://github.com/MidnightTale/hyeconomy","commit_stats":null,"previous_names":["midnighttale/hyeconomy"],"tags_count":10,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MidnightTale%2Fhyeconomy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MidnightTale%2Fhyeconomy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MidnightTale%2Fhyeconomy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MidnightTale%2Fhyeconomy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MidnightTale","download_url":"https://codeload.github.com/MidnightTale/hyeconomy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246418698,"owners_count":20773935,"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":["asynchronous","asyncio","bukkit","bukkit-plugin","economy","folia","folia-plugin","folia-supported","mariadb","minecraft","minecraft-plugin","minecraft-server","paper","paper-plugin","papermc","plugin"],"created_at":"2025-03-31T04:44:24.047Z","updated_at":"2025-03-31T04:44:24.579Z","avatar_url":"https://github.com/MidnightTale.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![image](https://cdn.modrinth.com/data/HrYlg7yE/images/0971ab6c446a501992abca0b630864cd345f3cb6.png)\n## Features\n- Economy system for managing in-game currency (diamonds).\n- Deposit and withdraw diamonds.\n- Send diamonds to other players.\n- Check your current balance.\n- View a leaderboard of top players.\n- Support [MiniMessage](https://docs.advntr.dev/minimessage/format.html) format \n- PlaceholderAPI supported\n\n## Server Compatibility\n- **Paper / Folia** and any forks.\n- ⚠️ **Spigot**: untested.\n- ⚠️ **ฺBukkit**: untested.\n\n## Database Storage\n\nHyeconomy utilizes MariaDB for database storage. This ensures reliable and efficient data storage for player balances and transactions.\n\n## Commands\n### Player Command\n- `/balance`: Check your current balance.\n- `/balance \u003cplayer\u003e`: Check other current balance.\n- `/deposit \u003camount\u003e`: Deposit diamonds into your account.\n- `/withdraw \u003camount\u003e`: Withdraw diamonds from your account.\n- `/send \u003cplayer\u003e \u003camount\u003e`: Send diamonds to another player.\n- `/top`: View the leaderboard of top players.\n### Admin Command\n- `/dgive \u003cplayer\u003e \u003camount\u003e`: Give balance to player account.\n- `/dtake \u003cplayer\u003e \u003camount\u003e`: Take balance from player account.\n- `/dset \u003cplayer\u003e \u003camount\u003e`: Set player balance specific value.\n- `/dreset \u003cplayer\u003e`: Reset specific player balance to 0.\n- `/dreload`: Reload config and message.\n\n## Permissions\n- `hyeconomy.balance`: Permission to use the `/balance` command.\n- `hyeconomy.balance.other`: Permission to use the `/balance` command check other.\n- `hyeconomy.deposit`: Permission to use the `/deposit` command.\n- `hyeconomy.withdraw`: Permission to use the `/withdraw` command.\n- `hyeconomy.send`: Permission to use the `/send` command.\n- `hyeconomy.top`: Permission to use the `/top` command.\n- `hyeconomy.give`: Permission to use the `/dgive` command.\n- `hyeconomy.take`: Permission to use the `/dtake` command.\n- `hyeconomy.set`: Permission to use the `/dset` command.\n- `hyeconomy.reset`: Permission to use the `/dreset` command.\n- `hyeconomy.reload`: Permission to use the `/dreload` command.\n\n## Configuration\n\nYou can customize various aspects of the plugin, including messages and database settings, by editing the `config.yml` and `messages.yml` files in the plugin's folder.\n\n## PlaceholderAPI Integration\ninstall [placeholderapi](https://www.spigotmc.org/resources/placeholderapi.6245/)\n  - display a player's balance `%hyeconomy_balance%`.\n  - display a specific player's balance by name, use `%hyeconomy_balance_PLAYERNAME%` (replace `PLAYERNAME` with the actual player's name).\n  - display the username balance of the top 10 players, use `%hyeconomy_balance_top_username_1%`, `%hyeconomy_balance_top_username_2%`, and so on, up to `%hyeconomy_balance_top_username_10%`.\n  - display the amount balance of the top 10 players, use `%hyeconomy_balance_top_amount_1%`, `%hyeconomy_balance_top_amount_2%`, and so on, up to `%hyeconomy_balance_top_amount_10%`.\n\nRemember to replace `PLAYERNAME` with the actual player name you want to query in the second type of placeholder.\n\n## Support\n\nIf you encounter any issues or have questions, please feel free to [open an issue](https://github.com/MidnightTale/hyeconomy/issues) on the GitHub repository.\n\n## License\n\nThis plugin is open-source and available under the [MIT License](LICENSE).\n\n## Developer API [![Latest Release](https://repo.hynse.xyz/api/badge/latest/releases/xyz/hynse/api-hyeconomy)](https://repo.hynse.xyz/api/latest/releases/xyz/hynse/api-hyeconomy)\n\n### Information\nApache Maven `pom.xml`\n```xml\n\u003crepository\u003e\n    \u003cid\u003ehyeconomy\u003c/id\u003e\n    \u003curl\u003ehttps://repo.hynse.xyz/repository/maven-releases/\u003c/url\u003e\n\u003c/repository\u003e\n\u003cdependency\u003e\n  \u003cgroupId\u003exyz.hynse\u003c/groupId\u003e\n  \u003cartifactId\u003eapi-hyeconomy\u003c/artifactId\u003e\n  \u003cversion\u003e1.2-SNAPSHOT-1\u003c/version\u003e\n\u003c/dependency\u003e\n```\nGradle Groovy DSL `build.gradle`\n```gradlee\nrepositories {\n    maven { url = \"https://repo.hynse.xyz/repository/maven-releases/\"}\n}\ndependencies { \n    compileOnly 'xyz.hynse:api-hyeconomy:1.2-SNAPSHOT-1'\n}\n```\n\n\n### Example\n```java\nimport xyz.hynse.hyeconomy.API.HyeconomyAPI;\n\n// when you need to get or set player balances:\nHyeconomyAPI hyeconomyAPI = Hyeconomy.getAPI();\n\n// Get a player's balance by UUID\nUUID playerUUID = /* UUID of the player */;\nint balance = hyeconomyAPI.getPlayerBalance(playerUUID);\n\n// Set a player's balance by UUID\nint newBalance = /* The new balance */;\nhyeconomyAPI.setPlayerBalance(playerUUID, newBalance);\n\nint amount = /*Amount want to add or subtract*/;\n// Add a player's balance by UUID\nHyeconomyAPI.addToPlayerBalance(UUID playerUUID, amount)\n        \n// subtract a player's balance by UUID\nHyeconomyAPI.subtractFromPlayerBalance(UUID playerUUID, amount)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmidnighttale%2Fhyeconomy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmidnighttale%2Fhyeconomy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmidnighttale%2Fhyeconomy/lists"}