> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# مرجع المتغيرات

> كل متغيّر عنصر نائب في فيتوكس، مجموّعاً بحسب الميزة — ولماذا يستخدم بعضها الأقواس المربّعة والبعض الآخر الأقواس المعقوفة.

المتغيرات عناصر نائبة تُستبدل بقيم حقيقية عند إرسال الرسالة.

## صياغتان مختلفتان

<Warning>
  **يستخدم فيتوكس صياغتين، وهما غير قابلتين للتبادل.**

  | الصياغة    | يستخدمها                           |
  | ---------- | ---------------------------------- |
  | `[Square]` | رسائل نظام الترحيب والوداع والتحية |
  | `{curly}`  | كل شيء آخر                         |

  `{User}` في رسالة ترحيب تُطبع حرفياً. `[user]` في رسالة تذكرة تُطبع حرفياً.
</Warning>

## القاعدة العامة

<Warning>
  **المتغيّر غير المعروف يصبح نصاً فارغاً، لا خطأً** — وفي embeds، **الحقل الذي ينتهي عنوانه أو قيمته فارغاً يُسقَط من الرسالة كلياً.**

  هذا هو السبب الأكثر شيوعاً لـ "حقل embed لديّ يستمر بالاختفاء". غالباً متغيّر مكتوب خطأً أو غير موجود لتلك الميزة.
</Warning>

## نظام الترحيب والوداع والتحية

| المتغيّر       | القيمة                              |
| -------------- | ----------------------------------- |
| `[User]`       | العضو                               |
| `[ServerName]` | اسم سيرفرك                          |
| `[UsersCount]` | عدد الأعضاء الجديد                  |
| `[Inviter]`    | من دعاه — للترحيب فقط               |
| `[Code]`       | رمز الدعوة المُستخدَم — للترحيب فقط |
| `[CountUrl]`   | رابط صورة عدد الأعضاء — للترحيب فقط |

<Warning>
  **`[Server]` ليس متغيّراً.** يظهر في رسالة الترحيب الافتراضية ويُطبع حرفياً. استبدله بـ `[ServerName]`.
</Warning>

<Note>
  `[Inviter]` و`[Code]` يحتاجان إلى **Manage Server** ليتمكّن فيتوكس من قراءة الدعوات.
</Note>

## التذاكر

المجموعة الأغنى في فيتوكس. قابلة للاستخدام في embeds التذاكر، وصيغ أسماء القنوات، ورسائل ساعات الدعم.

<AccordionGroup>
  <Accordion title="العضو" icon="user">
    `{user}` `{mention}` `{username}` `{userid}` `{user.mention}` `{user.name}` `{user.username}` `{user.tag}` `{user.id}`
  </Accordion>

  <Accordion title="التذكرة" icon="ticket">
    `{ticket}` `{number}` `{num}` `{ticket.number}` `{ticket-number}` `{#number}` `{ticket.channel}` `{ticket.channelName}` `{ticket.priority}` `{ticket.closeReason}` `{ticket.openedAt}` `{ticket.createdAt}` `{ticket.closedAt}` `{ticket.users}`
  </Accordion>

  <Accordion title="القناة، واللوحة، والخيار" icon="hashtag">
    `{channel}` `{channel.mention}` `{channel.name}` `{channel.id}` `{panel}` `{panel.name}` `{panel-name}` `{option}` `{option.label}`
  </Accordion>

  <Accordion title="السيرفر" icon="server">
    `{server}` `{server.name}` `{server.id}` `{server.members}` `{server.icon}` `{server.banner}` `{guild}` `{members}`
  </Accordion>

  <Accordion title="الطاقم والإجراءات" icon="user-shield">
    `{staff}` `{staff.mention}` `{staff.name}` `{claim.user}` `{claim.name}` `{close.user}` `{close.name}` `{close.reason}` `{escalate.reason}` `{escalate.panel}` `{reason}`
  </Accordion>

  <Accordion title="إجابات النموذج" icon="clipboard-list">
    `{form.1}`, `{form.2}` … — **مفهرسة من 1**، بترتيب ظهور أسئلتك.

    `{form.Label}` تعمل أيضاً باستخدام تسمية السؤال نفسه.
  </Accordion>

  <Accordion title="الوقت والإحصاءات" icon="clock">
    `{date}` `{time}` `{timestamp}` `{time.created}` `{time.opened}` `{time.claimed}` `{time.closed}` — كل منها يقبل أيضاً `.age`.

    `{statistics.tickets.open}` `{statistics.tickets.created}` `{statistics.tickets.closed}` `{statistics.tickets.claimed}` `{statistics.tickets.averageRating}`
  </Accordion>

  <Accordion title="ساعات الدعم" icon="business-time">
    `{supportHours.status}` `{supportHours.nextOpen}` `{supportHours.nextOpenTime}` `{supportHours.nextOpenRelative}` `{supportHours.closesAt}` `{supportHours.closesAtTime}`
  </Accordion>
</AccordionGroup>

### المُعدِّلات

متغيّرات التذاكر تقبل مُعدِّلات بصياغة `{variable?modifier=value}`: `upper`، `lower`، `capitalize`، `truncate`، `slice`، `padleft`، `padright`، `replace`، `fallback`، `date`، `timestamp`، `math`، `ordinal`، `join`، `if`.

<Tip>
  `{user.name?upper}` يصرخ بالاسم. `{ticket.closeReason?fallback=No reason given}` يتجنّب سقوط حقل فارغ — وهو أنظف حل لحقول embed المتلاشية.
</Tip>

## Counting

`{count}` `{user}` `{record}` — بالإضافة إلى `{start}` و`{savesLeft}` في رسائل إعادة الضبط والحفظ.

<Warning>
  `{server}` مُقدَّم لكن **يُعرَض دائماً فارغاً**. اكتب اسم سيرفرك مباشرة.
</Warning>

## ستاربورد

`{author}` `{stars}` `{channel}` `{link}` `{content}` `{emoji}`

## Self-Roles

`[Role]` — اسم الرتبة، في إشعارات الرسائل الخاصة.

## قوالب الهدايا

`{prize}` `{winners}` `{host}` `{endsAt}` `{id}` `{description}` `{requiredRole}` `{minAccountAge}` `{entryCount}`

## الإشعارات

كل منصة لها مجموعتها الخاصة. استخدام متغيّر لمنصة على منصة أخرى ينتج فارغاً.

<AccordionGroup>
  <Accordion title="تويتش" icon="twitch">
    `{streamer.name}` `{streamer.url}` `{streamer.avatar}`

    مباشر فقط: `{stream.title}` `{stream.game}` `{stream.viewers}` `{stream.thumbnail}`
  </Accordion>

  <Accordion title="كيك" icon="tower-broadcast">
    `{streamer.name}` `{streamer.url}` `{streamer.avatar}`

    مباشر فقط: `{stream.title}` `{stream.category}` `{stream.viewers}` `{stream.thumbnail}`

    لاحظ `{stream.category}`، لا `{stream.game}` في تويتش.
  </Accordion>

  <Accordion title="يوتيوب" icon="youtube">
    `{channel.name}` `{channel.avatar}` `{video.title}` `{video.url}` `{video.thumbnail}` `{video.type}`
  </Accordion>

  <Accordion title="ريديت" icon="reddit">
    `{post.title}` `{post.url}` `{post.author}` `{post.content}` `{post.flair}` `{post.thumbnail}` `{subreddit.name}` `{subreddit.url}` `{subreddit.icon}`
  </Accordion>

  <Accordion title="بلوسكاي" icon="cloud">
    `{post.text}` `{post.url}` `{post.image}` `{post.likes}` `{author.name}` `{author.handle}` `{author.avatar}`
  </Accordion>

  <Accordion title="ستيم" icon="steam">
    `{news.title}` `{news.url}` `{news.content}` `{news.category}` `{news.author}` `{game.name}` `{game.image}`
  </Accordion>

  <Accordion title="RSS" icon="rss">
    `{item.title}` `{item.url}` `{item.description}` `{item.author}` `{feed.name}` `{feed.url}`
  </Accordion>

  <Accordion title="Podcasts" icon="podcast">
    عاملة: `{episode.title}` `{episode.url}` `{episode.description}` `{podcast.name}`

    <Warning>
      `{episode.duration}` و`{podcast.author}` و`{podcast.artwork}` مُقدَّمة لكنها **لا تنتج قيمة أبداً**. أي حقل مبني عليها فقط يُسقَط.
    </Warning>
  </Accordion>
</AccordionGroup>

## متغيّرات لا تعمل

<Warning>
  مؤكَّد أنها غير عاملة. تجنّب هذه:

  | المتغيّر                                    | أين                             | السلوك                                                                 |
  | ------------------------------------------- | ------------------------------- | ---------------------------------------------------------------------- |
  | `[Server]`                                  | نظام الترحيب                    | ليس متغيّراً — يُطبع حرفياً                                            |
  | `{server}`                                  | معالم Counting                  | فارغ دائماً                                                            |
  | `{episode.duration}`                        | Podcasts                        | فارغ دائماً                                                            |
  | `{podcast.author}`                          | Podcasts                        | فارغ دائماً                                                            |
  | `{podcast.artwork}`                         | Podcasts                        | فارغ عادةً                                                             |
  | `{username}` و`{server.name}` و`{nickname}` | **إجراءات سير عمل الطلبات**     | فارغة دائماً — تعمل في رسائل الرسائل الخاصة لكن ليس في قوالب الإجراءات |
  | `{stream.*}`                                | إعلانات تويتش/كيك **دون اتصال** | فارغة؛ مباشرة فقط                                                      |
</Warning>

<Card title="استكشاف الأخطاء" icon="wrench" horizontal href="/ar/help/troubleshooting">
  عندما لا تصل الرسالة أصلاً.
</Card>