Merge pull request #42 from QuickShop-Community/fix/updates

Update to correct crowdin, more documentation updates.

Author: creatorfromhell

.github/workflows/node.js.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Sync with Crowdin
         run: npm run crowdin:sync
         env:
-          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN_UPDATED }}
       - name: Build website
         run: npm run build
       - name: Deploy to GitHub Pages

crowdin.yml

@@ -1,5 +1,5 @@
-project_id: '559555'
-api_token_env: CROWDIN_PERSONAL_TOKEN
+project_id: '777746'
+api_token_env: CROWDIN_PERSONAL_TOKEN_UPDATED
 preserve_hierarchy: true
 files:
   # JSON 翻译文件

docs/about/licenses.md

@@ -1,7 +1,7 @@
 # Licenses
 
-Quickshop-Hikari is dual licensed under [GNU General Public License v3.0][gplv3] and [GNU Affero General Public License v3.0][https://www.gnu.org/licenses/agpl-3.0.html].  
-New contributions will follow the updated license of [GNU Affero General Public License v3.0][https://www.gnu.org/licenses/agpl-3.0.html].
+Quickshop-Hikari is dual licensed under [GNU General Public License v3.0][gplv3] and [GNU Affero General Public License v3.0](https://www.gnu.org/licenses/agpl-3.0.html).  
+New contributions will follow the updated license of [GNU Affero General Public License v3.0](https://www.gnu.org/licenses/agpl-3.0.html).
 
 ## Third-party components
 

docs/addon/bluemap.md

@@ -6,34 +6,172 @@ Can't find where to download the JAR? [Click here](../faq/where-addons-compacts-
 
 :::
 
-BlueMap Addon can display the shop on your [BlueMap](https://modrinth.com/plugin/bluemap) instance!
+The BlueMap Addon allows QuickShop to display shops directly on your [BlueMap](https://modrinth.com/plugin/bluemap) web map.
+
+Players can view:
+
+- Shop locations
+- Item being sold or bought
+- Price
+- Stock
+- Owner
+- Shop type
+
+As of 6.2.0.11, the BlueMap addon now supports **colored markers based on shop state**.
+
+---
+
+## New in 6.2.0.11
+
+The BlueMap addon now supports:
+
+- Colored markers based on shop type/state
+- Improved compatibility with the new ShopType system
+- Better synchronization with the revamped event system
+- More accurate updates when shop type changes
+
+Markers now visually reflect:
+
+- SELLING shops
+- BUYING shops
+- FROZEN shops
+
+This makes it easier for players to understand shop behavior directly from the map.
+
+---
 
 ## Showcase
 
 ![bluemap](img/bluemap.png)
 
+---
+
+## How It Works
+
+When a shop is:
+
+- Created
+- Removed
+- Updated
+- Frozen or unfrozen
+- Switched between BUYING/SELLING
+
+The BlueMap addon automatically updates the marker.
+
+Markers are:
+
+- Added when shops are created
+- Removed when shops are deleted
+- Updated when price, stock, or type changes
+
+No manual refresh required.
+
+---
+
+## Colored Markers
+
+Markers can now display different colors depending on shop state.
+
+Typical behavior:
+
+- Selling shops → default color
+- Buying shops → alternate color
+- Frozen shops → disabled / muted color
+
+This makes it easy to visually distinguish shop types on the map.
+
+The color logic follows the new shop type system introduced in 6.2.0.11.
+
+---
+
 ## Configuration
 
 ```yaml
 config-version: 1
+
 # If you want the marker set/markers to display by default when opening the map.
 display-by-default: true
-#Location for the image you want as your quick-shop marker, it's defaulted to the BlueMap assets folder.
+
+# Location for the image you want as your QuickShop marker.
+# Default is inside the BlueMap assets folder.
 icon-file-location: "/assets/chest.png"
-# If you want to display the marker icon.
+
+# Display the marker icon on the map.
 display-icon: true
-# Max distance of range where the user can see the marker, useful for lag reduction in frames.
+
+# Maximum distance at which markers are visible.
+# Lower values may improve performance on large servers.
 max-distance: 1000
-# This is where the name of each quick-shop marker when looking at the list (placeholders are %item%, %price%, %stock%, %owner%, %type%, %location%).
+
+# Marker label shown in the marker list.
+# Available placeholders:
+# %item%, %price%, %stock%, %owner%, %type%, %location%
 marker-label: "%item%, %price%, %stock%, %owner%, %type%"
-# This is the popup text when clicking the shop marker itself.
-marker-detail: '<span style="font-size: 120%">Chest Shop</span><hr><span>Owner: <strong>%owner%</strong></span><br><span>Item: <strong>%item%</strong></span><br><span>Price: <strong>%price%</strong><br><span>Stock: <strong>%stock%</strong><br><span>Type: <strong>%type%</strong><br><span>Location: <strong>%location%</strong></span>'
-# How many times per second does the plugin refresh the chestshops?
+
+# Popup text when clicking a marker.
+marker-detail: '<span style="font-size: 120%">Chest Shop</span><hr><span>Owner: <strong>%owner%</strong></span><br><span>Item: <strong>%item%</strong></span><br><span>Price: <strong>%price%</strong></span><br><span>Stock: <strong>%stock%</strong></span><br><span>Type: <strong>%type%</strong></span><br><span>Location: <strong>%location%</strong></span>'
+
+# How many times per second does the plugin refresh the shops?
 refresh-per-seconds: 5
-```
+````
+
+---
+
+## Placeholders
+
+The following placeholders are available:
+
+* `%item%`
+* `%price%`
+* `%stock%`
+* `%owner%`
+* `%type%`
+* `%location%`
+
+These reflect live shop data and update automatically.
+
+---
+
+## Performance
+
+To optimize performance:
+
+* Lower `refresh-per-seconds` on large servers.
+* Reduce `max-distance` to limit rendering range.
+* Avoid extremely high shop density in a single area.
+
+The addon is event-driven and only refreshes when necessary.
+
+---
 
 ## Localization
 
-BlueMap Addon use the `game-language` settings in your QuickShop-Hikari configuration.
+The BlueMap Addon uses the `game-language` setting from your QuickShop configuration.
+
+You can customize marker text via QuickShop’s Localization System:
+
+See: `modules/localization.md`
+
+---
+
+## Installation
+
+1. Install BlueMap.
+2. Install the QuickShop BlueMap Addon.
+3. Restart your server.
+
+If BlueMap is not detected, the addon remains inactive.
+
+---
+
+## Summary
+
+The BlueMap Addon:
+
+* Displays shops on your web map
+* Updates automatically
+* Supports colored markers by shop state (6.2.0.11+)
+* Integrates with the new shop type system
+* Requires minimal configuration
 
-You can customize the string via QuickShop-Hikari's [Localization System](../modules/localization.md).
+It is recommended for servers that want a modern, web-based shop overview.