{"id":19564907,"url":"https://github.com/levy-y/bartering-manager","last_synced_at":"2025-10-31T03:51:08.455Z","repository":{"id":253851706,"uuid":"844728637","full_name":"Levy-Y/bartering-manager","owner":"Levy-Y","description":"A plugin to modify minecraft trades","archived":false,"fork":false,"pushed_at":"2024-08-30T17:15:50.000Z","size":276,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-01-08T23:59:31.878Z","etag":null,"topics":["minecraft","minecraft-plugin","plugin","spigot-plugin"],"latest_commit_sha":null,"homepage":"https://trello.com/b/AdUkr5wt/trademanager","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/Levy-Y.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":"2024-08-19T21:16:35.000Z","updated_at":"2024-08-30T17:15:53.000Z","dependencies_parsed_at":"2024-11-11T05:27:03.420Z","dependency_job_id":"4fe85356-fe7b-4f24-868c-711b88f51ebf","html_url":"https://github.com/Levy-Y/bartering-manager","commit_stats":null,"previous_names":["levy-y/bartering-manager"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Levy-Y%2Fbartering-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Levy-Y%2Fbartering-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Levy-Y%2Fbartering-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Levy-Y%2Fbartering-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Levy-Y","download_url":"https://codeload.github.com/Levy-Y/bartering-manager/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240823743,"owners_count":19863501,"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-plugin","plugin","spigot-plugin"],"created_at":"2024-11-11T05:24:18.157Z","updated_at":"2025-10-31T03:51:03.431Z","avatar_url":"https://github.com/Levy-Y.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003ca href=\"/\"\u003e\u003cimg src=\"logo.png\" alt=\"Project Logo\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n## Overview\n\n[![Gradle Build](https://github.com/Levy-Y/bartering-manager/actions/workflows/gradle.yml/badge.svg)](https://github.com/Levy-Y/bartering-manager/actions/workflows/gradle.yml)\n\nThe Piglin Trade Manager plugin is a Spigot Minecraft plugin that allows server administrators to manage and customize the bartering system for Piglins. With this plugin, you can define custom trade items and probabilities for both vanilla and Oraxen items, providing enhanced control over Piglin interactions.\n\n## Features\n\n- Customizable Trades: \u003cbr\u003e\nDefine custom items, their drop chances and the amount to drop, for Piglin bartering.\n- Supports for different items: \u003cbr\u003e\nAdd vanilla, MMOItems and Oraxen items to the Piglin trade table.\n\n\u003cb style=color:red;\u003eDisclaimer\u003c/b\u003e\n- The plugin doesn't add the items to the piglin trades, it replaces them (the vanilla ones), if you want the vanilla trades aswell, you have to add them manually \u003cbr\u003e\n`This will be fixed in a future version!`\n\n## Installation\n\n1. Download the Plugin:\n    - Download the latest release of the Piglin Trade Manager plugin from the [releases tab](https://github.com/Levy-Y/bartering-manager/releases) (spigot aswell in the future).\n\n2. Install the Plugin:\n    - Place the PiglinTrades.jar file in the plugins folder of your Minecraft server.\n\n3. Start the Server:\n    - Start or restart your Minecraft server to load the plugin.\n\n4. Configure the Plugin:\n    - After the first startup, a config.yml file will be generated in the plugins/PiglinTrades directory. Customize this file according to your needs (see Configuration).\n\n5. Reload the Plugin:\n    - Use the /piglinreload command to reload the plugin configuration after making changes.\n\n## Commands\n### /piglinreload\n\n- Description: \u003cbr\u003e\nReloads the plugin's configuration file without needing to restart the server.\n- Usage: \u003cbr\u003e\n`/piglinreload`\n- Permissions: \u003cbr\u003e\nThis command requires appropriate permissions to use (`piglinTrades.reload`).\n\n## Configuration\n\nThe plugin uses a `config.yml` file for configuration. Below is a sample configuration with explanations:\n\n```yaml\n\nenabled: true # Should these trades be registered?\nlog: true # Enable debug logging (for development)\noverride_vanilla: false # should it override the vanilla trades with the custom ones\n\ntrades:\n   vanilla_trades: # vanilla trades here\n     - stone_sword: # vanilla item ID, not case sensitive\n         min_amount: 1 # minimum amount to drop\n         max_amount: 3 # maximum amount to drop\n         chance: 50 # chance in %\n     - iron_sword:\n         min_amount: 1\n         max_amount: 3\n         chance: 30\n     - diamond_sword:\n         min_amount: 1\n         max_amount: 3\n         chance: 10\n   oraxen_trades: # oraxen trades here\n     - obsidian_pickaxe: # oraxen item ID\n         min_amount: 1 # minimum amount to drop\n         max_amount: 3 # maximum amount to drop\n         chance: 10 # chance in %\n     - amethyst_hammer:\n         min_amount: 1\n         max_amount: 3\n         chance: 10\n   mmoitems_trades: # mmoitems trades\n     - SWORD: # mmoitems category name\n         item: \"TESTSWORD\" # mmoitems item ID\n         min_amount: 1\n         max_amount: 1\n         chance: 50 # chance in %\n     - AXE:\n         item: \"AXETEST\"\n         min_amount: 1\n         max_amount: 1\n         chance: 50\n\n```\n\n### Configuration Parameters\n\n`enabled: (boolean)` Enable or disable the plugin's trade functionality. \u003cbr\u003e\n`log: (boolean)` Toggle logging. Set to false if you don't want to see any info/warning from the plugin.\n`override_vanilla (boolean)` Enable or disable vanilla trades \n\n### Trades Section\n\n    vanilla_trades: Define trades for vanilla Minecraft items.\n        Item ID: The ID of the vanilla item.\n        min_amount: The minimum number of items to drop.\n        max_amount: The maximum number of items to drop.\n        chance: The percentage chance of this item being selected during a Piglin barter.\n        \n###\n\n    oraxen_trades: Define trades for Oraxen items.\n        Item ID: The ID of the Oraxen item.\n        min_amount: The minimum number of items to drop.\n        max_amount: The maximum number of items to drop.\n        chance: The percentage chance of this item being selected during a Piglin barter.\n\n###\n\n    mmoitems_trades: Define trades for MMOItems\n       - CATEGORY_NAME: Category of the item, ex.: SWORD, ARMOR \n         min_amount: The minimum number of items to drop.\n         max_amount: The maximum number of items to drop.\n         item: \"ITEM_NAME\" name of the item (case sensitive)\n         chance: The percentage chance of this item being selected during a Piglin barter.\n\n\n## Usage\n\n#### Once the plugin is installed and configured:\n\n- Barter with Piglins:\nWhen a player throws a gold ingot to a Piglin, the plugin will handle the item drop based on the configured trades.\nThe items dropped are selected according to the probabilities defined in the `config.yml`.\n\n- Monitor Logs (Optional):\nIf logging is enabled, the plugin will log trade information, including any errors or warnings about misconfigured items.\n\n- Update Configuration:\nEdit the `config.yml` file to adjust trades as needed.\nReload the configuration using the `/piglinreload` command.\n\n## Troubleshooting\n\n1. Piglin Reload Command Not Working: \u003cbr\u003e\n    - Check the server logs for any errors during plugin initialization.\n    - Make sure, that you have the `piglinTrades.reload` permission\n\n2. Items Not Dropping as Expected:\n    - Verify that the item IDs and chances are correctly defined in the config.yml.\nIf using Oraxen items, ensure that Oraxen is properly installed on the server.\n\n### Note for troubleshooting:\nThese are just basic solutions, if none of the above can solve your problem, open a ticket here on [Github](https://github.com/Levy-Y/bartering-manager/issues)\n\n## Trello\n\nWe have a trello board, where we keep all the tasks, and requests for future versions. If you are interested check it out [here](https://trello.com/b/AdUkr5wt/trademanager)\n\n## License\n\nThis project is licensed under the MIT License. See the LICENSE file for details.\nContributions\n\nContributions are welcome! Please fork the repository and submit a pull request for any features or fixes.\nSupport\n\nIf you encounter any issues or have questions, please open an issue on the GitHub repository.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flevy-y%2Fbartering-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flevy-y%2Fbartering-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flevy-y%2Fbartering-manager/lists"}