Add event for incoming TAB_COMPLETE requests (pre-forward, cancellable)

Đang mở
#1,900 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
45/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
java
Lĩnh vực
api

Hướng nghiên cứu

Start by reading the existing tab completion and command event APIs, especially TabCompleteEvent, PlayerAvailableCommandsEvent, and packet forwarding for TAB_COMPLETE. Trace how incoming packets reach the backend and how event results can cancel or replace responses. Done means plugins can receive this request before forwarding and cancel it or supply a replacement response; the issue names no source files or tests.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

type: feature
Requested Feature

Add an event that fires before an incoming TAB_COMPLETE (Command Suggestions Request) packet is forwarded from the proxy to the backend, allowing plugins to cancel it or replace the response.

@Subscribe
public void onTabCompleteRequest(TabCompleteRequestEvent e) {
    // e.getPlayer(), e.getPartialMessage() ("ver", "plugins", ...)
    e.setResult(TabCompleteRequestEvent.Result.denied()); // packet dropped, backend never sees it
}
Why is this needed?

Anti plugin detection plugins on the proxy. Mods like Ui-Utils don't use the client's command tree - they send raw TAB_COMPLETE("ver") packets. The proxy forwards them to the backend, the backend replies with its plugin/software list, and the scanner fingerprints the network.

Existing API can't stop this:

  • TabCompleteEvent - doesn't fire for 1.13+.
  • PlayerAvailableCommandsEvent - only changes the client tree, scanners ignore it.
  • CommandExecuteEvent - not relevant.
  • Registering fake commands with empty suggest() - works only for known names, breaks on namespaced/unknown names, hijacks real commands.

Today the only reliable fix is packetevents or a custom netty handler, both work around the lack of a public API. A first-class hook would let proxy plugins block scanners cleanly without external dependencies.

Alternative Solutions
  1. TabCompleteEvent - legacy clients only, doesn't fire for 1.13+.
  2. PlayerAvailableCommandsEvent - tree-only; scanners bypass it with raw packets. Verified: removing commands from the root node still doesn't stop Ui-Utils.
  3. Fake commands with empty suggest() - fragile, incomplete, hijacks real commands, bypassed by namespaced names.
  4. packetevents - works, but requires an external dependency for a common proxy-level concern.
  5. Custom netty handler - reimplements packetevents, uses non-public API, breaks on updates.
Additional Information

Proof the packet reaches the proxy, with packetevents, this blocks scanners completely:

public void onPacketReceive(PacketReceiveEvent event) {
    if (event.getPacketType() == PacketType.Play.Client.TAB_COMPLETE) {
        WrapperPlayClientTabComplete packet = new WrapperPlayClientTabComplete(event);
        String command = packet.getText().toLowerCase().split(" ")[0];
        if (shouldBlock(command)) event.setCancelled(true);
    }
}
Ngôn ngữ chính
Java
Star
2.3k
Fork
983
Merge trung bình
4 ngày 14 giờ
Pull request đã merge (30 ngày)
3

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của PaperMC/Velocity

Tất cả issue của PaperMC/Velocity

Issue tương tự

Thêm issue về Java

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.