From e386e123968604e39a4b4fb320899cb9e470cac0 Mon Sep 17 00:00:00 2001 From: Connor Lewis <50084106+imconnorngl@users.noreply.github.com> Date: Tue, 2 Dec 2025 16:39:07 +0000 Subject: [PATCH 1/2] chore: client brand changes --- client-brand.mdx | 51 ++++++++++++++++++++++++++---------------------- 1 file changed, 28 insertions(+), 23 deletions(-) diff --git a/client-brand.mdx b/client-brand.mdx index d8d59a1..607f5be 100644 --- a/client-brand.mdx +++ b/client-brand.mdx @@ -1,23 +1,28 @@ -import { Callout, Tab, Tabs } from 'nextra-theme-docs'; - -# Client Brand - -Lunar Client can be detected by checking the Minecraft client brand sent to the server. This allows you to detect and track Lunar Client players, if you're unable to use the full -[Apollo](/apollo/introduction) integration. - - - This is not a cryptographically secure detection method. Malicious clients can spoof the client brand sent to the server. - - -## Brand Format - -The client brand will always be in the format `lunarclient:`. `` is the Lunar Client build that the user is running. See the next section for info about the -version format. - -## Version Format - -We do not provide any guarantees about the exact format of the version, and it may change without notice. An unexpected version format does not mean that a user is running an -unofficial build of Lunar Client. The version will be visible on the Minecraft F3 menu, and in the window title, in addition to being present in the client brand. - -Most, but not all, users will have a version in the format of `v..-`. For example, `v2.12.0-2349` is version `v2.12.0`, which -was built in the 49th week of 2023. +import { Callout, Tab, Tabs } from 'nextra-theme-docs'; + +# Client Brand + +Lunar Client can be detected by checking the Minecraft client brand sent to the server. This allows you to detect and track Lunar Client players, if you're unable to use the full +[Apollo](/apollo/introduction) integration. + + + This is not a cryptographically secure detection method. Malicious clients can spoof the client brand sent to the server. + + +## Brand Format + +The client brand is sent as a comma-delimited list of identifiers. For example: `lunarclient:,fabric` + +The first identifier is always `lunarclient:`, where `` is the Lunar Client build that the user is running. Additional identifiers may be appended to indicate other mod loaders or relevant context. See the next section for info about the version format. + + + **Format Change:** Previously, the client brand was sent as a single string (`lunarclient:`). This change aligns the Lunar Client brand format with other modern mod loaders such as Fabric and Forge, improving compatibility with mods and plugins that rely on client branding to detect mod loaders. + + +## Version Format + +We do not provide any guarantees about the exact format of the version, and it may change without notice. An unexpected version format does not mean that a user is running an +unofficial build of Lunar Client. The version will be visible on the Minecraft F3 menu, and in the window title, in addition to being present in the client brand. + +Most, but not all, users will have a version in the format of `v..-`. For example, `v2.12.0-2349` is version `v2.12.0`, which +was built in the 49th week of 2023. From 26fc2fcf7a8a81abf974db568c6312012fecfe72 Mon Sep 17 00:00:00 2001 From: Connor Lewis <50084106+imconnorngl@users.noreply.github.com> Date: Tue, 2 Dec 2025 16:44:36 +0000 Subject: [PATCH 2/2] chore: include a date --- client-brand.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/client-brand.mdx b/client-brand.mdx index 607f5be..758ed45 100644 --- a/client-brand.mdx +++ b/client-brand.mdx @@ -16,7 +16,7 @@ The client brand is sent as a comma-delimited list of identifiers. For example: The first identifier is always `lunarclient:`, where `` is the Lunar Client build that the user is running. Additional identifiers may be appended to indicate other mod loaders or relevant context. See the next section for info about the version format. - **Format Change:** Previously, the client brand was sent as a single string (`lunarclient:`). This change aligns the Lunar Client brand format with other modern mod loaders such as Fabric and Forge, improving compatibility with mods and plugins that rely on client branding to detect mod loaders. + **Format Change:** As of 1st December 2025, the client brand was sent as a single string (`lunarclient:`). This change aligns the Lunar Client brand format with other modern mod loaders such as Fabric and Forge, improving compatibility with mods and plugins that rely on client branding to detect mod loaders. ## Version Format