# AnhyShop Is a unique plugin for creating merchants and trading on Minecraft servers, based on the trading inventory of villagers. Tested on `Spigot`, `Paper`, `Purpur` server cores, version `1.20.4`. ### Essential Dependencies for [**AnhyShop**](https://hangar.papermc.io/Anhydrite/AnhyShop) The primary requirement for **AnhyShop** to function is the installation of the [**AnhyLibAPI**](https://hangar.papermc.io/Anhydrite/AnhyLibAPI) library version 1.5.2 or higher. Without **AnhyLibAPI**, **AnhyShop** will not operate. It provides translation of system messages and multilingual names for merchants. Additionally, **AnhyShop** is compatible with [**AnhyLingo**](https://hangar.papermc.io/Anhydrite/AnhyLingo) version 0.3.3 or higher. Installing **AnhyLingo** expands the multilingual capabilities of **AnhyShop**. However, its absence does not affect the primary operation of **AnhyShop**. ## Functionality of the Plugin **AnhyShop: Intuitive Plugin for Creating Administrative Stores in Minecraft** - **Simplicity and Convenience**: No complicated configurations, all data is automatically stored in the embedded SQLite database (file `shops.db` in the plugin folder). - **Data Security**: Information about traders is encrypted. - **Flexible Use**: Open trade via console commands or player commands with appropriate permissions. ### Administrator Commands (with permission `anhyshop.*`) #### Reloading Commands - **Reloading the plugin** `(anhyshop.reload)`: `/shop reload` - Reloads the language files, configurations, and traders from the database. Available from the console. ### Work with Traders (with permission `anhyshop.trader.*`) 1. **Information about traders** `(anhyshop.trader.view)`: `/shop list` - Displays a list of all traders. Available from the console. 2. **Create a new trader** `(anhyshop.trader.create)`: `/shop newt ` - Creates a new trader. Available from the console. 3. **Remove trader** `(anhyshop.trader.delete)`: `/shop delt ` - Deletes a trader. Available from the console. 4. **Rename trader** `(anhyshop.trader.rename)`: `/shop rename ` - Renames a trader. Available from the console. 5. **Open trade inventory** `(anhyshop.trader.open)`: `/shop open ` - Opens trade for a player. Available from the console. 6. **Trade by yourself** `(anhyshop.trader.trade)`: `/shop trade ` - Opens a trade. ### Operations with Goods (with permission `anhyshop.product.*`) 1. **Add a new trade** `(anhyshop.product.add)`: `/shop add ` - To add a trade, place items in slots 1, 2, 3 of your inventory. 2. **Replace an existing trade** `(anhyshop.product.replace)`: `/shop replace ` - Replace or add products. 3. **Delete an existing trade** `(anhyshop.product.remove)`: `/shop remove ` - Remove a product from bidding. ![Add Trade](https://dev.anh.ink/images/addtrade.png "Work with traders") ### Directory Structure - `lang`: Files with translations of plugin system messages and translations of trader names. ```yaml trader_name_emberlyn: Emberlyn Gemwhisper trader_name_flint: Flint Firebeard trader_name_mira: Mira Mysticsight trader_name_silas: Silas Silverthread trader_name_cedric: Cedric Stonehand trader_name_willow: Willow Wildroot trader_name_raven: Raven Nightshade trader_name_eldon: Eldon Ironfoot trader_name_aurora: Aurora Skydancer trader_name_gideon: Gideon Goldspinner ``` ### Expanded Functionality of AnhyShop Plugin Version 1.0.0 **AnhyShop** in version 1.0.0 introduces a new concept of "Sellers," which allow players to interactively trade with merchants through in-game objects. This enhances the trading experience by providing a more dynamic and convenient management of trading processes on the server. #### Key Features of "Sellers": 1. **Types of "Sellers"**: - **Mechanical Objects**: Buttons, doors, levers are identified by their type and the exact coordinates of their location. - **Signs**: Identification is based on the material type and the text displayed on the sign. Signs can be placed in different locations, but the text on them will determine a single "Seller." - **Mobs with Custom Names**: Utilizes the type of mob and its unique name for identification. Only mobs with custom names can become "Sellers." - **Wandering Traders**: All wandering traders, once linked, are recognized as one "Seller," allowing for a uniform change to their trading inventories. - **Villagers**: Identified by profession and level. Creating a "Seller" from a villager of a specific profession and level replaces standard trade operations for all similar villagers. #### Commands to Manage "Sellers": **Note**: All the commands listed below are available only to players with the `anhyshop.seller` permission. - **Creating a "Seller"**: - **Command**: `/shop seller add ` - **Description**: Creates a "Seller" from the object the player is looking at, linking it to a selected trader using a unique key ``. The player must be within 5 blocks of the object. - **Removing a "Seller"**: - **Command**: `/shop seller remove ` - **Description**: Removes a "Seller" using its unique numerical identifier ``. - **Viewing Information about a "Seller"**: - **Command**: `/shop seller view ` - **Description**: Displays detailed information about the "Seller," including its type, location, linked trader, and identifier. - **Listing All "Sellers"**: - **Command**: `/shop seller list` - **Description**: Displays a list of all existing "Sellers," with the ability to copy `` to the clipboard, simplifying the management of identifiers for further operations. These updates significantly enhance player interactions with traders, providing greater control and customization options for trading processes on Minecraft servers. ### Language Personalization **Multilingual Functionality in AnhyShop with AnhyLibAPI and AnhyLingo Integration** 1. **System Messages Localization** (AnhyLibAPI): Stored in `shop_XX.yml` files within the `lang` folder. 2. **Trader Names Translation** (AnhyLibAPI): Add translations in `traders_XX.yml`. 3. **Multilingual Item Display in Trades** (AnhyLingo): Trades involving multilingual items display these items in the player's chosen language. ##### AnhyShop's integration with AnhyLibAPI and AnhyLingo enhances usability across different languages and enriches the trading experience, making it inclusive and globally accessible.

Published on	January 7, 2025
Downloads	12

AnhyShop

Release 1.1.0

Anhydrite released AnhyShop version 1.1.0 on January 7, 2025

Information

Platforms

Dependencies

Release
1.1.0