Terraria · راهنما

راهنمای TShock: راه‌اندازی، دستورها و دسترسی‌ها

به‌روزرسانی October 11, 2026 6 دقیقه مطالعه

در این صفحه
  1. نسخه‌های TShock و Terraria
  2. راه‌اندازی اولیه: ساخت حساب مالک
  3. گروه‌ها و دسترسی‌ها
  4. دستورهای TShock (دستورهای سرور Terraria)
  5. محافظت از سازه‌ها با مناطق
  6. کاراکترهای سمت سرور
  7. فایل پیکربندی و REST API
  8. TShock در HytHost
  9. پرسش‌های متداول

TShock یک سرور ساده Terraria را به سروری تبدیل می‌کند که واقعاً می‌توانید به‌عنوان ادمین اداره‌اش کنید: حساب‌ها و گروه‌ها، بن، مناطق محافظت‌شده، دستورهای آیتم و هیولا، کاراکترهای سمت سرور و ضدتقلب. این گزینه استاندارد برای سرورهای عمومی Terraria است.

این راهنما راه‌اندازی اولیه، گروه‌ها و دسترسی‌ها، دستورهایی که هر روز استفاده می‌کنید، مناطق، کاراکترهای سمت سرور، REST API و تنظیمات اصلی پیکربندی را پوشش می‌دهد.

نسخه‌های TShock و Terraria

TShock هر بار برای یک نسخه دقیق از Terraria ساخته می‌شود. نسخه فعلی، TShock 6.2.1، با Terraria 1.4.5.8 کار می‌کند. بازیکنان باید همان نسخه Terraria سرور را داشته باشند.

وقتی Terraria به‌روز می‌شود، پیش از به‌روزرسانی سرور منتظر نسخه منطبق TShock بمانید. قبل از ارتقای TShock، از tshock.sqlite و کل پوشه tshock نسخه پشتیبان بگیرید: حساب‌ها، گروه‌ها، بن‌ها و مناطق شما در آن‌ها نگه داشته می‌شوند.

راه‌اندازی خود سرور، همراه با پورت‌ها و دنیاها، در چگونه سرور Terraria بسازیم توضیح داده شده است.

راه‌اندازی اولیه: ساخت حساب مالک

در اولین اجرا، TShock یک کد راه‌اندازی در کنسول چاپ می‌کند و آن را در tshock/setup-code.txt ذخیره می‌کند. وارد سرور شوید و تایپ کنید:

/setup 123456
/user add YourName YourPassword owner
/login YourName YourPassword
/setup

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

با گروه owner بازی کنید. TShock یک superadmin داخلی هم دارد، اما توسعه‌دهندگانش توصیه می‌کنند با آن بازی نکنید: همه چیز را دور می‌زند، از جمله کاراکترهای سمت سرور.

TShock را هنگام سفارش انتخاب کنید یا بعداً در پنل به آن تغییر دهید: هاست Terraria در HytHost از €2.59 در ماه شروع می‌شود.

مشاهده پلن‌های Terraria

گروه‌ها و دسترسی‌ها

هر بازیکن عضو یک گروه است و دسترسی‌ها در گروه‌ها تعریف می‌شوند. TShock به‌طور پیش‌فرض این گروه‌ها را می‌سازد: guest (وارد نشده)، default (بازیکنان ثبت‌نام‌شده)، vip، newadmin، admin، trustedadmin و owner.

دستورکاری که انجام می‌دهد
/group add builderیک گروه می‌سازد
/group parent builder defaultباعث می‌شود دسترسی‌های گروه دیگری را به ارث ببرد
/group addperm builder tshock.world.editregionیک دسترسی اضافه می‌کند
/group delperm builder tshock.world.editregionیک دسترسی را حذف می‌کند
/group listperm builderدسترسی‌های گروه را فهرست می‌کند
/user group Alex builderحساب یک بازیکن را به یک گروه منتقل می‌کند

بازیکنان خودشان با /register password حساب می‌سازند و با /login وارد می‌شوند. برای جلوگیری از ساخت‌وساز بازیکنان ثبت‌نام‌نشده، RequireLogin را در پیکربندی روی true بگذارید.

دستورهای TShock (دستورهای سرور Terraria)

دستورکاری که انجام می‌دهد
/kick Name reasonبازیکن را بیرون می‌اندازد
/ban add Name reason 7dبازیکن را بن می‌کند، اینجا برای ۷ روز؛ بدون مدت، بن دائمی است
/ban list / /ban del 3بن‌ها را فهرست می‌کند، یا بن شماره ۳ را حذف می‌کند
/mute Nameبازیکن را در چت بی‌صدا می‌کند
/tp Name / /tphere Nameشما را نزد بازیکن تلپورت می‌کند، یا او را نزد شما می‌آورد
/item "Iron Pickaxe" 1یک آیتم به شما می‌دهد
/give "Healing Potion" Name 10به بازیکن دیگری آیتم می‌دهد
/butcherهمه NPCهای متخاصم را می‌کشد
/time dayزمان را تنظیم می‌کند: day، night، noon، midnight
/spawnmob Zombie 5نزدیک شما هیولا ظاهر می‌کند
/save / /offدنیا را ذخیره می‌کند، یا ذخیره و سرور را خاموش می‌کند
/reloadپیکربندی و دسترسی‌ها را دوباره بارگذاری می‌کند

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

محافظت از سازه‌ها با مناطق

مناطق مانع می‌شوند بازیکنان دیگر محدوده‌ای مثل نقطه شروع یا یک شهر را تغییر دهند.

/region set 1
/region set 2
/region define spawn
/region protect spawn true
/region allow Alex spawn
/region allowg builder spawn

پس از /region set 1، به یک بلوک ضربه بزنید تا گوشه اول علامت بخورد؛ برای گوشه ۲ هم همین کار را بکنید. سپس منطقه را نام‌گذاری کنید و از آن محافظت کنید. allow به یک بازیکن اجازه ساخت در داخل می‌دهد و allowg به یک گروه کامل. /region list و /region info spawn نشان می‌دهند چه چیزی وجود دارد.

توجه کنید که از TShock 6، محافظت خودکار نقطه شروع به‌طور پیش‌فرض خاموش است (SpawnProtection در پیکربندی). به هر حال، یک منطقه دور نقطه شروع کنترل دقیق‌تری به شما می‌دهد.

کاراکترهای سمت سرور

معمولاً کاراکتر هر بازیکن، همراه با موجودی‌اش، روی کامپیوتر خود او ذخیره می‌شود، پس بازیکنان می‌توانند آیتم‌هایی از دنیاهای دیگر یا کاراکترهای ویرایش‌شده بیاورند. کاراکترهای سمت سرور (SSC) در عوض کاراکترها را روی سرور ذخیره می‌کنند تا همه منصفانه پیشرفت کنند.

  • آن را در tshock/sscconfig.json با "Enabled": true فعال کنید و سرور را ری‌استارت کنید.
  • تعیین کنید کاراکترهای جدید با چه چیزی شروع کنند: StartingHealth، StartingMana و StartingInventory.
  • ادمین‌هایی که دسترسی tshock.ignore.ssc دارند در SSC ذخیره نمی‌شوند.

زود تصمیم بگیرید: وقتی SSC روشن شود، بازیکنان با موجودی شروع آغاز می‌کنند و ادمین باید کاراکتر موجود را با /uploadssc وارد کند. روشن کردن آن در ادامه، بازیکنان همیشگی را غافلگیر می‌کند.

فایل پیکربندی و REST API

تنظیمات TShock در tshock/config.json قرار دارند. مواردی که بیشتر سرورها تغییر می‌دهند:

  • ServerPassword: رمز عبور برای ورود؛
  • MaxSlots: سقف تعداد بازیکنان (به‌طور پیش‌فرض 8)؛
  • RequireLogin: بازیکنان باید پیش از بازی وارد شوند؛
  • EnableWhitelist: فقط آدرس‌های مجاز می‌توانند وارد شوند؛
  • BackupInterval: هر چند وقت یک‌بار TShock از دنیا نسخه پشتیبان می‌گیرد.

تغییرات را با /reload اعمال کنید، یا برای تنظیماتی که لازم دارند سرور را ری‌استارت کنید.

REST API به وب‌سایت‌ها و ابزارها اجازه می‌دهد سرور را از طریق HTTP کنترل کنند، به‌طور پیش‌فرض روی پورت 7878. این قابلیت به‌طور پیش‌فرض خاموش است (RestApiEnabled) و تا وقتی به آن نیاز ندارید باید خاموش بماند: یک توکن REST می‌تواند هر دستور سرور را با دسترسی‌های حسابی که به آن تعلق دارد اجرا کند. اگر از آن استفاده می‌کنید، به حساب توکن فقط دسترسی‌هایی را بدهید که ابزار لازم دارد و هرگز توکن را منتشر نکنید.

TShock در HytHost

در هاست Terraria در HytHost، TShock با یک کلیک در دسترس است: هنگام سفارش انتخابش کنید، یا بعداً در زبانه Software پنل به آن تغییر دهید؛ دنیا، رمز عبور، MOTD و اسلات‌های شما حفظ می‌شوند. سرور TShock 6.2.1 را برای Terraria 1.4.5.8 اجرا می‌کند و REST API به‌طور پیش‌فرض خاموش است.

کد راه‌اندازی در اولین اجرا در کنسول پنل نمایش داده می‌شود و config.json و sscconfig.json را در مدیر فایل ویرایش می‌کنید.

پرسش‌های متداول

پرسش‌های متداول

در اولین اجرا، از کد راه‌اندازی کنسول استفاده کنید: /setup code، سپس /user add Name Password owner، /login Name Password و دوباره /setup برای بستن راه‌اندازی.

TShock آن را در اولین اجرا در کنسول سرور چاپ می‌کند و در tshock/setup-code.txt ذخیره می‌کند. فقط تا زمانی کار می‌کند که اولین حساب ساخته شود.

TShock 6.2.1 از Terraria 1.4.5.8 پشتیبانی می‌کند. هر نسخه TShock برای یک نسخه Terraria ساخته شده و بازیکنان باید همان نسخه سرور را داشته باشند.

با یک منطقه از آن محافظت کنید: /region set 1 و /region set 2 برای علامت‌گذاری گوشه‌ها، /region define spawn، سپس /region protect spawn true.

فقط اگر ابزاری به آن نیاز دارد. REST API می‌تواند هر دستور سرور را اجرا کند، پس آن را به‌طور پیش‌فرض خاموش نگه دارید، توکنش را به حسابی با کمترین دسترسی بدهید و هرگز توکن را به اشتراک نگذارید.

یک سرور TShock راه بیندازید

هاست Terraria در HytHost شامل TShock، Vanilla و tModLoader است که از پنل قابل تغییرند، از €2.59 در ماه.

Live chat 8 AM – 11 PM (Chișinău time) · tickets answered during business hours

این راهنما برایتان مفید بود؟