New VitePress and design look + little work on update to work with.

2026-07-13 02:15:00 +00:00 · 2026-06-16 12:31:19 +01:00
parent 0ed2597186
commit 97a7aaf643
141 changed files with 4356 additions and 539 deletions
@@ -1,70 +1,147 @@
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-*$py.class
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*

-# C extensions
-*.so
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json

-# Distribution / packaging
-.Python
-env/
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
 node_modules/
-parts/
-sdist/
-var/
-package*.json
-*.egg-info/
-.installed.cfg
-*.egg
+jspm_packages/

-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/

-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
+# TypeScript cache
+*.tsbuildinfo

-# Unit test / coverage reports
-htmlcov/
-.tox/
-.coverage
-.coverage.*
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.*
+!.env.example
+
+# parcel-bundler cache (https://parceljs.org/)
 .cache
-nosetests.xml
-coverage.xml
-*,cover
-.hypothesis/
+.parcel-cache

-# Translations
-*.mo
+# Next.js build output
+.next
+out

-# Scrapy stuff:
-.scrapy
+# Nuxt.js build / generate output
+.nuxt
+dist
+.output

-# PyBuilder
-target/
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public

-# IPython Notebook
-.ipynb_checkpoints
+# vuepress build output
+.vuepress/dist

-# pyenv
-.python-version
+# vuepress v2.x temp directory
+.temp

-# virtualenv
-venv/
-ENV/
+# Sveltekit cache directory
+.svelte-kit/

-# MkDocs documentation
-site*/
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# Firebase cache directory
+.firebase/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# pnpm
+.pnpm-store
+
+# yarn v3
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Vite files
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*
+.vite/
+
+# Vitepress files
+docs/.vitepress/dist
+docs/.vitepress/cache
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -0,0 +1,234 @@
+import { defineConfig, type DefaultTheme } from 'vitepress'
+import { tabsMarkdownPlugin } from 'vitepress-plugin-tabs'
+import container from 'markdown-it-container'
+import type Token from 'markdown-it/lib/token.mjs'
+import enTranslations from '../en/nav-translations.json'
+import deTranslations from '../de/nav-translations.json'
+import frTranslations from '../fr/nav-translations.json'
+import esTranslations from '../es/nav-translations.json'
+import itTranslations from '../it/nav-translations.json'
+import ruTranslations from '../ru/nav-translations.json'
+import zhTranslations from '../zh/nav-translations.json'
+
+type LocaleKey = 'root' | 'de' | 'fr' | 'es' | 'it' | 'ru' | 'zh'
+
+type NavItem = {
+  text: string
+  link?: string
+  items?: NavItem[]
+}
+
+type TranslationMap = Record<string, string>
+
+const localeBasePath: Record<LocaleKey, string> = {
+  root: '',
+  de: '/de/',
+  fr: '/fr/',
+  es: '/es/',
+  it: '/it/',
+  ru: '/ru/',
+  zh: '/zh/'
+}
+
+const translations: Record<LocaleKey, TranslationMap> = {
+  root: enTranslations as TranslationMap,
+  de: deTranslations as TranslationMap,
+  fr: frTranslations as TranslationMap,
+  es: esTranslations as TranslationMap,
+  it: itTranslations as TranslationMap,
+  ru: ruTranslations as TranslationMap,
+  zh: zhTranslations as TranslationMap
+}
+
+const localizeLink = (locale: LocaleKey, link?: string) => {
+  if (!link || link.startsWith('http')) {
+    return link
+  }
+
+  if (locale === 'root') {
+    return `/en/${link === '/' ? '' : link.replace(/^\//, '')}`
+  }
+
+  return `${localeBasePath[locale]}${link === '/' ? '' : link.replace(/^\//, '')}`
+}
+
+const localizeItems = (locale: LocaleKey, items: NavItem[]): DefaultTheme.NavItem[] => {
+  return items.map((item) => {
+    const localized: Record<string, unknown> = {
+      text: translations[locale][item.text] ?? item.text
+    }
+
+    if (item.link) {
+      localized.link = localizeLink(locale, item.link)
+    }
+
+    if (item.items) {
+      localized.items = localizeItems(locale, item.items)
+    }
+
+    return localized as unknown as DefaultTheme.NavItem
+  })
+}
+
+const baseNav: NavItem[] = [
+  { text: 'Home', link: '/' },
+  {
+    text: 'Support',
+    items: [
+      { text: 'Playing BeamMP', link: '/game/getting-started' },
+      { text: 'Running a BeamMP-Server', link: '/server/create-a-server' },
+      { text: 'Mod & Resource Creation', link: '/guides/mod-creation/server/getting-started' }
+    ]
+  },
+  {
+    text: 'FAQ',
+    items: [
+      { text: 'How to check for CGNAT?', link: '/FAQ/How-to-check-for-CGNAT' },
+      { text: 'Where can I find my IP address?', link: '/FAQ/where-to-find-my-IP' },
+      { text: 'How to remove mods?', link: '/FAQ/Clearing-mods' },
+      { text: 'Manually updating the Launcher', link: '/FAQ/Update-launcher' },
+      { text: 'Changing the Launcher port', link: '/FAQ/Change-launcher-port' },
+      { text: 'Creating Exclusions (Defender)', link: '/FAQ/Defender-exclusions' },
+      { text: 'Player FAQ', link: '/FAQ/player-faq' },
+      { text: 'Game FAQ', link: '/FAQ/game-faq' },
+      { text: 'Server FAQ', link: '/FAQ/server-faq' }
+    ]
+  },
+  {
+    text: 'Development Guides',
+    items: [
+      { text: 'Development Environment Setup', link: '/guides/beammp-dev/beammp-dev' },
+      {
+        text: 'Mod Creation',
+        items: [{ text: 'Client Scripting Reference', link: '/scripting/mod-reference' }]
+      },
+      {
+        text: 'Resource Creation',
+        items: [{ text: 'Server Resources', link: '/guides/mod-creation/server/getting-started' }]
+      },
+      {
+        text: 'Scripting Reference',
+        items: [
+          { text: 'Mod (In-Game)', link: '/scripting/mod-reference' },
+          {
+            text: 'Server',
+            link: '/scripting/server/latest-server-reference',
+            items: [
+              { text: 'Version 3.X (Latest)', link: '/scripting/server/latest-server-reference' },
+              { text: 'Version 2.X (Deprecated)', link: '/scripting/server/v2-server-reference' }
+            ]
+          }
+        ]
+      }
+    ]
+  },
+  {
+    text: 'BeamNG Documentation',
+    items: [
+      {
+        text: 'Content Development',
+        items: [
+          { text: 'Introduction', link: '/beamng/dev/index' },
+          {
+            text: 'Programming',
+            items: [
+              { text: 'UI Apps (HTML)', link: '/beamng/dev/modding/ui-apps' },
+              { text: 'ImGui Window Tutorial', link: '/beamng/dev/modding/imgui-window-tutorial' },
+              { text: 'Lua Mods (Scripts)', link: '/beamng/dev/modding/lua-mods' }
+            ]
+          },
+          {
+            text: 'Content',
+            items: [
+              { text: 'Maps', link: '/beamng/dev/content/maps' },
+              { text: 'Props', link: '/beamng/dev/content/props' },
+              { text: 'Vehicles', link: '/beamng/dev/content/vehicles' }
+            ]
+          }
+        ]
+      },
+      { text: 'Lua Code Snippets', link: '/beamng/lua-snippets' },
+      { text: 'CSS Code Snippets', link: '/beamng/css-snippets' },
+      { text: 'ImGui Code Snippets', link: '/beamng/imgui-snippets' },
+      { text: 'CEF Code Snippets', link: '/beamng/cef-snippets' }
+    ]
+  },
+  {
+    text: 'Community',
+    items: [
+      { text: 'General Information', link: '/community/index' },
+      { text: 'Rules', link: '/community/rules' },
+      { text: 'Contributing', link: '/contributing' }
+    ]
+  }
+]
+
+const localeNav = (locale: LocaleKey) => localizeItems(locale, baseNav)
+
+const localeSidebar = (locale: LocaleKey) => localizeItems(locale, baseNav)
+
+const makeLocale = (locale: LocaleKey, label: string, lang: string, link?: string) => ({
+  label,
+  lang,
+  ...(link ? { link } : {}),
+  themeConfig: {
+    nav: localeNav(locale) as DefaultTheme.NavItem[],
+    sidebar: localeSidebar(locale) as DefaultTheme.SidebarItem[]
+  }
+})
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  title: 'BeamMP Docs',
+  description:
+    'This website serves as the new BeamMP Documentation site for general self serve support, guides and documentation.',
+  lastUpdated: true,
+  locales: {
+    root: makeLocale('root', 'English', 'en', '/en/'),
+    de: makeLocale('de', 'Deutsch', 'de', '/de/'),
+    fr: makeLocale('fr', 'Français', 'fr', '/fr/'),
+    es: makeLocale('es', 'Español', 'es', '/es/'),
+    it: makeLocale('it', 'Italiano', 'it', '/it/'),
+    ru: makeLocale('ru', 'Pусский', 'ru', '/ru/'),
+    zh: makeLocale('zh', '中文', 'zh', '/zh/')
+  },
+  markdown: {
+    config(md) {
+      md.use(tabsMarkdownPlugin)
+
+      const makeContainer = (type: string, defaultTitle: string) => [
+        container,
+        type,
+        {
+          render(tokens: Token[], idx: number) {
+            const token = tokens[idx]
+            const info = token.info.trim().slice(type.length).trim()
+            const title = info || defaultTitle
+            if (token.nesting === 1) {
+              return `<div class="custom-block ${type}"><p class="custom-block-title">${title}</p>\n`
+            }
+            return '</div>\n'
+          }
+        }
+      ] as const
+
+      md.use(...makeContainer('note', 'NOTE'))
+      md.use(...makeContainer('quote', 'QUOTE'))
+    },
+  },
+  sitemap: {
+    hostname: 'https://example.com'
+  },
+  themeConfig: {
+    editLink: {
+      pattern: 'https://github.com/beammp/docs/edit/main/docs/:path'
+    },
+    logo: {
+      light: '/assets/core/beammp_dark.png',
+      dark: '/assets/core/beammp_light.png'
+    },
+    search: {
+      provider: 'local'
+    }
+  }
+})
@@ -0,0 +1,146 @@
+<script setup lang="ts">
+import { Github, Facebook, Instagram, createLucideIcon } from 'lucide-vue-next'
+
+const currentYear = new Date().getFullYear()
+
+const XIcon = createLucideIcon('X', [
+  [
+    'path',
+    {
+      d: 'M18.901 1.153h3.68l-8.04 9.19L24 22.846h-7.406l-5.8-7.584-6.638 7.584H.474l8.6-9.83L0 1.154h7.594l5.243 6.932ZM17.61 20.644h2.039L6.486 3.24H4.298Z',
+      stroke: 'none',
+      fill: 'currentColor'
+    }
+  ]
+])
+
+const BlueskyIcon = createLucideIcon('Bluesky', [
+  [
+    'path',
+    {
+      d: 'M5.202 2.857C7.954 4.922 10.913 9.11 12 11.358c1.087-2.247 4.046-6.436 6.798-8.501C20.783 1.366 24 .213 24 3.883c0 .732-.42 6.156-.667 7.037-.856 3.061-3.978 3.842-6.755 3.37 4.854.826 6.089 3.562 3.422 6.299-5.065 5.196-7.28-1.304-7.847-2.97-.104-.305-.152-.448-.153-.327 0-.121-.05.022-.153.327-.568 1.666-2.782 8.166-7.847 2.97-2.667-2.737-1.432-5.473 3.422-6.3-2.777.473-5.899-.308-6.755-3.369C.42 10.04 0 4.615 0 3.883c0-3.67 3.217-2.517 5.202-1.026',
+      stroke: 'none',
+      fill: 'currentColor'
+    }
+  ]
+])
+
+const RedditIcon = createLucideIcon('Reddit', [
+  [
+    'path',
+    {
+      d: 'M12 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0zm5.01 4.744c.688 0 1.25.561 1.25 1.249a1.25 1.25 0 0 1-2.498.056l-2.597-.547-.8 3.747c1.824.07 3.48.632 4.674 1.488.308-.309.73-.491 1.207-.491.968 0 1.754.786 1.754 1.754 0 .716-.435 1.333-1.01 1.614a3.111 3.111 0 0 1 .042.52c0 2.694-3.13 4.87-7.004 4.87-3.874 0-7.004-2.176-7.004-4.87 0-.183.015-.366.043-.534A1.748 1.748 0 0 1 4.028 12c0-.968.786-1.754 1.754-1.754.463 0 .898.196 1.207.49 1.207-.883 2.878-1.43 4.744-1.487l.885-4.182a.342.342 0 0 1 .14-.197.35.35 0 0 1 .238-.042l2.906.617a1.214 1.214 0 0 1 1.108-.701zM9.25 12C8.561 12 8 12.562 8 13.25c0 .687.561 1.248 1.25 1.248.687 0 1.248-.561 1.248-1.249 0-.688-.561-1.249-1.249-1.249zm5.5 0c-.687 0-1.248.561-1.248 1.25 0 .687.561 1.248 1.249 1.248.688 0 1.249-.561 1.249-1.249 0-.687-.562-1.249-1.25-1.249zm-5.466 3.99a.327.327 0 0 0-.231.094.33.33 0 0 0 0 .463c.842.842 2.484.913 2.961.913.477 0 2.105-.056 2.961-.913a.361.361 0 0 0 .029-.463.33.33 0 0 0-.464 0c-.547.533-1.684.73-2.512.73-.828 0-1.979-.196-2.512-.73a.326.326 0 0 0-.232-.095z',
+      stroke: 'none',
+      fill: 'currentColor'
+    }
+  ]
+])
+
+const DiscordIcon = createLucideIcon('Discord', [
+  [
+    'path',
+    {
+      d: 'M20.317 4.37a19.791 19.791 0 0 0-4.885-1.515.074.074 0 0 0-.079.037c-.21.375-.444.864-.608 1.25a18.27 18.27 0 0 0-5.487 0 12.64 12.64 0 0 0-.617-1.25.077.077 0 0 0-.079-.037A19.736 19.736 0 0 0 3.677 4.37a.07.07 0 0 0-.032.027C.533 9.046-.32 13.58.099 18.057a.082.082 0 0 0 .031.057 19.9 19.9 0 0 0 5.993 3.03.078.078 0 0 0 .084-.028 14.09 14.09 0 0 0 1.226-1.994.076.076 0 0 0-.041-.106 13.107 13.107 0 0 1-1.872-.892.077.077 0 0 1-.008-.128 10.2 10.2 0 0 0 .372-.292.074.074 0 0 1 .077-.01c3.928 1.793 8.18 1.793 12.062 0a.074.074 0 0 1 .078.01c.12.098.246.198.373.292a.077.077 0 0 1-.006.127 12.299 12.299 0 0 1-1.873.892.077.077 0 0 0-.041.107c.36.698.772 1.362 1.225 1.993a.076.076 0 0 0 .084.028 19.839 19.839 0 0 0 6.002-3.03.077.077 0 0 0 .032-.054c.5-5.177-.838-9.674-3.549-13.66a.061.061 0 0 0-.031-.03zM8.02 15.33c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.956-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.956 2.418-2.157 2.418zm7.975 0c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.955-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.946 2.418-2.157 2.418z',
+      stroke: 'none',
+      fill: 'currentColor'
+    }
+  ]
+])
+
+const YouTubeIcon = createLucideIcon('YouTube', [
+  [
+    'path',
+    {
+      d: 'M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z',
+      stroke: 'none',
+      fill: 'currentColor'
+    }
+  ]
+])
+
+const TikTokIcon = createLucideIcon('TikTok', [
+  [
+    'path',
+    {
+      d: 'M12.525.02c1.31-.02 2.61-.01 3.91-.02.08 1.53.63 3.09 1.75 4.17 1.12 1.11 2.7 1.62 4.24 1.79v4.03c-1.44-.05-2.89-.35-4.2-.97-.57-.26-1.1-.59-1.62-.93-.01 2.92.01 5.84-.02 8.75-.08 1.4-.54 2.79-1.35 3.94-1.31 1.92-3.58 3.17-5.91 3.21-1.43.08-2.86-.31-4.08-1.03-2.02-1.19-3.44-3.37-3.65-5.71-.02-.5-.03-1-.01-1.49.18-1.9 1.12-3.72 2.58-4.96 1.66-1.44 3.98-2.13 6.15-1.72.02 1.48-.04 2.96-.04 4.44-.99-.32-2.15-.23-3.02.37-.63.41-1.11 1.04-1.36 1.75-.21.51-.15 1.07-.14 1.61.24 1.64 1.82 3.02 3.5 2.87 1.12-.01 2.19-.66 2.77-1.61.19-.33.4-.67.41-1.06.1-1.79.06-3.57.07-5.36.01-4.03-.01-8.05.02-12.07z',
+      stroke: 'none',
+      fill: 'currentColor'
+    }
+  ]
+])
+
+const socials = [
+  { label: 'GitHub', href: 'https://github.com/BeamMP', icon: Github },
+  { label: 'Discord', href: 'https://discord.gg/beammp', icon: DiscordIcon },
+  { label: 'YouTube', href: 'https://www.youtube.com/@beammpofficial', icon: YouTubeIcon },
+  { label: 'X', href: 'https://x.com/beammpofficial', icon: XIcon },
+  { label: 'Reddit', href: 'https://www.reddit.com/r/BeamMP', icon: RedditIcon },
+  { label: 'Bluesky', href: 'https://bsky.app/profile/beammp.com', icon: BlueskyIcon },
+  { label: 'Instagram', href: 'https://www.instagram.com/beammpofficial', icon: Instagram },
+  { label: 'TikTok', href: 'https://www.tiktok.com/@beammpofficial', icon: TikTokIcon },
+  { label: 'Facebook', href: 'https://www.facebook.com/BeamMPTeam', icon: Facebook }
+] as const
+</script>
+
+<template>
+  <footer class="bm-footer">
+    <div class="bm-footer__inner">
+      <div class="bm-footer__socials">
+        <a
+          v-for="social in socials"
+          :key="social.label"
+          :href="social.href"
+          target="_blank"
+          rel="noopener noreferrer"
+          :aria-label="social.label"
+          class="bm-footer__social-link"
+        >
+          <component :is="social.icon" aria-hidden="true" />
+        </a>
+        <span class="bm-footer__divider" aria-hidden="true">|</span>
+        <a
+          href="https://www.patreon.com/BeamMP"
+          target="_blank"
+          rel="noopener noreferrer"
+          class="bm-footer__patreon"
+        >
+          Support on Patreon
+        </a>
+      </div>
+
+      <div class="bm-footer__legal">
+        <p class="bm-footer__copyright">
+          © 2019 - {{ currentYear }} | BeamMP Mod Team All Rights Reserved
+        </p>
+        <div class="bm-footer__links">
+          <a
+            href="https://beammp.com/about"
+            target="_blank"
+            rel="noopener noreferrer"
+            class="bm-footer__legal-link"
+          >
+            About
+          </a>
+          <span aria-hidden="true">·</span>
+          <a
+            href="https://forum.beammp.com/topic/95/privacy-policy-v1-0"
+            target="_blank"
+            rel="noopener noreferrer"
+            class="bm-footer__legal-link"
+          >
+            Privacy Policy
+          </a>
+          <span aria-hidden="true">·</span>
+          <a
+            href="https://forum.beammp.com/topic/94/terms-of-use-v1-0"
+            target="_blank"
+            rel="noopener noreferrer"
+            class="bm-footer__legal-link"
+          >
+            Terms & Conditions
+          </a>
+        </div>
+      </div>
+    </div>
+  </footer>
+</template>
@@ -0,0 +1,407 @@
+:root {
+  /* BeamMP brand tokens */
+  --beammp-orange: #F36D24;
+  --beammp-orange-hover: #c7571a;
+  --beammp-white: #FFFFFF;
+  --beammp-black: #000000;
+  --beammp-gray: #333333;
+  --beammp-green: #1D9749;
+  --beammp-blue: #4470B6;
+  --beammp-neutral: #6B7280;
+
+  /* Radius scale */
+  --radius: 0.5rem;
+  --radius-lg: var(--radius);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-sm: calc(var(--radius) - 4px);
+
+  /* Semantic HSL tokens (values only) */
+  --background: 0 0% 100%;
+  --foreground: 0 0% 12%;
+  --card: 0 0% 100%;
+  --card-foreground: 0 0% 12%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 0 0% 12%;
+  --primary: 23 90% 55%;
+  --primary-foreground: 0 0% 100%;
+  --secondary: 220 43% 49%;
+  --secondary-foreground: 0 0% 100%;
+  --muted: 0 0% 96%;
+  --muted-foreground: 0 0% 35%;
+  --accent: 139 67% 35%;
+  --accent-foreground: 0 0% 100%;
+  --destructive: 0 84% 60%;
+  --destructive-foreground: 0 0% 100%;
+  --border: 0 0% 88%;
+  --input: 0 0% 88%;
+  --ring: 23 90% 55%;
+
+  --chart-1: 23 90% 55%;
+  --chart-2: 217 45% 49%;
+  --chart-3: 139 67% 35%;
+  --chart-4: 32 95% 53%;
+  --chart-5: 262 83% 58%;
+
+  /* Mapped color aliases from requested theme object */
+  --color-background: hsl(var(--background));
+  --color-foreground: hsl(var(--foreground));
+  --color-card: hsl(var(--card));
+  --color-card-foreground: hsl(var(--card-foreground));
+  --color-popover: hsl(var(--popover));
+  --color-popover-foreground: hsl(var(--popover-foreground));
+  --color-primary: hsl(var(--primary));
+  --color-primary-foreground: hsl(var(--primary-foreground));
+  --color-secondary: hsl(var(--secondary));
+  --color-secondary-foreground: hsl(var(--secondary-foreground));
+  --color-muted: hsl(var(--muted));
+  --color-muted-foreground: hsl(var(--muted-foreground));
+  --color-accent: hsl(var(--accent));
+  --color-accent-foreground: hsl(var(--accent-foreground));
+  --color-destructive: hsl(var(--destructive));
+  --color-destructive-foreground: hsl(var(--destructive-foreground));
+  --color-border: hsl(var(--border));
+  --color-input: hsl(var(--input));
+  --color-ring: hsl(var(--ring));
+  --color-chart-1: hsl(var(--chart-1));
+  --color-chart-2: hsl(var(--chart-2));
+  --color-chart-3: hsl(var(--chart-3));
+  --color-chart-4: hsl(var(--chart-4));
+  --color-chart-5: hsl(var(--chart-5));
+
+  /* VitePress theme mapping */
+  --vp-c-brand-1: var(--beammp-orange);
+  --vp-c-brand-2: var(--beammp-orange);
+  --vp-c-brand-3: var(--beammp-orange-hover);
+
+  --vp-c-bg: var(--color-background);
+  --vp-c-bg-alt: var(--color-card);
+  --vp-c-bg-elv: var(--color-popover);
+  --vp-c-text-1: var(--color-foreground);
+  --vp-c-text-2: var(--color-muted-foreground);
+  --vp-c-text-3: hsl(0 0% 50%);
+  --vp-c-border: var(--color-border);
+  --vp-c-divider: var(--color-border);
+
+  --vp-button-brand-bg: var(--beammp-orange);
+  --vp-button-brand-hover-bg: var(--beammp-orange-hover);
+  --vp-button-brand-active-bg: var(--beammp-orange-hover);
+  --vp-button-brand-text: var(--beammp-white);
+  --vp-button-brand-border: transparent;
+
+  /* Custom block border colours (bg & title overridden by direct CSS below) */
+  --vp-custom-block-tip-border: var(--beammp-blue);
+  --vp-custom-block-warning-border: var(--beammp-orange);
+  --vp-custom-block-danger-border: hsl(var(--destructive));
+
+  --vp-nav-height: 64px;
+}
+
+.dark {
+  --beammp-neutral: #9CA3AF;
+  --background: 0 0% 7%;
+  --foreground: 0 0% 96%;
+  --card: 0 0% 10%;
+  --card-foreground: 0 0% 96%;
+  --popover: 0 0% 10%;
+  --popover-foreground: 0 0% 96%;
+  --muted: 0 0% 15%;
+  --muted-foreground: 0 0% 70%;
+  --border: 0 0% 22%;
+  --input: 0 0% 22%;
+
+  --vp-c-bg: var(--color-background);
+  --vp-c-bg-alt: var(--color-card);
+  --vp-c-bg-elv: var(--color-popover);
+  --vp-c-text-1: var(--color-foreground);
+  --vp-c-text-2: var(--color-muted-foreground);
+  --vp-c-border: var(--color-border);
+  --vp-c-divider: var(--color-border);
+}
+
+.VPButton.medium.brand,
+.VPButton.brand {
+  border-radius: var(--radius-md);
+}
+
+.VPDoc .VPDocAside .content,
+.VPDoc .VPDocOutlineDropdown,
+.vp-doc div[class*='language-'] {
+  border-radius: var(--radius-lg);
+}
+
+/* ============================================================
+   Admonitions / Custom Blocks  —  MkDocs Material style
+   ============================================================ */
+
+/* Strip default VitePress padding; layout is managed per-element */
+.vp-doc .custom-block {
+  padding: 0;
+  border-left-width: 4px;
+  border-left-style: solid;
+  border-radius: var(--radius-lg);
+  overflow: hidden;
+}
+
+/* Header band */
+.vp-doc .custom-block .custom-block-title {
+  display: flex;
+  align-items: center;
+  gap: 0.5em;
+  margin: 0;
+  padding: 0.45rem 0.75rem;
+  font-size: 0.75rem;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+  line-height: 1.4;
+}
+
+/* Icon via ::before mask */
+.vp-doc .custom-block .custom-block-title::before {
+  content: '';
+  display: inline-block;
+  flex-shrink: 0;
+  width: 1rem;
+  height: 1rem;
+  -webkit-mask-repeat: no-repeat;
+  mask-repeat: no-repeat;
+  -webkit-mask-position: center;
+  mask-position: center;
+  -webkit-mask-size: contain;
+  mask-size: contain;
+}
+
+/* Body: pad all direct children that aren't the title */
+.vp-doc .custom-block > *:not(.custom-block-title) {
+  padding-left: 1rem;
+  padding-right: 1rem;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+.vp-doc .custom-block > .custom-block-title + * {
+  padding-top: 0.75rem;
+}
+
+.vp-doc .custom-block > *:not(.custom-block-title):last-child {
+  padding-bottom: 0.75rem;
+}
+
+/* details: hide native disclosure triangle; animate chevron icon */
+.vp-doc .custom-block.details > summary {
+  cursor: pointer;
+  list-style: none;
+}
+
+.vp-doc .custom-block.details > summary::-webkit-details-marker,
+.vp-doc .custom-block.details > summary::marker {
+  display: none;
+}
+
+.vp-doc .custom-block.details > summary.custom-block-title::before {
+  transition: transform 0.2s ease;
+}
+
+.vp-doc .custom-block.details[open] > summary.custom-block-title::before {
+  transform: rotate(90deg);
+}
+
+/* ---- info (blue) ---- */
+.vp-doc .custom-block.info {
+  border-color: var(--beammp-blue);
+  background-color: color-mix(in srgb, var(--beammp-blue) 5%, transparent);
+}
+
+.vp-doc .custom-block.info .custom-block-title {
+  background-color: color-mix(in srgb, var(--beammp-blue) 14%, transparent);
+  color: var(--beammp-blue);
+}
+
+.vp-doc .custom-block.info .custom-block-title::before {
+  background-color: var(--beammp-blue);
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10a10 10 0 0 0 10-10A10 10 0 0 0 12 2z'/%3E%3C/svg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10a10 10 0 0 0 10-10A10 10 0 0 0 12 2z'/%3E%3C/svg%3E");
+}
+
+/* ---- tip (green) ---- */
+.vp-doc .custom-block.tip {
+  border-color: var(--beammp-green);
+  background-color: color-mix(in srgb, var(--beammp-green) 5%, transparent);
+}
+
+.vp-doc .custom-block.tip .custom-block-title {
+  background-color: color-mix(in srgb, var(--beammp-green) 14%, transparent);
+  color: var(--beammp-green);
+}
+
+.vp-doc .custom-block.tip .custom-block-title::before {
+  background-color: var(--beammp-green);
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M9 21c0 .55.45 1 1 1h4c.55 0 1-.45 1-1v-1H9v1zm3-19C8.14 2 5 5.14 5 9c0 2.38 1.19 4.47 3 5.74V17c0 .55.45 1 1 1h6c.55 0 1-.45 1-1v-2.26c1.81-1.27 3-3.36 3-5.74 0-3.86-3.14-7-7-7z'/%3E%3C/svg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M9 21c0 .55.45 1 1 1h4c.55 0 1-.45 1-1v-1H9v1zm3-19C8.14 2 5 5.14 5 9c0 2.38 1.19 4.47 3 5.74V17c0 .55.45 1 1 1h6c.55 0 1-.45 1-1v-2.26c1.81-1.27 3-3.36 3-5.74 0-3.86-3.14-7-7-7z'/%3E%3C/svg%3E");
+}
+
+/* ---- warning (orange) ---- */
+.vp-doc .custom-block.warning {
+  border-color: var(--beammp-orange);
+  background-color: color-mix(in srgb, var(--beammp-orange) 5%, transparent);
+}
+
+.vp-doc .custom-block.warning .custom-block-title {
+  background-color: color-mix(in srgb, var(--beammp-orange) 14%, transparent);
+  color: var(--beammp-orange);
+}
+
+.vp-doc .custom-block.warning .custom-block-title::before {
+  background-color: var(--beammp-orange);
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M13 14h-2v-4h2m0 8h-2v-2h2M1 21h22L12 2L1 21z'/%3E%3C/svg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M13 14h-2v-4h2m0 8h-2v-2h2M1 21h22L12 2L1 21z'/%3E%3C/svg%3E");
+}
+
+/* ---- danger (red) ---- */
+.vp-doc .custom-block.danger {
+  border-color: hsl(var(--destructive));
+  background-color: color-mix(in srgb, hsl(var(--destructive)) 5%, transparent);
+}
+
+.vp-doc .custom-block.danger .custom-block-title {
+  background-color: color-mix(in srgb, hsl(var(--destructive)) 14%, transparent);
+  color: hsl(var(--destructive));
+}
+
+.vp-doc .custom-block.danger .custom-block-title::before {
+  background-color: hsl(var(--destructive));
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M7 2v11h3v9l7-12h-4l4-8z'/%3E%3C/svg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M7 2v11h3v9l7-12h-4l4-8z'/%3E%3C/svg%3E");
+}
+
+/* ---- details (neutral, collapsible) ---- */
+.vp-doc .custom-block.details {
+  border-color: var(--vp-c-border);
+  background-color: var(--vp-c-bg-alt);
+}
+
+.vp-doc .custom-block.details .custom-block-title {
+  background-color: var(--vp-c-bg-elv);
+  color: var(--vp-c-text-2);
+}
+
+.vp-doc .custom-block.details .custom-block-title::before {
+  background-color: var(--vp-c-text-2);
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M8.59 16.58L13.17 12L8.59 7.41L10 6l6 6l-6 6l-1.41-1.42z'/%3E%3C/svg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M8.59 16.58L13.17 12L8.59 7.41L10 6l6 6l-6 6l-1.41-1.42z'/%3E%3C/svg%3E");
+}
+
+/* ---- note (gray) ---- */
+.vp-doc .custom-block.note {
+  border-color: var(--beammp-neutral);
+  background-color: color-mix(in srgb, var(--beammp-neutral) 5%, transparent);
+}
+
+.vp-doc .custom-block.note .custom-block-title {
+  background-color: color-mix(in srgb, var(--beammp-neutral) 14%, transparent);
+  color: var(--beammp-neutral);
+}
+
+.vp-doc .custom-block.note .custom-block-title::before {
+  background-color: var(--beammp-neutral);
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8l-6-6zm-1 1.5L18.5 9H13V3.5zM6 20V4h5v7h7v9H6z'/%3E%3C/svg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8l-6-6zm-1 1.5L18.5 9H13V3.5zM6 20V4h5v7h7v9H6z'/%3E%3C/svg%3E");
+}
+
+/* ---- quote (gray) ---- */
+.vp-doc .custom-block.quote {
+  border-color: var(--beammp-neutral);
+  background-color: color-mix(in srgb, var(--beammp-neutral) 5%, transparent);
+}
+
+.vp-doc .custom-block.quote .custom-block-title {
+  background-color: color-mix(in srgb, var(--beammp-neutral) 14%, transparent);
+  color: var(--beammp-neutral);
+}
+
+.vp-doc .custom-block.quote .custom-block-title::before {
+  background-color: var(--beammp-neutral);
+  -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M6 17h3l2-4V7H5v6h3zm8 0h3l2-4V7h-6v6h3z'/%3E%3C/svg%3E");
+  mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M6 17h3l2-4V7H5v6h3zm8 0h3l2-4V7h-6v6h3z'/%3E%3C/svg%3E");
+}
+
+.bm-footer {
+  border-top: 1px solid var(--vp-c-divider);
+  margin-top: 2rem;
+}
+
+.bm-footer__inner {
+  max-width: 1152px;
+  margin: 0 auto;
+  padding: 1.25rem 1rem;
+}
+
+.bm-footer__socials {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+  align-items: center;
+  justify-content: center;
+}
+
+.bm-footer__social-link {
+  color: var(--vp-c-text-2);
+  transition: color 0.2s ease;
+}
+
+.bm-footer__social-link:hover {
+  color: var(--beammp-blue);
+}
+
+.bm-footer__social-link svg {
+  width: 1.15rem;
+  height: 1.15rem;
+  display: block;
+}
+
+.bm-footer__divider {
+  color: var(--vp-c-text-3);
+}
+
+.bm-footer__patreon {
+  color: var(--beammp-orange);
+  font-size: 0.8rem;
+  text-decoration: none;
+}
+
+.bm-footer__patreon:hover {
+  text-decoration: underline;
+  color: var(--beammp-orange-hover);
+}
+
+.bm-footer__legal {
+  margin-top: 0.85rem;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 0.35rem;
+  color: var(--vp-c-text-2);
+  font-size: 0.78rem;
+}
+
+.bm-footer__copyright {
+  margin: 0;
+  text-align: center;
+}
+
+.bm-footer__links {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  align-items: center;
+  gap: 0.45rem;
+}
+
+.bm-footer__legal-link {
+  color: var(--vp-c-text-2);
+  text-decoration: none;
+}
+
+.bm-footer__legal-link:hover {
+  color: var(--beammp-blue);
+}
@@ -0,0 +1,18 @@
+import type { Theme } from 'vitepress'
+import DefaultTheme from 'vitepress/theme'
+import { h } from 'vue'
+import { enhanceAppWithTabs } from 'vitepress-plugin-tabs/client'
+import AppFooter from './components/AppFooter.vue'
+import './custom.css'
+
+export default {
+  extends: DefaultTheme,
+  Layout: () => {
+    return h(DefaultTheme.Layout, null, {
+      'layout-bottom': () => h(AppFooter)
+    })
+  },
+  enhanceApp({ app }) {
+    enhanceAppWithTabs(app)
+  },
+} satisfies Theme
@@ -2,14 +2,15 @@

 In BeamMP stellt der Server, mit dem du dich verbindest, die notwendigen Mods bereit. Diese werden beim Verbinden automatisch heruntergeladen und aktiviert. Sind lokale Mods installiert und aktiviert, funktioniert BeamMP oft nicht richtig, selbst wenn du nur einen zusätzlichen Mod neben BeamMP hast.

-!!! warning
+::: warning

    Entferne alle Mods, die du im Ordner BeamNG.Drive\content\ oder in Unterordnern abgelegt hast. Dieser Speicherort ist NICHT für die Installation von Mods vorgesehen und kann zu Problemen führen, wie in der Datei `DO_NOT_INSTALL_MODS_HERE.txt` im selben Verzeichnis beschrieben.

-    !!! quote "DO_NOT_INSTALL_MODS_HERE.txt"
+    ::: quote "DO_NOT_INSTALL_MODS_HERE.txt"

        Kopiere KEINE Mods in diesen Ordner: Dies kann zu beschädigten Mods, einer langsameren Installation von Updates, einem beschädigten Mod-Manager, einem beschädigten abgesicherten Modus und anderen Problemen führen.
-
+    :::
+:::
 ## Wie deaktiviere/entferne ich meine Mods?

 Es gibt drei Möglichkeiten, mögliche Probleme bei der Verwendung von BeamMP zu lösen.
@@ -32,7 +33,8 @@ Starte anschließend BeamNG.Drive über den BeamMP-Launcher. Im Repository sollt

 Um zwischengespeicherte Mods aus den BeamMP-Verzeichnissen zu entfernen, gehe zum Installationsort deines BeamMP-Launchers. Standardmäßig lautet der Pfad „C:\Benutzer\AppData\BeamMP-Launcher“. Dort findest du den Ordner „Ressourcen“. Lösche diesen Ordner, um alle zwischengespeicherten Mods zu löschen. Dies kann hilfreich sein, wenn du mehr Speicherplatz auf deiner Festplatte benötigst oder veraltete BeamNG-Mods entfernen möchtest.

-!!! question "Meine Einstellungen und Konfigurationen sind weg! Wie kann ich sie wiederherstellen?"
+::: question "Meine Einstellungen und Konfigurationen sind weg! Wie kann ich sie wiederherstellen?"

    Wenn du den Benutzerordner umbenannt hast, wurde das Spiel gezwungen, einen neuen, sauberen Benutzerordner zu erstellen. Du kannst die beiden Ordner „Einstellungen“ und „Fahrzeuge“ aus dem umbenannten Ordner (z. B. 0.34_OLD) in den neu erstellten Ordner kopieren.
    Stelle sicher, dass BeamNG.Drive geschlossen ist, und ersetze alle Elemente am Zielort. Alle Konfigurationen und Einstellungen sollten nun wiederhergestellt sein.
+:::
@@ -1,18 +1,18 @@
 # Wie erstelle ich Ausnahmen für Windows Defender Firewall und Antivirus?

-!!! info
+::: info

 ```
 Bevor Änderungen an der Firewall vorgenommen werden, sollte sichergestellt werden, dass das aktive Netzwerk in den Windows Netzwerk-Einstellungen als "privat" gekennzeichnet ist (vorausgesetzt, das Netzwerk ist tatsächlich ein privates).

-!!! danger ":material-scale-balance: ACHTUNG:"
+::: danger ":material-scale-balance: ACHTUNG:"

    **Firewall-/Defender-Ausnahmen stellen ein Sicherheitsrisiko dar**.

    Es wird vorausgesetzt, dass der/die Leser*in die Risiken versteht, die mit dem Deaktivieren des Virenschutzes für ein Programm und dem Öffnen von Firewall-Ports in seinem/ihrem Heimnetzwerk einhergehen. BeamMP kann für keine daraus resultierenden Schäden jeglicher Art zur Verantwortung gezogen werden.

    Für externe, auf dieser Webseite verlinkte Inhalte wird keine Haftung übernommen.
-```
+:::

 ## 1. Firewall-Ausnahme für den BeamMP-Launcher

@@ -16,7 +16,7 @@ Für eine detaillierte Erklärung, was CGNAT ist und warum es dich am heim-hosti

 Öffne ein Command Prompt, führe `tracert -4 beammp.com` aus. Das wird eine Reihe von Netzwerk-Hops ausgeben. Warte, bis die Operation abgeschlossen ist (kann bis zu 30 Hops dauern). Prüfe die ersten paar IP Adressen nach deinem Router/Modem/Gateway. Wenn mehrere IP Adressen im Block `100.64.x.x`-`100.127.x.x` oder `10.xx.xx.xx` nach dem ersten Hop erscheinen, bist du sehr wahrscheinlich hinter einem CGNAT.

-!!! note
+::: note

    Der erste Hop wird dein Router/Modem/Gateway sein und kann sich zwischen Modellen unterscheiden.
    Die offiziellen Adressblöcke für lokale Netzwerke lauten wie folgt: ``10.0.0.xxx`` - ``192.168.xxx.xxx`` - ```172.16.xxx.xxx``
@@ -29,7 +29,7 @@ Finde die WAN IP auf dem Web-Interface deines Routers. Vergleiche diese mit der

 Rufe deinen Internet Anbieter an für Hilfe. Abhängig von deinem Anbieter, bieten diese möglicherweise garkeine *dynamischen* IP Adressen an. Behalte im Kopf, dass eine statische IP nicht nötig ist.

-!!! warning
+::: warning

    Internet Anbieter bieten eine dedizierte IP Adresse eventuell nur als **bezahlte Option** an.
    Bitte prüfe die Preise unserer Hosting-Partner, weil diese billiger sein könnten als eine statische IP.
@@ -2,11 +2,11 @@

 In BeamMP stellt der Server, mit dem du dich verbindest, die notwendigen Mods bereit. Diese werden beim Verbinden automatisch heruntergeladen und aktiviert. Sind lokale Mods installiert und aktiviert, funktioniert BeamMP oft nicht richtig, selbst wenn du nur einen zusätzlichen Mod neben BeamMP hast.

-!!! warning
+::: warning

    Entferne alle Mods, die du im Ordner BeamNG.Drive\content\ oder in Unterordnern abgelegt hast. Dieser Speicherort ist NICHT für die Installation von Mods vorgesehen und kann zu Problemen führen, wie in der Datei `DO_NOT_INSTALL_MODS_HERE.txt` im selben Verzeichnis beschrieben.

-    !!! quote "DO_NOT_INSTALL_MODS_HERE.txt"
+    ::: quote "DO_NOT_INSTALL_MODS_HERE.txt"

        Kopiere KEINE Mods in diesen Ordner: Dies kann zu beschädigten Mods, einer langsameren Installation von Updates, einem beschädigten Mod-Manager, einem beschädigten abgesicherten Modus und anderen Problemen führen.

@@ -32,7 +32,7 @@ Starte anschließend BeamNG.Drive über den BeamMP-Launcher. Im Repository sollt

 Um zwischengespeicherte Mods aus den BeamMP-Verzeichnissen zu entfernen, gehe zum Installationsort deines BeamMP-Launchers. Standardmäßig lautet der Pfad „C:\Benutzer\AppData\BeamMP-Launcher“. Dort findest du den Ordner „Ressourcen“. Lösche diesen Ordner, um alle zwischengespeicherten Mods zu löschen. Dies kann hilfreich sein, wenn du mehr Speicherplatz auf deiner Festplatte benötigst oder veraltete BeamNG-Mods entfernen möchtest.

-!!! question "Meine Einstellungen und Konfigurationen sind weg! Wie kann ich sie wiederherstellen?"
+::: question "Meine Einstellungen und Konfigurationen sind weg! Wie kann ich sie wiederherstellen?"

    Wenn du den Benutzerordner umbenannt hast, wurde das Spiel gezwungen, einen neuen, sauberen Benutzerordner zu erstellen. Du kannst die beiden Ordner „Einstellungen“ und „Fahrzeuge“ aus dem umbenannten Ordner (z. B. 0.34_OLD) in den neu erstellten Ordner kopieren.
    Stelle sicher, dass BeamNG.Drive geschlossen ist, und ersetze alle Elemente am Zielort. Alle Konfigurationen und Einstellungen sollten nun wiederhergestellt sein.
@@ -1,10 +1,11 @@
-!!! warning "Diese Seite befindet sich im Aufbau!"
+::: warning "Diese Seite befindet sich im Aufbau!"

    An dieser Seite wird aktiv gearbeitet.

    Haben Sie das Gefühl, Sie könnten helfen? Bitte klicken Sie dazu auf das Blatt-mit-Bleistift Symbol auf der rechten Seite!

    Dies kann auch auf jeder anderen Seite erfolgen.
+:::

 # BeamNG.drive-Kartenerstellung

@@ -1,10 +1,11 @@
-!!! warning "Diese Seite befindet sich im Aufbau!"
+::: warning "Diese Seite befindet sich im Aufbau!"

    An dieser Seite wird aktiv gearbeitet.

    Haben Sie das Gefühl, Sie könnten helfen? Bitte klicken Sie dazu auf das Blatt-mit-Bleistift Symbol auf der rechten Seite!

    Dies kann auch auf jeder anderen Seite erfolgen.
+:::

 # Erstellung von BeamNG.drive-Requisiten

@@ -1,10 +1,11 @@
-!!! warning "Diese Seite befindet sich im Aufbau!"
+::: warning "Diese Seite befindet sich im Aufbau!"

    An dieser Seite wird aktiv gearbeitet.

    Haben Sie das Gefühl, Sie könnten helfen? Bitte klicken Sie dazu auf das Blatt-mit-Bleistift Symbol auf der rechten Seite!

    Dies kann auch auf jeder anderen Seite erfolgen.
+:::

 # BeamNG.drive Fahrzeugerstellung

@@ -1,9 +1,10 @@
-!!! warning "Diese Seite befindet sich im Aufbau!"
+::: warning "Diese Seite befindet sich im Aufbau!"

    An dieser Seite wird aktiv gearbeitet.

    Haben Sie das Gefühl, Sie könnten helfen? Bitte klicken Sie dazu auf das Blatt-mit-Bleistift Symbol auf der rechten Seite!

    Dies kann auch auf jeder anderen Seite erfolgen.
+:::

 # Einführung in die BeamNG.drive Entwicklungsumgebung
@@ -1,10 +1,11 @@
-!!! warning "Diese Seite befindet sich im Aufbau!"
+::: warning "Diese Seite befindet sich im Aufbau!"

    An dieser Seite wird aktiv gearbeitet.

    Haben Sie das Gefühl, Sie könnten helfen? Bitte klicken Sie dazu auf das Blatt-mit-Bleistift Symbol auf der rechten Seite!

    Dies kann auch auf jeder anderen Seite erfolgen.
+:::

 # BeamNG.drive Code Ausschnitte

@@ -9,41 +9,47 @@ hide:

 ## Unsere Social Media-Links

-!!!failure ""
+:::failure ""

 ```
 BeamMP Forum - [https://forum.beammp.com](https://forum.beammp.com)
 ```
+:::

-!!!quote ""
+:::quote ""

 ```
 X (Twitter) - [https://x.com/BeamMPOfficial](https://x.com/BeamMPOfficial)
 ```
+:::

-!!!danger ""
+:::danger ""

 ```
 YouTube - [https://www.youtube.com/@BeamMPOfficial](https://www.youtube.com/@BeamMPOfficial)
 ```
+:::

-!!!warning ""
+:::warning ""

 ```
 Patreon - [https://www.patreon.com/c/BeamMP](https://www.patreon.com/c/BeamMP)
 ```
+:::

-!!!note ""
+:::note ""

 ```
 Discord - [https://discord.com/invite/beammp](https://discord.com/invite/beammp)
 ```
+:::

-!!!info ""
+:::info ""

 ```
 BlueSky - [https://bsky.app/profile/beammpofficial.bsky.social](https://bsky.app/profile/beammpofficial.bsky.social)
 ```
+:::

 ## Regeln

@@ -5,7 +5,8 @@ hide:

 # BeamMP Gemeinschafts-Regeln

-!!! info Die Mitwirkenden von BeamMP sind nicht an die strikte Einhaltung dieser Regeln gebunden und können nach eigenem Ermessen handeln. Zusätzlich zu diesen Regeln gelten [die Community-Richtlinien](https://discord.com/guidelines/) und [Nutzungsbedingungen](https://discord.com/terms/) von Discord und werden durchgesetzt.
+::: info Die Mitwirkenden von BeamMP sind nicht an die strikte Einhaltung dieser Regeln gebunden und können nach eigenem Ermessen handeln. Zusätzlich zu diesen Regeln gelten [die Community-Richtlinien](https://discord.com/guidelines/) und [Nutzungsbedingungen](https://discord.com/terms/) von Discord und werden durchgesetzt.
+:::

 ## Allgemeine BeamMP-Regeln (gilt für Discord, Forum und im Spiel)

@@ -48,4 +49,5 @@ hide:

 Alle Einsprüche gegen Sperren werden gründlich untersucht, wobei mindestens zwei (2) Mitglieder des Personals/Moderationsteams, die nicht in den vorliegenden Fall involviert waren, hinzugezogen werden. Der ausstellende Mitarbeiter darf Stellung nehmen, ist aber ansonsten nicht an der Entscheidung über den Einspruch beteiligt. Die Ergebnisse des Einspruchs sind endgültig. BeamMP behält sich das Recht vor, Mitglieder nach eigenem Ermessen gemäß den BeamMP-Community-Regeln (siehe oben), [den Discord-Nutzungsbedingungen](https://discord.com/terms) und anderen Faktoren zuzulassen oder abzulehnen.

-!!! warning: Im Falle von Maßnahmen gegen dich, ist es untersagt, ein neues Discord- oder BeamMP-Konto zu erstellen, um die Sperre zu umgehen.
+::: warning: Im Falle von Maßnahmen gegen dich, ist es untersagt, ein neues Discord- oder BeamMP-Konto zu erstellen, um die Sperre zu umgehen.
+:::
@@ -4,7 +4,7 @@

 BeamMP ist vollständig kompatibel mit Windows und Linux, an der Kompatibilität mit MacOS noch wird gearbeitet. Da es sich bei Linux und MacOS jedoch um sekundäre Plattformen handelt, sind Fehler zu erwarten.

-!!! warning "Warnung"
+::: warning "Warnung"

    BeamMP funktioniert nicht mit Raubkopien oder veralteten Versionen von BeamNG.drive.
    Das BeamMP-Support Team bietet keinen Support für Probleme mit Raubkopien / veralteten Kopien.
@@ -23,9 +23,9 @@ BeamMP ist vollständig kompatibel mit Windows und Linux, an der Kompatibilität
 8. Du wirst aufgefordert, dich anzumelden oder als Gast zu spielen (nicht alle Server erlauben Gäste). Du kannst in unserem [Forum](https://forum.beammp.com) ein Konto erstellen und dich dann mit denselben Anmeldeinformationen bei BeamMP anmelden.
 9. Wählen einen beliebigen Server aus und drücken `Connect` . Viel Spaß!

-!!! note ""
-
-    Wenn du in eine Sitzung mit mehreren bereits gespawnten Autos beitrittst, könnte das Laden eventuell etwas länger dauern.
+::: note
+Wenn du in eine Sitzung mit mehreren bereits gespawnten Autos beitrittst, könnte das Laden eventuell etwas länger dauern.
+:::

 ### **2b. Linux Installation**

@@ -77,15 +77,15 @@ cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cma
 cmake --build bin --parallel
 ```

-!!!note ""
+:::note ""

    Sollte dir während des Erstellens der RAM ausgehen, kannst du die Anweisung --parallel weglassen. Dann wird weniger RAM verwendet, da das Erstellen nur auf einem CPU-Thread erfolgt.

-!!!note ""
+:::note ""

    Wenn du -DCMAKE_BUILD_TYPE=Release nicht spezifizierst, erstellst du eine Debug-Version, die zwar eine größere Dateigröße hat, aber nicht den Fehler „Launcher kann sich nur einmal mit einem Server verbinden" enthält.

-!!!note "Fedora Benutzer"
+:::note "Fedora Benutzer"
    Wenn vcpkg während der OpenSSL-Kompilierung aufgrund von Kernel-Header-Fehlern fehlschlägt, stelle sicher, dass alle Abhängigkeiten installiert sind:
    ```bash
    sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl
@@ -126,7 +126,7 @@ Wenn der symbolische Link zwischen den Benutzerordnern und dem kompilierten Laun

 Beachte, dass hierbei davon ausgegangen wird, dass die Binärdatei des Launchers, die Sie zuvor kompiliert wurde, in `/home/user/BeamMP/` abgelegt wurde. Ändere diese daher so, dass sie mit der Stelle übereinstimmt, an der du die fertige Binärdatei abgelegt hast. Außerdem musst du  den Launcher jedes Mal mit dem richtigen Git-Zweig neu kompilieren, wenn ein Launcher-Update veröffentlicht wird.

-!!! tip "Hinzufügen von emoji-font um in-text emojis zu erhalten"
+::: tip "Hinzufügen von emoji-font um in-text emojis zu erhalten"

    Damit Emojis entweder in der Serverliste (als Teil eines benutzerdefinierten Servernamens) oder im Ingame-Chat angezeigt werden, benötigst du eine Schriftart, die Emojis enthält.

@@ -1,23 +1,48 @@
 ---
-hide:
-  - Navigation
+layout: home
+
+hero:
+  name: BeamMP Dokumentation
+  text: Alles was du wissen musst
+  tagline: Komplette Anleitungen für Spieler, Serverbetreiber und Entwickler
+  image:
+    src: /assets/core/beammp_dark.png
+    alt: BeamMP
+  actions:
+    - theme: brand
+      text: Erste Schritte
+      link: /de/game/getting-started
+    - theme: alt
+      text: View on GitHub
+      link: https://github.com/beammp/docs
+
+features:
+  - icon: 🎮
+    title: Für Spieler
+    details: Erfahren Sie, wie Sie BeamMP installieren, sich mit Servern verbinden und das Beste aus Ihrem Multiplayer-Erlebnis herausholen
+    link: /de/game/getting-started
+  - icon: 🖥️
+    title: Für Serverbetreiber
+    details: Richten Sie Ihren eigenen BeamMP-Server ein und verwalten Sie ihn mit unseren umfassenden Leitfäden und Fehlerbehebungsressourcen
+    link: /de/server/create-a-server
+  - icon: 💻
+    title: Für Entwickler
+    details: Erstellen Sie Mods, Ressourcen und UI-Apps mit detaillierter API-Dokumentation und Codebeispielen
+    link: /de/guides/index
+  - icon: ❓
+    title: FAQ
+    details: Finden Sie schnelle Antworten auf häufig gestellte Fragen zu Setup, Fehlerbehebung und Best Practices
+    link: /de/FAQ/player-faq
+  - icon: 📋
+    title: Gemeinschaftsregeln
+    details: Erfahren Sie mehr über unsere Community-Richtlinien und wie Sie Probleme melden oder Entscheidungen anfechten können
+    link: /de/community/rules
+  - icon: 🔗
+    title: Gemeinschaft
+    details: Treten Sie unserem Discord bei, folgen Sie auf sozialen Medien und verbinden Sie sich mit anderen BeamMP-Spielern und Entwicklern
+    link: /de/community/index
 ---

-!!! warning "Diese Seite befindet sich im Aufbau!"
-
-  Diese Seite steht unter aktiver Bearbeitung.
-  Denkst du, dass du helfen könntest? Das kannst du tun, indem du auf das Editier Symbol auf der rechten Seite klickst!
-  Das trifft auch auf alle anderen Seiten zu.
-
-
-# Willkommen bei BeamMP Docs! :tada:
-
-Willkommen im neuen und verbesserten Dokumentationszentrum für BeamMP! Egal, ob du Spieler, Serverbesitzer oder Entwickler bist, wir haben die Ressourcen, die du benötigst, um dein Mehrspielererlebnis in BeamNG.drive zu optimieren.
-
-## Für Spieler
-
-Neu bei BeamMP? Schau dir unsere [Erste Schritte](../game/getting-started.md) -Seite an, um sofort loszulegen und das Beste aus deinen Multiplayer-Abenteuern herauszuholen. Bei allgemeinen Fragen und Problemen schau dir bitte die [Spieler-FAQ](../FAQ/player-faq.md) an.
-
 ## Für Serverbesitzer

 Du möchtest deinen eigenen BeamMP-Server erstellen? Unsere umfassende Anleitung [hier](../server/create-a-server.md) führt dich durch den Prozess und stellt sicher, dass du alle notwendigen Werkzeuge und Kenntnisse für die effiziente Konfiguration deines Servers zur Verfügung hast.
@@ -0,0 +1,57 @@
+{
+  "Home": "Hauptseite",
+  "Support": "Support",
+  "Playing BeamMP": "BeamMP spielen",
+  "Installing BeamMP": "BeamMP Installation",
+  "Error Codes": "Fehlercodes",
+  "Multiplayer Settings": "Einstellungen anpassen",
+  "Running a BeamMP-Server": "Server ausführen",
+  "Server Installation": "Server Installation",
+  "Port Forwarding": "Portweiterleitung",
+  "Server Maintenance": "Server Wartung",
+  "Server Manual": "Server Handbuch",
+  "Mod & Resource Creation": "Mod- & Ressourcenerstellung",
+  "Client Side": "Clientseite",
+  "Server Side": "Serverseite",
+  "FAQ": "FAQ",
+  "How to check for CGNAT?": "Wie überprüft man auf CGNAT?",
+  "Where can I find my IP address?": "Wo finde ich meine IP Adresse?",
+  "How to remove mods?": "Wie entferne ich Mods?",
+  "Manually updating the Launcher": "Den Launcher manuell updaten",
+  "Changing the Launcher port": "Ändern des Launcher Ports",
+  "Creating Exclusions (Defender)": "Ausnahmen erstellen (Defender)",
+  "Player FAQ": "Spieler-FAQ",
+  "Game FAQ": "Spiel FAQ",
+  "Server FAQ": "Server FAQ",
+  "Development Guides": "Entwicklungsanleitungen",
+  "Development Environment Setup": "Entwicklungsumgebung einrichten",
+  "Mod Creation": "Mod-Erstellung",
+  "Resource Creation": "Ressourcenerstellung",
+  "Client Scripting Reference": "Client-Scripting-Referenz",
+  "Server Resources": "Server-Ressourcen",
+  "BeamNG Documentation": "BeamNG-Dokumentation",
+  "Content Development": "Inhaltsentwicklung",
+  "Introduction": "Einführung",
+  "Programming": "Programmierung",
+  "UI Apps (HTML)": "UI-Apps (HTML)",
+  "ImGui Window Tutorial": "ImGui-Fenster-Tutorial",
+  "Lua Mods (Scripts)": "Lua-Mods (Skripte)",
+  "Content": "Inhalt",
+  "Maps": "Karten",
+  "Props": "Objekte",
+  "Vehicles": "Fahrzeuge",
+  "Lua Code Snippets": "Lua-Code-Snippets",
+  "CSS Code Snippets": "CSS-Code-Snippets",
+  "ImGui Code Snippets": "ImGui-Code-Snippets",
+  "CEF Code Snippets": "CEF-Code-Snippets",
+  "Scripting Reference": "Scripting-Referenz",
+  "Mod (In-Game)": "Mod (Im Spiel)",
+  "Server": "Server",
+  "Version 3.X (Latest)": "Version 3.X (Aktuell)",
+  "Version 2.X (Deprecated)": "Version 2.X (Veraltet)",
+  "Contributing": "Mitwirken",
+  "Getting Started": "Erste Schritte",
+  "Community": "Gemeinschaft",
+  "General Information": "Allgemeine Informationen",
+  "Rules": "Regeln"
+}
@@ -26,13 +26,13 @@ Das Aufsetzen besteht aus folgenden Schritten. Du solltest alle davon durchgehen

 ### **1. Port Weiterleitung**

-!!! info
+::: info

 ```
 Wenn du einen VPS (Virtual Private Server), einen Rootserver nutzt oder planst, diesen Server lokal zu hosten (mit Spielern im selben Haus wie du), kannst du diesen Schritt überspringen.
 Dieser Schritt ist notwendig, wenn, jemand **außerhalb** des Haushalts einem selbst gehosteten Server beitreten soll (außerhalb Ihres lokalen Netzwerks).

-!!! danger :material-scale-balance: HAFTUNGSAUSSCHLUSS:"
+::: danger ":material-scale-balance: HAFTUNGSAUSSCHLUSS:"

 **Portweiterleitung birgt Risiken.**

@@ -74,7 +74,7 @@ Eine detailliertere Anleitung findest du unter [dieser Dokumentationsseite](http

 Der Authentifizierungsschlüssel, auch “Authentication Key” oder “AuthKey” genannt, ist nötig, um einen Öffentlichen Server zu erstellen. Für einen privaten Server benötigst du nicht zwingend einen offiziellen Schlüssel, jedoch darf das Feld in der Konfigurationsdatei nicht leer gelassen werden. Du hast eine limitierte Anzahl an Schlüssel. Ein Schlüssel kann nur für einen Server auf einmal verwendet werden, also kannst du nicht 2 Server mitdemselben Schlüssel starten. Mehr Schlüssel können durch das Unterstützen des Projektes erworben werden. Lies [diesen Artikel](https://docs.beammp.com/support/player-faq/) für mehr Informationen.

-!!! warning "WARNUNG"
+::: warning "WARNUNG"

 ```
  TEILE ODER ZEIGE DEN SCHLÜSSEL NICHT. BEHANDLE IHN WIE EIN PASSWORT.
@@ -187,7 +187,7 @@ Description = "Total Random Beam MP Server"
 ResourceFolder = "Resources"
 ```

-!!! info
+::: info

 ```
  Dies ist deine Konfigurationsdatei. Sie verwendet das Format TOML. Weitere Informationen zu dieser Datei und den Variablen findest du im Abschnitt [Serverwartung](server-maintenance.md).
@@ -216,7 +216,7 @@ Nun führe den Server erneut aus und sieh nach, ob weitere `[ERROR]` oder `[WARN

 Fahrzeug- und Karten-Mods werden unterschiedlich installiert, müssen aber beide im Serverordner ( `Resources/Client` ) abgelegt werden. Ziehe einfach die gewünschten Mods in diesen Ordner.

-!!! warning
+::: warning

 ```
  Solltest du beim Versuch, deinem Server nach dem Hinzufügen von Mods beizutreten, die Meldung „Fertig“ oder „Start“ erhalten, hast du wahrscheinlich eine inkompatible oder fehlerhafte Mod dem Server hinzugefügt.
@@ -279,12 +279,12 @@ Gib unten die öffentliche IPv4-Adresse und den Port des Servers ein und klicke
  <input type="submit" value="CheckBeamMP">
 </form>

-!!! warning "Ich möchte einen VPN wie RadminVPN, Hamachi oder ähnlich verwenden"
+::: warning "Ich möchte einen VPN wie RadminVPN, Hamachi oder ähnlich verwenden"

 ```
  BeamMP unterstützt diese VPNs nicht, weil diese oft Probleme verursachen. Eines davon ist das blockieren von UDP Verkehr. Um dies zu beheben, siehe Sektion 1.

-  !!! question "Aber warum hat es vorher funktioniert?"
+  ::: question "Aber warum hat es vorher funktioniert?"

    Das passiert, weil die Entwickler dieser Applikationen updaten und Änderungen implementiere, über welche BeamMP keine Kontroll hat.
     Es liegt an den Entwicklern diesen Applikationen, um Support für spezifische Fälle wie eines BeamMP-Servers zu unterstützen.
@@ -17,5 +17,5 @@ Code | Beschreibung | Mögliche Lösung
 10064 | Host nicht verfügbar | Unwahrscheinlicher Fehler, aber bedeutet, der Server ist nicht erreichbar.<br>Entweder weil der Server abgeschaltet ist, oder weil die Ports geschlossen wurden.
 10065 | Host nicht erreichbar | Kein Internet oder schlechtes Port Forwarding. Sieh dir die [Anleitung](create-a-server.md#1-port-forwarding) an.

-!!! note
+::: note
    Für codes, welche nicht in der Liste vorkommen, siehe [https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2](https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2) wenn du dich etwas mit Netzwerke / Sockets auskennst.
@@ -1,13 +1,13 @@
 # Port Weiterleitung

-!!! danger ":material-scale-balance: ACHTUNG"
+::: danger ":material-scale-balance: ACHTUNG"

  **Das weiterleiten von Ports ist ein Risiko**.
  Durch die Portweiterleitung bist du dir den Risiken bewusst, die mit der Öffnung von Ports in das öffentliche Netz verbunden sind. Daher verlierst du das Recht, BeamMP für **alle** Schäden haftbar zu machen, die dir oder deinem Haushalt entstehen können.
  Wir übernehmen keine Verantwortung für Inhalte auf extern verlinkten Diensten oder Websites.
  <u>**Wenn du diese Anleitung nicht verstehst, ziehe die Nutzung eines unserer Hosting Partner in Betracht.**</u>

-    !!! warning "Warnung"
+    ::: warning "Warnung"

      Bitte stelle sicher, dass dein Router kein 4G/5G-exklusives Gerät ist. Wenn es sich um ein Hybridgerät handelt, wähle später in Abschnitt 3 dieser Anleitung unbedingt den kabelgebundenen Adapter aus!

@@ -100,7 +100,11 @@ Nachfolgend findest du Beispiele für lokale IPv4-Adressen, die mindestens einer

 Subnetzmaske (höchstwahrscheinlich 255.255.255.0)  Standard-Gateway (höchstwahrscheinlich 192.168.0.1 oder 192.168.1.1)

-!!! Info „Beachte“ BeamMP unterstützt derzeit kein IPv6 zum Hosten eines Servers.
+::: info "Beachte"
+
+BeamMP unterstützt derzeit kein IPv6 zum Hosten eines Servers.
+
+:::

 #### 1.2. Adaptereinstellungen ändern

@@ -181,7 +185,11 @@ Sobald du den Bereich für die Portweiterleitung gefunden hast, kannst du die er

 BeamMP erfordert sowohl UDP- als auch TCP-Port 30814 (es sei denn, du hast diesen in deiner [ServerConfig.toml](create-a-server.md#4-configuration) geändert).

-!!!! info "Hinweis" Der **Standardport** ist **30814.** Du kannst aber auch andere Ports größer als 1024 und kleiner als 65535 wählen. Notiere dir deine Wahl, falls diese nicht 30814 ist. Du musst sowohl **TCP** als auch **UDP** weiterleiten.  Es wird empfohlen, den Standardport beizubehalten, da dieser höchstwahrscheinlich nicht von einem anderen Dienst auf Ihrem PC verwendet wird.  Wenn du jedoch mehrere Server auf einem Rechner hostest, benötigt jeder Server einen anderen Port. Server 1: 30814, Server 2: 30815 zum Beispiel.
+::: info "Hinweis"
+
+Der **Standardport** ist **30814.** Du kannst aber auch andere Ports größer als 1024 und kleiner als 65535 wählen. Notiere dir deine Wahl, falls diese nicht 30814 ist. Du musst sowohl **TCP** als auch **UDP** weiterleiten.  Es wird empfohlen, den Standardport beizubehalten, da dieser höchstwahrscheinlich nicht von einem anderen Dienst auf Ihrem PC verwendet wird.  Wenn du jedoch mehrere Server auf einem Rechner hostest, benötigt jeder Server einen anderen Port. Server 1: 30814, Server 2: 30815 zum Beispiel.
+
+:::

 Auf einigen Routern muss man möglicherweise zwei Regeln erstellen, eine für UDP und eine für TCP, während andere praktisch sind und dir beides mit einer einzigen Regel ermöglichen!

@@ -205,13 +213,13 @@ Dies kann durch die Abfrage deiner öffentlichen IPv4-Adresse erfolgen. Auch hie

 Besuche den folgenden Link und ersetzen Sie "IP" durch deine tatsächliche IPv4-Adresse und "Port" durch den Port deines Servers. Achte darauf, keine Leerzeichen zu hinterlassen. https://check.beammp.com/api/v2/beammp/ip/port

-!!! success "status: ok"
+::: success "status: ok"

  Wenn du die obige Ausgabe erhältst, kannst du des jetzt deinem Server beitreten!
  Es gibt zwei Möglichkeiten, beizutreten: entweder direkt mit den Daten, die du in probablyup eingegeben hast, oder, wenn dein Server auf „öffentlich“ eingestellt ist, über die Serverliste.
  Da du einen Server vor Ort hostest, verwenden 127.0.0.1 (localhost), wenn der Server auf demselben PC läuft, auf dem du spielst, oder die LAN-IPv4 des lokalen Computers, auf dem der Server läuft.

-!!! failure "status: error"
+::: failure "status: error"

  Wenn die Verbindung vollständig fehlschlägt, verwendet dein Anbieter möglicherweise CGNAT (Carrier Grade Network Address Translation). Weitere Informationen findest du unter [Wie kann ich auf CGNAT prüfen?](../FAQ/How-to-check-for-CGNAT.md),
  oder öffne ein Server-Support-Ticket auf unserem [Discord-Server](https://discord.gg/beammp) im Kanal „#support“ und einer unserer Mitarbeiter wird sich um dein Ticket kümmern!
@@ -20,7 +20,7 @@ The result should be a clean new userfolder.
    If you have renamed the userfolder, you forced the game to create a new, clean userfolder. You may copy the 'settings' and 'vehicles' folder from the folder you renamed (e.g. `current_old`) to the new folder it created.
    Make sure BeamNG.Drive is closed and replace all elements in the location you want to copy the folders to. You should now have all configs and settings as they were before.

-    !!! warning "Be careful when moving back files/folders to the new userfolder.
+    ::: warning "Be careful when moving back files/folders to the new userfolder.
           
        If you resolved any issues by renaming the userfolder, moving back the old files may cause any issues you had to possibly re-occur.

@@ -1,10 +1,10 @@
 # How to create exclusions in the Windows Defender Firewall and Antivirus?

-!!! info
+::: info
    
    Before tampering with the firewall, make sure that your network within the windows networking settings is set to private (assuming you are in a private network).

-    !!! danger ":material-scale-balance: DISCLAIMER:"
+    ::: danger ":material-scale-balance: DISCLAIMER:"

        **Firewall / Defender exclsuions are a risk**.

@@ -16,7 +16,7 @@ For a detailed explanation, on what CGNAT is and why it's an issue when trying t
 Open a command prompt, run ``tracert -4 beammp.com``. This will output a series of network hops. Wait for the operation to finish (may take up to 30 hops). Check the first few IP addresses after the IP of your Router/Modem/Gateway.
 If multiple IP addresses within the range of ``100.64.x.x``-``100.127.x.x`` or ``10.xx.xx.xx`` appear after the first hop, you are most likely behind a CGNAT.

-!!! note
+::: note

    The first hop will be your Router/Modem/Gateway and differs between Devices.
    The official ranges for local networks are as follows: ``10.0.0.xxx`` - ``192.168.xxx.xxx`` - ```172.16.xxx.xxx``
@@ -28,7 +28,7 @@ Find out the WAN IP on your router by looking it up on its interface. Compare it
 Call your Internet Service Provider for assistance.
 Depending on your ISP, they might not offer dedicated *dynamic* IP adresses. Keep in mind, that a static IP is not necessary.

-!!! warning
+::: warning

    Internet Service Providers may only offer dedicated IP addresses as a **paid option**.
    Please check the prices of our partnered hosting services as they could be cheaper than this fee!
@@ -3,7 +3,7 @@
 The Launcher can't update or shows a blank screen?
 This quick guide explains how to manually update the Launcher.

-!!! note
+::: note

    You should have already used or installed BeamMP using the installer provided by [our website](https://beammp.com) before continuing.

@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,9 +1,7 @@
-!!! warning "This site is under construction!"
+::: warning This site is under construction!
+This site is being actively worked on. 

-    This site is being actively worked on. 
-    
-    Feel you could help? Please do by clicking on the page with a pencil on the right!
-
-    This can be done any page too.
+Feel you could help? Please do by clicking "Edit this page" at the bottom!
+:::

 # BeamNG.drive Development Introduction
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,11 +1,12 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

-    This site is being actively worked on. 
-    
-    Feel you could help? Please do by clicking on the page with a pencil on the right!
+This site is being actively worked on. 
+
+Feel you could help? Please do by clicking on the page with a pencil on the right!
+
+This can be done any page too.
+:::

-    This can be done any page too.
-    
 # BeamNG.drive ImGui Code Snippets

 ## Setup
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -205,11 +205,11 @@ HTML is supported and can be used to add images/icons, for example.

 Multiple can be displayed at once, displayed sequentially.

-!!! bug
+::: bug

    Providing no buttons prevents the player from escaping the dialog without using the console.

-!!! bug
+::: bug

    The SDF parts of the Minimap UI app remain visible while a ConfirmationDialog is active.

@@ -249,7 +249,7 @@ guihooks.trigger("introPopupClose")
 * `noButtons`
    * Provides no buttons

-!!! warning
+::: warning

    When using the noButtons flavour on the page, providing no extra JavaScript in the page content to close the popup causes a softlock. Pages are not combined into one popup in this flavour. It is not recommended to use this flavour.

@@ -293,7 +293,7 @@ guihooks.trigger("introPopupClose")

 If multiple pages are provided, or the hook is triggered multiple times, then the pages are combined into the same popup. If the hook is triggered while a introPopup is active, or when a different introPopup type has already been triggered, then it is displayed in a separate popup after the existing popup is closed.

-!!! bug
+::: bug

    The background blur has a minimum height, causing popups with short content to have excess blur below its window. Two main workarounds exist:

@@ -338,7 +338,7 @@ guihooks.trigger("introPopupClose")

 If multiple pages are provided, or the hook is triggered multiple times, then the pages are combined into the same popup. If the hook is triggered while a introPopup is active, or when a different introPopup type has already been triggered, then it is displayed in a separate popup after the existing popup is closed.

-!!! bug
+::: bug

    The background blur has a minimum height, causing popups with short content to have excess blur below its window. Two main workarounds exist:

@@ -374,7 +374,7 @@ ui_missionInfo.closeDialogue()

 Only one Dialogue can be displayed at once. Any existing Dialogue is overridden.

-!!! info
+::: info

    `#!lua ui_missionInfo.closeDialogue()` must be used to close a dialogue.

@@ -9,29 +9,29 @@ hide:

 ## Our social media links

-!!!failure ""
+:::warning {{''}}
+BeamMP Forum - [https://forum.beammp.com](https://forum.beammp.com)
+:::

-    BeamMP Forum - [https://forum.beammp.com](https://forum.beammp.com)
+:::quote {{''}}
+X (Twitter) - [https://x.com/BeamMPOfficial](https://x.com/BeamMPOfficial)
+:::

-!!!quote ""
+:::danger {{''}}
+YouTube - [https://www.youtube.com/@BeamMPOfficial](https://www.youtube.com/@BeamMPOfficial)
+:::

-    X (Twitter) - [https://x.com/BeamMPOfficial](https://x.com/BeamMPOfficial)
+:::warning {{''}}
+Patreon - [https://www.patreon.com/c/BeamMP](https://www.patreon.com/c/BeamMP)
+:::

-!!!danger ""
+:::note {{''}}
+Discord - [https://discord.com/invite/beammp](https://discord.com/invite/beammp)
+:::

-    YouTube - [https://www.youtube.com/@BeamMPOfficial](https://www.youtube.com/@BeamMPOfficial)
-
-!!!warning ""
-
-    Patreon - [https://www.patreon.com/c/BeamMP](https://www.patreon.com/c/BeamMP)
-
-!!!note ""
-
-    Discord - [https://discord.com/invite/beammp](https://discord.com/invite/beammp)
-
-!!!info ""
-
-    BlueSky - [https://bsky.app/profile/beammpofficial.bsky.social](https://bsky.app/profile/beammpofficial.bsky.social)
+:::info {{''}}
+BlueSky - [https://bsky.app/profile/beammpofficial.bsky.social](https://bsky.app/profile/beammpofficial.bsky.social)
+:::

 ## Our Rules
 You can find our rules [here](rules.md)
@@ -4,7 +4,7 @@ hide:
 ---
 # BeamMP Community Rules

-!!! info
+::: info
    BeamMP Staff are not bound to moderate strictly by these rules and may operate at their own discretion. In addition to these rules, Discord's [Community Guidelines](https://discord.com/guidelines/) and [Terms of Service](https://discord.com/terms/) apply, and are enforced.

 ## BeamMP General Rules (Applies to Discord, Forum and In-Game)
@@ -50,5 +50,5 @@ hide:

 All ban appeals are investigated thoroughly, involving at least two (2) members of the staff/moderation team that were not involved in the case-at-hand.  The issuing staff member will be allowed to comment, but will not be otherwise involved in the appeal decision.  These appeal outcomes are final. BeamMP reserves the right to allow or not allow members as they deem appropriate according to the BeamMP Community Rules (as above), [Discord ToS](https://discord.com/terms), and other factors. 

-!!! warning
+::: warning
    In the event of action taken against you, you are prohibited from creating a new Discord or BeamMP account to circumvent the ban.
@@ -5,30 +5,29 @@
 BeamMP is fully compatible with Windows and Linux, compatibility with MacOS is being worked on.
 However, both Linux and MacOS are secondary platforms, this means bugs are to be expected.

-!!!warning
-
-    BeamMP will not work with pirated or outdated versions of BeamNG.drive.
-    The BeamMP support team does not offer support for issues with pirated / outdated copies.
-
+::: warning
+BeamMP will not work with pirated or outdated versions of BeamNG.drive.
+The BeamMP support team does not offer support for issues with pirated / outdated copies.
+:::
 ---

 ## **2. Installation**

 ### **2a. Windows Installation**

-!!!note
+::: note
+As of April 1st, 2026, the MSI installer is an "unrecognized app" according to Windows Defender SmartScreen.

-    As of April 1st, 2026, the MSI installer is an "unrecognized app" according to Windows Defender SmartScreen.
-    
-    To bypass this warning, click 'More info', then click 'Run anyway'.
+To bypass this warning, click 'More info', then click 'Run anyway'.
+:::

 1. Go to [beammp.com](https://beammp.com/) and click the 'Download Now' button.
 2. Run the `BeamMP_Installer.msi` installer and follow the instructions.
 3. The BeamMP Launcher icon should appear on your desktop. If not, just search for “BeamMP” in the Windows search bar.

-!!!note
-
-      As you are loading into a map with multiple vehicles spawned it might take longer than expected to join.
+::: note
+As you are loading into a map with multiple vehicles spawned it might take longer than expected to join.
+:::

 ### **2b. Linux Installation**

@@ -83,24 +82,25 @@ cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cma
 cmake --build bin --parallel
 ```

-!!!note ""
+::: note
+Should you run out of RAM while building, you can ommit the --parallel instruction, it will then use less RAM due to building only on one CPU thread.
+:::

-      Should you run out of RAM while building, you can ommit the --parallel instruction, it will then use less RAM due to building only on one CPU thread.
+:::note ""
+By not specifying `-DCMAKE_BUILD_TYPE=Release` you are building a debug version, which is larger in filesize but does not contain the launcher-can-only-connect-to-a-server-once bug
+:::

-!!!note ""
-
-      By not specifying `-DCMAKE_BUILD_TYPE=Release` you are building a debug version, which is larger in filesize but does not contain the launcher-can-only-connect-to-a-server-once bug
-
-!!!note "Fedora Users"
-    If vcpkg fails during OpenSSL compilation with kernel headers errors, ensure all dependencies are installed:
-    ```bash
-    sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl
-    ```
-    Then clean the vcpkg cache:
-    ```bash
-    rm -rf $VCPKG_ROOT/buildtrees/openssl
-    ```
-    And retry the cmake configuration command.
+:::note Fedora Users
+If vcpkg fails during OpenSSL compilation with kernel headers errors, ensure all dependencies are installed:
+```bash
+sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl
+```
+Then clean the vcpkg cache:
+```bash
+rm -rf $VCPKG_ROOT/buildtrees/openssl
+```
+And retry the cmake configuration command.
+:::

 Move the finished application out of the `/bin` folder into its own folder and run it from there:
 ```bash
@@ -132,11 +132,11 @@ With the symlink in place between the userfolders and the launcher compiled, you

 Note that this assumes you put the launcher's binary you compiled earlier into `/home/user/BeamMP/`, so change it to match where you put the finished binary, and you will need to re-compile the launcher with the correct git branch each time a launcher update is released.

-!!! tip "Adding an emoji-font to get in-text emojis"
+::: tip "Adding an emoji-font to get in-text emojis"
+In order to get emojis to show up in either the serverlist (As part of a servers customised name) or in the ingame chat, you need to have a font that contains emojis.

-    In order to get emojis to show up in either the serverlist (As part of a servers customised name) or in the ingame chat, you need to have a font that contains emojis.
-
-    This can be done for example by adding the [Linux-port of the Windows Segoe-UI emoji font](https://github.com/mrbvrz/segoe-ui-linux)
+This can be done for example by adding the [Linux-port of the Windows Segoe-UI emoji font](https://github.com/mrbvrz/segoe-ui-linux)
+:::

 ### **2d. Updating the Launcher**

@@ -20,7 +20,7 @@

    If disabled, physics instabilities will cause your game to pause

-    !!! note ""
+    ::: note ""

        Its advised to leave disabled, since repeated instabilities can cause the game to crash

@@ -36,7 +36,7 @@

    If disabled, the ingame chat will be displayed in the UI app

-    !!! note ""
+    ::: note ""

        Dragging IMGUI windows out of the main game window can cause performance issues, as well as trick screen recording software into recording the chat window instead of the main game window

@@ -76,7 +76,7 @@

    If disbaled, other vehicles will stay fully visible regardless of distance

-    !!! note ""
+    ::: note ""

        This only affects the visible 3d mesh of a vehicle, not its physics node-beam-mesh. In order to also disable physics, you need to enable `Simplified collision physics` in the Gameplay settings

@@ -190,13 +190,13 @@

 ??? setting "Fade distance/Invert nametag fade direction"

-    !!! setting "Fade out"
+    ::: setting "Fade out"

        Nametags are getting less visible the further away a player is

        `Fade distance` defines the distance at which a nametag will be drawn at minimal opacity

-    !!! setting "Fade in"
+    ::: setting "Fade in"

        Nametags are getting more visible the further away a player is

@@ -234,7 +234,7 @@

    If disabled, no further network activity will be shown in the console

-    !!! danger ""
+    ::: danger ""

        Be careful with this setting, since all the console output gets also written into the log files
        
@@ -248,7 +248,7 @@

    Dont forget to also change it on the launcher side, by modifying `launcher.cfg`

-    !!! tip ""
+    ::: tip ""

        The port specified is only the first of two, the second port being used is directly following, set port + 1

@@ -3,7 +3,7 @@ title: Guides
 description: This set of pages provides some basic guides for BeamMP
 status: new
 ---
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,6 +1,6 @@
 # Multiplayer mod creation

-## Folderstructure and file basics
+## Folder structure and file basics

 The basic folder and file structure needs to look like this:

@@ -31,8 +31,9 @@ The Client folder contains the zip files that are sent to a client, which then w
 Any other files in the Client folder will cause an error on server startup, but apart from that will be ignored by the server.
 The modScript.lua will be read by BeamNG and instructs the game which plugin to load.

-!!!example ""
-    [Download the examplePlugin.zip](../../../../assets/content/ResourcesForExamplePlugin.zip)
+:::example ""
+[Download the examplePlugin.zip](../../../../assets/content/ResourcesForExamplePlugin.zip)
+:::

 ## Serverside lua

@@ -1,34 +1,44 @@
 ---
-hide:
-  - navigation
+layout: home
+
+hero:
+  name: BeamMP Documentation
+  text: Everything you need to know
+  tagline: Complete guides for players, server owners, and developers
+  image:
+    src: /assets/core/beammp_dark.png
+    alt: BeamMP
+  actions:
+    - theme: brand
+      text: Get Started
+      link: /en/game/getting-started
+    - theme: alt
+      text: View on GitHub
+      link: https://github.com/beammp/docs
+
+features:
+  - icon: 🎮
+    title: For Players
+    details: Learn how to install BeamMP, connect to servers, and get the most out of your multiplayer experience
+    link: /en/game/getting-started
+  - icon: 🖥️
+    title: For Server Owners
+    details: Set up and manage your own BeamMP server with our comprehensive guides and troubleshooting resources
+    link: /en/server/create-a-server
+  - icon: 💻
+    title: For Developers
+    details: Create mods, resources, and UI apps with detailed API documentation and code examples
+    link: /en/guides/index
+  - icon: ❓
+    title: FAQ
+    details: Find quick answers to common questions about setup, troubleshooting, and best practices
+    link: /en/FAQ/player-faq
+  - icon: 📋
+    title: Community Rules
+    details: Learn about our community guidelines and how to report issues or appeal decisions
+    link: /en/community/rules
+  - icon: 🔗
+    title: Community
+    details: Join our Discord, follow on social media, and connect with other BeamMP players and developers
+    link: /en/community/index
 ---
-!!! warning "This site is under construction!"
-
-    This site is being actively worked on. 
-    
-    Feel you could help? Please do by clicking on the page with a pencil on the right!
-
-    This can be done on any page, too.
-
-# Welcome to BeamMP Docs! :tada:
-
-Welcome to the new and improved documentation hub for BeamMP! Whether you're a player, server owner, or developer, we have the resources you need to enhance your BeamNG.drive multiplayer experience.
-
-## For Players
-
-New to BeamMP? Check out our [Getting Started](../game/getting-started.md) page to help you hit the road running and make the most out of your multiplayer adventures.
-For general questions and issues please check out the [Players FAQ](../FAQ/player-faq.md).
-
-## For Server Owners
-
-Thinking about creating your own BeamMP server? Our comprehensive guide [here](../server/create-a-server.md) will walk you through the process, ensuring you have all the tools and knowledge to set up your server efficiently.
-
-## For Developers
-
-Discover the ins and outs of creating resources for the BeamMP Server in our [Resource Development Guide](../guides/mod-creation/server/getting-started.md).
-
-Exciting updates are on the horizon, including a brand-new homepage designed to enhance your browsing experience. Stay tuned for more! :slight_smile:
-
-## Community Rules
-
-Read through the BeamMP [Community rules](https://docs.beammp.com/community/rules/) and how to appeal bans.
@@ -0,0 +1 @@
+{}
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -1,4 +1,4 @@
-!!! warning "This site is under construction!"
+::: warning "This site is under construction!"

    This site is being actively worked on. 
    
@@ -8,7 +8,7 @@

 # Server Scripting Reference
 ## Server Version 2.X
-!!! warning
+::: warning

    BeamMP server version 2.X is now unsupported. This documentation is provided as a reference only.
    Please update to the latest version for maintenance and support.
@@ -24,12 +24,12 @@ The setup consists of the following steps, you should follow all of them.

 ### **1. Port forwarding**

-!!! info
+::: info

    If you are on a VPS (Virtual Private Server), Rootserver, or plan on hosting this server locally (with players in the same house as you), you can skip this step.
    This step is necessary if you want someone **outside** of your household to join your home-hosted server (outside of your local network).

-    !!! danger ":material-scale-balance: DISCLAIMER:"
+    ::: danger ":material-scale-balance: DISCLAIMER:"

        **Port forwarding is a risk**.

@@ -74,7 +74,7 @@ The “Authentication Key”, often called “AuthKey”, is necessary for makin
 You have a limited number of keys. One key can be used on one server at a time, so you cannot start two servers at the same time with the same key.
 More keys can be obtained by supporting the project. Read [this article](https://docs.beammp.com/support/player-faq/) for more information.

-!!! warning
+::: warning

    DO NOT EVER SHARE THIS KEY OR SHOW IT TO ANYONE. TREAT THIS LIKE A PASSWORD.

@@ -192,7 +192,7 @@ Description = "Total Random Beam MP Server"
 ResourceFolder = "Resources"
 ```

-!!! info
+::: info

      This is your configuration file. It uses a format called TOML. Refer to the [Server Maintenance](server-maintenance.md) section for more info on this file and the variables.
      Your server will **NOT** show in the server list as long as `Private = true`. _If_ you want it to show in the list, set that to **`Private = false`**.
@@ -217,7 +217,7 @@ Now run your server again, and see if it spits out any more `[ERROR]` or `[WARN]

 Vehicle mods and map mods are different to install, but both require you to put them in your server's (`Resources/Client`) folder. Simply slide any mod you want to add in that folder.

-!!! warning
+::: warning

    Should you receive a "done" or "start" message when trying to join your server after adding mods, you likely added an incompatible or broken mod to your server.
    Mod incompatibilities can also occur between 2 or more mods. If you have client mods installed, check [this guide](../../FAQ/How-to-deactivate-mods.md) about removing mods from your game.
@@ -282,11 +282,11 @@ Enter the servers public IPv4 and Port below, then click "CheckBeamMP".
  <input type="submit" value="CheckBeamMP">
 </form>

-!!! warning "I want to use a VPN such as RadminVPN, Hamachi, or similar."
+::: warning "I want to use a VPN such as RadminVPN, Hamachi, or similar."
    
    BeamMP does not support these VPNs, as they often cause issues. One of these issues is UDP traffic not being forwarded. To resolve this, refer to section 1.
    
-    !!! question "But why has it worked in the past?"
+    ::: question "But why has it worked in the past?"

        This is due to the developers of these applications updating their software and implementing changes which BeamMP has no control over.
        It is up to the developers of these applications to provide support for specific use cases like a BeamMP-Server.
@@ -17,6 +17,6 @@ This page contains all the error codes that the server may display.
 | 10064 | Host down                                  | Unlikely error, but it means that the host is down because either it's shutdown or ports were closed.                 |
 | 10065 | Host not reachable                         | No internet or bad port forwarding, please refer to the [guide steps](create-a-server.md#1-port-forwarding).          |

-!!! note
+::: note
 	For any other code not in this list, you can refer to <https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2> if you know a bit how networks / sockets work.

@@ -1,6 +1,6 @@
 # Port Forwarding

-!!! danger ":material-scale-balance: DISCLAIMER:"
+::: danger ":material-scale-balance: DISCLAIMER:"

    **Port forwarding is a risk**.

@@ -10,7 +10,7 @@

    <u>**If you do not understand this guide, please consider using one of our partners.**</u>

-!!! warning
+::: warning

      Please make sure your Router is not a 4G/5G exclusive device. If it is a hybrid device, make sure to select the cable connected adapter later in section 3 of this guide!

@@ -116,7 +116,7 @@ Subnet Mask (most likely 255.255.255.0)
 </br>
 Default Gateway (most likely 192.168.0.1 or 192.168.1.1)

-!!! info "Please Note"
+::: info "Please Note"
    BeamMP currently does not support IPv6 for hosting a server. 

 #### 1.2. Modify Adapter Settings
@@ -208,7 +208,7 @@ Your router will have a place to enter the ports to be forwarded and the destina

 BeamMP requires both UDP and TCP port 30814 (Unless you have changed this in your [ServerConfig.toml](create-a-server.md#4-configuration)). 

-!!! info "Note"
+::: info "Note"
    While the default **Port** is **30814**, you can choose any other number greater than 1024 but less than 65535, but you need to note down what you picked if it's not 30814\. You need to forward both **TCP** and **UDP**.
    </br>
    It is recommended to stick to the default port as that one is very unlikely to be used by another service on your PC.
@@ -238,13 +238,13 @@ This can be done by getting your public IPv4 Address, this once again can be don
 Visit the following Link and replace "IP" with your actual IPv4 address, and the "Port" with your servers port. Be sure to leave no spaces.
 https://check.beammp.com/api/v2/beammp/ip/port

-!!! success "status: ok"
+::: success "status: ok"

      If you get the output above you can now join your server!
      There are 2 ways to join, either directly with the details you entered into Probably UP, or, if your server is set to 'public', through the server-list.
      Since you are hosting a server on-premise, use 127.0.0.1 (localhost) if the Server is running on the same PC as you play, or the LAN IPv4 of the local machine that is running the server.

-!!! failure "status: error"
+::: failure "status: error"

      If the connection fails entirely, your ISP could be using CGNAT (Carrier Grade Network Address Translation). For more details, please check [How to check for CGNAT?](../FAQ/How-to-check-for-CGNAT.md),
      or open a Server Support ticket on our [Discord server](https://discord.gg/beammp) in the `#support` channel and one of our staff will get to your ticket!
@@ -1,4 +1,4 @@
-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -1,4 +1,4 @@
-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -1,4 +1,4 @@
-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -1,4 +1,4 @@
-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -1,4 +1,4 @@
-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -1,4 +1,4 @@
-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -4,7 +4,7 @@ description: Este conjunto de páginas ofrece algunas guías básicas para BeamM
 status: nuevo
 ---

-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -1,4 +1,4 @@
-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -1,24 +1,48 @@
 ---
-hide:
-  - navegación
+layout: home
+
+hero:
+  name: Documentación de BeamMP
+  text: Todo lo que necesitas saber
+  tagline: Guías completas para jugadores, propietarios de servidores y desarrolladores
+  image:
+    src: /assets/core/beammp_dark.png
+    alt: BeamMP
+  actions:
+    - theme: brand
+      text: Comenzar
+      link: /es/game/getting-started
+    - theme: alt
+      text: Ver en GitHub
+      link: https://github.com/beammp/docs
+
+features:
+  - icon: 🎮
+    title: Para Jugadores
+    details: Aprende cómo instalar BeamMP, conectarte a servidores y aprovechar al máximo tu experiencia multijugador
+    link: /es/game/getting-started
+  - icon: 🖥️
+    title: Para Propietarios de Servidores
+    details: Configura y administra tu propio servidor BeamMP con nuestras guías completas y recursos de solución de problemas
+    link: /es/server/create-a-server
+  - icon: 💻
+    title: Para Desarrolladores
+    details: Crea mods, recursos y aplicaciones de interfaz de usuario con documentación detallada de API y ejemplos de código
+    link: /es/guides/index
+  - icon: ❓
+    title: Preguntas Frecuentes
+    details: Encuentra respuestas rápidas a preguntas frecuentes sobre configuración, solución de problemas y mejores prácticas
+    link: /es/FAQ/player-faq
+  - icon: 📋
+    title: Reglas de la Comunidad
+    details: Aprende sobre nuestras directrices de la comunidad y cómo reportar problemas o apelar decisiones
+    link: /es/community/rules
+  - icon: 🔗
+    title: Comunidad
+    details: Únete a nuestro Discord, síguenos en redes sociales y conecta con otros jugadores y desarrolladores de BeamMP
+    link: /es/community/index
 ---

-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
-
-```
-Se está trabajando en este sitio.
-
-¿Crees que puedes ayudar? Por favor, hazlo haciendo clic en la página con un lápiz a la derecha.
-
-Esto puede ser hecho en cualquier página.
-```
-
-# ¡Bienvenido a BeamMP Docs! :tada:
-
-¡Bienvenido al nuevo y mejorado centro de documentación para BeamMP! Ya seas jugador, propietario de un servidor o desarrollador, tenemos los recursos que necesitas para mejorar tu experiencia multijugador en BeamNG.drive.
-
-## Para Jugadores
-
 ¿Nuevo en BeamMP? Échale un vistazo [Cómo Empezar](../game/getting-started.md) para ayudarte a tocar la carretera y hacer la mayoría de tus aventuras en multijugador. Para preguntas generales y problemas, por favor échale un ojo a [Players FAQ](../support/player-faq.md).

 ## Para Propietarios de Servidor
@@ -0,0 +1,57 @@
+{
+  "Home": "Inicio",
+  "Support": "Soporte",
+  "Playing BeamMP": "Jugando a BeamMP",
+  "Installing BeamMP": "Instalación de BeamMP",
+  "Error Codes": "Códigos de error",
+  "Multiplayer Settings": "Ajustes multijugador",
+  "Running a BeamMP-Server": "Ejecutando un Servidor",
+  "Server Installation": "Instalación del Servidor",
+  "Port Forwarding": "Redirección de puertos",
+  "Server Maintenance": "Manutención del Servidor",
+  "Server Manual": "Manual del Servidor",
+  "Mod & Resource Creation": "Creación de Mods y Recursos",
+  "Client Side": "Lado del Cliente",
+  "Server Side": "Lado del Servidor",
+  "FAQ": "FAQ",
+  "How to check for CGNAT?": "Cómo comprobar si hay CGNAT?",
+  "Where can I find my IP address?": "¿Dónde puedo encontrar mi dirección IP?",
+  "How to remove mods?": "¿Cómo se eliminan los mods?",
+  "Manually updating the Launcher": "Actualizar manualmente el Launcher",
+  "Changing the Launcher port": "Cambiar el puerto del Launcher",
+  "Creating Exclusions (Defender)": "Creación de exclusiones (Defender)",
+  "Player FAQ": "Preguntas frecuentes del jugador",
+  "Game FAQ": "Preguntas Frecuentes del Juego",
+  "Server FAQ": "Preguntas Frecuentes del Servidor",
+  "Development Guides": "Guías de Desarrollo",
+  "Development Environment Setup": "Configuración del entorno de desarrollo",
+  "Mod Creation": "Creación de Mods",
+  "Resource Creation": "Creación de Recursos",
+  "Client Scripting Reference": "Referencia de scripting del cliente",
+  "Server Resources": "Recursos del servidor",
+  "BeamNG Documentation": "Documentación de BeamNG",
+  "Content Development": "Desarrollo de contenido",
+  "Introduction": "Introducción",
+  "Programming": "Programación",
+  "UI Apps (HTML)": "Aplicaciones de IU (HTML)",
+  "ImGui Window Tutorial": "Tutorial de ventana ImGui",
+  "Lua Mods (Scripts)": "Mods Lua (scripts)",
+  "Content": "Contenido",
+  "Maps": "Mapas",
+  "Props": "Objetos",
+  "Vehicles": "Vehículos",
+  "Lua Code Snippets": "Fragmentos de código Lua",
+  "CSS Code Snippets": "Fragmentos de código CSS",
+  "ImGui Code Snippets": "Fragmentos de código ImGui",
+  "CEF Code Snippets": "Fragmentos de código CEF",
+  "Scripting Reference": "Referencia de scripting",
+  "Mod (In-Game)": "Mod (En el Juego)",
+  "Server": "Servidor",
+  "Version 3.X (Latest)": "Versión 3.X (Última)",
+  "Version 2.X (Deprecated)": "Versión 2.X (Obsoleta)",
+  "Contributing": "Contribuir",
+  "Getting Started": "Primeros Pasos",
+  "Community": "Comunidad",
+  "General Information": "Información general",
+  "Rules": "Normas"
+}
@@ -1,4 +1,4 @@
-¡¡¡ ADVERTENCIA !!! "¡Esta página está bajo construcción!"
+::: warning "¡Esta página está bajo construcción!"

 ```
 Se está trabajando en este sitio.
@@ -2,11 +2,11 @@

 Dans BeamMP, le serveur auquel vous vous connectez fournit les mods nécessaires. Ceux-ci sont téléchargés et activés automatiquement lors de la connexion. L'installation et l'activation de mods locaux peuvent souvent entraîner un dysfonctionnement de BeamMP, même avec un seul mod supplémentaire.

-!!! warning
+::: warning

 Supprimez tous les mods placés dans le dossier BeamNG.Drive\content\ ou ses sous-dossiers. Cet emplacement n'est PAS destiné à l'installation de mods et peut entraîner des problèmes, comme indiqué dans le fichier « DO_NOT_INSTALL_MODS_HERE.txt », situé dans le même répertoire.

-!!! quote 'DO_NOT_INSTALL_MODS_HERE.txt"
+::: quote 'DO_NOT_INSTALL_MODS_HERE.txt"

 NE copiez PAS les mods dans ce dossier : cela peut entraîner des mods cassés, une installation plus lente des mises à jour, un gestionnaire de mods cassé, un mode sans échec cassé et autres.

@@ -32,7 +32,7 @@ Une fois terminé, lancez BeamNG.Drive via le lanceur BeamMP. Le seul mod activ

 Pour nettoyer les mods en cache des répertoires BeamMP, accédez à l'emplacement d'installation de votre lanceur BeamMP. Par défaut, le chemin est « C:\Users\AppData\BeamMP-Launcher ». Vous y trouverez un dossier « Resources ». Supprimez ce dossier pour supprimer tous les mods en cache. Cela peut être utile si vous avez besoin de plus d'espace disque ou si vous souhaitez supprimer des mods BeamNG obsolètes.

-!!! question "Mes paramètres et configurations ont disparu ! Comment puis-je les restaurer ?"
+::: question "Mes paramètres et configurations ont disparu ! Comment puis-je les restaurer ?"

 Si vous avez renommé le dossier utilisateur, vous avez forcé le jeu à créer un nouveau dossier utilisateur propre. Vous pouvez copier les dossiers « paramètres » et « véhicules » du dossier renommé (par exemple, 0.34_OLD) vers le nouveau dossier créé.
 Assurez-vous que BeamNG.Drive est fermé et remplacez tous les éléments à l'emplacement où vous souhaitez copier les dossiers. Toutes les configurations et tous les paramètres devraient maintenant être identiques.
@@ -16,7 +16,7 @@ Pour une explication détaillée de ce qu'est CGNAT et pourquoi c'est un problè

 Ouvrez une invite de commande et exécutez `tracert -4 beammp.com` . Cela affichera une série de sauts réseau. Attendez la fin de l'opération (jusqu'à 30 sauts peuvent être nécessaires). Vérifiez les premières adresses IP après celle de votre routeur/modem/passerelle. Si plusieurs adresses IP comprises entre `100.64.xx` et `100.127.xx` ou `10.xx.xx.xx` apparaissent après le premier saut, vous êtes probablement derrière un CGNAT.

-!!! note
+::: note

 Le premier saut sera votre routeur/modem/passerelle et diffère selon les appareils.
 Les plages officielles pour les réseaux locaux sont les suivantes : « 10.0.0.xxx » - « 192.168.xxx.xxx » - « 172.16.xxx.xxx »
@@ -29,7 +29,7 @@ Trouvez l'adresse IP WAN de votre routeur en la consultant sur son interface. Co

 Contactez votre fournisseur d'accès Internet pour obtenir de l'aide. Selon votre fournisseur d'accès, il se peut qu'il ne propose pas d'adresses IP *dynamiques* dédiées. N'oubliez pas qu'une adresse IP statique n'est pas nécessaire.

-!!! warning
+::: warning

 Les fournisseurs de services Internet ne peuvent proposer des adresses IP dédiées qu'en tant qu'**option payante**.
 Veuillez vérifier les prix de nos services d'hébergement partenaires car ils pourraient être moins chers que ces frais !
@@ -2,11 +2,11 @@

 Dans BeamMP, le serveur auquel vous vous connectez fournit les mods nécessaires. Ceux-ci sont téléchargés et activés automatiquement lors de la connexion. L'installation et l'activation de mods locaux peuvent souvent entraîner un dysfonctionnement de BeamMP, même avec un seul mod supplémentaire.

-!!! warning
+::: warning

 Supprimez tous les mods placés dans le dossier BeamNG.Drive\content\ ou ses sous-dossiers. Cet emplacement n'est PAS destiné à l'installation de mods et peut entraîner des problèmes, comme indiqué dans le fichier « DO_NOT_INSTALL_MODS_HERE.txt », situé dans le même répertoire.

-!!! quote 'DO_NOT_INSTALL_MODS_HERE.txt"
+::: quote 'DO_NOT_INSTALL_MODS_HERE.txt"

 NE copiez PAS les mods dans ce dossier : cela peut entraîner des mods cassés, une installation plus lente des mises à jour, un gestionnaire de mods cassé, un mode sans échec cassé et autres.

@@ -32,7 +32,7 @@ Une fois terminé, lancez BeamNG.Drive via le lanceur BeamMP. Le seul mod activ

 Pour nettoyer les mods en cache des répertoires BeamMP, accédez à l'emplacement d'installation de votre lanceur BeamMP. Par défaut, le chemin est « C:\Users\AppData\BeamMP-Launcher ». Vous y trouverez un dossier « Resources ». Supprimez ce dossier pour supprimer tous les mods en cache. Cela peut être utile si vous avez besoin de plus d'espace disque ou si vous souhaitez supprimer des mods BeamNG obsolètes.

-!!! question "Mes paramètres et configurations ont disparu ! Comment puis-je les restaurer ?"
+::: question "Mes paramètres et configurations ont disparu ! Comment puis-je les restaurer ?"

 Si vous avez renommé le dossier utilisateur, vous avez forcé le jeu à créer un nouveau dossier utilisateur propre. Vous pouvez copier les dossiers « paramètres » et « véhicules » du dossier renommé (par exemple, 0.34_OLD) vers le nouveau dossier créé.
 Assurez-vous que BeamNG.Drive est fermé et remplacez tous les éléments à l'emplacement où vous souhaitez copier les dossiers. Toutes les configurations et tous les paramètres devraient maintenant être identiques.
@@ -1,4 +1,4 @@
-!!! warning "Ce site est en construction !"
+::: warning "Ce site est en construction !"

 Ce site est en cours de développement actif.

@@ -1,4 +1,4 @@
-!!! warning "Ce site est en construction !"
+::: warning "Ce site est en construction !"

 Ce site est en cours de développement actif.

@@ -5,7 +5,7 @@
 BeamMP est entièrement compatible avec Windows et Linux, la compatibilité avec MacOS est en cours de développement. 
 Cependant, puisque Linux et MacOS sont des systèmes d'opération secondaire plusieurs problèmes (bug) sont à prévoir.

-!!!warning "Attention"
+:::warning "Attention"

    Aucune version piratée ou dépassée de BeamNG.drive ne sera compatible avec BeamMP.
    L'équipe de support de BeamMP ne fournit aucun soutien pour les versions piratées ou défectueuses.
@@ -23,7 +23,7 @@ Cependant, puisque Linux et MacOS sont des systèmes d'opération secondaire plu
 8. On va vous demander si vous voulez vous connecter ou si vous voulez jouer en teant qu'invité (guest) (Certains serveurs bloque les joueur invités (guest)). Vous pouvez créer un compte sur notre [forum](https://forum.beammp.com) et vous connecter à BeamMP avec les mêmes informations par la suite.
 9. Choisissez n'importe quel serveur de votre choix et appuyer sur `Connect`. Amusez-vous!

-!!!note
+:::note

      Lorsque vous vous connectez à un serveur avec plusieurs joueurs et/ou véhicules, les temps de chargement peuvent être prolongés.

@@ -58,11 +58,11 @@ cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=~/vcpkg/scripts/buildsystems/vcpkg.cmake -
 cmake --build bin --parallel
 ```

-!!!note ""
+:::note ""

      Si vous manquer de RAM lorsque vous construisez, vous pouvez ignorer --parallel instruction, cela va utiliser moin s de RAM puisque la construction n'utilisera qu'un fil (thread) du CPU.

-!!!note ""
+:::note ""

      Si vous ne spécifiez pas `-DCMAKE_BUILD_TYPE=Release`, vous allez construire la version debug qui est plus volumineuse, mais ne contient pas le problème (bug):
      launcher-can-only-connect-to-a-server-once (Lanceur-peut-se-connecter-seulement-unefois-à-un-serveur)
@@ -91,7 +91,7 @@ Avec le symlink configuré antre le lanceur compilé et les userfolders, vous po

 Notez que ceci assume que vous avez mis, les binairies du lanceur que vous avez compilé plus tôt, dans `/home/user/BeamMP/`, donc changez l'emplacement pour qu'il corresponde à où vous avez mis les binairies terminées et vous allez avoir besoin de recompiler le lanceur avec la bonne branche git à chaque fois qu'une nouvelle mise à jour sera disponible.

-!!! tip "Ajoutez une police d'écriture pour les emojis pour avoir les emojis en jeu"
+::: tip "Ajoutez une police d'écriture pour les emojis pour avoir les emojis en jeu"

    Pour avoir accès aux emojis soit dans la liste des serveurs (certains serveurs utilisent des emojis dans leur nom personalisé), soit dans le chat en jeu, vous avez besoin d'une police d'écriture qui contient certains emojis.

@@ -4,7 +4,7 @@ description: Cet ensemble de pages fournit quelques guides de base pour BeamMP
 status: nouveau
 ---

-!!! warning "Ce site est en construction !"
+::: warning "Ce site est en construction !"

 Ce site est en cours de développement actif.

@@ -1,22 +1,47 @@
 ---
-hide:
-  - navigation
+layout: home
+
+hero:
+  name: Documentation BeamMP
+  text: Tout ce que vous devez savoir
+  tagline: Guides complets pour les joueurs, propriétaires de serveurs et développeurs
+  image:
+    src: /assets/core/beammp_dark.png
+    alt: BeamMP
+  actions:
+    - theme: brand
+      text: Commencer
+      link: /fr/game/getting-started
+    - theme: alt
+      text: View on GitHub
+      link: https://github.com/beammp/docs
+
+features:
+  - icon: 🎮
+    title: Pour les Joueurs
+    details: Apprenez comment installer BeamMP, vous connecter aux serveurs et tirer le meilleur parti de votre expérience multijoueur
+    link: /fr/game/getting-started
+  - icon: 🖥️
+    title: Pour les Propriétaires de Serveur
+    details: Configurez et gérez votre propre serveur BeamMP avec nos guides complets et ressources de dépannage
+    link: /fr/server/create-a-server
+  - icon: 💻
+    title: Pour les Développeurs
+    details: Créez des mods, des ressources et des applications UI avec la documentation API détaillée et des exemples de code
+    link: /fr/guides/index
+  - icon: ❓
+    title: FAQ
+    details: Trouvez des réponses rapides aux questions fréquemment posées sur la configuration, le dépannage et les meilleures pratiques
+    link: /fr/FAQ/player-faq
+  - icon: 📋
+    title: Règles de la Communauté
+    details: Découvrez nos directives communautaires et comment signaler des problèmes ou contester des décisions
+    link: /fr/community/rules
+  - icon: 🔗
+    title: Communauté
+    details: Rejoignez notre Discord, suivez-nous sur les réseaux sociaux et connectez-vous avec d'autres joueurs et développeurs BeamMP
+    link: /fr/community/index
 ---
-!!! warning "Ce site est en construction !"
-
-    Ce site est actuellement en cours de travail.
-
-    Pensez-vous pouvoir nous aider ? N'hésitez pas à cliquer sur la page avec un crayon à droite!
-
-    Cela peut également être fait sur n'importe quelle page.
-
-# Bienvenue sur BeamMP Docs ! :tada:
-
-Bienvenue sur le centre de documentation amélioré pour BeamMP ! Que vous soyez un joueur, un propriétaire de serveur ou un développeur, nous disposons des ressources nécessaires pour améliorer votre expérience multijoueur sur BeamNG.drive.
-
-## Pour les Joueurs
-
-Nouveau sur BeamMP ? Consultez notre [Guide de Démarrage](../game/getting-started.md) pour vous aider à commencer et profiter au maximum de vos aventures multijoueurs.

 ## Pour les Propriétaires de Serveur

@@ -0,0 +1,57 @@
+{
+  "Home": "Accueil",
+  "Support": "Support",
+  "Playing BeamMP": "Jouer à BeamMP",
+  "Installing BeamMP": "Installation de BeamMP",
+  "Error Codes": "Codes d'erreur",
+  "Multiplayer Settings": "Paramètres multijoueurs",
+  "Running a BeamMP-Server": "Exécution d'un serveur",
+  "Server Installation": "Installation du serveur",
+  "Port Forwarding": "Redirection de port",
+  "Server Maintenance": "Maintenance du serveur",
+  "Server Manual": "Manuel du serveur",
+  "Mod & Resource Creation": "Création de mods et de ressources",
+  "Client Side": "Côté client",
+  "Server Side": "Côté serveur",
+  "FAQ": "FAQ",
+  "How to check for CGNAT?": "Comment puis-je vérifier cgnat?",
+  "Where can I find my IP address?": "Où puis-je trouver mon adresse IP?",
+  "How to remove mods?": "Comment supprimer des mods ?",
+  "Manually updating the Launcher": "Mise à jour manuelle du lanceur",
+  "Changing the Launcher port": "Changer le port du lanceur",
+  "Creating Exclusions (Defender)": "Création d'exclusions (Defender)",
+  "Player FAQ": "FAQ du joueur",
+  "Game FAQ": "FAQ du jeu",
+  "Server FAQ": "FAQ du serveur",
+  "Development Guides": "Guides de développement",
+  "Development Environment Setup": "Configuration de l’environnement de développement",
+  "Mod Creation": "Création de mods",
+  "Resource Creation": "Création de ressources",
+  "Client Scripting Reference": "Référence de script client",
+  "Server Resources": "Ressources serveur",
+  "BeamNG Documentation": "Documentation BeamNG",
+  "Content Development": "Développement de contenu",
+  "Introduction": "Introduction",
+  "Programming": "Programmation",
+  "UI Apps (HTML)": "Applications UI (HTML)",
+  "ImGui Window Tutorial": "Tutoriel de fenêtre ImGui",
+  "Lua Mods (Scripts)": "Mods Lua (scripts)",
+  "Content": "Contenu",
+  "Maps": "Cartes",
+  "Props": "Objets",
+  "Vehicles": "Véhicules",
+  "Lua Code Snippets": "Extraits de code Lua",
+  "CSS Code Snippets": "Extraits de code CSS",
+  "ImGui Code Snippets": "Extraits de code ImGui",
+  "CEF Code Snippets": "Extraits de code CEF",
+  "Scripting Reference": "Référence de script",
+  "Mod (In-Game)": "Mod (en jeu)",
+  "Server": "Serveur",
+  "Version 3.X (Latest)": "Version 3.X (Dernière)",
+  "Version 2.X (Deprecated)": "Version 2.X (Obsolète)",
+  "Contributing": "Contribution",
+  "Getting Started": "Premiers pas",
+  "Community": "Communauté",
+  "General Information": "Informations générales",
+  "Rules": "Règles"
+}
@@ -26,7 +26,7 @@ La configuration comprend les étapes suivantes, vous devez toutes les suivre.

 ### **1. Redirection de port**

-!!! info
+::: info

 Si vous êtes sur un VPS (Virtual Private Server), un Rootserver, ou si vous prévoyez d'héberger ce serveur localement (avec des joueurs dans la même maison que vous), vous pouvez sauter cette étape.
 Cette étape est nécessaire si vous voulez que quelqu'un **en dehors** de votre foyer rejoigne votre serveur hébergé localement (en dehors de votre réseau local).
@@ -70,7 +70,7 @@ Si vous rencontrez des problèmes, n'hésitez pas à les poser également sur no

 La clé d'authentification, souvent appelée « AuthKey », est nécessaire pour rendre un serveur **public** accessible à la liste des serveurs. Il est toutefois recommandé d'ajouter également la clé d'authentification aux serveurs privés. Le nombre de clés est limité. Une clé peut être utilisée sur un serveur à la fois ; vous ne pouvez donc pas démarrer deux serveurs simultanément avec la même clé. Vous pouvez obtenir davantage de clés en soutenant le projet. Consultez [cet article](https://docs.beammp.com/support/player-faq/) pour plus d'informations.

-!!! warning
+::: warning

 NE PARTAGEZ JAMAIS CETTE CLÉ ET NE LA MONTREZ À PERSONNE. TRAITEZ CECI COMME UN MOT DE PASSE.

@@ -184,7 +184,7 @@ Donnez également un nom à votre serveur dans le champ `Name` . Vous pouvez le

 Si vous avez choisi un **port** différent de **30814** , assurez-vous de le remplacer ici sous `Port` .

-!!! info
+::: info

  Votre serveur n'apparaîtra **PAS** dans la liste des serveurs tant que le champ `Private = true` à comme option "True. _Si_ vous souhaitez qu'il apparaisse dans la liste, définissez-le sur **`Private = false`**.

@@ -198,7 +198,7 @@ Redémarrez votre serveur et vérifiez s'il affiche d'autres messages `[ERROR]`

 L'installation des mods de véhicules et de cartes est différente, mais ils doivent tous deux être placés dans le dossier `Resources/Client` de votre serveur. Il vous suffit de glisser le mod souhaité dans ce dossier.

-!!! warning
+::: warning

 Si vous recevez un message « terminé » ou « démarrer » lorsque vous essayez de rejoindre votre serveur après avoir ajouté des mods, vous avez probablement ajouté un mod incompatible ou cassé à votre serveur.
 Des incompatibilités de mods peuvent également survenir entre deux ou plusieurs mods. Si vous avez installé des mods clients, consultez ce guide pour savoir comment les supprimer de votre jeu.
@@ -259,11 +259,11 @@ Saisissez l'IPv4 publique et le port des serveurs ci-dessous, puis cliquez sur
  <input type="submit" value="CheckBeamMP">
 </form>

-!!! warning "Je souhaite utiliser un VPN tel que RadminVPN, Hamachi ou similaire."
+::: warning "Je souhaite utiliser un VPN tel que RadminVPN, Hamachi ou similaire."

 BeamMP ne prend pas en charge ces VPN, car ils posent souvent problème. L'un de ces problèmes est le non-transfert du trafic UDP. Pour résoudre ce problème, consultez la section 1.

-!!! question "Mais pourquoi cela a-t-il fonctionné dans le passé ?"
+::: question "Mais pourquoi cela a-t-il fonctionné dans le passé ?"

 Cela est dû au fait que les développeurs de ces applications mettent à jour leurs logiciels et mettent en œuvre des modifications sur lesquelles BeamMP n'a aucun contrôle.
 Il appartient aux développeurs de ces applications de fournir un support pour des cas d'utilisation spécifiques comme un serveur BeamMP.
@@ -17,4 +17,4 @@ Code | Description | Solution possible
 10064 | Hôte en panne | Erreur peu probable, mais cela signifie que l'hôte est en panne parce qu'il est arrêté ou que les ports ont été fermés.
 10065 | Hôte non joignable | Pas d'Internet ou mauvaise redirection de port, veuillez vous référer aux [étapes de ce guide](create-a-server.md#1-port-forwarding) .

-!!! note Pour tout autre code ne figurant pas dans cette liste, vous pouvez vous référer à [https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2](https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2) si vous savez un peu comment fonctionnent les réseaux / sockets.
+::: note Pour tout autre code ne figurant pas dans cette liste, vous pouvez vous référer à [https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2](https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2) si vous savez un peu comment fonctionnent les réseaux / sockets.
@@ -0,0 +1,15 @@
+---
+layout: false
+---
+
+<script setup>
+import { onMounted } from 'vue'
+import { useRouter } from 'vitepress'
+
+const router = useRouter()
+
+onMounted(() => {
+  // Redirects incoming root traffic to the /en/ folder
+  router.go('/en/')
+})
+</script>
@@ -1,4 +1,4 @@
-!!! Attenzione "Questo sito è ancora in costruzione"
+::: warning "Questo sito è ancora in costruzione"

 	Questo sito è in fase di lavorazione.
 	
@@ -1,4 +1,4 @@
-!!! Attenzione "Questo sito è ancora in costruzione"
+::: warning "Questo sito è ancora in costruzione"

 	Questo sito è in fase di lavorazione.
 	
@@ -1,4 +1,4 @@
-!!! Attenzione "Questo sito è ancora in costruzione"
+::: warning "Questo sito è ancora in costruzione"

 	Questo sito è in fase di lavorazione.
 	
@@ -1,4 +1,4 @@
-!!! Attenzione "Questo sito è ancora in costruzione"
+::: warning "Questo sito è ancora in costruzione"

 	Questo sito è in fase di lavorazione.
 	
@@ -1,4 +1,4 @@
-!!! Attenzione "Questo sito è ancora in costruzione"
+::: warning "Questo sito è ancora in costruzione"

 	Questo sito è in fase di lavorazione.
 	
@@ -2,7 +2,7 @@
 hide:
  - navigation
 ---
-!!! Attenzione "Questo sito è ancora in costruzione"
+::: warning "Questo sito è ancora in costruzione"

 	Questo sito è in fase di lavorazione.
 	
@@ -4,7 +4,7 @@ hide:
 ---
 # Regole della comunità di BeamMP

-!!! info
+::: info
    I moderatori non sono strettamente legati a queste regole e applicano queste ultime secondo loro discrezioni. In aggiunta a queste regole, si applicano anche le regole delle [community di Discord](https://discord.com/guidelines/) e i [Termini di Servizio](https://discord.com/terms/).
 	
 ## Regole generali di BeamMP (applicate al Discord, forum e in gioco):
@@ -43,5 +43,5 @@ hide:

 Tutti gli appelli sono investigati scrupolosamente, da almeno due (2) membri dello staff/moderatori che non erano coinvolti nel caso in questione. Il membro dello staff che ha emesso il ban potrà commentare, ma non potrà decidere il risultato dell'appello. Il risultato dell'appello al ban è definitivo e non può essere controbattuto. BeamMP si riserva il diritto di ammettere o meno i membri come ritiene opportuno in base alle [Linee guida della comunità BeamMP](https://forum.beammp.com/t/beammp-rules/282059), ai [ToS di Discord](https://discord.com/terms) e ad [altri fattori](https://forum.beammp.com/category/28/ban-appeal).

-!!! warning
+::: warning
    Nel caso il tuo account (Discord o BeamMP) sia stato bannato, non puoi crearne uno nuovo per aggirare il ban.
@@ -1,4 +1,4 @@
-!!! warning "Questo sito è in costruzione!"
+::: warning "Questo sito è in costruzione!"

    Questo sito è attualmente in fase di lavorazione.

@@ -3,7 +3,7 @@ title: Guides
 description: This set of pages provides some basic guides for BeamMP
 status: new
 ---
-!!! Attenzione "Questo sito è ancora in costruzione"
+::: warning "Questo sito è ancora in costruzione"

 	Questo sito è in fase di lavorazione.
 	
@@ -1,4 +1,4 @@
-!!! warning "Questo sito è in costruzione!"
+::: warning "Questo sito è in costruzione!"

    Questo sito è attualmente in fase di lavorazione.

@@ -1,22 +1,47 @@
 ---
-hide:
-  - navigation
+layout: home
+
+hero:
+  name: Documentazione BeamMP
+  text: Tutto quello che devi sapere
+  tagline: Guide complete per giocatori, proprietari di server e sviluppatori
+  image:
+    src: /assets/core/beammp_dark.png
+    alt: BeamMP
+  actions:
+    - theme: brand
+      text: Inizia
+      link: /it/game/getting-started
+    - theme: alt
+      text: Visualizza su GitHub
+      link: https://github.com/beammp/docs
+
+features:
+  - icon: 🎮
+    title: Per i Giocatori
+    details: Scopri come installare BeamMP, connettersi ai server e ottenere il massimo dalla tua esperienza multiplayer
+    link: /it/game/getting-started
+  - icon: 🖥️
+    title: Per i Proprietari di Server
+    details: Configura e gestisci il tuo server BeamMP con le nostre guide complete e risorse di risoluzione dei problemi
+    link: /it/server/create-a-server
+  - icon: 💻
+    title: Per gli Sviluppatori
+    details: Crea mod, risorse e app UI con documentazione API dettagliata ed esempi di codice
+    link: /it/guides/index
+  - icon: ❓
+    title: Domande Frequenti
+    details: Trova risposte rapide alle domande più frequenti su configurazione, risoluzione dei problemi e best practice
+    link: /it/FAQ/player-faq
+  - icon: 📋
+    title: Regole della Comunità
+    details: Scopri le nostre linee guida sulla comunità e come segnalare problemi o contestare decisioni
+    link: /it/community/rules
+  - icon: 🔗
+    title: Comunità
+    details: Unisciti al nostro Discord, seguici sui social media e connettiti con altri giocatori e sviluppatori BeamMP
+    link: /it/community/index
 ---
-!!! warning "Questo sito è in costruzione!"
-
-    Questo sito è attualmente in fase di lavorazione.
-
-    Pensate di poter aiutare? Per favore, fatelo cliccando sulla pagina con una matita a destra!
-
-    Questo può essere fatto anche su qualsiasi altra pagina.
-
-# Benvenuti su BeamMP Docs! :tada:
-
-Benvenuti nel centro documentazione rinnovato per BeamMP! Che tu sia un giocatore, un proprietario di server o uno sviluppatore, abbiamo le risorse di cui hai bisogno per migliorare la tua esperienza multiplayer su BeamNG.drive.
-
-## Per i Giocatori
-
-Sei nuovo su BeamMP? Dai un'occhiata alla nostra [Guida Introduttiva](../game/getting-started.md) per aiutarti a iniziare e trarre il massimo dalle tue avventure multiplayer. Se hai delle domande guarda le [FAQ del giocatore](../support/player-faq.md).

 ## Per i Proprietari di Server

@@ -0,0 +1,57 @@
+{
+  "Home": "Home",
+  "Support": "Supporto",
+  "Playing BeamMP": "Giocare a BeamMP",
+  "Installing BeamMP": "Installazione di BeamMP",
+  "Error Codes": "Codici di errore",
+  "Multiplayer Settings": "Impostazioni multigiocatore",
+  "Running a BeamMP-Server": "Eseguire un server",
+  "Server Installation": "Installazione del server",
+  "Port Forwarding": "Reindirizzamento delle porte",
+  "Server Maintenance": "Manutenzione del server",
+  "Server Manual": "Manuale del server",
+  "Mod & Resource Creation": "Creazione di Mod e Risorse",
+  "Client Side": "Lato client",
+  "Server Side": "Lato server",
+  "FAQ": "FAQ",
+  "How to check for CGNAT?": "Come verificare la presenza di CGNAT?",
+  "Where can I find my IP address?": "Dove posso trovare il mio indirizzo IP?",
+  "How to remove mods?": "Come si rimuovono le mod?",
+  "Manually updating the Launcher": "Aggiornamento manuale del Launcher",
+  "Changing the Launcher port": "Cambiare la porta del Launcher",
+  "Creating Exclusions (Defender)": "Creazione di esclusioni (Defender)",
+  "Player FAQ": "FAQ del giocatore",
+  "Game FAQ": "FAQ del gioco",
+  "Server FAQ": "FAQ del server",
+  "Development Guides": "Guide allo Sviluppo",
+  "Development Environment Setup": "Configurazione dell’ambiente di sviluppo",
+  "Mod Creation": "Creazione di Mod",
+  "Resource Creation": "Creazione di Risorse",
+  "Client Scripting Reference": "Riferimento allo scripting client",
+  "Server Resources": "Risorse del server",
+  "BeamNG Documentation": "Documentazione BeamNG",
+  "Content Development": "Sviluppo dei contenuti",
+  "Introduction": "Introduzione",
+  "Programming": "Programmazione",
+  "UI Apps (HTML)": "App UI (HTML)",
+  "ImGui Window Tutorial": "Tutorial finestra ImGui",
+  "Lua Mods (Scripts)": "Mod Lua (script)",
+  "Content": "Contenuti",
+  "Maps": "Mappe",
+  "Props": "Oggetti",
+  "Vehicles": "Veicoli",
+  "Lua Code Snippets": "Snippet di codice Lua",
+  "CSS Code Snippets": "Snippet di codice CSS",
+  "ImGui Code Snippets": "Snippet di codice ImGui",
+  "CEF Code Snippets": "Snippet di codice CEF",
+  "Scripting Reference": "Riferimento allo scripting",
+  "Mod (In-Game)": "Mod (In gioco)",
+  "Server": "Server",
+  "Version 3.X (Latest)": "Versione 3.X (Più recente)",
+  "Version 2.X (Deprecated)": "Versione 2.X (Deprecata)",
+  "Contributing": "Contribuire",
+  "Getting Started": "Primi passi",
+  "Community": "Comunità",
+  "General Information": "Informazioni generali",
+  "Rules": "Regole"
+}
@@ -1,4 +1,4 @@
-!!! warning "Questo sito è ancora in costruzione"
+::: warning "Questo sito è ancora in costruzione"

 	Questo sito è in fase di lavorazione.
 	
@@ -29,7 +29,7 @@ La configurazione consiste di pochi passi che sono obbligatori da seguire.
 Questo passo è necessario se vuoi che qualcuno all'esterno della tua casa ("all'esterno del tuo network locale o LAN") possa accedere al server.

 ####
-!!! danger ":material-scale-balance: LIMITAZIONE DI RESPONSABILITA':"
+::: danger ":material-scale-balance: LIMITAZIONE DI RESPONSABILITA':"
 	
    **Port forward è rischioso**

@@ -17,6 +17,6 @@ Questa pagina contiene tutti i possibili errori del server.
 | 10064  | Host inattivo                    | Errore non comune, significa che l'host è inattivo perché è spento o perché ha le porte chiuse.                                             |
 | 10065  | Host non raggiungibile           | Nessuna connessione ad internet oppure port forward non corretto, guarda la [guida di installazione](create-a-server.md#1-port-forwarding). |

-!!! note
+::: note
 	Altri codici non riportati in tabella sono disponibili qui <https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2> se sai un po' come funzionano le reti e i socket.

@@ -0,0 +1,255 @@
+---
+title: Navigation Structure Proposal
+description: Proposed information architecture and navigation for BeamMP Docs
+status: draft
+---
+
+# BeamMP Docs Navigation Proposal
+
+## Goal
+Make docs easier to navigate for first-time users while still supporting advanced/server/developer workflows.
+
+## Key Problems in Current Nav
+- Audience types are mixed together (players, server owners, developers).
+- BeamMP-specific docs and BeamNG/game docs are split in ways that are not obvious to new users.
+- FAQ and troubleshooting content is scattered.
+- Sidebar mirrors global nav, making in-section navigation noisy.
+
+## Proposed Top-Level Navigation
+1. Get Started
+2. Players
+3. Server Owners
+4. Developers
+5. Game Documentation
+6. Troubleshooting
+7. Community
+
+## Full Proposed Navigation Tree (At a Glance)
+
+```text
+Home
+├─ Get Started
+│  ├─ Install BeamMP
+│  ├─ Join Your First Server
+│  └─ First-Time Multiplayer Settings
+├─ Players
+│  ├─ Gameplay Basics
+│  ├─ Multiplayer Settings
+│  ├─ Player FAQ
+│  └─ Mod Safety & Local Mod Management
+├─ Server Owners
+│  ├─ Host a Server
+│  ├─ Port Forwarding
+│  ├─ Check for CGNAT
+│  ├─ Server Maintenance
+│  ├─ Server FAQ
+│  └─ Server Error Codes
+├─ Developers (BeamMP)
+│  ├─ Development Environment Setup
+│  ├─ Mod & Resource Creation
+│  └─ BeamMP Scripting Reference
+│     ├─ Mod (In-Game)
+│     └─ Server
+│        ├─ v3 (Latest)
+│        └─ v2 (Legacy)
+├─ Game Documentation (BeamNG)
+│  ├─ Content Development Introduction
+│  ├─ Programming
+│  │  ├─ UI Apps (HTML/CEF)
+│  │  ├─ Lua
+│  │  └─ ImGui
+│  ├─ Content Creation
+│  │  ├─ Maps
+│  │  ├─ Props
+│  │  └─ Vehicles
+│  └─ Code Snippets
+│     ├─ Lua
+│     ├─ CSS
+│     ├─ ImGui
+│     └─ CEF
+├─ Troubleshooting
+│  ├─ Launcher Update Issues
+│  ├─ Connection / Networking Issues
+│  ├─ Error Codes (Game + Server)
+│  └─ Defender / Firewall Exclusions
+└─ Community
+  ├─ Community Info
+  ├─ Rules
+  └─ Contributing
+```
+
+## Proposed File & Folder Structure (Markdown)
+
+The navigation changes above can be supported by restructuring content into audience-first sections.
+
+### Canonical source structure (English)
+
+```text
+docs/
+└─ en/
+  ├─ index.md
+  ├─ get-started/
+  │  ├─ index.md
+  │  ├─ install-beammp.md
+  │  ├─ join-first-server.md
+  │  └─ multiplayer-settings-quickstart.md
+  ├─ players/
+  │  ├─ index.md
+  │  ├─ gameplay-basics.md
+  │  ├─ multiplayer-settings.md
+  │  ├─ faq.md
+  │  └─ mod-safety.md
+  ├─ server-owners/
+  │  ├─ index.md
+  │  ├─ host-a-server.md
+  │  ├─ port-forwarding.md
+  │  ├─ cgnat.md
+  │  ├─ maintenance.md
+  │  ├─ faq.md
+  │  └─ error-codes.md
+  ├─ developers/
+  │  ├─ index.md
+  │  ├─ dev-environment-setup.md
+  │  ├─ mod-and-resource-creation.md
+  │  └─ beammp-scripting/
+  │     ├─ index.md
+  │     ├─ mod-in-game.md
+  │     └─ server/
+  │        ├─ latest.md
+  │        └─ legacy-v2.md
+  ├─ game-documentation/
+  │  ├─ index.md
+  │  ├─ content-development/
+  │  │  ├─ index.md
+  │  │  ├─ maps.md
+  │  │  ├─ props.md
+  │  │  └─ vehicles.md
+  │  ├─ programming/
+  │  │  ├─ ui-apps-html-cef.md
+  │  │  ├─ lua.md
+  │  │  └─ imgui.md
+  │  └─ snippets/
+  │     ├─ lua-snippets.md
+  │     ├─ css-snippets.md
+  │     ├─ imgui-snippets.md
+  │     └─ cef-snippets.md
+  ├─ troubleshooting/
+  │  ├─ index.md
+  │  ├─ launcher-update.md
+  │  ├─ connection-networking.md
+  │  ├─ defender-exclusions.md
+  │  └─ error-codes.md
+  └─ community/
+    ├─ index.md
+    ├─ rules.md
+    └─ contributing.md
+```
+
+### Localized content structure
+
+Each locale mirrors the same section layout to keep URLs and nav predictable:
+
+```text
+docs/
+├─ de/
+├─ es/
+├─ fr/
+├─ it/
+├─ ru/
+└─ zh/
+  (same folder pattern as /en)
+```
+
+### Migration notes
+- Start with nav/URL aliases first; avoid breaking links immediately.
+- Move files incrementally by section (Get Started -> Players -> Server Owners -> etc.).
+- Keep redirects for old paths during transition.
+- Treat `/en` as canonical; localizations can follow as translated pages are ready.
+
+## Proposed Section Structure
+
+### 1) Get Started
+- Install BeamMP
+- Join your first server
+- First-time multiplayer settings
+
+### 2) Players
+- Gameplay basics
+- Multiplayer settings
+- Player FAQ
+- Mod safety and local mod management
+
+### 3) Server Owners
+- Create a server
+- Port forwarding
+- CGNAT
+- Server maintenance
+- Server FAQ
+- Server error codes
+
+### 4) Developers (BeamMP-focused)
+- Dev environment setup
+- Mod & resource creation
+- BeamMP scripting reference
+  - Mod (in-game)
+  - Server v3 (primary)
+  - Server v2 (legacy)
+
+### 5) Game Documentation (BeamNG-focused)
+- Content development intro
+- Programming
+  - UI apps (HTML/CEF)
+  - Lua
+  - ImGui
+- Content creation
+  - Maps
+  - Props
+  - Vehicles
+- Code snippets
+  - Lua
+  - CSS
+  - ImGui
+  - CEF
+
+### 6) Troubleshooting
+- Launcher update issues
+- Connection/network issues
+- Error code hubs (game + server)
+- Defender/firewall exclusions
+
+### 7) Community
+- Community info
+- Rules
+- Contributing
+
+## Design Principles
+- Audience-first labels over technical labels.
+- Task-oriented wording (e.g., “Host a Server” instead of “Running a BeamMP-Server”).
+- Keep BeamMP docs separate from BeamNG/game docs, but cross-link both directions.
+- Keep legacy content available but visually de-emphasized.
+- Section-specific sidebars instead of global sidebar duplication.
+
+## Suggested Naming Changes
+- “Support” -> “Players”
+- “Development Guides” -> “Developers”
+- “BeamNG Documentation” -> “Game Documentation”
+- “FAQ” -> split into section-owned FAQ + central Troubleshooting hub
+
+## Rollout Plan (Recommended)
+1. Align on IA and labels (this proposal).
+2. Update global nav only (no URL changes).
+3. Introduce section-specific sidebars.
+4. Add cross-links and “Start here” blocks on section index pages.
+5. Optionally reorganize URLs later if needed.
+
+## Open Questions for Team
+1. Should “Troubleshooting” be a top-level item or integrated into each audience section?
+2. Should “Game Documentation” appear before “Developers” for visibility?
+3. Do we keep one shared FAQ area, or split FAQ by audience entirely?
+4. Should v2 server scripting be moved under an explicit “Legacy” section?
+
+## Success Criteria
+- New users can find installation/joining content in <= 2 clicks.
+- Server owners can find hosting/networking docs in <= 2 clicks.
+- Developers can find BeamMP API docs and BeamNG docs without ambiguity.
+- Lower bounce rate from index pages and fewer support questions for discoverability.
@@ -1,11 +1,11 @@
 # Как создать исключения в брандмауэре и антивирусе Защитника Windows?

-!!! информация
+::: info

 ```
 Перед изменением настроек брандмауэра убедитесь, что ваша сеть в параметрах Windows настроена как частная (при условии, что вы действительно находитесь в частной сети).

-!!! danger ":material-scale-balance: DISCLAIMER:"
+::: danger ":material-scale-balance: DISCLAIMER:"

    **Исключения в Firewall / Defender представляют собой риск**.

@@ -16,7 +16,7 @@

 Откройте командную строку, запустите `tracert -4 beammp.com`. Это выведет серию сетевых переходов. Дождитесь завершения операции (может занять до 30 переходов). Проверьте первые несколько IP-адресов после IP вашего маршрутизатора/модема/шлюза. Если после первого перехода появляется несколько IP-адресов в диапазоне `100.64.xx` - `100.127.xx` или `10.xx.xx.xx`, скорее всего, вы находитесь за CGNAT.

-!!!примечание
+:::примечание

 ```
 Первый переход будет вашим роутером/модемом/шлюзом и отличается в зависимости от устройства.
@@ -32,7 +32,7 @@

 Обратитесь за помощью к своему интернет-провайдеру. В зависимости от вашего интернет-провайдера, они могут не предлагать выделенные *динамические* IP-адреса. Помните, что статический IP-адрес не является обязательным.

-!!! предупреждение
+::: warning

 ```
 Интернет-провайдеры могут предлагать выделенные IP-адреса только как платную услугу.
@@ -2,12 +2,12 @@

 В BeamMP сервер, к которому вы решили подключиться, предоставляет необходимые моды. Они загружаются и активируются автоматически при подключении. Наличие установленных и активных локальных модов часто приводит к тому, что BeamMP не работает должным образом, даже если у вас есть всего один дополнительный мод помимо BeamMP.

-!!! предупреждение
+::: warning

 ```
 Удалите все моды, которые вы разместили в папке BeamNG.Drive\content\ или её подпапках. Это место не предназначено для установки модов и может вызвать проблемы, как указано в файле `DO_NOT_INSTALL_MODS_HERE.txt`, находящемся в той же директории.

-!!! quote "DO_NOT_INSTALL_MODS_HERE.txt"
+::: quote "DO_NOT_INSTALL_MODS_HERE.txt"

    Ни в коем случае не копируйте моды в эту папку: это может привести к повреждению модов, замедлению установки обновлений, неправильной работе менеджера модов, нарушению работы безопасного режима и другим проблемам.
 ```
@@ -34,7 +34,7 @@

 Чтобы очистить кэшированные моды из каталогов BeamMP, перейдите в место установки вашего BeamMP-Launcher. По умолчанию путь будет <code>C:\Users\AppData\BeamMP-Launcher</code>. Там вы найдете папку 'Resources'. Удалите папку, чтобы удалить все кэшированные моды. Это может быть полезно, если вам нужно больше места на диске или вы хотите очистить устаревшие моды BeamNG.

-!!! вопрос "Мои настройки и конфигурации пропали! Как их восстановить?"
+::: question "Мои настройки и конфигурации пропали! Как их восстановить?"

 ```
 Если вы переименовали папку пользователя, вы заставили игру создать новую, чистую папку пользователя. Вы можете скопировать папки "settings" и "vehicles" из папки, которую вы переименовали (например, `current_old`), в новую созданную папку.
@@ -2,7 +2,7 @@

 Launcher не может обновиться или показывает пустой экран? Это краткое руководство объясняет, как вручную обновить Launcher.

-!!! примечание
+::: note

 ```
 Ты должен был уже установить или использовать BeamMP с помощью установщика, предоставленного на [нашем сайте](https://beammp.com), прежде чем продолжить.
@@ -7,7 +7,7 @@
 === Помогите! Мой лаунчер BeamMP не работает! Попробуйте переустановить лаунчер BeamMP. Для этого выполните следующие действия: 1. Перейдите на [сайт beammp.com](https://beammp.com/) 2. Нажмите *«Скачать сейчас»* 3. Запустите установщик и следуйте инструкциям

 ```
-!!! примечание
+::: примечание

 По состоянию на 1 апреля 2026 года, согласно Windows Defender SmartScreen, установщик MSI является «неопознанным приложением».

@@ -17,7 +17,7 @@
 === Помогите! Мои ключи авторизации больше не работают! С 1 апреля 2026 года системы управления ключами и авторизации отключены. Это означает, что ваши ключи авторизации работать не будут. Чтобы обойти это, выполните следующие действия: 1. Откройте файл `ServerConfig.toml` или любой другой файл конфигурации вашего сервера. 2. Установите значение `Private` в `true` . Должно получиться примерно так: `Private = true` 3. Это должно решить проблему с ключами авторизации.

 ```
-!!! примечание
+::: примечание

 С 1 апреля 2026 года системы аутентификации BeamMP отключены. Доступны только гостевые учетные записи.

@@ -1,4 +1,4 @@
-!!! Внимание! "Сайт находится в стадии разработки!"
+::: warning "Сайт находится в стадии разработки!"

 ```
 Работа над этим сайтом активно ведётся.
@@ -1,4 +1,4 @@
-!!! внимание "Этот сайт находится в стадии разработки!"
+::: warning "Этот сайт находится в стадии разработки!"

 ```
 Над этим сайтом ведется активная работа.
@@ -1,4 +1,4 @@
-!!! внимание "Этот сайт находится в стадии разработки!"
+::: warning "Этот сайт находится в стадии разработки!"

 ```
 Над этим сайтом ведется активная работа.
@@ -1,4 +1,4 @@
-!!! внимание "Этот сайт находится в стадии разработки!"
+::: warning "Этот сайт находится в стадии разработки!"

 ```
 Над этим сайтом ведется активная работа.
@@ -1,4 +1,4 @@
-!!! внимание "Этот сайт находится в стадии разработки!"
+::: warning "Этот сайт находится в стадии разработки!"

 ```
 Над этим сайтом ведется активная работа.
@@ -9,37 +9,37 @@ hide:

 ## Наши страницы в социальных сетях

-!!!сбой ""
+:::сбой ""

 ```
 BeamMP Форум - [https://forum.beammp.com](https://forum.beammp.com)
 ```

-!!!цитата ""
+:::цитата ""

 ```
 X (Twitter) - [https://x.com/BeamMPOfficial](https://x.com/BeamMPOfficial)
 ```

-!!!опасность ""
+:::опасность ""

 ```
 YouTube - [https://www.youtube.com/@BeamMPOfficial](https://www.youtube.com/@BeamMPOfficial)
 ```

-!!!внимание ""
+:::внимание ""

 ```
 Patreon - [https://www.patreon.com/c/BeamMP](https://www.patreon.com/c/BeamMP)
 ```

-!!!примечание ""
+:::примечание ""

 ```
 Discord - [https://discord.com/invite/beammp](https://discord.com/invite/beammp)
 ```

-!!!информация ""
+:::информация ""

 ```
 BlueSky - [https://bsky.app/profile/beammpofficial.bsky.social](https://bsky.app/profile/beammpofficial.bsky.social)
--- a/Show More
+++ b/Show More