DREAMFIRE Docs ← Back to site
Loading...
Searching...
No Matches
DreamChat.java
Go to the documentation of this file.
1/*
2 * MIT License
3 *
4 * Copyright (c) 2025 Dreamfire Studio
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in all
14 * copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22 * SOFTWARE.
23 */
24package com.dreamfirestudios.dreamcore.DreamChat;
25
26import com.dreamfirestudios.dreamcore.DreamLuckPerms.DreamLuckPerms;
27import net.kyori.adventure.text.serializer.plain.PlainTextComponentSerializer;
28import org.bukkit.Bukkit;
29import org.bukkit.entity.Player;
30
31import java.util.Arrays;
32import java.util.List;
33import java.util.UUID;
34
49public final class DreamChat {
50
51 private DreamChat() { }
52
58 public static void SendMessageToConsole(String message, DreamMessageSettings settings){
59 var cleanMessage = DreamMessageFormatter.format(message, settings);
60 for (var splitMessage : SplitMessage(PlainTextComponentSerializer.plainText().serialize(cleanMessage))) {
61 Bukkit.getConsoleSender().sendMessage(splitMessage);
62 }
63 }
64
71 public static void SendMessageToPlayer(Player player, String message, DreamMessageSettings settings){
72 var cleanMessage = DreamMessageFormatter.format(message, player, settings);
73 for (var splitMessage : SplitMessage(PlainTextComponentSerializer.plainText().serialize(cleanMessage))) {
74 player.sendMessage(splitMessage);
75 }
76 }
77
83 public static void BroadcastMessage(String message, DreamMessageSettings settings){
84 for (var player : Bukkit.getOnlinePlayers()) {
85 SendMessageToPlayer(player, message, settings);
86 }
87 }
88
99 public static <T extends Enum<T>> void SendMessageToPerm(String message, T permission, DreamMessageSettings settings){
100 for (var player : Bukkit.getOnlinePlayers()){
101 var luckPermsUser = DreamLuckPerms.getUser(player);
102 var cleanMessage = DreamMessageFormatter.format(message, player, settings);
103 if (DreamLuckPerms.hasPermission(luckPermsUser, permission)) {
104 SendMessageToPlayer(player, PlainTextComponentSerializer.plainText().serialize(cleanMessage), settings);
105 }
106 }
107 }
108
115 public static void SendMessageToWorld(String message, String worldName, DreamMessageSettings settings){
116 for (var player : Bukkit.getOnlinePlayers()){
117 var cleanMessage = DreamMessageFormatter.format(message, player, settings);
118 if (player.getWorld().getName().equalsIgnoreCase(worldName)) {
119 SendMessageToPlayer(player, PlainTextComponentSerializer.plainText().serialize(cleanMessage), settings);
120 }
121 }
122 }
123
134 public static void SendMessageToWorld(String message, UUID worldUUID, DreamMessageSettings settings){
135 for (var player : Bukkit.getOnlinePlayers()){
136 var cleanMessage = DreamMessageFormatter.format(message, player, settings);
137 if (player.getWorld().getUID() == worldUUID) {
138 SendMessageToPlayer(player, PlainTextComponentSerializer.plainText().serialize(cleanMessage), settings);
139 }
140 }
141 }
142
148 private static List<String> SplitMessage(String message){
149 return Arrays.asList(message.split(FormatTags.SplitLine.tag));
150 }
151}
Convenience helpers for sending formatted messages to console, players, worlds, and permission‑gated ...
static void SendMessageToWorld(String message, UUID worldUUID, DreamMessageSettings settings)
Sends a formatted message to players in a specific world by world UUID.
static void SendMessageToPlayer(Player player, String message, DreamMessageSettings settings)
Formats and sends a message to a specific player.
static< T extends Enum< T > void SendMessageToPerm(String message, T permission, DreamMessageSettings settings)
Sends a formatted message to all online players who have the given enum‑based permission.
static void SendMessageToConsole(String message, DreamMessageSettings settings)
Formats and sends a message to the Minecraft console sender.
static void SendMessageToWorld(String message, String worldName, DreamMessageSettings settings)
Sends a formatted message to players in a specific world by name (case‑insensitive).
static void BroadcastMessage(String message, DreamMessageSettings settings)
Broadcasts a formatted message to all online players.
Adventure‑first message formatter that supports: MiniMessage parsing (configurable via DreamMessageSe...
static Component format(@Nullable String message, @Nullable DreamMessageSettings settings)
Formats a raw string to an Adventure Component using settings.
Reserved inline formatting tokens used by DreamChat utilities.
SplitLine
Split token used to break messages into multiple lines.
record DreamMessageSettings(boolean usePlaceholders, boolean allowMiniMessage, boolean allowColors, boolean allowFormatting, boolean allowClickAndHover)
Immutable settings that control how DreamMessageFormatter processes messages.