จัดการไฟล์

ภาพรวมหน้าไฟล์

แท็บ ไฟล์ แสดงไฟล์ทั้งหมดที่ผู้เล่นของ Instance จะได้รับ จัดเป็นโฟลเดอร์ตาม path ใช้แถบ breadcrumb ด้านบน (Root> โฟลเดอร์ …) เพื่อย้อนกลับ และมีปุ่มเครื่องมือ 4 ปุ่มที่มุมขวา: นำเข้า .mrpack, Modrinth, สร้างโฟลเดอร์ และ อัปโหลด

ระหว่างโหลดรายการจะเห็นโครงสีเทากะพริบ และถ้าไม่มีไฟล์จะมีข้อความแนะนำวิธีเริ่มต้น

Path คืออะไร

ไฟล์แต่ละไฟล์มี Path คือตำแหน่งในโฟลเดอร์เกมของผู้เล่น เช่น mods/sodium.jar หรือ config/example.toml ที่ launcher จะวางไฟล์ให้ตรงตำแหน่งนี้ ไม่มีช่องตั้ง "ชื่อไฟล์" แยก - ตั้ง Path เต็ม (รวมชื่อไฟล์) ช่องเดียว

• ห้ามเว้นว่าง, ห้ามขึ้นต้น/ลงท้ายด้วย / (ขึ้นต้นด้วย / ระบบตัดให้), ห้ามมีส่วนว่างหรือ .. และยาวไม่เกิน 500 ตัวอักษร
• โฟลเดอร์ในหน้าไฟล์ไม่ได้เป็นของจริง - เกิดขึ้นจาก path ของไฟล์ที่อยู่ข้างใน ถ้าไม่มีไฟล์ข้างใน โฟลเดอร์ก็ไม่แสดง
• Path ที่ตั้งเป็นข้อมูลในระบบ ไม่ใช่ชื่อไฟล์จริงใน Storage (ใน Storage ไฟล์ใช้ชื่อสุ่ม ดู Storage)

อัปโหลดไฟล์

วิธีเริ่มอัปโหลด

• กดปุ่ม อัปโหลด แล้วเลือกไฟล์ (เลือกได้หลายไฟล์)
• ลากไฟล์หรือโฟลเดอร์มาวางที่ไหนก็ได้ในหน้า - โฟลเดอร์จะคงโครงสร้างข้างในไว้
• วาง (paste) ไฟล์จาก clipboard ได้
• ไฟล์ .mrpack ที่ลากมาวางเดี่ยวๆ จะเปิดหน้านำเข้า modpack แทน ดู .mrpack

หน้าต่างอัปโหลด

1. 1

   เลือกไฟล์ (หรือลากมาวาง)

2. 2

   ตรวจ Path ของแต่ละไฟล์

   แก้ได้ตามต้องการ เช่น เปลี่ยนเป็น mods/foo.jar ปุ่มอัปโหลดจะกดไม่ได้ถ้า Path ว่าง ไม่ถูกต้อง หรือซ้ำกันเองในชุดเดียวกัน

3. 3

   เลือก Storage และผู้ที่ได้รับไฟล์ (ถ้าต้องการ)

4. 4

   กดอัปโหลด

   ระบบทำทีละไฟล์: อัปโหลด → บันทึกลงรายการ สำเร็จแล้วหน้าต่างปิดเอง

เปลี่ยนชื่อไฟล์

คลิกขวาที่ไฟล์แล้วเลือก เปลี่ยนชื่อ (ใช้ได้กับไฟล์ทุกชนิด รวมถึงไฟล์ Modrinth) ไฟล์ยังอยู่ในโฟลเดอร์เดิม ใส่ / ไม่ได้ และถ้ามีไฟล์ชื่อเดียวกันอยู่แล้ว (ไม่สนตัวพิมพ์เล็กใหญ่) ระบบจะไม่ให้เปลี่ยน การเปลี่ยนชื่อไม่ย้ายหรือโหลดไฟล์ใหม่ใน Storage ผู้เล่นจะเห็นชื่อใหม่ในครั้งถัดไปที่ Launcher ซิงก์ไฟล์ และไฟล์ชื่อเก่าในโฟลเดอร์ mods/ ของผู้เล่นจะถูกลบตามกฎซิงก์ปกติ

แก้ไข / แทนที่ไฟล์

คลิกขวาที่แถวของไฟล์ที่อัปโหลดไว้ (หรือกดปุ่ม ⋯) เลือก แก้ไข / แทนที่ไฟล์ แล้วเลือกไฟล์ใหม่ - ไฟล์เดิมจะถูกแทนที่ด้วยไฟล์ใหม่ที่ Path เดิม (แก้ Path ได้) และ SHA-1 กับขนาดอัปเดต หน้าต่างนี้รับได้ทีละ 1 ไฟล์ และ dropdown สิทธิ์จะเริ่มที่สิทธิ์ปัจจุบันของไฟล์ ระบบลบไฟล์เก่าใน Storage ให้หลังแทนที่สำเร็จ

ปุ่มนี้ใช้ได้กับไฟล์ที่เก็บใน Storage ของคุณและไฟล์ลิงก์ภายนอก (แทนที่ด้วยไฟล์ที่อัปโหลดเอง) ส่วนไฟล์ Modrinth ไม่มีปุ่มแก้ไข - ลบแล้วติดตั้งใหม่แทน

สร้างโฟลเดอร์

กดปุ่ม สร้างโฟลเดอร์ ใส่ชื่อ ระบบจะพาเข้าไปในโฟลเดอร์นั้นเพื่ออัปโหลดไฟล์ต่อ เนื่องจากโฟลเดอร์เกิดจาก path ของไฟล์ จึงต้องมีไฟล์อย่างน้อย 1 ไฟล์ข้างใน โฟลเดอร์ถึงจะค้างอยู่

เมนูคลิกขวา (Quick action)

แทนที่จะมีปุ่มเรียงเต็มท้ายแถว การจัดการไฟล์ทั้งหมดอยู่ในเมนูคลิกขวา: คลิกขวาที่แถวไหนก็ได้ หรือกดปุ่ม ⋯ ที่ท้ายแถว (สำหรับทัชสกรีนหรือคนที่ไม่ใช้คลิกขวา) เมนูเปิดตรงตำแหน่งเมาส์ ไม่ล้นหน้าจอ ปิดด้วยการคลิกที่อื่น กด Esc หรือเลื่อนหน้า และใช้ลูกศรขึ้นลง / Enter ได้

รายการเรียงลำดับเดียวกันทุกแถว (ข้อที่แถวนั้นไม่มีจะถูกข้าม) และลบอยู่ล่างสุดแยกด้วยเส้น:

• เลือกหลายไฟล์แล้วคลิกขวา ที่แถวหนึ่งที่ถูกเลือก เมนูจะเป็นของทั้งชุดที่เลือก (หัวเมนูบอกจำนวน) มี ย้ายไป Storage, ตั้งสิทธิ์, ลบ และล้างการเลือก เหมือนใน Explorer ถ้าคลิกขวาที่แถวที่ไม่ได้เลือก เมนูเป็นของแถวนั้นอย่างเดียว
• แถวสีแดงที่เป็นกฎ Ignored Paths มีเมนูแค่ เปิดโฟลเดอร์ (ถ้าเป็นโฟลเดอร์) กับเอากฎออก ส่วนโฟลเดอร์ที่ยังว่างมี เปิดโฟลเดอร์ กับเอาออก
• ข้อที่ใช้ไม่ได้ในขณะนั้น (เช่น กำลังดาวน์โหลดไฟล์เดียวกันอยู่) จะเป็นสีจาง

ปรับความกว้างคอลัมน์

ตารางไฟล์ปรับความกว้างได้เหมือนมุมมองรายละเอียดใน Windows Explorer: ชี้ที่ขอบขวาของหัวคอลัมน์ (เส้นขีดเล็กๆ) เมื่อเมาส์เป็นลูกศรสองหัวให้ลากเพื่อขยาย/ย่อ

• ดับเบิลคลิกที่ขอบเพื่อคืนความกว้างเริ่มต้นของคอลัมน์นั้น
• ความกว้างที่ตั้งไว้ถูกจำใน localStorage ของเบราว์เซอร์ (ต่อเครื่อง ต่อเบราว์เซอร์) กลับมาเปิดหน้านี้จะเหมือนเดิม และใช้กับทุก Instance
• แต่ละคอลัมน์มีความกว้างต่ำสุด และถ้าผลรวมกว้างกว่าหน้าจอ ตารางจะเลื่อนซ้ายขวาได้ ข้อความที่ยาวเกินจะถูกตัดด้วย "..." (เอาเมาส์ชี้ที่ชื่อไฟล์เพื่อดูชื่อเต็ม)
• การคลิกที่ชื่อคอลัมน์ยังเป็นการเรียงลำดับเหมือนเดิม การลากที่ขอบไม่ทำให้เรียงลำดับ

เรียงลำดับ

คลิกหัวคอลัมน์ File / Storage / Permission / Last Modified / Size เพื่อเรียงน้อย→มาก คลิกซ้ำเพื่อกลับเป็นมาก→น้อย ลูกศรบอกทิศทาง ค่าเริ่มต้นเรียงตามชื่อ A→Z โฟลเดอร์อยู่เหนือไฟล์เสมอ ขนาดเรียงตามไบต์จริง เวลาเรียงตามเวลาจริง ชื่อเรียงแบบ natural (mod2 ก่อน mod10) ค่าเท่ากันเรียงต่อด้วยชื่อ

เลือกหลายไฟล์

ติ๊กช่องหน้าแต่ละแถวเพื่อเลือก แถบสูงคงที่เหนือตารางจะเปลี่ยนเป็น "เลือกแล้ว N ไฟล์" พร้อมปุ่ม:

• ตั้งสิทธิ์ - ตั้งผู้รับไฟล์ให้ทุกไฟล์ที่เลือกพร้อมกัน (ถ้าสิทธิ์เดิมต่างกัน จะเตือนและให้เลือกใหม่)
• ลบ - ลบทุกไฟล์ที่เลือก มีหน้าต่างยืนยันบอกจำนวน
• ปุ่ม X - ล้างการเลือก

• ติ๊กที่โฟลเดอร์เพื่อเลือกทุกไฟล์ข้างใน (ติ๊กบางส่วนจะเป็นสถานะกึ่งเลือก)
• ช่องติ๊กที่หัวตารางเลือกทุกไฟล์ที่เห็นในมุมมองนี้
• การเลือกคงอยู่เมื่อเปลี่ยนโฟลเดอร์ และไฟล์ที่ถูกลบจะหลุดออกจากรายการที่เลือกเอง

ดาวน์โหลดไฟล์

คลิกขวาที่แถวของไฟล์ แล้วเลือก ดาวน์โหลด เพื่อบันทึกลงเครื่อง (ไฟล์ใน Storage, ไฟล์จาก Modrinth และลิงก์ภายนอกทำได้หมด) ไฟล์จะถูกบันทึกด้วยชื่อจริงของไฟล์ (ส่วนท้ายของ Path เช่น sodium.jar) ไม่ใช่ชื่อสุ่มที่ใช้ใน Storage ระหว่างโหลดไอคอนจะหมุน และถ้าโหลดไม่ได้จะมีข้อความบอกสาเหตุ เช่น "The file is gone from where it was stored"

• ทำได้เฉพาะผู้ที่จัดการ Instance นี้ (คนเดียวกับที่เห็นหน้าไฟล์) ผู้เล่นทั่วไปไม่เห็นหน้านี้
• การดาวน์โหลดผ่าน API ของเรา ไม่ได้ดึงจาก Storage โดยตรงจากเบราว์เซอร์ จึงไม่ต้องตั้ง CORS ที่ Storage และชื่อไฟล์ถูกต้องเสมอ
• ไฟล์จากลิงก์ภายนอกโหลดได้เฉพาะจากโฮสต์ที่ระบบอนุญาต (Modrinth และโฮสต์ที่ .mrpack อนุญาต)
• โฟลเดอร์ดาวน์โหลดไม่ได้ ดาวน์โหลดได้ทีละไฟล์

ลบไฟล์

• คลิกขวาที่แถว เลือก ลบ (หรือ ลบ ในแถบเลือกหลายไฟล์) → ยืนยันในหน้าต่าง ที่โฟลเดอร์เมนูคือ ลบทุกไฟล์ข้างใน
• ไฟล์ที่อยู่ใน Storage จะถูกลบจาก Storage ด้วย (ข้อความยืนยันบอกไว้) ไฟล์ Modrinth / ลิงก์ภายนอกลบแค่ออกจากรายการ
• ถ้า Storage ติดต่อไม่ได้ ไฟล์จะถูกลบออกจากรายการแต่ object ใน Storage อาจค้าง (ลบมือที่ Storage ได้)

ย้ายไฟล์ Modrinth / ลิงก์ภายนอกไปเก็บใน Storage

ไฟล์ที่เพิ่มจาก Modrinth หรือนำเข้าจาก .mrpack ไม่ได้เก็บอยู่กับเรา ผู้เล่นโหลดจากต้นทางโดยตรง ถ้าต้นทางล่ม หรือผู้พัฒนาถอนม็อดออก ผู้เล่นจะโหลดไม่ได้และเปิดเกมไม่ติด การย้ายไป Storageคือให้เซิร์ฟเวอร์ดาวน์โหลดไฟล์มาเก็บไว้ใน Storage ของ Instance แล้วให้ launcher โหลดจากที่นั่นแทน

• ย้ายทั้งหมด: เมื่อมีไฟล์ที่ยังอยู่ที่ต้นทาง แถบเครื่องมือเหนือตารางจะบอกจำนวนและมีปุ่ม ย้ายทั้งหมดไป Storage
• ย้ายบางไฟล์: ติ๊กเลือกไฟล์ แล้วกด ย้ายไป Storage ในแถบเลือกหลายไฟล์ หรือคลิกขวาที่แถวแล้วเลือกจากเมนู
• หน้าต่างยืนยันให้เลือก Storageที่จะเก็บ (เริ่มที่ Storage หลักของ Instance ถ้ามีอันเดียวจะแสดงเป็นการ์ด) ต้องมี Storage อย่างน้อยหนึ่งอัน จากนั้นระบบทำทีละชุดพร้อมแสดงความคืบหน้า ไฟล์ต่างชุดจะเลือกคนละ Storage ก็ได้

ขั้นตอน และการเลือก Storage

1. 1

   เลือกไฟล์ที่จะย้าย

   กด ย้ายทั้งหมดไป Storage หรือติ๊กเลือกไฟล์แล้วกด ย้ายไป Storage (ระบบข้ามไฟล์ที่เก็บใน Storage อยู่แล้วให้เอง)

2. 2

   เลือก Storage ในหน้าต่าง Move to Storage

   หน้าต่างบอกจำนวนไฟล์และให้เลือกที่เก็บ ตัวเลือกเริ่มที่ Storage หลัก เปลี่ยนได้จาก dropdown ใต้ตัวเลือกแสดง bucket (S3/R2) หรือ URL (Host) พร้อม Path prefix และป้าย "Storage หลัก" ของที่ที่เลือก

3. 3

   กดย้าย แล้วรอ

   แถบเครื่องมือแสดง "กำลังย้ายไป Storage N/M" ระหว่างทำ ปุ่มย้ายอื่นกดไม่ได้จนกว่าจะเสร็จ เมื่อเสร็จมีข้อความสรุป และไฟล์ที่ล้มเหลวพร้อมเหตุผลแสดงในกรอบแดงใต้แถบเครื่องมือ

• ถ้า Instance มี Storage อันเดียว ช่องเลือกแสดงเป็นการ์ดชื่อ Storage นั้นเฉยๆ ถ้ายังไม่มีเลย จะมีลิงก์ไปเพิ่ม Storage ที่หน้าตั้งค่า และกดย้ายไม่ได้
• แต่ละครั้งที่กดย้ายเลือกได้ใหม่ จึงแบ่งไฟล์ไปคนละ Storage ได้ เช่น ม็อดชุดหนึ่งไป R2 อีกชุดไป Host (ไฟล์ที่ย้ายแล้วอยู่ที่ Storage ที่เลือกครั้งนั้น)
• ย้ายไปที่ไหน ลบไฟล์ภายหลังก็ลบออกจาก Storage นั้น (ดู Storage)

ไฟล์ที่ launcher ไม่แตะ (Ignored Paths)

การ์ด Ignored Paths เหนือตารางกำหนดไฟล์/โฟลเดอร์ที่ผู้เล่นแก้เองได้โดย launcher ไม่เขียนทับและไม่ลบ (เช่น saves, options.txt, config ที่ผู้เล่นปรับ) เมนูคลิกขวาของแถวมีรายการ เพิ่มใน Ignored Paths (กดซ้ำคือเอาออก) เพิ่ม/เอา path ออกในคลิกเดียว แถวที่ถูกครอบจะพื้นหลังแดงพร้อมป้าย ignored รายละเอียดและวิธีเขียน rule ที่ Ignored Paths

สิทธิ์ของไฟล์

คลิกที่ค่าในคอลัมน์ Permission ของแถวไฟล์ (หรือเมนูคลิกขวา > ตั้งสิทธิ์การรับไฟล์) จะเปิดหน้าต่างเปลี่ยนสิทธิ์ ใช้กำหนดว่าไฟล์นี้ส่งให้ใคร (ทุกคน หรือเฉพาะผู้เล่นที่มีสิทธิ์) รายละเอียดที่ สิทธิ์ (Permissions)