refactor(pulse): update to 1.7.2 version

Author: TheFaser

pulse/en/api/index.md

@@ -18,7 +18,7 @@ FlectonePulse is available on Maven Central. Below are configurations for includ
 <dependency>
     <groupId>net.flectone.pulse</groupId>
     <artifactId>core</artifactId>
-    <version>1.7.1</version> <!-- Replace with latest version -->
+    <version>1.7.2</version> <!-- Replace with latest version -->
     <scope>provided</scope>
 </dependency>
 ```
@@ -29,7 +29,7 @@ repositories {
 }
 
 dependencies {
-    compileOnly 'net.flectone.pulse:core:1.7.1' // Replace with latest version
+    compileOnly 'net.flectone.pulse:core:1.7.2' // Replace with latest version
 }
 ```
 
@@ -39,7 +39,7 @@ repositories {
 }
 
 dependencies {
-    compileOnly("net.flectone.pulse:core:1.7.1") // Replace with latest version
+    compileOnly("net.flectone.pulse:core:1.7.2") // Replace with latest version
 }
 ```
 
@@ -53,7 +53,7 @@ For snapshot versions:
 <dependency>
     <groupId>net.flectone.pulse</groupId>
     <artifactId>core</artifactId>
-    <version>1.7.2-SNAPSHOT</version> <!-- Replace with latest version -->
+    <version>1.7.3-SNAPSHOT</version> <!-- Replace with latest version -->
     <scope>provided</scope>
 </dependency>
 ```
@@ -64,7 +64,7 @@ repositories {
 }
 
 dependencies {
-    compileOnly 'net.flectone.pulse:core:1.7.2-SNAPSHOT' // Replace with latest version
+    compileOnly 'net.flectone.pulse:core:1.7.3-SNAPSHOT' // Replace with latest version
 }
 ```
 
@@ -74,7 +74,7 @@ repositories {
 }
 
 dependencies {
-    compileOnly("net.flectone.pulse:core:1.7.2-SNAPSHOT") // Replace with latest version
+    compileOnly("net.flectone.pulse:core:1.7.3-SNAPSHOT") // Replace with latest version
 }
 ```
 

pulse/en/docs/command/sprite/index.md

@@ -0,0 +1,84 @@
+---
+authors:
+  - TheFaser
+---
+
+# `/sprite`
+
+Command for searching sprites from Minecraft atlases
+![sprite](/commandsprite.png)
+
+[//]: # (localization)
+<!--@include: @/parts/words.md#localization-->
+<!--@include: @/parts/words.md#path--> `localizations → language.yml → command.sprite`
+
+<!--@include: @/parts/words.md#default-->
+
+::: code-group
+<<< @/files/localizations/ru_ru.yml#sprite
+<<< @/files/localizations/en_us.yml#sprite
+:::
+
+### `null_atlas`
+
+Message if the entered atlas does not exist
+
+### `null_page`
+
+Message if the entered page does not exist
+
+### `download_error`
+
+Message when downloading an atlas file from the internet fails. Atlases may differ or not exist across different versions, so this error should be considered normal
+
+### `atlas_downloading`
+
+Message when starting to download an atlas file from the internet
+
+### `header`
+
+The top part of the list message
+
+### `line_element`
+
+Format for each component, they will be added one after another
+
+#### `footer`
+
+The bottom part of the list message
+
+[//]: # (command.yml)
+<!--@include: @/parts/words.md#setting-->
+<!--@include: @/parts/words.md#path--> `command.yml → sprite`
+
+<!--@include: @/parts/words.md#default-->
+<<< @/files/command.yml#sprite
+
+<!--@include: @/parts/enable.md-->
+<!--@include: @/parts/perPage.md-->
+<!--@include: @/parts/aliases.md-->
+
+### `categories`
+
+List of categories, i.e., available atlases
+
+::: info INFO
+- Each atlas is downloaded only once if it does not exist in the folder `FlectonePulse/minecraft/<version>/atlases/`
+- Each atlas has the final format `minecraft_textures_atlas_<atlas>.png.txt`
+- Each atlas is downloaded from Flectone's own web server via the link `https://flectone.net/files/r/minecraft/<version>/atlases/minecraft_textures_atlas_<atlas>.png.txt`
+- Atlases do not necessarily need to be downloaded from the web server; you can place them manually in advance in the folder `FlectonePulse/minecraft/<version>/atlases/` by obtaining them using the `F3 + S` combination in Minecraft
+:::
+
+<!--@include: @/parts/cooldown.md-->
+<!--@include: @/parts/sound.md-->
+
+[//]: # (permission.yml)
+<!--@include: @/parts/words.md#permission-->
+<!--@include: @/parts/words.md#path--> `permission.yml → command.sprite`
+
+<!--@include: @/parts/words.md#default-->
+<<< @/files/permission.yml#sprite
+
+<!--@include: @/parts/permission/permissionTier3.md-->
+<!--@include: @/parts/permission/cooldown.md-->
+<!--@include: @/parts/permission/sound.md-->

pulse/en/docs/command/symbol/index.md

@@ -22,9 +22,25 @@ Huge thanks to @replaceitem for allowing the use of [symbol lists](https://githu
 <<< @/files/localizations/en_us.yml#symbol
 :::
 
-### `format`
+### `null_category`
 
-Format of the message that will be sent
+Message if the entered category does not exist
+
+### `null_page`
+
+Message if the entered page does not exist
+
+### `header`
+
+The top part of the list message
+
+### `line_element`
+
+Format for each component, they will be added one after another
+
+#### `footer`
+
+The bottom part of the list message
 
 [//]: # (command.yml)
 <!--@include: @/parts/words.md#setting-->
@@ -34,6 +50,7 @@ Format of the message that will be sent
 <<< @/files/command.yml#symbol
 
 <!--@include: @/parts/enable.md-->
+<!--@include: @/parts/perPage.md-->
 <!--@include: @/parts/aliases.md-->
 
 ### `categories`
@@ -43,9 +60,8 @@ List of categories and symbols separated by spaces
 ::: info WHAT CAN YOU DO WITH THIS?
 1. Add your own symbols to the current ones, separated by spaces
 2. Rename categories or add your own
-   :::
+:::
 
-<!--@include: @/parts/destination.md-->
 <!--@include: @/parts/cooldown.md-->
 <!--@include: @/parts/sound.md-->
 

pulse/en/docs/integration/discord/index.md

@@ -342,6 +342,7 @@ You don't need to configure localization, by default the message will be sent wi
 :::
 
 <!--@include: @/parts/destination.md-->
+<!--@include: @/parts/sound.md-->
 
 [//]: # (permission.yml)
 <!--@include: @/parts/words.md#permission-->
@@ -350,4 +351,5 @@ You don't need to configure localization, by default the message will be sent wi
 <!--@include: @/parts/words.md#default-->
 <<< @/files/permission.yml#discord
 
-<!--@include: @/parts/permission/permissionTier3.md-->
+<!--@include: @/parts/permission/permissionTier3.md-->
+<!--@include: @/parts/permission/sound.md-->

pulse/en/docs/integration/telegram/index.md

@@ -187,6 +187,7 @@ For other chats in the forum, this rule does not apply, and you need to enter th
 :::
 
 <!--@include: @/parts/destination.md-->
+<!--@include: @/parts/sound.md-->
 
 [//]: # (permission.yml)
 <!--@include: @/parts/words.md#permission-->
@@ -195,4 +196,5 @@ For other chats in the forum, this rule does not apply, and you need to enter th
 <!--@include: @/parts/words.md#default-->
 <<< @/files/permission.yml#telegram
 
-<!--@include: @/parts/permission/permissionTier3.md-->
+<!--@include: @/parts/permission/permissionTier3.md-->
+<!--@include: @/parts/permission/sound.md-->

pulse/en/docs/integration/twitch/index.md

@@ -168,6 +168,7 @@ follow_channel:
 :::
 
 <!--@include: @/parts/destination.md-->
+<!--@include: @/parts/sound.md-->
 
 [//]: # (permission.yml)
 <!--@include: @/parts/words.md#permission-->
@@ -176,4 +177,5 @@ follow_channel:
 <!--@include: @/parts/words.md#default-->
 <<< @/files/permission.yml#twitch
 
-<!--@include: @/parts/permission/permissionTier3.md-->
+<!--@include: @/parts/permission/permissionTier3.md-->
+<!--@include: @/parts/permission/sound.md-->

pulse/en/docs/message/format/object/index.md

@@ -11,9 +11,30 @@ The module will only work for players using version `1.21.9` and above. For othe
 
 :::
 
+::: warning WARNING
+
+Heads and sprites can be colored in config files. To prevent this, you need to use a white color before them. For example: `<white><player_head></white>`
+
+:::
+
 Module responsible for heads and symbols in chat
 ![object](/object.png)
 
+[//]: # (localization)
+<!--@include: @/parts/words.md#localization-->
+<!--@include: @/parts/words.md#path--> `localizations → language.yml → message.format.object`
+
+<!--@include: @/parts/words.md#default-->
+
+::: code-group
+<<< @/files/localizations/ru_ru.yml#object
+<<< @/files/localizations/en_us.yml#object
+:::
+
+### `default_symbol`
+
+Symbol for regular `<player_head>` and `<sprite>`, if the recipient cannot see the final object (for `<player_head_or>` and `<sprite_or>` this is specified manually)
+
 [//]: # (message.yml)
 <!--@include: @/parts/words.md#setting-->
 <!--@include: @/parts/words.md#path--> `message.yml → format.object`
@@ -30,6 +51,7 @@ Enables formatting of the `<player_head>` placeholder. It can be used in differe
 - `<player_head:Notch>` returns the head of the player whose nickname was written inside
 - `<player_head:Notch:false>` returns the head of the player with the second layer disabled, whose nickname was written inside
 - If the specified nickname doesn't exist, the head will have a random default skin
+- `<player_head_or:...>` will return the player's head or the text specified as the first argument if the recipient cannot see heads in chat. For example, `<player_head_or:hello:Notch>` will return Notch's head, and in the console, it will be the word `hello`
 
 ::: tip NOTE
 
@@ -43,9 +65,12 @@ Enables formatting of the `<sprite:...>` placeholder. It can be used in differen
 - `<sprite:name>`, returns an icon from the `blocks` atlas, for example `<sprite:item/diamond_sword>` (this is the same as `<sprite:blocks:item/diamond_sword>`)
 - `<sprite:atlas:name>`, returns an icon from the specified atlas, for example `<sprite:gui:container/slot>`
 - If the sprite is specified incorrectly, it will be an unknown texture. Using a resource pack you can create your own sprites
+- `<sprite_or:...>` returns an sprite or the text specified as the first argument if the recipient cannot see sprites in chat. For example, `<sprite_or:hello:block/oak_log>` returns the oak sprite, and in the console, it will be the word `hello`
 
-The easiest way to find atlas and icon names is in the folder created using the `F3 + S` combination inside Minecraft. There will be `minecraft_textures_atlas_...` files with `.txt` and `.png` format, using this it's easy to find the right sprite.
+The easiest way to find atlas and sprite names is by using the [command /sprite](/docs/command/sprite/)
+![command sprite](/commandsprite.png)
 
+You can also find them in the folder created using the `F3 + S` combination inside Minecraft. There, you will find `minecraft_textures_atlas_...` files in both `.txt` and `.png` formats, which you can use to locate the appropriate sprite
 ::: info EXAMPLE
 
 There is a `gui` atlas with the name `minecraft_textures_atlas_gui.png.txt`. In it you can find a line with `minecraft:container/slot	x=494	y=54	w=18	h=18`

pulse/en/files/command.yml

@@ -702,6 +702,33 @@ rockpaperscissors:
   sound:
     enable: false
 #endregion rockpaperscissors
+#region sprite
+sprite:
+  enable: true
+  per_page: 16
+  aliases:
+  - "sprite"
+  categories:
+  - "armor_trims"
+  - "banner_patterns"
+  - "beds"
+  - "blocks"
+  - "celestials"
+  - "chest"
+  - "decorated_pot"
+  - "gui"
+  - "items"
+  - "map_decorations"
+  - "paintings"
+  - "particles"
+  - "shield_patterns"
+  - "shulker_boxes"
+  - "signs"
+  cooldown:
+    enable: false
+  sound:
+    enable: false
+#endregion sprite
 #region spy
 spy:
   enable: true
@@ -749,6 +776,7 @@ stream:
 #region symbol
 symbol:
   enable: true
+  per_page: 16
   aliases:
   - "symbol"
   categories:

pulse/en/files/config.yml

@@ -9,9 +9,7 @@
 #        \/           \/
 #
 # Don't change it if you don't know what it is
-# region version
-version: "1.7.1"
-# endregion version
+version: "1.7.2"
 #region language
 language:
   type: "en_us"

pulse/en/files/integration.yml

@@ -55,6 +55,8 @@ discord:
     - "123456"
   destination:
     type: "CHAT"
+  sound:
+    enable: false
 #endregion discord
 #region floodgate
 floodgate:
@@ -166,6 +168,8 @@ telegram:
     - "123456"
   destination:
     type: "CHAT"
+  sound:
+    enable: false
 #endregion telegram
 #region triton
 triton:
@@ -191,6 +195,8 @@ twitch:
     - "stream start https://twitch.tv/faseri4ka"
   destination:
     type: "CHAT"
+  sound:
+    enable: false
 #endregion twitch
 #region vault
 vault: