ปลั๊กอิน Minecraft SCore

🔌 เกี่ยวกับ SCore

SCore คือปลั๊กอินแกนหลัก/ไลบรารีที่สร้างโดย Ssomar เพื่อรวมฟังก์ชันที่ใช้ร่วมกันในชุดปลั๊กอินของพวกเขาไว้ที่ศูนย์กลางเดียว มันมีทั้งตัวแก้ไขในเกมและฟีเจอร์ runtime ที่ปลั๊กอิน Ssomar อื่น ๆ ใช้งาน และยังสามารถใช้แบบ standalone เพื่อสร้างและรันโปรเจกไทล์แบบกำหนดเอง จัดการตัวแปร และเรียกใช้งานคำสั่งแบบกำหนดเองที่แพ็กไว้ได้

🎯 วัตถุประสงค์

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

⚙️ ฟีเจอร์

• ตัวแก้ไขในเกมสำหรับสร้างและแก้ไขโปรเจกไทล์แบบกำหนดเอง
• โปรเจกไทล์แบบกำหนดเองใน runtime ที่สามารถยิงหรือทริกเกอร์ได้
• ตัวแปรแบบ global และแบบต่อผู้เล่น พร้อมชนิด (NUMBER, STRING, LIST)
• รองรับ placeholder สำหรับตัวแปร (token placeholder สำหรับใช้ในปลั๊กอิน/การตั้งค่าอื่น ๆ)
• เฟรมเวิร์กสำหรับรันคำสั่งแบบแพ็ก/แบบกำหนดเองที่เข้าถึงได้จากคอนโซลเซิร์ฟเวอร์หรือปลั๊กอินอื่น
• ออกแบบมาให้ปลั๊กอิน Ssomar อื่น ๆ ใช้เป็น dependency ได้

🧩 เหมาะกับใคร

• เจ้าของเซิร์ฟเวอร์ที่รันปลั๊กอิน Ssomar (ExecutableItems, ExecutableBlocks ฯลฯ)
• นักพัฒนาที่ต้องการไลบรารีนำกลับมาใช้ซ้ำได้สำหรับโปรเจกไทล์ ตัวแปร และการรันคำสั่งแบบกำหนดเอง
• ผู้ดูแลที่ต้องการตัวแก้ไขแบบเบา ๆ ภายในเซิร์ฟเวอร์สำหรับฟีเจอร์เหล่านั้น

🏗️ ตัวอย่างการใช้งาน

• เซิร์ฟเวอร์ใช้ SCore ร่วมกับ ExecutableItems เพื่อกำหนดและเรียกพฤติกรรมโปรเจกไทล์แบบกำหนดเอง
• แอดมินสร้างตัวแปรแบบ global หรือแบบต่อผู้เล่น แล้วเปิดให้ใช้เป็น placeholder สำหรับเมนูหรือปลั๊กอินอื่น
• นักพัฒนาปลั๊กอินพึ่งพา SCore เพื่อใช้ซ้ำพื้นที่เก็บตัวแปรและการแพ็กคำสั่งข้ามหลายปลั๊กอิน

⌨️ คำสั่ง

หมายเหตุ: เอกสารทางการยังระบุ token placeholder สำหรับตัวแปรด้วย (เช่น %score_variables_<var_name>% และ %score_variables_<var_name>_int%). ใน metadata ของปลั๊กอินที่อ้างถึงไม่ได้ระบุ node ของสิทธิ์ไว้

⚙️ การติดตั้ง

📥 การตั้งค่า

• ดาวน์โหลดไฟล์ SCore .jar อย่างเป็นทางการสำหรับเวอร์ชันปลั๊กอินที่ตรงกัน
• วางไฟล์ .jar ลงในไดเรกทอรี plugins/ ของเซิร์ฟเวอร์
• รีสตาร์ทเซิร์ฟเวอร์และตรวจสอบคอนโซลเพื่อยืนยันว่า SCore ถูกโหลดแล้ว
• หากคุณใช้ปลั๊กอิน Ssomar อื่น ๆ ให้อินสตอล build ของ SCore ที่ตรงกับ suffix เวอร์ชันของปลั๊กอินเหล่านั้นตามที่โปรเจกต์แนะนำ (จับคู่ build ของ SCore กับ build ของปลั๊กอินที่พึ่งพา)

🧠 หมายเหตุทางเทคนิค

• แพลตฟอร์มที่ยืนยันว่ารองรับ: Bukkit, Spigot, Paper, Purpur, Folia
• เวอร์ชัน Minecraft ที่ยืนยันว่ารองรับรวมถึง: 1.21.x ลงไปถึง 1.8.x (ตามที่โปรเจกต์ระบุ)
• metadata ของโปรเจกต์ระบุป้ายกำกับไลเซนส์แบบจำกัด (ARR / All Rights Reserved) ขณะที่การแจกจ่ายของโปรเจกต์ก็อ้างถึง Git repository สำหรับการมีส่วนร่วมด้วย; รายการเหล่านี้ปรากฏอยู่ร่วมกันใน metadata อย่างเป็นทางการ
• SCore ตั้งใจให้ติดตั้งเป็นไลบรารี/dependency สำหรับปลั๊กอิน Ssomar อื่น ๆ โดยมันเปิดเผยฟีเจอร์ที่ปลั๊กอินอื่นเรียกใช้ใน runtime

🤝 ปลั๊กอินนี้มีประโยชน์เมื่อไร

ถ้าคุณใช้ปลั๊กอิน Ssomar หรือจำเป็นต้องมีระบบในเซิร์ฟเวอร์ที่พร้อมใช้สำหรับโปรเจกไทล์แบบกำหนดเองและ placeholder ของตัวแปร SCore จะมอบ runtime ร่วมและตัวแก้ไขที่ปลั๊กอินเหล่านั้นพึ่งพา โดยไม่ต้องให้คุณสร้างกลไกเดิมขึ้นมาใหม่