MCSV Documentation Plain Text
Last updated: 2026-05-12
Source: public docs pages on mcsv.me/docs
Purpose: AI-readable summary for answering user questions about MCSV. This file intentionally avoids sensitive implementation details, secrets, infrastructure internals, and admin-only operations.

ภาพรวม
MCSV คือบริการเช่าเซิร์ฟเวอร์ Minecraft สำหรับผู้ใช้ไทย ผู้ใช้จัดการเซิร์ฟเวอร์ผ่านเว็บได้ตั้งแต่สมัคร เติมเครดิต สร้างเซิร์ฟ จัดการไฟล์ คอนโซล Backup ฐานข้อมูล โดเมน ทีมงาน Webhooks AI และระบบเสริมอื่น ๆ

หลักการใช้งานที่ควรรู้
- ระบบใช้เครดิตแบบเติมเงินล่วงหน้า เครดิตใช้ซื้อเซิร์ฟ ต่ออายุ ซื้อบริการเสริม และเติมโควตา AI ตามที่หน้าเว็บรองรับ
- มีรอบบิลรายวันและรายเดือน รายเดือนคือ 30 วัน ราคาล่าสุดให้ดูจากหน้าแพ็กเกจ
- Auto-renew เปิด/ปิดได้ต่อเซิร์ฟ ถ้าเครดิตพอ ระบบต่ออายุอัตโนมัติ ถ้าเครดิตไม่พอ เซิร์ฟจะถูกระงับเมื่อหมดอายุ
- สถานะการชำระเงิน/หมดอายุแยกจากสถานะการรันของเซิร์ฟ เช่น running, stopped, starting, offline
- ที่อยู่เข้าเซิร์ฟให้ใช้โดเมนที่แสดงในหน้าเว็บ เช่น sv*.mcsv.me:{port}, subdomain หรือโดเมนที่ผู้ใช้ตั้ง ไม่ควรแนะนำให้ใช้ raw IP

เริ่มต้นใช้งาน
- สมัครสมาชิกที่ /craft ด้วยอีเมล รหัสผ่าน ชื่อที่แสดง และรหัสแนะนำถ้ามี
- เข้าสู่ระบบที่ /join รองรับ 2FA หากผู้ใช้เปิดไว้
- โปรไฟล์อยู่ที่ /profile ใช้แก้ชื่อที่แสดง เปลี่ยนรหัสผ่าน จัดการ avatar ดู rank และตั้งค่า 2FA
- Dashboard แสดงเครดิตคงเหลือ สถานะเซิร์ฟ ประกาศ rank, credit runway, node capacity และเซิร์ฟล่าสุด

เมนูหลักหลังเข้าสู่ระบบ
- /dashboard: ภาพรวมบัญชี เครดิต เซิร์ฟเวอร์ ประกาศ และทางลัด
- /server-list: รายการเซิร์ฟเวอร์ทั้งหมด
- /create-server: สร้างเซิร์ฟเวอร์ใหม่
- /team: เซิร์ฟเวอร์ที่แชร์กับผู้ใช้และภาพรวมทีม
- /dedicated-ip: ซื้อและจัดการ Dedicated IP
- /billing/plans หรือ /plans: ดูแพ็กเกจและราคา
- /topup: เติมเครดิตผ่านช่องทางที่หน้าเว็บเปิดให้ใช้ เช่น PromptPay QR หรือ TrueWallet
- /coupons: ใช้คูปอง
- /transactions: ประวัติธุรกรรม
- /referral: แนะนำเพื่อน
- /notifications: ศูนย์แจ้งเตือน
- /announcements: ประกาศจากทีมงาน
- /tickets: ศูนย์ช่วยเหลือและการติดต่อทีมงาน

การสร้างเซิร์ฟเวอร์
ขั้นตอนหลัก: เลือกประเภทเซิร์ฟเวอร์ -> เลือกเวอร์ชัน/build -> เลือกแพ็กเกจและรอบบิล -> ตั้งชื่อ -> เลือก auto-renew -> ยอมรับ EULA สำหรับ Java -> ใส่คูปองถ้ามี -> ยืนยันสร้าง
ประเภทที่พบได้ เช่น Paper, Purpur, Vanilla, Forge, Fabric, Bedrock และ Modpack ทั้งนี้ให้ยึดรายการที่หน้าเว็บแสดงเป็นปัจจุบัน
ไม่ควรบอกเวลาติดตั้งแบบตายตัว ให้บอกว่าเซิร์ฟพร้อมใช้งานเมื่อระบบติดตั้งเสร็จและสถานะพร้อมแล้ว

หน้าเซิร์ฟเวอร์และเมนูสำคัญ
- Overview: ดูชื่อ สถานะ ปุ่ม power, address/port, resource charts, วันหมดอายุ, renew, auto-renew, upgrade และข้อมูลสำคัญของเซิร์ฟ
- Console: ดู log และส่งคำสั่ง หากผู้ใช้มีสิทธิ์
- Files: จัดการไฟล์ด้วย tree/editor/tabs, upload, download, zip, copy, move, rename, delete, search, file tags และ fix permissions
- Backups: สร้าง backup, restore, download, delete, bulk delete และตั้ง auto backup ตามวันเวลาและจำนวนสูงสุด
- Databases: สร้าง/ลบ database, rotate password และเปิด Database Explorer เพื่อดู table/row หรือรัน query ตามสิทธิ์
- Worlds: หน้า จัดการ World ใช้ได้ทั้ง Java และ Bedrock — ดูรายการ world พร้อมข้อมูล (เวอร์ชันที่เซฟ, โหมดเกม, ความยาก, seed, จำนวน data pack), สลับ world ที่ใช้งาน, สร้างใหม่, เปลี่ยนชื่อ, คัดลอก, ดาวน์โหลด, รีเซ็ต และนำเข้าจากไฟล์/ลิงก์/แมพ CurseForge (Bedrock ยังมี fix nested folder เหมือนเดิม)
- Data Pack: เฉพาะ Java — ค้นหาและติดตั้ง data pack จาก Modrinth, CurseForge, Vanilla Tweaks หรือลิงก์ .zip ลงที่ world/datapacks ของ world ที่ใช้อยู่ เปิด/ปิดได้ (เซิร์ฟเปิดใช้คำสั่ง /datapack, เซิร์ฟปิดเขียน level.dat) และเช็ค pack format ให้อัตโนมัติ
- Commands: ส่งคำสั่งที่ใช้บ่อย เช่น time, weather, difficulty, broadcast, title/actionbar/bossbar และ player actions
- Players: ดูผู้เล่นออนไลน์และจัดการ action เช่น kick, ban, op/deop ตามที่ระบบรองรับ
- Whitelist: เปิด/ปิด whitelist เพิ่ม/ลบรายชื่อผู้เล่น
- Plugins: สำหรับ Paper/Purpur/Spigot/Folia ค้นหา ติดตั้ง และถอนปลั๊กอินจากแหล่งที่ระบบรองรับ
- Mods: สำหรับ Forge/Fabric/NeoForge ค้นหา ติดตั้ง และถอนม็อด
- Addons: สำหรับ Bedrock ติดตั้ง .mcaddon/.mcpack/.zip จัดลำดับ behavior/resource packs, sync, uninstall และ regenerate UUID
- Schedules: ตั้ง power action หรือ command ตามวันเวลา และเปิด/ปิด schedule ได้
- Domain: ตั้ง subdomain ใต้ mcsv.me, external domain, ตรวจ DNS และจัดการ port ที่เกี่ยวข้อง
- Web Customize: เปิด public server page ปรับ icon/background/theme/palette และข้อมูลสำหรับโปรโมตเซิร์ฟ
- Webhooks: ส่ง event ไป Discord webhook เช่น power change, backup, install, domain, member, settings พร้อมปรับ embed/mention/test webhook
- Members: เพิ่มสมาชิกด้วยอีเมล แก้ permission หรือลบสมาชิก Owner มีสิทธิ์เต็มเสมอ
- Activity Logs: ดู action สำคัญย้อนหลัง เช่น power, file, backup, domain, member และ settings
- Settings: rename server, game config/server.properties, update build, Java/Bedrock version, JVM flags, icon/background, custom JAR, public directory และ transfer node
- Reinstall: ติดตั้งใหม่แบบเดิมหรือเปลี่ยนประเภท/เวอร์ชัน การ reinstall ลบไฟล์ใน server volume รวมถึง backup ภายใน ควรดาวน์โหลด backup ก่อน

สิทธิ์ทีมงาน
Owner มีสิทธิ์เต็มโดยปริยาย สิทธิ์สำคัญได้แก่ power, console_read, console_write, files_read, files_write, databases_read, databases_write, databases_admin, settings_view, settings_edit, manage_members, plugins_manage, players_manage และ use_ai
Preset ที่ผู้ใช้เห็นได้ เช่น Viewer, Helper, Operator, Manager

การเงิน เครดิต คูปอง Referral
- เติมเครดิต: เลือกช่องทาง เลือกจำนวน ชำระเงิน แล้วเครดิตเข้าบัญชีเมื่อรายการสำเร็จ
- ประวัติธุรกรรมแสดงรายการเช่น topup, purchase, renewal, coupon, referral_reward และ admin_adjust
- คูปองมีเงื่อนไข เช่น จำนวนครั้งที่ใช้ได้ วันหมดอายุ สิทธิ์ต่อบัญชี และบริบทการใช้งาน ห้ามเดาหรือแต่งรหัสคูปองเอง
- Referral: ผู้แนะนำได้รับเครดิตตามนโยบายเมื่อผู้ถูกแนะนำเติมเครดิตครั้งแรกถึงขั้นต่ำ ค่าเริ่มต้นของระบบคือขั้นต่ำ 100 บาท และ reward 30 บาท แต่ควรบอกผู้ใช้ให้ดูตัวเลขล่าสุดในหน้าแนะนำเพื่อน

Dedicated IP
ใช้สำหรับซื้อ IP ส่วนตัว จัดการ label, renew, auto-renew, release, attach/detach กับเซิร์ฟเวอร์ และจัดการ port preset/custom port ตามที่หน้าเว็บรองรับ

Public Server List และ Public Page
/servers แสดงเซิร์ฟเวอร์ที่เปิด public page ผู้ใช้เปิดและตกแต่ง public page ได้จาก Web Customize เหมาะกับเซิร์ฟที่ต้องการรับผู้เล่นใหม่หรือทำ branding

Tickets, Notifications, Announcements
Tickets ใช้ติดต่อทีมงาน มี flow open -> answered -> open เมื่อผู้ใช้ตอบกลับ -> closed เมื่อปิด รองรับข้อความและรูปแนบ
Notifications ใช้แจ้งเตือนเหตุการณ์สำคัญ เช่น เครดิต เซิร์ฟใกล้หมดอายุ ticket หรือ event สำคัญ
Announcements คือประกาศจากทีมงาน และอาจแสดงเป็น banner บน Dashboard

AI
Server AI ใช้ในหน้าเซิร์ฟเพื่อช่วยวิเคราะห์ log/config อธิบายปัญหา แนะนำขั้นตอน และใช้เครื่องมือที่ระบบอนุญาตตามสิทธิ์/โควตา
Global Advisor ใช้ตอบคำถามเกี่ยวกับ MCSV เช่น แพ็กเกจ การสร้างเซิร์ฟ เครดิต คูปอง ทีมงาน และคู่มือ
AI ต้องไม่รับประกันคำตอบที่เสี่ยง ควรแนะนำ backup ก่อนทำสิ่งที่กระทบข้อมูล เช่น delete, restore, reinstall, custom JAR, เปลี่ยน build/Java หรือ transfer node

API และ MCP
แต่ละเซิร์ฟสร้าง API key ได้สูงสุด 5 key จากเมนู ระบบ -> API / MCP ในหน้าเซิร์ฟ key เดียวใช้ได้ทั้ง REST API และ MCP พร้อมกัน ใช้ต่อ AI agent เขียนสคริปต์ bot หรือ external dashboard
- MCP endpoint: https://api.mcsv.me/api/mcp (JSON-RPC / Streamable HTTP) สำหรับ AI app เช่น Cursor, Claude Code, VSCode Copilot, Windsurf
- REST API: https://api.mcsv.me/api/v1 สำหรับ curl สคริปต์และ bot
- ยืนยันตัวตนด้วย header Authorization: Bearer mcsv_... หรือ X-API-Key เหมือนกันทั้งสองช่องทาง
- สิทธิ์มี 3 แบบ: สิทธิ์เต็ม (ทุก tool 50 ตัว), อ่านอย่างเดียว (21 tools ที่อ่านข้อมูล), กำหนดเอง (เลือกรายกลุ่ม/รายตัว) แก้สิทธิ์ย้อนหลังได้มีผลทันที token แสดงครั้งเดียวตอนสร้าง revoke ได้ทุกเมื่อ
- REST endpoints หลัก: GET /api/v1/me เช็ค key และสิทธิ์, GET /api/v1/tools ดูรายชื่อ tool พร้อม allowed, POST /api/v1/tools/{name} เรียก tool โดย body เป็น arguments, ทางลัด GET /api/v1/server, POST /api/v1/power, POST /api/v1/command, GET /api/v1/logs?lines=200
- Response สำเร็จ {"ok":true,"result":...} พลาด {"ok":false,"error":...} status 400 tool ทำงานไม่สำเร็จ (arguments/path ผิด หรือคำสั่งถูกบล็อค — ข้อความ error บอกวิธีแก้), 401 key ผิด/ถูก revoke, 403 ไม่มีสิทธิ์, 404 ไม่รู้จัก tool, 409 เซิร์ฟกำลังติดตั้ง, 429 เกิน rate limit (300 ครั้ง/นาที และ 6000 ครั้ง/ชั่วโมง ต่อ key)
- คู่มือ /docs/api มี tool reference ครบทุกตัว: arguments (ชื่อ/type/required) + ตัวอย่าง request curl + ตัวอย่าง response JSON ของแต่ละ tool
- Tools 50 ตัวแบ่ง 13 กลุ่ม: ข้อมูลเซิร์ฟ, อ่านไฟล์, แก้ไฟล์, คอนโซล, power, backups, ตั้งค่าเซิร์ฟ, ปลั๊กอิน/mod, ฐานข้อมูล, ตารางเวลา, webhooks, ทีมงาน, web_fetch
- กติกา path ของ file tools (สาเหตุที่ AI ทำงานไฟล์พลาดบ่อยสุด): path เริ่มจาก root ของเซิร์ฟ / เช่น /server.properties, /plugins/Essentials/config.yml ไม่มี /home/container (ส่งมาระบบตัดให้) · ตัวพิมพ์เล็กใหญ่ต้องตรงเป๊ะ ไม่รู้ชื่อจริงให้ files_list ก่อนห้ามเดา · หาไฟล์ไม่เจอ API จะส่งรายชื่อไฟล์จริงในโฟลเดอร์นั้นกลับมาให้แก้ path ได้เลย · แก้ไฟล์เดิมใช้ files_edit (แก้เฉพาะจุดด้วย old_string/new_string ที่คัดลอกจาก files_read ตรงตัว — ส่วนอื่นของไฟล์ไม่ถูกแตะ) · files_write ทับทั้งไฟล์ ใช้เฉพาะสร้างไฟล์ใหม่ · เขียน/ลบพลาดกู้คืนได้ด้วย files_undo (ระบบสำรองให้อัตโนมัติ 30 วัน) · แก้ server.properties ใช้ server_properties_patch · สร้างไฟล์ใหม่ในโฟลเดอร์ที่ไม่มีจริงหรือชื่อซ้ำแบบต่างตัวพิมพ์จะถูกปฏิเสธพร้อมบอกชื่อจริง ยืนยันด้วย force_new: true · อ่านหลายไฟล์ทีเดียวใช้ files_read_many (25 ไฟล์/ครั้ง) ประหยัด rate limit
- ความปลอดภัย: การเรียก tool ที่แก้ข้อมูลถูกบันทึกในกิจกรรมล่าสุดของหน้า API / MCP (เห็น diff ไฟล์) ระบบบล็อคการอ่าน/แก้ไฟล์ credentials (.env, .pem, ชื่อไฟล์มี token/secret/password) และบล็อคคำสั่งคอนโซลอันตราย (op, deop, ban, stop) ให้ใช้ power_action แทน stop

โครงสร้าง world ของ Minecraft Java
- ตั้งแต่ 26.1 ทุกมิติอยู่ในโฟลเดอร์ world เดียว: world/dimensions/minecraft/overworld, the_nether, the_end ข้อมูลผู้เล่นอยู่ world/players/ และ gamerule/seed แยกเป็นไฟล์ใน world/data/minecraft/ (Paper เก็บสำเนารายมิติที่ world/dimensions/minecraft/overworld/data/minecraft/)
- ก่อน 26.1 แผนที่หลักอยู่ world/region เนเธอร์อยู่ DIM-1 ดิเอนด์อยู่ DIM1 และ Paper แยกเป็น world_nether กับ world_the_end
- world เก่าถูกอัปเกรดอัตโนมัติตอนเปิดเซิร์ฟ 26.1 ครั้งแรก และย้อนกลับไปเวอร์ชันเก่าไม่ได้อีก ต้องแนะนำให้ backup ก่อนเสมอ
- ชื่อ world ต้องเป็นตัวอักษรอังกฤษ/ตัวเลข/- _ . เท่านั้น ชื่อภาษาไทยทำให้เซิร์ฟหาโฟลเดอร์ไม่เจอแล้วสร้าง world เปล่าใหม่

ข้อควรระวังในการตอบผู้ใช้
- อย่าบอกว่ามีทดลองเปิดเซิร์ฟฟรีโดยไม่เติมเงิน
- อย่ารับประกันเวลา setup แบบตายตัว หรือรับประกันระดับ DDoS ด้วยตัวเลข
- เครดิตที่เติมแล้วไม่ถอนเป็นเงินสด ใช้ตามนโยบายในระบบ
- อย่าให้ข้อมูล internal เช่น secret, token, key, path ภายใน server, queue, service runtime หรือรายละเอียด infra ภายใน เว้นแต่ผู้ใช้เป็นทีมงานและถามเชิงพัฒนาโดยตรง
- ถ้าข้อมูลราคา/โควตา/คูปองไม่แน่ใจ ให้บอกให้ผู้ใช้ดูจากหน้าเว็บล่าสุด หรือเปิด Ticket ให้ทีมงานตรวจ

ลิงก์คู่มือหลัก
/docs/getting-started
/docs/creating-server
/docs/server-management
/docs/file-manager
/docs/backups
/docs/plugins-mods
/docs/server-settings
/docs/players
/docs/team
/docs/domain
/docs/database
/docs/billing
/docs/account
/docs/server-ai
/docs/webhooks
/docs/referral
/docs/dedicated-ip
/docs/schedules
/docs/activity-logs
/docs/web-customize
/docs/world-import
/docs/datapacks
/docs/commands
/docs/public-servers
/docs/advanced-settings
/docs/notifications-support
/docs/api
/docs/faq
/docs/open-minecraft-server
/docs/bedrock-server
/docs/install-modpack
/docs/best-plugins
/docs/fix-server-lag
/docs/paper-vs-spigot