thienplam

Tôi cần bạn viết 1 plugin Minecraft Spigot/Paper (Java) tên "HarshlandsBedrockFilter", softdepend vào 3 plugin có sẵn: "Harshlands", "Geyser-Spigot", "floodgate".

BỐI CẢNH:

Server dùng plugin Harshlands (port Ice and Fire/Tough As Nails/Comfort... sang Bukkit) kèm resource pack riêng gửi qua Player.addResourcePack(). Resource pack này dùng font custom kiểu Java (bitmap font provider với mã Unicode Private Use Area, namespace "harshlands:" trong file assets/minecraft/font/default.json) để vẽ icon HUD (nhiệt độ, khát nước, ký sinh trùng...) trong actionbar.

VẤN ĐỀ:

Có 1 nhóm ký tự trong font đó dùng để vẽ HIỆU ỨNG PHỦ TOÀN MÀN HÌNH (vignette đỏ khi quá nóng, vignette xanh khi quá lạnh, cảnh báo thiếu dinh dưỡng...) bằng cách khai báo ascent cực đoan (150 hoặc -10000) để phóng to/ẩn ký tự ra ngoài dòng chữ bình thường — đây là kỹ thuật chỉ hoạt động trên Java Edition.

Người chơi Bedrock (qua Geyser+Floodgate) không hiểu được kỹ thuật này — thay vì ẩn đi hoặc phủ màn hình, client Bedrock tự vẽ 1 ô vuông đen/placeholder (tofu glyph) rất xấu và gây khó chịu, không hề bị ẩn như mong đợi.

DANH SÁCH MÃ UNICODE CẦN LỌC BỎ (chỉ áp dụng cho người chơi Floodgate/Bedrock): \uE787, \uE788, \uE821, \uE822, \uE823, \uE824, \uE825, \uE829, \uE831, \uE832, \uE833, \uE834, \uE835, \uE8B0, \uE8B1, \uE8B2, \uE8B3

YÊU CẦU:

Viết code chặn/lọc các ký tự trên khỏi MỌI actionbar message gửi tới người chơi Floodgate, trước khi packet actionbar thực sự bay ra client. Có 2 cách, chọn cách nào khả thi hơn với ProtocolLib đã có sẵn trên server (ưu tiên cách 1):

CÁCH 1 (ưu tiên) - Packet listener bằng ProtocolLib:

  • Đăng ký PacketListener lắng nghe packet loại actionbar/title

(PacketType.Play.Server.SET_ACTION_BAR_TEXT hoặc tương đương tùy version, hoặc packet System Chat với overlay=true tùy cách Harshlands gửi)

  • Trong onPacketSending, check FloodgateApi.getInstance().isFloodgatePlayer(player.getUniqueId())
  • Nếu là Floodgate player: lấy nội dung text của packet (dạng Component/JSON), dùng

regex hoặc string replace xoá sạch các ký tự Unicode trong danh sách trên khỏi text, rồi set lại nội dung đã lọc vào packet trước khi cho gửi tiếp

  • Nếu không phải Floodgate player: không đụng gì, cho packet đi qua bình thường

CÁCH 2 (dự phòng nếu cách 1 không khả thi) - Chặn ở tầng API cao hơn:

  • Nếu Harshlands expose được sự kiện actionbar riêng, hoặc có thể wrap

Player#sendActionBar bằng cách nào đó (Adventure API), hook vào đó thay vì packet-level

YÊU CẦU KỸ THUẬT:

  • plugin.yml: name: HarshlandsBedrockFilter, softdepend: [Harshlands, Geyser-Spigot, floodgate, ProtocolLib]
  • main class implements JavaPlugin
  • Trong onEnable(), check các plugin phụ thuộc có tồn tại chưa (Bukkit.getPluginManager().getPlugin(...)),

log cảnh báo rõ ràng và tự disable nếu thiếu ProtocolLib hoặc Floodgate

  • pom.xml Maven đầy đủ, dependency: spigot-api (1.21.11), ProtocolLib (mới nhất trên

repo dmulloy2), floodgate-api (mới nhất trên repo Geyser Maven: https://repo.opencollab.dev/main/)

  • Code sạch, comment tiếng Việt giải thích từng bước, đặc biệt đoạn regex lọc ký tự

phải liệt kê rõ từng mã Unicode kèm comment nó tương ứng icon/hiệu ứng gì (dựa theo danh sách trên)

Kodari AI
KodariAug 9 at 6:35 pm 1
HarshlandsBedrockFilter
Filters out problematic Unicode characters from actionbar messages sent to Bedrock players via Geyser/Floodgate on Harshlands servers. These characters render as ugly tofu boxes on Bedrock clients due to incompatible bitmap font techniques. Uses ProtocolLib packet listener to intercept actionbar packets, detects Floodgate players, and strips the listed Unicode characters from the message content before forwarding. Falls back gracefully if dependencies are missing. Supports both SET_ACTION_BAR_TEXT and System Chat overlay packets. Preserves normal messages for Java players untouched.
  1. Tạo cấu hình Maven và plugin.yml với các dependency/softdepend cần thiết.

  2. Tạo main class kiểm tra plugin phụ thuộc, tự disable khi thiếu ProtocolLib hoặc Floodgate.

  3. Tạo ProtocolLib listener lọc các mã PUA khỏi packet actionbar dành riêng cho Floodgate player.

Đã tạo plugin HarshlandsBedrockFilter gồm:

  • pom.xml với Spigot API, ProtocolLib và Floodgate API.

  • plugin.yml khai báo softdepend cho Harshlands, Geyser-Spigot, floodgate và ProtocolLib.

  • Main class kiểm tra dependency, cảnh báo plugin tùy chọn và tự disable nếu thiếu ProtocolLib hoặc Floodgate.

  • ProtocolLib listener lọc actionbar qua:

    • SET_ACTION_BAR_TEXT

    • SYSTEM_CHAT với overlay=true

  • Chỉ lọc người chơi Floodgate/Bedrock.

  • Đã loại bỏ toàn bộ 17 mã Unicode PUA, bao gồm cả dạng ký tự thật và dạng escaped JSON.

Kodari can make mistakes. Review important code before using.
Files
src
pom.xml
Code
4 234
src/main/java/com/harshlands/bedrockfilter/HarshlandsBedrockFilter.java
package com.harshlands.bedrockfilter;

import com.comphenix.protocol.ProtocolLibrary;
import com.comphenix.protocol.ProtocolManager;
import org.bukkit.Bukkit;
import org.bukkit.plugin.Plugin;
import org.bukkit.plugin.PluginManager;
import org.bukkit.plugin.java.JavaPlugin;

public final class HarshlandsBedrockFilter extends JavaPlugin {

    private ProtocolManager protocolManager;
    private ActionBarPacketListener actionBarPacketListener;

    @Override
    public void onEnable() {
        PluginManager pluginManager = Bukkit.getPluginManager();

        // Harshlands và Geyser là plugin tích hợp; thiếu chúng không làm bộ lọc packet vô hiệu.
        warnIfMissing(pluginManager, "Harshlands");
        warnIfMissing(pluginManager, "Geyser-Spigot");

        // ProtocolLib và Floodgate là hai dependency bắt buộc để nhận diện player và sửa packet.
        Plugin protocolLib = pluginManager.getPlugin("ProtocolLib");
        Plugin floodgate = pluginManager.getPlugin("floodgate");
        if (!isEnabled(protocolLib)) {
            getLogger().severe("Không thể khởi động: cần ProtocolLib đang được bật.");
            pluginManager.disablePlugin(this);
            return;
        }
        if (!isEnabled(floodgate)) {
            getLogger().severe("Không thể khởi động: cần Floodgate đang được bật.");
            pluginManager.disablePlugin(this);
            return;
        }

        protocolManager = ProtocolLibrary.getProtocolManager();
        actionBarPacketListener = new ActionBarPacketListener(this);
        protocolManager.addPacketListener(actionBarPacketListener);
        getLogger().info("Đã bật bộ lọc actionbar cho người chơi Floodgate.");
    }

    @Override
    public void onDisable() {
        if (protocolManager != null && actionBarPacketListener != null) {
            protocolManager.removePacketListener(actionBarPacketListener);
        }
    }

    private void warnIfMissing(PluginManager pluginManager, String pluginName) {
        if (!isEnabled(pluginManager.getPlugin(pluginName))) {
            getLogger().warning("Không tìm thấy plugin tích hợp " + pluginName + "; bộ lọc vẫn tiếp tục khởi động.");
        }
    }

    private boolean isEnabled(Plugin plugin) {
        return plugin != null && plugin.isEnabled();
    }
}