Cobblemon คือ mod ของ Minecraft ที่นำ Pokémon เข้ามาอยู่ในเกมแบบเนทีฟ โดยอาศัยระบบรีซอร์สและ datapack ของ Minecraft เพื่อให้ปรับแต่งได้อย่างเต็มที่ จุดเด่นสำคัญอย่างหนึ่งของแนวทางนี้คือความสามารถในการแก้ไขตรรกะการเกิด (spawn) ของ Pokémon ได้ทั้งหมดโดยไม่ต้องแตะซอร์สโค้ดของ mod เลย ด้วย datapack ที่จัดโครงสร้างอย่างดี ผู้ดูแลเซิร์ฟเวอร์หรือผู้สร้าง modpack สามารถควบคุมได้อย่างแม่นยำว่า Pokémon ตัวไหนจะเกิด ในไบโอมใด ภายใต้เงื่อนไขอะไร และบ่อยแค่ไหน
คู่มือเชิงเทคนิคนี้เขียนขึ้นสำหรับผู้ดูแลเซิร์ฟเวอร์ Cobblemon และผู้สร้าง modpack ที่ต้องการเชี่ยวชาญระบบการเกิดแบบกำหนดเองของ mod นี้ เราจะมาดูกันว่าจะจัดโครงสร้าง datapack อย่างไร ทำความเข้าใจรูปแบบ JSON ของไฟล์การเกิด และนำทั้งหมดไปใช้งานจริงบนเซิร์ฟเวอร์ production
ทำไมต้องปรับแต่งการเกิดด้วย datapack?
โดยค่าเริ่มต้น Cobblemon จะสร้างไฟล์การเกิดของตัวเองสำหรับ Pokémon ทุกเจเนอเรชัน (Gen 1 ถึง Gen 9) ไฟล์เหล่านี้กำหนดเงื่อนไขที่แต่ละสายพันธุ์จะปรากฏในโลกได้ อย่างไรก็ตาม มีหลายสถานการณ์ที่ควรสร้าง datapack การเกิดแบบกำหนดเอง:
- ปรับสมดุลความหายาก: Pokémon บางตัวอาจพบบ่อยเกินไปหรือหายากเกินไปในการตั้งค่าไบโอมของคุณ
- เพิ่มการเกิดตามธีม: ให้ Pokémon น้ำเกิดเฉพาะในไบโอมมหาสมุทรบางแบบใน modpack ของคุณเท่านั้น
- สร้างโซนพิเศษ: สงวน Pokémon บางตัวไว้สำหรับมิติหรือสิ่งก่อสร้างเฉพาะ
- ลบการเกิดที่ไม่ต้องการ: ปิดการเกิดของบางสายพันธุ์ด้วยเหตุผลด้านความสมดุล
- ซิงก์กับ mod อื่น: รวมไบโอมที่เพิ่มเข้ามาโดย mod อย่าง Terralith หรือ BYG เข้ากับตรรกะการเกิด
Datapack ของ Cobblemon รองรับการโหลดใหม่ขณะรันอยู่ผ่านคำสั่ง /reload ได้อย่างสมบูรณ์ ทำให้ดีบักและปรับแต่งแบบสดได้สะดวก
โครงสร้างของ datapack Cobblemon
Datapack มาตรฐานของ Minecraft ใช้ลำดับชั้นโฟลเดอร์ที่ชัดเจน สำหรับ Cobblemon ไฟล์การเกิดจะวางอยู่ในโฟลเดอร์ย่อยเฉพาะ นี่คือโครงสร้างขั้นต่ำที่ต้องทำตาม:
mon-datapack/
├── pack.mcmeta
└── data/
└── cobblemon/
└── spawn_pool_world/
├── bulbasaur.json
├── pikachu.json
└── ...
ไฟล์ pack.mcmeta ต้องมีเนื้อหาอย่างน้อยดังนี้:
{
"pack": {
"pack_format": 15,
"description": "Spawns personnalisés Cobblemon"
}
}
ปรับค่า pack_format ให้ตรงกับเวอร์ชัน Minecraft ที่คุณใช้ (15 สำหรับ 1.20.x, 18 สำหรับ 1.21.x) โฟลเดอร์ spawn_pool_world คือไดเรกทอรีที่ Cobblemon คอยตรวจดูเพื่อโหลดกฎการเกิดในโลกหลัก นอกจากนี้ยังมี spawn_pool_nether และ spawn_pool_end สำหรับมิติที่เกี่ยวข้อง
กายวิภาคของไฟล์ JSON การเกิด
ไฟล์ JSON การเกิดแต่ละไฟล์สามารถมีหลายรายการสำหรับ Pokémon ตัวเดียวหรือหลายสายพันธุ์ก็ได้ นี่คือตัวอย่างพร้อมคำอธิบายสำหรับ Pikachu:
{
"enabled": true,
"neededInstalledMods": [],
"neededUninstalledMods": [],
"spawns": [
{
"id": "cobblemon:pikachu_forest",
"pokemon": "pikachu",
"type": "land",
"context": "grounded",
"bucket": "uncommon",
"level": "10-25",
"weight": 8.0,
"condition": {
"biomes": [
"#minecraft:is_forest"
],
"timeRange": "any",
"isRaining": false,
"minY": 60,
"maxY": 120
},
"anticondition": {
"structures": ["#minecraft:villages"]
}
}
]
}
ฟิลด์ที่สำคัญ
- id: ตัวระบุที่ไม่ซ้ำกันของกฎ ในรูปแบบ
namespace:nom_descriptifต้องไม่ซ้ำกันทั่วทั้ง datapack - pokemon: ชื่อภายในของ Pokémon เป็นตัวพิมพ์เล็ก ตามที่ปรากฏใน Cobblemon (เช่น
bulbasaur,garchomp,iron_bundle) - type: รูปแบบการเคลื่อนที่ของการเกิด ค่าที่เป็นไปได้:
land,water,water_surface,underwater,air,lava - context: บริบทเพิ่มเติม สำหรับ
landให้ใช้groundedสำหรับ Pokémon ที่บินได้ ให้ใช้flying - bucket: หมวดความหายาก ค่าที่ระบบรู้จักคือ
common,uncommon,rareและultra_rare - level: ช่วงเลเวลของ Pokémon ที่เกิด ในรูปแบบ
"min-max" - weight: น้ำหนักสัมพัทธ์ภายใน bucket ยิ่งค่านี้สูงเมื่อเทียบกับรายการอื่นใน bucket เดียวกัน Pokémon ตัวนั้นก็ยิ่งเกิดบ่อย
บล็อก condition
ฟิลด์ condition คือหัวใจของการปรับแต่ง รองรับพารามิเตอร์มากมาย:
- biomes: รายการไบโอมหรือแท็กไบโอม แท็กจะขึ้นต้นด้วย
#(เช่น#minecraft:is_ocean,#forge:is_hotหรือแท็กของ mod อย่าง#terralith:tropical_island) - structures: รายการสิ่งก่อสร้างที่อนุญาตให้เกิดได้ (เช่น
minecraft:stronghold) - timeRange: ช่วงเวลา ค่า:
any,day,night,dawn,dusk - minY / maxY: ความสูงต่ำสุดและสูงสุดของการเกิด
- minLight / maxLight: ระดับแสงต่ำสุดและสูงสุด (0-15)
- isRaining: ค่าบูลีน ตั้งเป็น true เพื่อจำกัดให้เกิดเฉพาะตอนฝนตก
- isThundering: ค่าบูลีน สำหรับตอนพายุฝนฟ้าคะนองเท่านั้น
- moonPhase: ข้างขึ้นข้างแรมของดวงจันทร์ (0 = พระจันทร์เต็มดวง, จำนวนเต็ม 0-7)
- nearbyBlocks: รายการบล็อกที่ต้องมีอยู่ใกล้กับจุดเกิด
บล็อก anticondition
ฟิลด์ anticondition ทำงานเหมือน condition แต่ในทางกลับกัน: หากเงื่อนไขใดเงื่อนไขหนึ่งใน anticondition เป็นจริง การเกิดจะถูกบล็อก ตัวอย่างเช่น ใช้เพื่อป้องกันไม่ให้ Pokémon เกิดภายในสิ่งก่อสร้าง ขณะที่ยังให้มันเกิดในไบโอมที่มีสิ่งก่อสร้างนั้นอยู่ได้
กรณีใช้งานจริงในการปรับแต่ง
กรณีที่ 1: Pokémon เฉพาะไบโอมของ mod
หากคุณใช้ Terralith คุณสามารถทำให้ Sneasel เกิดเฉพาะในไบโอม terralith:snowy_badlands ได้:
{
"spawns": [
{
"id": "monpack:sneasel_snowy_badlands",
"pokemon": "sneasel",
"type": "land",
"context": "grounded",
"bucket": "rare",
"level": "25-40",
"weight": 5.0,
"condition": {
"biomes": ["terralith:snowy_badlands"]
}
}
]
}
กรณีที่ 2: การเกิดตอนกลางคืนแบบมีเงื่อนไข
หากต้องการให้ Haunter เกิดเฉพาะตอนกลางคืน ในถ้ำหรือพื้นที่มืด:
{
"spawns": [
{
"id": "monpack:haunter_cave_night",
"pokemon": "haunter",
"type": "land",
"context": "grounded",
"bucket": "rare",
"level": "20-35",
"weight": 4.0,
"condition": {
"timeRange": "night",
"maxY": 50,
"maxLight": 3
}
}
]
}
กรณีที่ 3: ปิดการเกิดที่มีอยู่เดิม
หากต้องการปิดการเกิดดั้งเดิมของ Cobblemon ให้สร้างไฟล์ JSON ที่มี "enabled": false และใช้ตัวระบุเดียวกับกฎต้นฉบับ Cobblemon จะรวม datapack เข้าด้วยกัน และ datapack ของผู้ใช้จะมีลำดับความสำคัญเหนือข้อมูลที่ติดมากับ mod:
{
"enabled": false,
"spawns": [
{
"id": "cobblemon:magikarp_river"
}
]
}
ข้อควรระวัง: คุณต้องรู้ตัวระบุที่ถูกต้องของกฎต้นฉบับ ซึ่งดูได้จากซอร์สโค้ดของ mod บนรีโพสิทอรี GitLab อย่างเป็นทางการของ Cobblemon หรือโดยการแตกไฟล์ JAR ของ mod
การเกิดของฟอร์มและรูปแบบต่าง ๆ
Cobblemon รองรับฟอร์มของ Pokémon ได้โดยตรงในไฟล์การเกิด หากต้องการระบุฟอร์มเฉพาะ ให้เพิ่มฟอร์มต่อท้ายชื่อ Pokémon:
"pokemon": "rattata form=alolan"
คุณยังสามารถเพิ่ม aspect ด้านภาพหรือตัวปรับแต่งได้ด้วย:
"pokemon": "pikachu aspects=[original_cap]"
คุณสมบัติที่ใช้ได้ในฟิลด์ pokemon จะเป็นไปตามไวยากรณ์ของคำสั่ง Cobblemon และช่วยให้ระบุเพศ เลเวล ความสามารถพิเศษ หรือคุณลักษณะอื่นใดที่ mod รู้จักได้
การนำไปใช้บนเซิร์ฟเวอร์
เมื่อสร้างและทดสอบ datapack บนเครื่องของคุณเรียบร้อยแล้ว การนำไปใช้บนเซิร์ฟเวอร์ Cobblemon มีขั้นตอนง่าย ๆ ดังนี้:
- บีบอัดเป็น ZIP: โฟลเดอร์
mon-datapack/ของคุณต้องถูกบีบอัดเป็นmon-datapack.zipโดยรากของไฟล์บีบอัดต้องมีpack.mcmetaและโฟลเดอร์data/อยู่โดยตรง - วางในโฟลเดอร์ที่ถูกต้อง: บนเซิร์ฟเวอร์ Minecraft datapack จะวางไว้ใน
world/datapacks/(หรือworld_nether/datapacks/สำหรับ Nether) - เปิดใช้งาน datapack: ในการเปิดครั้งแรกหรือหลัง
/reloadให้รัน/datapack enable "file/mon-datapack.zip"หาก datapack ไม่ถูกเปิดใช้งานโดยอัตโนมัติ - โหลดการเกิดใหม่: รัน
/reloadเพื่อให้ Cobblemon โหลดไฟล์การเกิดทั้งหมดใหม่ ไม่จำเป็นต้องรีสตาร์ทเซิร์ฟเวอร์
บนแผงควบคุมอย่าง PteroPilot หรือ Pterodactyl คุณสามารถอัปโหลดไฟล์ ZIP ได้โดยตรงผ่านตัวจัดการไฟล์บนเว็บ หรือผ่าน SFTP ไปยังโฟลเดอร์ world/datapacks/
ตรวจสอบการโหลด datapack
เพื่อยืนยันว่า datapack ของคุณถูกโหลดและทำงานอยู่จริง:
- คำสั่ง
/datapack list: แสดงรายการ datapack ทั้งหมดที่ทำงานอยู่ ของคุณต้องปรากฏพร้อมชื่อของมัน - ล็อกของเซิร์ฟเวอร์: ตอนเริ่มเซิร์ฟเวอร์หรือตอน
/reloadCobblemon จะแสดงข้อความบอกจำนวนกฎการเกิดที่โหลดแล้ว - คำสั่ง Cobblemon
/cobblemon spawnpool(หากมี): ใช้ตรวจสอบ pool การเกิดปัจจุบัน ณ ตำแหน่งของคุณ
แนวปฏิบัติที่ดีและกับดักที่ควรหลีกเลี่ยง
ตัวระบุชนกัน
กฎสองข้อที่ใช้ id เดียวกันจะเขียนทับกันและกัน ซึ่งมีประโยชน์สำหรับการปิดการเกิดดั้งเดิม แต่ก็อาจทำให้เกิดพฤติกรรมที่ไม่คาดคิดได้ หาก datapack สองตัวบนเซิร์ฟเวอร์ของคุณบังเอิญกำหนดตัวระบุเดียวกัน ควรใช้ namespace ที่ไม่ซ้ำใครสำหรับตัวระบุของคุณเสมอ (เช่น monserveur:...)
น้ำหนักและ bucket
ระบบน้ำหนักทำงานแยกตาม bucket ไม่ใช่แบบรวมทั้งหมด Pokémon ที่มี weight เท่ากับ 100 ใน bucket ultra_rare ไม่จำเป็นต้องพบบ่อย เพราะโอกาสที่ bucket ultra_rare จะถูกเลือกยังคงต่ำอยู่ ให้ปรับ bucket ก่อน แล้วจึงปรับน้ำหนักภายใน bucket
แท็กไบโอมที่ระบบไม่รู้จัก
หากแท็กไบโอมในเงื่อนไขของคุณไม่มีอยู่ในอินสแตนซ์ของคุณ (เช่น แท็กของ mod ที่ไม่ได้ติดตั้ง) กฎการเกิดอาจถูกข้ามไปเงียบ ๆ หรือทำให้เกิดข้อผิดพลาด ควรตรวจสอบเสมอว่า mod ที่กำหนดแท็กที่คุณใช้นั้นติดตั้งอยู่บนเซิร์ฟเวอร์จริง
ประสิทธิภาพ
กฎการเกิดที่ซับซ้อนจำนวนมากอาจส่งผลต่อประสิทธิภาพของเซิร์ฟเวอร์เล็กน้อย โดยเฉพาะเงื่อนไขที่ต้องค้นหาบล็อกใกล้เคียง ควรจำกัดการใช้ nearbyBlocks ไว้เฉพาะกรณีที่จำเป็นจริง ๆ และทดสอบประสิทธิภาพด้วยเครื่องมือ profiling อย่าง Spark ก่อนนำไปใช้บน production
ก้าวต่อไป
เมื่อเข้าใจพื้นฐานแล้ว คุณสามารถสำรวจฟีเจอร์ขั้นสูงของ Cobblemon ได้ เช่น การเกิดแบบมีเงื่อนไขที่ผูกกับอีเวนต์ในเกม การเชื่อมต่อกับปลั๊กอินเซิร์ฟเวอร์ผ่าน API ของ Cobblemon หรือการสร้าง Pokémon บอส พร้อมกฎการเกิดเฉพาะ อย่าลืมดูคู่มือของเราเรื่องการตั้งค่าเซิร์ฟเวอร์ Cobblemon แบบครบถ้วน เพื่อภาพรวมของการดูแลเซิร์ฟเวอร์
ระบบ datapack ของ Cobblemon เป็นหนึ่งในระบบที่ยืดหยุ่นที่สุดในบรรดา mod Pokémon สำหรับ Minecraft เมื่อคุณใช้เวลาทำความเข้าใจโครงสร้าง JSON และพารามิเตอร์ของเงื่อนไข คุณจะควบคุมระบบนิเวศของ Pokémon บนเซิร์ฟเวอร์ได้ทั้งหมด โดยไม่ต้องพึ่งการอัปเดตของ mod เพื่อปรับสมดุล