網頁編輯器  •  GITHUB  •  文檔  •  DISCORD

概述 - Gloss 的功能

Gloss 是一個整體的全息圖和 UI 顯示套件。它是一個插件，取代了大多數其他插件，例如 MOTD、計分板、標籤列表、表情符號等。

• 全息圖 基於 TextDisplay 的浮動文本，具有每位玩家的佔位符渲染、可熱加載的 JSON 文件、文本到方塊藝術的渲染和完整的命令管理。

• 全息菜單 可點擊的世界內 UI，具有按鈕、切換、頁面導航、懸停動畫和從物品、方塊、實體、玩家頭像、圖像或自定義物品插件中繪製的圖標。

• 世界面板 持久的世界固定菜單，您可以定位、旋轉、縮放、對齊，甚至附加到玩家身上。

• 容器預覽 查看箱子、熔爐、釀造台、漏斗或其他十個容器，並且一張全息卡會渲染其實時內容。

• 真實掉落 掉落的物品變成有重心的、翻滾的顯示模型，帶有浮動標籤、可選的真實物理（彈跳、浮力）和可編程的動畫層。

• 計分板 JSON 定義的側邊欄，具有主要/世界默認值、權限限制的板和每組的默認值。

• 標籤列表 可配置的標題/頁腳和每組玩家列表名稱。

• 表情符號 :emoji: 並在聊天中觸發替換，支持標籤補全和每個表情符號的權限，預設有 71 個，您可以輕鬆添加更多。

• 聊天氣泡 消息在講話者的頭上浮動，堆疊，並在過期時飛走，具有每個世界和每組的樣式。

• 傷害指示器 浮動的傷害和治療數字，具有彈道運動，根據實際施加的健康變化進行測量。

• 動畫 基於幀的文本動畫，可在任何全息圖、計分板或標籤列表行中使用，通過 |animation.<id>|。

• MOTD 隨機化、顏色過濾的伺服器列表 MOTD（默認關閉）。

在 Gloss 中，所有內容都是完全可配置的，您可以使用網頁編輯器輕鬆預覽您的更改，並有數十個隨機輸出幫助您選擇適合您的內容。所有配置更改在文件保存後或從網頁編輯器推送到伺服器時會立即熱加載。

網頁編輯器 - 在瀏覽器中構建菜單和面板

查看網頁編輯器，輕鬆創建您的菜單： gloss.volmitsoftware.com. 您可以可視化地佈置菜單、面板、掉落動畫腳本、容器預覽等，並進行實時預覽。

實時雙向同步 運行 \/gloss menu edit <menu> 或 \/gloss panel web <panel>，Gloss 會給您一個可點擊的鏈接，打開編輯器中的文檔。從瀏覽器發布，伺服器在幾秒鐘內提取更改，驗證並通過原子事務寫入，並自動備份之前的內容。

\/gloss sync list       活躍的編輯會話
\/gloss sync status     中繼和會話狀態
\/gloss sync pull       立即輪詢中繼
\/gloss sync revoke     立即終止會話

您的自定義物品，在編輯器中 \/gloss items export 會寫入 custom-items.json，以便編輯器可以瀏覽您伺服器上的每個 ItemsAdder、Oraxen、Nexo、MMOItems、Slimefun 等。

會話受到保護 同步會話會過期（默認 60 分鐘），有大小限制，並檢測版本衝突，因此兩個編輯器無法靜默覆蓋彼此。

編輯器寫入的所有內容都是您插件文件夾中的純 JSON。您可以隨時手動編輯文件或通過網頁編輯器的分割視圖進行編輯。

命令和權限

主要命令是 \/gloss. 別名 \/gl, \/glo, \/gg

其他別名： \/hologram, \/holo, \/h, \/board, \/sb, \/bd

\/gloss status                                  顯示所有已加載的內容。

\/hologram create|delete|list|info              管理全息圖
\/hologram addline|setline|removeline|clear
\/hologram move|movehere|tp|orient              定位和面向
\/hologram rendertext                           將文本光柵化為方塊藝術行

\/board create|delete|title                     管理側邊欄
\/board addline|setline|removeline
\/board show|hide|primary|permission|reset

\/gloss menu list|create|open|edit|builder|new|copy
\/gloss menu addrow|insertrow|setrow|removerow|offsetrow|seticon|style|image

\/gloss panel create|delete|list|near|info|rename|copy
\/gloss panel move|here|tp|rotate|scale|align|follow|unfollow
\/gloss panel ranges|visibility|permissions|edit|web|save|cancel

\/gloss preview list|reset|dump                 容器預覽文檔
\/gloss item status|export                      自定義物品提供者 \/ 編輯器導出
\/gloss sync list|status|revoke|pull            編輯器同步會話
\/gloss import preview|apply|holoui|legacy
\/gloss emoji list|reset                        點擊表情符號將其插入聊天
\/gloss animations list|reset
\/gloss bubbles style|reset                     選擇您的個人氣泡樣式
\/gloss tablist reset  \/gloss motd reset  \/gloss drops reset

運行 \/gloss 單獨打開一個分頁的懸停和點擊幫助菜單。列表項目是可點擊的，點擊全息圖以傳送到它，點擊表情符號以插入它。標籤補全在任何地方都有效。

權限 遵循命令樹。所有內容都掛在 gloss.*（默認：op）：

gloss.*                    每個節點的父級。授予整個插件。
gloss.admin                重置子命令：emoji、animations、bubbles、tablist、motd、drops

gloss.holograms            五個全息圖節點的父級。基本訪問 \/hologram
gloss.holograms.create     創建全息圖並添加行
gloss.holograms.edit       編輯行、重命名、渲染文本
gloss.holograms.delete     刪除全息圖
gloss.holograms.move       移動、移動到這裡、定向
gloss.holograms.teleport   傳送到全息圖

gloss.boards               五個側邊欄節點的父級。基本訪問 \/board
gloss.boards.create        創建側邊欄
gloss.boards.edit          標題、添加行、設置行、刪除行
gloss.boards.delete        刪除側邊欄
gloss.boards.show          向自己或其他人顯示側邊欄
gloss.boards.hide          隱藏側邊欄

gloss.menus                八個菜單節點的父級。基本訪問 \/gloss menu
gloss.menus.list           列出菜單文檔
gloss.menus.open           打開菜單
gloss.menus.close          關閉打開的菜單
gloss.menus.move           重新定位打開的菜單
gloss.menus.back           導航頁面堆棧
gloss.menus.create         創建新的菜單文檔
gloss.menus.edit           編輯行、圖標、樣式、圖像
gloss.menus.builder        遊戲內菜單構建器

gloss.panels               面板節點的父級。創建、移動、旋轉、縮放、對齊、跟隨
gloss.panels.editweb       在網頁編輯器中打開面板（\/gloss panel web）

gloss.preview              查看容器預覽並調整其比例
gloss.sync                 管理網頁編輯器同步會話（列表、狀態、提取、撤銷）
gloss.import               導入節點的父級。乾運行預覽（\/gloss import preview）
gloss.import.apply         實際應用導入

gloss.emoji.use            在聊天中使用表情符號                      默認：true
gloss.bubbles.send         您的聊天以氣泡形式呈現           默認：true
gloss.indicators.show      查看傷害和治療指示器         默認：true
gloss.chat.color           在聊天中使用顏色代碼                默認：op
gloss.bubbles.style        選擇個人氣泡樣式           默認：op

每個節點都是 默認：op 除非另有標記。授予父級（gloss.menus) 會授予其子級；三個面向玩家的節點默認對所有人開放。

配置

在 Gloss 中，所有內容都是可配置的，所有選項在保存時會熱加載，無需重新加載您的更改。

# 配置 - gloss
# 此文件在加載時會被標準化；註釋和新鍵可能會自動更新。
#
# Gloss 運行時配置。每個旋鈕都會發出註釋，
# 超出其文檔範圍的值會在加載時被夾緊，
# 編輯在伺服器運行時熱加載。

# 在啟動期間打印 Gloss 啟動畫面。
splashScreen = true
# 發送匿名的 bStats 使用指標。
metrics = true

# 功能設置。
[features]
# 啟用全息圖引擎。
holograms = true
# 啟用計分板側邊欄。
boards = true
# 啟用標籤列表標題/頁腳和列表名稱管理。
tablist = true
# 啟用聊天和內容中的表情符號替換。
emoji = true
# 啟用文本動畫。
animations = true
# 啟用玩家上方的聊天氣泡。
chatBubbles = true
# 啟用浮動的傷害和治療指示器。
damageIndicators = true
# 啟用掉落物品堆的自定義名稱。
drops = true
# 用有重心的、翻滾的顯示模型和顯示支持的標籤替換原版掉落物品渲染。
realDrops = true
# 啟用全息菜單。
menus = true
# 啟用世界固定面板。
panels = true
# 啟用查看容器預覽。
previews = true
# 啟用自定義伺服器列表 MOTD。
motd = false

# 熱加載設置。
[hotload]
# 監視文件熱加載的輪詢間隔。夾緊到 1..200。
watchIntervalTicks = 5

# 全息圖設置。
[holograms]
# 堆疊全息圖行之間的垂直距離（以方塊為單位）。夾緊到 0.05..2.0。
stackDistance = 0.26
# 全息圖文本刷新的間隔（以 ticks 為單位）。夾緊到 1..200。
updateIntervalTicks = 10
# 全息圖可見的距離（以方塊為單位）。夾緊到 4..128。
viewRange = 48.0
# 每位查看玩家渲染完整的佔位符、函數和表達式令牌，而不是全局渲染一次。
perViewerPlaceholders = true
# 臨時全息圖的刷新間隔（以 ticks 為單位）。夾緊到 1..20。
temporaryUpdateIntervalTicks = 2
# 使用客戶端顯示插值來移動臨時全息圖，當伺服器 API 缺少時回退到傳送。
interpolatedMotion = true
# 通過專用的異步線程驅動快速動畫全息圖行，而不是通過 tick 更新器。
highFrequencyAnimations = true
# 高頻動畫線程目標的最大幀率（每秒）。夾緊到 1..240。
maxAnimationFps = 120
# 每秒允許的動畫文本數據包數；大型觀眾會按比例降低幀率。夾緊到 100..1000000。
animationPacketBudget = 20000
# 渲染文本藝術的最大寬度（以字符為單位）。夾緊到 8..128。
textArtMaxWidth = 48

# 計分板設置。
[boards]
# 計分板刷新的間隔（以 ticks 為單位）。夾緊到 1..200。
updateIntervalTicks = 20

# 標籤列表設置。
[tablist]
# 標籤列表刷新的間隔（以 ticks 為單位）。夾緊到 1..400。
updateIntervalTicks = 40

# 群組設置。
[groups]
# 通過 Vault 解決玩家群組（如果已安裝）。
useVault = true

# 表情符號設置。
[emoji]
# 需要每個表情符號的權限，而不是全局表情符號權限。
emojiSpecificPermissions = false
# 在聊天標籤補全中提供表情符號觸發。
tabComplete = true

# 文本設置。
[text]
# 在渲染文本中解析 PlaceholderAPI 佔位符。
placeholders = true
# 在渲染文本中解析 |function| 表達式。
functions = true

# 聊天設置。
[chat]
# 為獲得權限的玩家翻譯聊天中的顏色代碼。
color = true

# 聊天氣泡設置。
[chatBubbles]
# 聊天氣泡永遠不會出現的世界文件夾名稱。
blacklistWorlds = []

# 傷害指示器設置。
[damageIndicators]
# 隨機施加於生成的指示器的側向力。夾緊到 0.0..2.0。
randomThrowForce = 0.08
# 施加於生成的指示器的初始向上力。夾緊到 0.0..2.0。
initialUpForce = 0.13
# 每個 tick 施加於指示器的重力拉力。夾緊到 0.0..1.0。
gravityFactor = 0.0093
# 每秒生成的最大指示器數，超過此數量的新指示器將被丟棄。夾緊到 1..1000。
maxPerSecond = 40
# 指示器存活的毫秒數。夾緊到 250..30000。
maxMsAlive = 3000
# 施加於傷害數字的顏色代碼前綴。
damagePrefix = "&c&l"
# 施加於治療數字的顏色代碼前綴。
healPrefix = "&a&l"
# 指示器數字顯示的小數位數。夾緊到 0..2。
decimals = 0
# 除了傷害指示器外，還顯示治療指示器。
showHeals = true

# 掉落設置。
[drops]
# 掉落物品堆的名稱格式；{count} 和 {type} 被替換。
nameFormat = "&7{count}x {type}"
# 托運掉落的捆綁包的名稱格式；{total}
# 和 {contents} 被替換。空捆綁包使用 nameFormat。
bundleFormat = "&7Bundle &8(&7{total} items&8): &7{contents}"
# 在其餘部分合併之前列出捆綁包內容條目。夾緊到 1..10。
bundleEntryLimit = 3
# 在啟用 realDrops 時，對捆綁包使用垂直的 TextDisplay 標籤。
bundleVerticalLabels = true
# 垂直捆綁包標籤的標題格式；{total} 被替換。
bundleHeaderFormat = "&eBundle &8(&e{total} items&8)"
# 垂直捆綁包標籤的條目格式；{count} 和 {type} 被替換。
bundleEntryFormat = "&7- &f{count}x {type}"
# 垂直捆綁包標籤的剩餘格式；{remaining} 被替換為
# 隱藏的材料數量。
bundleMoreFormat = "&8+{remaining} more"
# 保留其他插件已經設置的掉落物品的自定義名稱。
preserveCustomNames = true
# 使用物品的顯示名稱作為 {type} 而不是材料名稱。
useItemDisplayNames = true

# 命令設置。
[commands]
# 當命令輸出被交付時播放反饋聲音。
sounds = true

# 調試設置。
[debug]
# 為所有會話渲染菜單命中框調試輪廓。
hitbox = false
# 為所有會話渲染菜單位置調試標記。
position = false
# 每 10 秒記錄高頻動畫循環統計。
animator = false

# 編輯器設置。
[editor]
# 托管的網頁編輯器的基本 URL；必須是普通的 http(s) 鏈接，否則使用默認值。
builderUrl = "https://gloss.volmitsoftware.com"

# 同步設置。
[editor.sync]
# 通過中繼啟用實時編輯器同步會話。
enabled = true
# 中繼端點 URL；必須是 https（或回送 http），以 /v2 結尾，否則使用默認值。
endpoint = "https://sync.gloss.volmitsoftware.com/v2"
# 中繼會話創建令牌，長度為 22..128 個字符，範圍為 A-Z、a-z、
# 0-9、_ 和 -；其他任何內容都視為空。
createToken = ""
# 編輯器同步會話的存活時間（以分鐘為單位）。夾緊到 5..1440。
sessionMinutes = 60
# 在活動會話期間的中繼輪詢間隔（以秒為單位）。夾緊到 1..60。
pollSeconds = 3
# 最大編輯器同步項目大小（以 MiB 為單位）。夾緊到 1..32。
maxProjectMiB = 8

# 預覽設置。
[preview]
# 對於容器預覽，查看射線的距離（以方塊為單位）。夾緊到 1.0..24.0。
lookDistance = 10.0
# 容器預覽的基本渲染比例。夾緊到 0.25..4.0。
scale = 0.65

# 菜單設置。
[menus]
# 全息菜單和面板的全局渲染比例乘數。夾緊到 0.25..4.0。
uiScale = 1.0

# 物品設置。
[items]
# 啟用通過安裝的物品插件解析的自定義物品圖標。
customItems = true
# 物品提供者允許列表，按提供者或插件名稱；空列表允許每個提供者。
customItemProviders = []

# 集成設置。
[integration]
# 監視其他 Volmit 插件發布的指標的樣本間隔
# |metric.<key>| 和預覽變量。夾緊到 1..200。
sampleIntervalTicks = 20

語言 17 種語言從標準英語默認翻譯可供選擇。

要切換，請在 language 中設置 plugins/Gloss/language.yml

locale: en_US

de_DE    德語（德國）
es_ES    西班牙語（西班牙）
fi_FI    芬蘭語（芬蘭）
fr_FR    法語（法國）
he_IL    希伯來語（以色列）
it_IT    意大利語（意大利）
ja-JP    日語（日本）
ko_KR    韓語（南韓）
lt_LT    立陶宛語（立陶宛）
nl_NL    荷蘭語（荷蘭）
pl_PL    波蘭語（波蘭）
pt_PT    葡萄牙語（葡萄牙）
ru_RU    俄語（俄羅斯）
tr_TR    土耳其語（土耳其）
vi_VI    越南語（越南）
zh_CN    中文（簡體）
zh_TW    中文（繁體）

菜單和可點擊的 UI

菜單是通過 \/gloss menu 命令創建和管理的，文件存儲在 plugins/Gloss/menus

• 組件 按鈕、切換和裝飾，每個都有自己的命中框。

• 圖標 文本、圖像、動畫圖像、物品、方塊、實體、玩家頭像或來自自定義物品插件的任何物品（提供者自動檢測）。

• 動作 運行命令、播放聲音、發送消息、傳送或使用頁面導航菜單（推送、替換、返回、主頁、關閉）。

• 點擊觸發 左鍵、右鍵、Shift+左鍵、Shift+右鍵。

• 懸停動畫 具有緩動曲線和可配置的持續時間。

• 行為 lockPosition、followPlayer、maxDistance、closeOnDeath、closeOnTeleport。

面板 是固定在世界中的菜單：定位、旋轉（偏航、俯仰、滾轉）和縮放它們，使用 ~相對坐標，將一個面板對齊到另一個面板，設置視圖和交互範圍，根據權限限制可見性，或讓面板跟隨玩家進行固定、偏航或全旋轉。

容器預覽

完全可配置的容器預覽。您可以雙擊 Shift 以保存容器的大小，或按住 shift + 滾輪 設置容器的大小（向下滾動到 0% 以關閉，對每個玩家的設置持久）。

有十四種預設容器類型：箱子、末影箱、熔爐、釀造台、漏斗、發射器、鍋、蜂巢、音樂盒、雕刻書架、架子、礦車、鎖定容器卡和沙盒箱。

卡片顯示實時值，熔爐烹飪和燃料進度、釀造時間、銀行 XP、佔用率等。輕鬆修改預設或使用網頁編輯器創建自己的預設。

WorldGuard 容器限制訪問檢查，以確保玩家無法窺探他們沒有權限的容器。

真實掉落物理和腳本

掉落的物品變得更加真實，它們可以在空中翻滾，落在一個平面上並穩定，發光等等。

您可以在 plugins/Gloss/real-drops/default.json 中修改這些設置，或使用我們的網頁編輯器進行修改。

• 限制 更新頻率、每堆的視覺效果、每區塊的實體預算

• 運動 翻滾速度、每軸旋轉、彈跳驅動的方向變化、浸入旋轉阻尼、地面滾動。

• 著陸 自然、平坦或直立，帶有傾斜、隨機偏航和面朝吸引。

• 標籤 偏移、縮放、視距、廣告模式、背景顏色。

• 物理 真實的實體物理：重力倍增器、彈跳、水浮力和阻力。這些移動實際的物品，而不僅僅是圖片。

• 腳本 一個表達層，動畫視覺效果：偏移、旋轉、縮放、發光和可見性，按軸進行，變量如 t、phase、impactSpeed、inWater、blockLight 和每個物品的穩定隨機。

• 動畫 根據狀態（SPAWN、IMPACT、BOUNCE、ENTER_FLUID、SETTLE...）觸發的類型關鍵幀片段，帶有緩動和混合模式。

聊天氣泡、傷害指示器、表情符號 MOTD、標籤列表和動畫

聊天氣泡 聊天在玩家的頭上浮動，堆疊，並在過期時飛走。樣式支持表達驅動的運動（平移、縮放、旋轉、不透明度）、單詞換行、生成時的閃爍、hideOwn、世界黑名單，以及按世界和 Vault 群組選擇，並設置優先級。擁有權限的玩家通過 \/gloss bubbles style 選擇個人樣式。

傷害指示器 浮動的傷害和治療數字，具有真實的彈道運動。

表情符號 71 個默認表情符號，使用 :name: 並觸發替換類型 <3 變成心形。聊天中的標籤補全、可選的每個表情符號的權限，以及 \/gloss emoji 列表項目在點擊時插入聊天。

動畫 基於幀的文本動畫，具有上升、下降或乒乓播放和每幀間隔。可以在任何渲染行中使用，作為 |animation.rainbow|。

MOTD 自定義您的 MOTD，以循環多個 MOTD 或保持靜態設計。

標籤列表 標籤列表支持 Gloss 的每個方面，根據您的需求進行自定義！

佔位符和表達式

每個渲染行的全息圖、計分板、標籤列表、氣泡、預覽支持有界的 {{ ... }} 表達式，具有原生的 player.* 和 server.* 值（名稱、延遲、健康、等級、在線、最大玩家、tps）。

PlaceholderAPI 是可選的，並完全支持以下 Gloss 佔位符：

%gloss_available%            顯示 Gloss 是否可用
%gloss_menu.open%            顯示菜單是否打開
%gloss_menu.id%              顯示當前菜單 ID

表達式庫在全息圖、氣泡、預覽和掉落中共享：clamp、lerp、smoothstep、sin、cos、rgb、mix、palette、bar、select 等，還有顏色如 #FFAA55 和完整的運算符集，包括三元運算。

開發者 API

Gloss 提供可用的 API，您可以進行掛鉤，請參閱我們的文檔以獲取更多信息。

GlossAPI api = GlossAPI.get();
api.open(myPlugin, player, "shop/main");            \/\/ 打開菜單
api.createHologram("welcome", location);            \/\/ 管理全息圖
api.createTemporaryHologram("popup", loc, 3000);    \/\/ 定時全息圖
api.filter(player, raw);                            \/\/ 將任何字符串通過文本管道
api.setBoard(player, "arena");  api.setTab(player, header, footer);

還有一個流暢的菜單構建器（按鈕、裝飾、來自文本、物品、方塊、實體、圖像或動畫圖像的圖標）、帶有觸發器和關閉原因的點擊處理程序、一個 PreviewStateProvider 擴展點，用於將您自己的變量提供給容器預覽卡，以及三個事件：GlossMenuOpenEvent、GlossMenuClickEvent、GlossContainerPreviewAccessEvent。

兼容性 - 運行時和 Java

Gloss 支持 Paper、Purpur、Leaf、Folia、Canvas 和 Spigot，運行於 Java 25 的 Minecraft 26.x+

可選集成 PlaceholderAPI、Vault、WorldGuard 和十個自定義物品提供者 - CraftEngine、ItemsAdder、Oraxen、Nexo、MMOItems、ExecutableItems、EcoItems、Slimefun、MythicMobs、HeadDatabase。提供者會自動檢測並熱插拔。

圖像和媒體