گیم روت
API و توسعه‌دهندگان

ابزارک‌ها و بنرها

بدون یک خط کد هم می‌توانید وضعیت سرورتان را در سایت، انجمن یا صفحه گیت‌هاب نشان دهید. ابزارک‌ها کلید نمی‌خواهند و از سهمیه درخواست شما کم نمی‌کنند.

سازنده کد#

ساده‌ترین راه، پنل سرور، بخش API، وبهوک و ابزارک و زبانه ابزارک و بنر است: اندازه و پوسته را انتخاب کنید، پیش‌نمایش را ببینید و کد HTML، BBCode یا Markdown را کپی کنید.

بنر تصویری#

متن
https://gameroute.ir/api/v1/widgets/{server}/{size}.{png|svg}?theme={theme}
اندازه (size)ابعادمناسب برای
badge۲۲۰ × ۴۰امضای انجمن، کنار متن
banner۴۶۸ × ۶۰بنر کلاسیک انجمن‌ها و وبلاگ‌ها
card۳۵۰ × ۱۲۰ستون کناری سایت، همراه نوار ظرفیت
leaderboard۷۲۸ × ۹۰بالای صفحه سایت
پوسته (theme)ظاهر
dark (پیش‌فرض)زمینه تیره
lightزمینه روشن
accentزمینه تیره با حاشیه رنگی

بنر نام سرور، بازی، آدرس، وضعیت (آنلاین، آفلاین یا «وضعیت نامشخص» اگر بیش از ۵ دقیقه بررسی نشده) و تعداد بازیکنان را با فونت گیم روت و ارقام فارسی نشان می‌دهد.

  • PNG را برای انجمن‌ها و جاهایی که SVG نمی‌پذیرند استفاده کنید. تصویر با وضوح دو برابر ساخته می‌شود تا روی نمایشگرهای پرتراکم هم تیز باشد؛ ابعاد نمایش را با width و height تعیین کنید.
  • SVG سبک‌تر و همیشه تیز است و فونتش داخل فایل است.

کد جاسازی#

HTML
<a href="https://gameroute.ir/servers/iran-craft" target="_blank" rel="noopener">
  <img src="https://gameroute.ir/api/v1/widgets/iran-craft/banner.png" width="468" height="60" alt="Iran Craft در گیم روت">
</a>
متن
[url=https://gameroute.ir/servers/iran-craft][img]https://gameroute.ir/api/v1/widgets/iran-craft/banner.png[/img][/url]
متن
[![Iran Craft در گیم روت](https://gameroute.ir/api/v1/widgets/iran-craft/badge.svg?theme=light)](https://gameroute.ir/servers/iran-craft)

کارت زنده (iframe)#

کارت iframe نام، لوگو، امتیاز، وضعیت، نوار ظرفیت، آدرس با دکمه کپی و رکورد سرور را نشان می‌دهد و تا وقتی صفحه باز است، هر دقیقه خودش را به‌روز می‌کند.

HTML
<iframe src="https://gameroute.ir/embed/server/iran-craft" width="380" height="190" style="border:0;border-radius:16px" loading="lazy" title="Iran Craft در گیم روت"></iframe>

ابعاد پیشنهادی ۳۸۰ × ۱۹۰ است و کارت تا عرض حدود ۲۶۰ پیکسل جمع می‌شود.

کش و ایندکس#

مدت کشایندکس موتور جست‌وجو
بنر SVG و PNG۶۰ ثانیه (با اجازه نمایش نسخه قدیمی‌تر تا ۵ دقیقه هنگام به‌روزرسانی)خیر (X-Robots-Tag: noindex)
کارت iframeحدود ۶۰ ثانیه، به‌علاوه به‌روزرسانی زنده در مرورگرخیر (noindex)

بعضی انجمن‌ها و شبکه‌های اجتماعی تصویرها را روی سرور خودشان کش می‌کنند و ممکن است بنر را دیرتر به‌روز نشان دهند؛ این خارج از کنترل گیم روت است.

نکته‌ها#

  • اگر نامک سرور اشتباه باشد یا سرور هنوز تأیید نشده باشد، بنر «سرور یافت نشد» با کد 404 برمی‌گردد (تصویر شکسته نمایش داده نمی‌شود).
  • اگر نامک سرور را عوض کنید، آدرس بنرها هم عوض می‌شود؛ می‌توانید به جای نامک از شناسه سرور استفاده کنید که هیچ‌وقت تغییر نمی‌کند.
  • به ابزارک‌ها پیوند صفحه سرورتان در گیم روت را بدهید تا بازیکنان با یک کلیک به صفحه و آدرس اتصال برسند.
  • برای طراحی کاملاً سفارشی، داده را از API وضعیت بخوانید و خودتان نمایش دهید.