improve the javadocs and add text offer the created TextOverlay

Fixed some typos in the javadocs and made add text so you could set propitiates to your text after it added to the list.

Author: broken1arrow

Item Creator/src/main/java/org/broken/arrow/library/itemcreator/meta/map/MapRendererData.java

@@ -101,9 +101,10 @@ public void addPixel(@Nonnull final MapColoredPixel mapColoredPixel) {
      * @param x    The x-coordinate of the text.
      * @param y    The y-coordinate of the text.
      * @param text The text to display.
+     * @return returns the newly created text overlay, so you could set some of the options after.
      */
-    public void addText(final int x, int y, final String text) {
-        this.addText(x, y, text, null, null);
+    public TextOverlay addText(final int x, int y, final String text) {
+        return this.addText(x, y, text, null, null);
     }
 
     /**
@@ -114,9 +115,10 @@ public void addText(final int x, int y, final String text) {
      * @param y    The y-coordinate of the text.
      * @param text The text to display.
      * @param font The  font for the character.
+     * @return returns the newly created text overlay, so you could set some of the options after.
      */
-    public void addText(final int x, int y, final String text, @Nullable final Font font) {
-        this.addText(x, y, text, null, font);
+    public TextOverlay addText(final int x, int y, final String text, @Nullable final Font font) {
+        return this.addText(x, y, text, null, font);
     }
 
     /**
@@ -127,8 +129,9 @@ public void addText(final int x, int y, final String text, @Nullable final Font
      * @param text      The text to display.
      * @param fontChars Set the characters you want to replace in your text with the font.
      * @param font      The  font for the character
+     * @return returns the newly created text overlay, so you could set some of the options after.
      */
-    public void addText(final int x, int y, @Nonnull final String text, @Nullable final char[] fontChars, @Nullable final Font font) {
+    public TextOverlay addText(final int x, int y, @Nonnull final String text, @Nullable final char[] fontChars, @Nullable final Font font) {
         TextOverlay textOverlay = new TextOverlay(x, y, text);
         if (font != null) {
             if (fontChars != null && fontChars.length > 0) {
@@ -137,6 +140,7 @@ public void addText(final int x, int y, @Nonnull final String text, @Nullable fi
             textOverlay.setMapFont(this.fontChars, font);
         }
         this.addText(textOverlay);
+        return textOverlay;
     }
 
     /**

Item Creator/src/main/java/org/broken/arrow/library/itemcreator/meta/map/pixel/TextOverlay.java

@@ -69,15 +69,14 @@ public void setMapFont(final char[] chars, @Nonnull final Font font) {
     }
 
     /**
-     * Sets the {@link ColorParser} used for interpreting color and style codes
-     * in the text.
+     * Sets the {@link ColorParser} used to interpret color and style codes
+     * in this text instance.
      * <p>
-     * The parser is responsible for detecting formatting sequences and updating
-     * the {@link RenderState} accordingly. By default, the API uses
-     * {@link AmpersandHexColorParser}, but this method allows you to replace it
-     * with a custom implementation, including lambda-based parsers.
+     * By default, the API uses the global parser from {@link MapFontWrapper} (typically
+     * {@link AmpersandHexColorParser}). This method allows overriding it for this
+     * specific text, including using lambda-based or custom parser implementations.
      *
-     * @param colorParser the color parser to use
+     * @param colorParser the color parser to use for this text
      */
     public void setColorParser(@Nonnull final ColorParser colorParser) {
         mapFontWrapper.setColorParser(colorParser);