คู่มือ / การก่อสร้างและทรัพยากร
ภาพวาดและแผ่นเพลงแบบกำหนดเองต้องใช้สองแพ็ก และการติดตั้งเพียงแพ็กเดียวมักเป็นสาเหตุของความล้มเหลว
ดาต้าแพ็กลงทะเบียนเนื้อหา ส่วนรีซอร์สแพ็กจัดหาพื้นผิวและเสียง การใช้ดาต้าแพ็กอย่างเดียวจะลงทะเบียนเนื้อหาแต่ไม่มีอะไรแสดงผล นอกจากนี้ยังมีข้อจำกัด 4x4 และเหตุผลที่ความยาวของแผ่นเพลงไม่ใช่แค่เรื่องความสวยงาม
ทั้งภาพวาดและแผ่นเพลงต่างก็เป็นรายการที่ลงทะเบียนจริงใน Java สมัยใหม่ ซึ่งหมายความว่าคุณสามารถเพิ่มมันเข้าไปได้แทนที่จะแทนที่ของเดิมที่มีอยู่ ไม่มีสิ่งใดที่คุณเพิ่มเข้าไปจะไปแทนที่ภาพวาดหรือแผ่นเพลงที่มีอยู่แล้ว
ข้อเสียคือเนื้อหาถูกแบ่งออกเป็นสองประเภทแพ็กที่แตกต่างกัน และแต่ละประเภทก็ไร้ประโยชน์หากอยู่เพียงลำพัง
อะไรไปอยู่ที่ไหน
ดาต้าแพ็กลงทะเบียนสิ่งของ:
data/<ns>/painting_variant/<id>.json asset_id, width, height, title, author
data/<ns>/jukebox_song/<id>.json sound_event, description, length, comparatorรีซอร์สแพ็กจัดหาสิ่งที่คุณเห็นและได้ยิน:
assets/<ns>/textures/painting/<id>.png
assets/<ns>/sounds/<id>.ogg
assets/<ns>/sounds.jsonหากติดตั้งเฉพาะดาต้าแพ็ก เนื้อหาจะถูกลงทะเบียนสำเร็จ — มันมีอยู่จริง, /give ค้นพบมัน, แต่ไม่มีพื้นผิวและเสียง นั่นเป็นผลลัพธ์ที่สับสนมากกว่าความล้มเหลวโดยสิ้นเชิง และเป็นสาเหตุปกติที่ทำให้ภาพวาดแบบกำหนดเอง "ใช้งานไม่ได้" เครื่องมือในหน้านี้จะจัดส่งทั้งสองอย่างในไฟล์ zip เดียวกันโดยเฉพาะ เพื่อไม่ให้แยกออกจากกันได้
โปรดสังเกตไฟล์ pack.mcmeta ทั้งสองไฟล์ พวกมันเป็นแพ็กแยกกันที่มีตัวตนแยกกัน ไม่มีรูปแบบรวมที่สามารถเก็บทั้งสองอย่างไว้ด้วยกันได้
ID การลงทะเบียนเข้มงวดกว่าชื่อไฟล์
ID สามารถมีได้เฉพาะ a-z, 0-9, _, . และ - เท่านั้น หากมีอย่างอื่น แพ็กจะโหลดไม่สำเร็จ — ไม่ใช่แค่รายการที่เสีย แต่ทั้งแพ็ก ตัวอักษรพิมพ์ใหญ่และช่องว่างเป็นสองสิ่งที่มักจะทำให้คนสับสน เพราะทั้งสองอย่างเป็นเรื่องปกติในชื่อไฟล์ที่คุณลากเข้ามา
ภาพวาด: 1×1 ถึง 4×4
ขนาดมาตรฐานมีตั้งแต่ 1 × 1 ไปจนถึง 4 × 4 บล็อก ทำให้มีรูปร่างที่เป็นไปได้สิบหกแบบ ภาพวาดที่มีขนาดนอกเหนือจากช่วงนี้จะยังคงแสดงผลได้ — เกมไม่ปฏิเสธมัน — แต่ไม่สามารถแขวนบนผนังที่มีขนาดที่ผู้เล่นคาดหวังได้ ดังนั้นจึงไม่สามารถวางได้จริงในการสร้างปกติ
ขนาดถูกประกาศใน JSON เป็น width และ height ในหน่วยบล็อก มันไม่ได้ถูกอนุมานจากไฟล์ PNG ดังนั้นภาพวาดขนาด 3 × 1 ที่มีพื้นผิวเป็นสี่เหลี่ยมจัตุรัสจึงเป็นไฟล์ที่ถูกต้องซึ่งจะแสดงผลแบบยืดออก
ความยาวของแผ่นเพลงไม่ใช่แค่ป้ายกำกับ
length_in_seconds ควบคุมสองสิ่ง: เวลาของตู้เพลง (jukebox timing) และ ตัวเปรียบเทียบสัญญาณ (comparator ramp) — สัญญาณที่ตัวเปรียบเทียบอ่านจากตู้เพลงที่กำลังเล่นจะเพิ่มขึ้นตามระยะเวลาที่ประกาศไว้ของเพลง
ดังนั้นความยาวที่ไม่ถูกต้องจึงไม่ใช่ข้อผิดพลาดด้านความสวยงาม หากประกาศเพลง 200 วินาทีเป็น 100 วินาที ตัวเปรียบเทียบจะสิ้นสุดสัญญาณเมื่อถึงครึ่งทาง ซึ่งจะทำให้ระบบเรดสโตนที่ผูกกับเพลงจบลงทำงานผิดพลาด เครื่องมือนี้จะอ่านระยะเวลาจริงจากไฟล์แทนที่จะให้คุณพิมพ์เอง ด้วยเหตุผลนี้โดยเฉพาะ
เพลงยังถูกเขียนด้วย "stream": true ใน sounds.json เพลงมีความยาว และการโหลดเพลงเต็มเพลงลงในหน่วยความจำก่อนเล่นจะทำให้เกิดอาการกระตุก — การสตรีมเป็นค่าเริ่มต้นที่เหมาะสมสำหรับเพลงที่มีความยาวเท่าแผ่นเพลง และเป็นค่าที่ไม่เหมาะสมสำหรับเอฟเฟกต์เสียงสั้นๆ