CustomScreenMenu

# 是否开启调试模式
Debug: false

# 是否开启南瓜头遮罩效果
use-pumpkin-overlay: false

# 是否使用玩家当前位置作为菜单摄像机位置
use-player-location: false

# 声音设置
sound:
  name: 'music.menu'
  volume: 1
  pitch: 1
  loop:
    enabled: true
    duration: 30

# 光标设置
cursor-item:
  material: 'ARROW'
  custom-model-data: 0
  scale: 0.5
  max-x: 2
  max-y: 3
  x: 0.0
  y: 0.0
  z-offset: 0.0
                

example:
  # 菜单权限节点
  permission: cursormenu.menu.example

  # 自动执行命令
  auto-commands:
    enabled: false
    commands:
      - "[console] say 欢迎进入菜单"
    delays:
      - 60

  # 摄像机位置设置
  camera-position:
    distance: 1.5
    world: lobby
    x: -187
    y: 70
    z: 347
    yaw: 190
    pitch: 0.0

  # 菜单布局
  layout:
    button1:
      permission: cursormenu.button.test.layout1
      name: "注册账号"
      x: -2
      y: 0
      z: 3.5
      command:
        - '[op] say 注册账号'
      next-menu:
        enabled: true
        menu: login_menu
                

// 获取插件实例
CursorMenuPlugin plugin = (CursorMenuPlugin) Bukkit.getServer().getPluginManager()
    .getPlugin("CustomScreenMenu");

// 打开指定菜单
plugin.setupCursor(player, "菜单名");

// 关闭玩家当前菜单
plugin.stopCursor(player, true);

Introduction

CustomScreenMenu is a powerful holographic cursor menu plugin designed for Minecraft servers. It allows server administrators to create immersive 3D holographic menu interfaces that players can interact with through a cursor.

Installation Guide

1. Ensure the server has Java 17 or higher installed
2. Download and install the following dependency plugins:
   • PlaceholderAPI
   • packetevents
3. Put the CustomScreenMenu.jar file into the server's plugins directory
4. Start the server to generate configuration files
5. Edit the configuration files as needed
6. Restart the server to make the configuration take effect

Configuration

Main Configuration File (config.yml)

The main configuration file contains the core settings of the plugin:

# Whether to enable debug mode
Debug: false

# Whether to enable pumpkin overlay effect
use-pumpkin-overlay: false

# Whether to use the player's current position as the menu camera position
use-player-location: false

# Sound settings
sound:
  name: 'music.menu'
  volume: 1
  pitch: 1
  loop:
    enabled: true
    duration: 30

# Cursor settings
cursor-item:
  material: 'ARROW'
  custom-model-data: 0
  scale: 0.5
  max-x: 2
  max-y: 3
  x: 0.0
  y: 0.0
  z-offset: 0.0
                

Menu Configuration File

The menu configuration files are located in the plugins/CustomScreenMenu/menu/ directory in YAML format:

example:
  # Menu permission node
  permission: cursormenu.menu.example

  # Auto-executed commands
  auto-commands:
    enabled: false
    commands:
      - "[console] say Welcome to the menu"
    delays:
      - 60

  # Camera position settings
  camera-position:
    distance: 1.5
    world: lobby
    x: -187
    y: 70
    z: 347
    yaw: 190
    pitch: 0.0

  # Menu layout
  layout:
    button1:
      permission: cursormenu.button.test.layout1
      name: "Register Account"
      x: -2
      y: 0
      z: 3.5
      command:
        - '[op] say Register Account'
      next-menu:
        enabled: true
        menu: login_menu
                

Command Reference

Permission Nodes

Permission Node	Description	Default Permission
cursormenu.start	Allows use of /cursormenu run command	OP
cursormenu.stop	Allows use of /cursormenu stop command	OP
cursormenu.reload	Allows reloading plugin configuration	OP
cursormenu.menu.<menu_name>	Allows opening a specific menu	Based on configuration

Placeholders

CustomScreenMenu is fully compatible with PlaceholderAPI, and you can use any placeholders provided by PlaceholderAPI in menu text.

Developer API

CustomScreenMenu provides a rich set of API interfaces for other plugins to call:

Opening Menus

// Get plugin instance
CursorMenuPlugin plugin = (CursorMenuPlugin) Bukkit.getServer().getPluginManager()
    .getPlugin("CustomScreenMenu");

// Open specified menu
plugin.setupCursor(player, "menu_name");

Closing Menus

// Close player's current menu
plugin.stopCursor(player, true);

Troubleshooting

FAQ

Q: How to create a new menu?

A: Create a new YAML file in the plugins/CustomScreenMenu/menu/ directory, and write it by referring to the sample configuration file format.

Q: How to customize the cursor appearance?

A: Modify cursor-item.material and related properties in config.yml.

Q: Which Minecraft versions are supported?

A: The plugin supports Minecraft 1.19 and above.

Введение

CustomScreenMenu - это мощный плагин голографического меню курсора, разработанный для серверов Minecraft. Он позволяет администраторам серверов создавать захватывающие 3D-голографические интерфейсы меню, с которыми игроки могут взаимодействовать с помощью курсора.

Руководство по установке

1. Убедитесь, что на сервере установлен Java 17 или выше
2. Загрузите и установите следующие плагины зависимостей:
   • PlaceholderAPI
   • packetevents
3. Поместите файл CustomScreenMenu.jar в каталог plugins сервера
4. Запустите сервер для создания файлов конфигурации
5. Отредактируйте файлы конфигурации по мере необходимости
6. Перезапустите сервер, чтобы конфигурация вступила в силу

Конфигурация

Основной файл конфигурации (config.yml)

Основной файл конфигурации содержит основные настройки плагина:

# Включить режим отладки
Debug: false

# Включить эффект наложения тыквы
use-pumpkin-overlay: false

# Использовать текущее положение игрока в качестве положения камеры меню
use-player-location: false

# Настройки звука
sound:
  name: 'music.menu'
  volume: 1
  pitch: 1
  loop:
    enabled: true
    duration: 30

# Настройки курсора
cursor-item:
  material: 'ARROW'
  custom-model-data: 0
  scale: 0.5
  max-x: 2
  max-y: 3
  x: 0.0
  y: 0.0
  z-offset: 0.0
                

Файл конфигурации меню

Файлы конфигурации меню находятся в каталоге plugins/CustomScreenMenu/menu/ в формате YAML:

example:
  # Узел разрешения меню
  permission: cursormenu.menu.example

  # Автоматически выполняемые команды
  auto-commands:
    enabled: false
    commands:
      - "[console] say Добро пожаловать в меню"
    delays:
      - 60

  # Настройки положения камеры
  camera-position:
    distance: 1.5
    world: lobby
    x: -187
    y: 70
    z: 347
    yaw: 190
    pitch: 0.0

  # Макет меню
  layout:
    button1:
      permission: cursormenu.button.test.layout1
      name: "Зарегистрировать аккаунт"
      x: -2
      y: 0
      z: 3.5
      command:
        - '[op] say Зарегистрировать аккаунт'
      next-menu:
        enabled: true
        menu: login_menu
                

Ссылка на команду

Узлы разрешений

Узел разрешения	Описание	Разрешение по умолчанию
cursormenu.start	Позволяет использовать команду /cursormenu run	OP
cursormenu.stop	Позволяет использовать команду /cursormenu stop	OP
cursormenu.reload	Позволяет перезагружать конфигурацию плагина	OP
cursormenu.menu.<название_меню>	Позволяет открывать определенное меню	На основе конфигурации

Заполнители

CustomScreenMenu полностью совместим с PlaceholderAPI, и вы можете использовать любые заполнители, предоставляемые PlaceholderAPI, в тексте меню.

API разработчика

CustomScreenMenu предоставляет богатый набор интерфейсов API для вызова другими плагинами:

Открытие меню

// Получить экземпляр плагина
CursorMenuPlugin plugin = (CursorMenuPlugin) Bukkit.getServer().getPluginManager()
    .getPlugin("CustomScreenMenu");

// Открыть указанное меню
plugin.setupCursor(player, "название_меню");

Закрытие меню

// Закрыть текущее меню игрока
plugin.stopCursor(player, true);

Устранение неполадок

Часто задаваемые вопросы

В: Как создать новое меню?

О: Создайте новый файл YAML в каталоге plugins/CustomScreenMenu/menu/ и напишите его, используя пример формата файла конфигурации.

В: Как настроить внешний вид курсора?

О: Измените cursor-item.material и связанные свойства в config.yml.

В: Какие версии Minecraft поддерживаются?

О: Плагин поддерживает Minecraft 1.19 и выше.

Introduction

Introduction

CustomScreenMenu est un plugin de menu curseur holographique puissant conçu pour les serveurs Minecraft. Il permet aux administrateurs de serveur de créer des interfaces de menu holographiques 3D immersives avec lesquelles les joueurs peuvent interagir via un curseur.

Guide d'installation

1. Assurez-vous que le serveur dispose de Java 17 ou supérieur
2. Téléchargez et installez les plugins de dépendance suivants :
   • PlaceholderAPI
   • packetevents
3. Mettez le fichier CustomScreenMenu.jar dans le répertoire plugins du serveur
4. Démarrez le serveur pour générer les fichiers de configuration
5. Modifiez les fichiers de configuration selon vos besoins
6. Redémarrez le serveur pour que la configuration prenne effet

Configuration

Fichier de configuration principal (config.yml)

Le fichier de configuration principal contient les paramètres de base du plugin :

# Activer le mode débogage
Debug: false

# Activer l'effet de masque citrouille
use-pumpkin-overlay: false

# Utiliser la position actuelle du joueur comme position de la caméra du menu
use-player-location: false

# Paramètres audio
sound:
  name: 'music.menu'
  volume: 1
  pitch: 1
  loop:
    enabled: true
    duration: 30

# Paramètres du curseur
cursor-item:
  material: 'ARROW'
  custom-model-data: 0
  scale: 0.5
  max-x: 2
  max-y: 3
  x: 0.0
  y: 0.0
  z-offset: 0.0
                

Fichier de configuration du menu

Les fichiers de configuration du menu se trouvent dans le répertoire plugins/CustomScreenMenu/menu/ au format YAML :

example:
  # Nœud d'autorisation du menu
  permission: cursormenu.menu.example

  # Commandes exécutées automatiquement
  auto-commands:
    enabled: false
    commands:
      - "[console] say Bienvenue dans le menu"
    delays:
      - 60

  # Paramètres de position de la caméra
  camera-position:
    distance: 1.5
    world: lobby
    x: -187
    y: 70
    z: 347
    yaw: 190
    pitch: 0.0

  # Disposition du menu
  layout:
    button1:
      permission: cursormenu.button.test.layout1
      name: "Créer un compte"
      x: -2
      y: 0
      z: 3.5
      command:
        - '[op] say Créer un compte'
      next-menu:
        enabled: true
        menu: login_menu
                

Référence des commandes

Nœuds d'autorisation

Nœud d'autorisation	Description	Autorisation par défaut
cursormenu.start	Permet d'utiliser la commande /cursormenu run	OP
cursormenu.stop	Permet d'utiliser la commande /cursormenu stop	OP
cursormenu.reload	Permet de recharger la configuration du plugin	OP
cursormenu.menu.<nom_du_menu>	Permet d'ouvrir un menu spécifique	Selon la configuration

Espaces réservés

CustomScreenMenu est entièrement compatible avec PlaceholderAPI, et vous pouvez utiliser n'importe quel espace réservé fourni par PlaceholderAPI dans le texte du menu.

API développeur

CustomScreenMenu fournit un ensemble riche d'interfaces API pour les autres plugins :

Ouverture des menus

// Obtenir l'instance du plugin
CursorMenuPlugin plugin = (CursorMenuPlugin) Bukkit.getServer().getPluginManager()
    .getPlugin("CustomScreenMenu");

// Ouvrir le menu spécifié
plugin.setupCursor(player, "nom_du_menu");

Fermeture des menus

// Fermer le menu actuel du joueur
plugin.stopCursor(player, true);

Dépannage

FAQ

Q : Comment créer un nouveau menu ?

R : Créez un nouveau fichier YAML dans le répertoire plugins/CustomScreenMenu/menu/ et rédigez-le en vous référant au format du fichier de configuration d'exemple.

Q : Comment personnaliser l'apparence du curseur ?

R : Modifiez cursor-item.material et les propriétés associées dans config.yml.

Q : Quelles versions de Minecraft sont prises en charge ?

R : Le plugin prend en charge Minecraft 1.19 et supérieur.

Einführung

CustomScreenMenu ist ein leistungsstarkes Hologramm-Cursor-Menü-Plugin, das für Minecraft-Server entwickelt wurde. Es ermöglicht Serveradministratoren, immersive 3D-Hologramm-Menü-Schnittstellen zu erstellen, mit denen Spieler über einen Cursor interagieren können.

Installationsanleitung

1. Stellen Sie sicher, dass Java 17 oder höher auf dem Server installiert ist
2. Laden Sie die folgenden Abhängigkeits-Plugins herunter und installieren Sie sie:
   • PlaceholderAPI
   • packetevents
3. Legen Sie die Datei CustomScreenMenu.jar in das plugins-Verzeichnis des Servers
4. Starten Sie den Server, um Konfigurationsdateien zu generieren
5. Bearbeiten Sie die Konfigurationsdateien nach Bedarf
6. Starten Sie den Server neu, damit die Konfiguration wirksam wird

Konfiguration

Hauptkonfigurationsdatei (config.yml)

Die Hauptkonfigurationsdatei enthält die Kerneinstellungen des Plugins:

# Debug-Modus aktivieren
Debug: false

# Kürbismaskeneffekt aktivieren
use-pumpkin-overlay: false

# Aktuelle Spielerposition als Menü-Kameraposition verwenden
use-player-location: false

# Toneinstellungen
sound:
  name: 'music.menu'
  volume: 1
  pitch: 1
  loop:
    enabled: true
    duration: 30

# Cursor-Einstellungen
cursor-item:
  material: 'ARROW'
  custom-model-data: 0
  scale: 0.5
  max-x: 2
  max-y: 3
  x: 0.0
  y: 0.0
  z-offset: 0.0
                

Menü-Konfigurationsdatei

Die Menü-Konfigurationsdateien befinden sich im Verzeichnis plugins/CustomScreenMenu/menu/ im YAML-Format:

example:
  # Menü-Berechtigungsknoten
  permission: cursormenu.menu.example

  # Automatisch ausgeführte Befehle
  auto-commands:
    enabled: false
    commands:
      - "[console] say Willkommen im Menü"
    delays:
      - 60

  # Kamera-Positionseinstellungen
  camera-position:
    distance: 1.5
    world: lobby
    x: -187
    y: 70
    z: 347
    yaw: 190
    pitch: 0.0

  # Menü-Layout
  layout:
    button1:
      permission: cursormenu.button.test.layout1
      name: "Konto registrieren"
      x: -2
      y: 0
      z: 3.5
      command:
        - '[op] say Konto registrieren'
      next-menu:
        enabled: true
        menu: login_menu
                

Befehlsreferenz

Berechtigungsknoten

Berechtigungsknoten	Beschreibung	Standardberechtigung
cursormenu.start	Erlaubt die Verwendung des /cursormenu run-Befehls	OP
cursormenu.stop	Erlaubt die Verwendung des /cursormenu stop-Befehls	OP
cursormenu.reload	Erlaubt das Neuladen der Plugin-Konfiguration	OP
cursormenu.menu.<menü_name>	Erlaubt das Öffnen eines bestimmten Menüs	Basiert auf der Konfiguration

Platzhalter

CustomScreenMenu ist vollständig kompatibel mit PlaceholderAPI, und Sie können alle von PlaceholderAPI bereitgestellten Platzhalter im Menütext verwenden.

Entwickler-API

CustomScreenMenu bietet eine umfangreiche Sammlung von API-Schnittstellen für andere Plugins:

Menüs öffnen

// Plugin-Instanz abrufen
CursorMenuPlugin plugin = (CursorMenuPlugin) Bukkit.getServer().getPluginManager()
    .getPlugin("CustomScreenMenu");

// Angegebenes Menü öffnen
plugin.setupCursor(player, "menü_name");

Menüs schließen

// Aktuelles Menü des Spielers schließen
plugin.stopCursor(player, true);

Fehlerbehebung

FAQ

F: Wie erstelle ich ein neues Menü?

A: Erstellen Sie eine neue YAML-Datei im Verzeichnis plugins/CustomScreenMenu/menu/ und schreiben Sie sie nach dem Beispiel-Konfigurationsdateiformat.

F: Wie passe ich das Erscheinungsbild des Cursors an?

A: Ändern Sie cursor-item.material und verwandte Eigenschaften in config.yml.

F: Welche Minecraft-Versionen werden unterstützt?

A: Das Plugin unterstützt Minecraft 1.19 und höher.

はじめに

はじめに

CustomScreenMenuは、Minecraftサーバー用に設計された強力なホログラフィックカーソルメニュープラグインです。サーバー管理者が没入型の3Dホログラフィックメニューユーザーインターフェースを作成でき、プレイヤーはカーソルを使ってインタラクティブに操作できます。

インストールガイド

1. サーバーにJava 17以上がインストールされていることを確認してください
2. 以下の依存プラグインをダウンロードしてインストールしてください：
   • PlaceholderAPI
   • packetevents
3. CustomScreenMenu.jarファイルをサーバーのpluginsディレクトリに配置してください
4. サーバーを起動して設定ファイルを生成してください
5. 必要に応じて設定ファイルを編集してください
6. サーバーを再起動して設定を適用してください

構成

メイン設定ファイル (config.yml)

メイン設定ファイルにはプラグインのコア設定が含まれています：

# デバッグモードを有効にする
Debug: false

# かぼちゃオーバーレイ効果を有効化
use-pumpkin-overlay: false

# プレイヤーの現在位置をメニューカメラ位置として使用
use-player-location: false

# サウンド設定
sound:
  name: 'music.menu'
  volume: 1
  pitch: 1
  loop:
    enabled: true
    duration: 30

# カーソル設定
cursor-item:
  material: 'ARROW'
  custom-model-data: 0
  scale: 0.5
  max-x: 2
  max-y: 3
  x: 0.0
  y: 0.0
  z-offset: 0.0
                

メニューコンフィギュレーションファイル

メニューコンフィギュレーションファイルはplugins/CustomScreenMenu/menu/ディレクトリにYAML形式で配置されます：

example:
  # メニュー権限ノード
  permission: cursormenu.menu.example
  
  # 自動実行コマンド
  auto-commands:
    enabled: false
    commands:
      - "[console] say メニューへようこそ"
    delays:
      - 60
      
  # カメラ位置設定
  camera-position:
    distance: 1.5
    world: lobby
    x: -187
    y: 70
    z: 347
    yaw: 190
    pitch: 0.0
    
  # メニューレイアウト
  layout:
    button1:
      permission: cursormenu.button.test.layout1
      name: "アカウント登録"
      x: -2
      y: 0
      z: 3.5
      command:
        - '[op] say アカウント登録'
      next-menu:
        enabled: true
        menu: login_menu
                

コマンドリファレンス

権限ノード

権限ノード	説明	デフォルト権限
cursormenu.start	/cursormenu run コマンドの使用を許可	OP
cursormenu.stop	/cursormenu stop コマンドの使用を許可	OP
cursormenu.reload	プラグイン設定の再読み込みを許可	OP
cursormenu.menu.<メニュー名>	特定のメニューを開くことを許可	設定による

プレースホルダー

CustomScreenMenuはPlaceholderAPIと完全に互換性があり、メニューテキストでPlaceholderAPIが提供する任意のプレースホルダーを使用できます。

開発者API

CustomScreenMenuは他のプラグインが呼び出すための豊富なAPIインターフェースを提供します：

メニューを開く

// プラグインインスタンスを取得
CursorMenuPlugin plugin = (CursorMenuPlugin) Bukkit.getServer().getPluginManager()
    .getPlugin("CustomScreenMenu");

// 指定されたメニューを開く
plugin.setupCursor(player, "メニュー名");

メニューを閉じる

// プレイヤーの現在のメニューを閉じる
plugin.stopCursor(player, true);

トラブルシューティング

よくある質問

Q: 新しいメニューを作成するには？

A: plugins/CustomScreenMenu/menu/ディレクトリに新しいYAMLファイルを作成し、サンプル設定ファイル形式を参考にして作成してください。

Q: カーソルの外観をカスタマイズするには？

A: config.ymlでcursor-item.materialと関連するプロパティを変更してください。

Q: どのMinecraftバージョンをサポートしていますか？

A: プラグインはMinecraft 1.19以降をサポートしています。

Giới thiệu

CustomScreenMenu là một plugin menu con trỏ hologram mạnh mẽ được thiết kế cho các máy chủ Minecraft. Nó cho phép quản trị viên máy chủ tạo các giao diện menu hologram 3D hấp dẫn mà người chơi có thể tương tác thông qua con trỏ.

Hướng dẫn cài đặt

1. Đảm bảo máy chủ đã cài đặt Java 17 trở lên
2. Tải xuống và cài đặt các plugin phụ thuộc sau:
   • PlaceholderAPI
   • packetevents
3. Đặt tệp CustomScreenMenu.jar vào thư mục plugins của máy chủ
4. Khởi động máy chủ để tạo các tệp cấu hình
5. Chỉnh sửa các tệp cấu hình theo nhu cầu
6. Khởi động lại máy chủ để cấu hình có hiệu lực

Cấu hình

Tệp cấu hình chính (config.yml)

Tệp cấu hình chính chứa các cài đặt cốt lõi của plugin:

# Bật chế độ gỡ lỗi
Debug: false

# Bật hiệu ứng mặt nạ bí ngô
use-pumpkin-overlay: false

# Sử dụng vị trí hiện tại của người chơi làm vị trí camera menu
use-player-location: false

# Cài đặt âm thanh
sound:
  name: 'music.menu'
  volume: 1
  pitch: 1
  loop:
    enabled: true
    duration: 30

# Cài đặt con trỏ
cursor-item:
  material: 'ARROW'
  custom-model-data: 0
  scale: 0.5
  max-x: 2
  max-y: 3
  x: 0.0
  y: 0.0
  z-offset: 0.0
                

Tệp cấu hình menu

Các tệp cấu hình menu nằm trong thư mục plugins/CustomScreenMenu/menu/ ở định dạng YAML:

example:
  # Nút quyền menu
  permission: cursormenu.menu.example
  
  # Các lệnh tự động thực thi
  auto-commands:
    enabled: false
    commands:
      - "[console] say Chào mừng đến với menu"
    delays:
      - 60
      
  # Cài đặt vị trí camera
  camera-position:
    distance: 1.5
    world: lobby
    x: -187
    y: 70
    z: 347
    yaw: 190
    pitch: 0.0
    
  # Bố cục menu
  layout:
    button1:
      permission: cursormenu.button.test.layout1
      name: "Đăng ký tài khoản"
      x: -2
      y: 0
      z: 3.5
      command:
        - '[op] say Đăng ký tài khoản'
      next-menu:
        enabled: true
        menu: login_menu
                

Tham chiếu lệnh

Nút quyền

Nút quyền	Mô tả	Quyền mặc định
cursormenu.start	Cho phép sử dụng lệnh /cursormenu run	OP
cursormenu.stop	Cho phép sử dụng lệnh /cursormenu stop	OP
cursormenu.reload	Cho phép tải lại cấu hình plugin	OP
cursormenu.menu.<tên_menu>	Cho phép mở menu cụ thể	Dựa trên cấu hình

Trình giữ chỗ

CustomScreenMenu hoàn toàn tương thích với PlaceholderAPI, và bạn có thể sử dụng bất kỳ trình giữ chỗ nào do PlaceholderAPI cung cấp trong văn bản menu.

API dành cho nhà phát triển

CustomScreenMenu cung cấp một bộ giao diện API phong phú cho các plugin khác gọi:

Mở menu

// Lấy phiên bản plugin
CursorMenuPlugin plugin = (CursorMenuPlugin) Bukkit.getServer().getPluginManager()
    .getPlugin("CustomScreenMenu");

// Mở menu đã chỉ định
plugin.setupCursor(player, "tên_menu");

Đóng menu

// Đóng menu hiện tại của người chơi
plugin.stopCursor(player, true);

Khắc phục sự cố

Câu hỏi thường gặp

H: Làm cách nào để tạo menu mới?

Đ: Tạo tệp YAML mới trong thư mục plugins/CustomScreenMenu/menu/ và viết theo định dạng tệp cấu hình mẫu.

H: Làm cách nào để tùy chỉnh giao diện con trỏ?

Đ: Sửa đổi cursor-item.material và các thuộc tính liên quan trong config.yml.

H: Hỗ trợ các phiên bản Minecraft nào?

Đ: Plugin hỗ trợ Minecraft 1.19 trở lên.