---

 UShop

🔔Introductions

• Customizable lore for items
• Easy to create shop categories
  • Shop categories' icons can be automatically created
  • Shop categories can be edited at any time through GUI forms
• Easy to add goods
  • goods' names can be automatically getted (local languages support)
  • goods' icons can be automatically getted
  • goods' attributes can be automatically getted
    • enchantments (local languages support)
    • lore
    • type
  • goods' purchase price and reclaim price can be set independently
  • three good modes are provided
    • purchase and reclaim
    • only purchase
    • only reclaim
  • goods can be edited at any time through GUI forms
• Accurate players' inventory detection
• Items' durability can be detected during reclaiming process
• Good collections
• Good search
• Full GUI support
• Hot reload support
• Local languages support

🔨Installation

[Required pre-plugin] UMoney

[Optional pre-plugin] ZX_UI

Put .whl file into the endstone plugins folder, and then start the server. Enter the command /us to call out the main form.

💻Download

Now, you can get the release version form this repo or  Minebbs.

📁File structure

Plugins/
├─ ushop/
│  ├─ config.json
│  ├─ shop.json
│  ├─ lang/
│  │  ├─ zh_CN.json
│  │  ├─ en_US.json

📝Configuration

UShop allows operators or players to edit/update relevant settings through GUI forms with ease, here are just simple explanations for relevant configurations.

config.json

{
    "good_reclaim_durability_threshold": 0.5
}
/**
 * This will have an impact during reclaiming process (if the target item has duraibility attribute)
 * If set to 0.0, the durability detection will not work
 * If set to 1.0, the target item to reclaim must be brand new
 */

shop.json

{
    "test": {   // shop category's name
        "673e2c6f5e0f9c7003548fdeaad81f4ba170eb49d4aefe0b90c6152035ea305b": {    // good's hex dig
            "good_type_translation_key": "item.diamond_sword.name",    // good's translation key
            "good_type_id": "minecraft:diamond_sword",    // good's type
            "good_enchants": {    // good's enchant(s)
                "fire_aspect": 1,
                "unbreaking": 3,
                "sharpness": 5,
                "knockback": 2,
                "mending": 1
            },
            "good_lore": [    // good's lore
                "Sword Art Online",
                "oh yeah"
            ],
            "good_purchase_price": 2000,    // good's purchase price
            "good_reclaim_price": 1000,    // good's reclaim price
            "good_mode": "purchase and reclaim",    // good's mode
            "collectors": []    // players who have collected this good
        }
    }
}

🌐Languages

• zh_CN
• en_US

Off course you can add your mother language to UShop, just creat XX_XX.json (such as ja_JP.json) and translate value with reference to en_US.json.

You can also creat a PR to this repo to make your mother language one of the official languages of UShop.

📷Screenshots

You can view related screenshots of UShop from images folder of this repo.

🔥Operation document

you can download the operation document folder of this repo to learn how to use UShop.

Development plans

As soon as relevant API of EndstoneMC is available, Ushop will roll out the player shop feature