แนะนำการใช้โปรแกรมทดลองเขียนบท BuzzDe Engine version 1.2

 

ข้อควรรู้

- ดาวน์โหลดตัวโปรแกรมจากลิงก์นี้

- รันเกมทดสอบด้วย Call Me Master. Exe

- ไฟล์ที่ผู้ใช้จะใส่เข้าไปอยู่ ในโฟลเดอร์ Data ทั้งหมด

- โฟลเดอร์ check เป็นที่เก็บตัวตรวจความ ถูกต้องของข้อมูลต่าง ๆ

- ในกรณีที่เซฟเกมพังจน เกมค้างเปิดไม่ได้ ให้รันไฟล์ clear-save.reg

- ไม่ควรยุ่งกับไฟล์อื่นๆ

 

 

ข้อมูลเบื้องต้น

- กด ALT+Enter จะเป็นการ ย่อขยาย จอเกมแบบ Full Screen กับ Windowed

- กดปุ่ม Delete บนคีย์บอร์ด ระหว่างรันโปรแกรมจะทำ การล้างเซฟที่เล่นผ่านมาทั้งหมด เมื่อกดแล้วรอสักครู่โปรแกรม จะทำการปิดไปเอง

- ดูเวอร์ชั่นของโปรแกรมทดลอง ได้ที่มุมซ้ายล่างของหน้าแรก หรือ มุมขวาล่างของหน้าต่างตั้งค่า

- ไฟล์เนื้อเรื่องที่แสดง จะอ่านจาก ..\Data\story\story.yaml

 

 

การเพิ่มทรัพยากรในเกม

เพิ่มไฟล์ภาพและเสียงต่างๆ ได้ใน ..\Data\assets\Assets\AddressablesAsset การตั้งชื่อไฟล์ห้ามมีอักขระนอกจาก ภาษาอังกฤษ ตัวเลข และ - กับ _ แทนการเว้นวรรค

avatar มีไว้สำหรับใส่ภาพอวตาร์ตัวละคร ที่ใช้ในแชทและหน้าเลือกบท

bg มีไว้ใส่ภาพพื้นหลังในวิช่วลโนเวล

bgm เอาไว้ใส่เสียงเพลงประกอบที่จะใช้กับ music และเพลงประกอบในฉากอื่น

cg เอาไว้ใส่ภาพที่จะใช้ในแท็ก cg: ของวิช่วลโนเวล และ image: ของแชท และภาพ thumbnail ของภาพเหล่านั้นที่จะแสดงใน gallery

character ไว้สำหรับใส่ภาพตัวละครและท่าทางที่จะใช้ในวิช่วลโนเวล

configs ไว้ใส่ไฟล์รวมข้อมูล รหัสอวตาร์ รหัสตัวละคร และข้อมูล gallery

gallery สำหรับใส่ป้ายชื่อของอัลบั้มภาพ

minicg สำหรับใส่ภาพที่จะแสดงในคำสั่ง image: ของวิช่วลโนเวล

sound ไว้สำหรับใส่เสียงประกอบที่จะใช้กับ sound: ในวิช่วลโนเวล

stickers ไว้สำหรับใส่สติ๊กเกอร์ที่จะแสดงในคำสั่ง sticker: ของแชท

 

 

การเพิ่มภาพ Avatar

ให้ใส่ภาพอวตาร์ไว้ใน ..\Data\assets\Assets\AddressablesAsset\avatar ภาพต้องมีขนาด 164x164 px และต้องเป็นไฟล์นามสกุล .png

 

จากนั้นในในไฟล์ ..\Data\assets\Assets\AddressablesAsset\configs\avatar.yaml ต้องไปใส่ลิสต์อวตาร์ที่จะเพิ่มเข้าไปเอาไว้โดยมีข้อมูลดังนี้

• avatar: ให้ใส่ชื่อ/รหัสที่จะใช้อ้างอิงถึงในไฟล์เนื้อเรื่อง
• image: ให้ใส่ชื่อไฟล์ที่อยู่ในโฟลเดอร์ avatar
• name: ให้ใส่ชื่อที่จะแสดงเวลาอวตาร์นี้ส่งข้อความ

 

 

การเพิ่มภาพ Background

ให้เพิ่มภาพพื้นหลังไว้ใน ..\Data\assets\Assets\AddressablesAsset\bg ภาพในไฟล์นี้ ต้องเป็นนามสกุล .png ภาพพื้นหลังมีขนาดอยู่ที่ 1920x1920 px

เรียกใช้ภาพในโฟลเดอร์นี้ด้วยคำสั่ง background: ตามด้วยชื่อไฟล์โดยไม่ต้องมีนามสกุลไฟล์ (.png) ในห้องวิช่วลโนเวล

 

 

การเพิ่มภาพ CG

ให้เพิ่มภาพไว้ใน ..\Data\assets\Assets\AddressablesAsset\cg ภาพในไฟล์นี้ต้องเป็นนามสกุล .png โดยขนาดจะอยู่ที่ 864x1920 px หรือสัดส่วนเท่านั้น เช่น 1728x3840 px (ใหญ่ขึ้นสองเท่า)

 

ภาพที่จะมีการเก็บสะสมในอัลบั้ม ของโฟลเดอร์นี้ จะต้องมี thumbnail ขนาด100x100 px สำหรับแสดงตัวอย่าง ในอัลบั้มโดยมีชื่อเหมือนกับไฟล์หลัก แต่ลงท้ายด้วย _thumb

 

 

การเพิ่มภาพ miniCG

ให้เพิ่มภาพไว้ใน ..\Data\assets\Assets\AddressablesAsset\minicg ภาพในไฟล์นี้ ต้องเป็นนามสกุล .png โดยขนาดควรจะอยู่ที่ 724x724 px

เรียกใช้ภาพในโฟลเดอร์นี้ด้วยคำสั่ง image: ในบทของห้องประเภท วิชวลโนเวล ภาพนี้จะแสดงขึ้นกลางหน้า จอจนกว่าจะทำการปิดด้วย คำสั่ง - image: empty

 

 

การเพิ่มข้อมูลอัลบั้ม

ให้เพิ่มภาพปกอัลบั้มไว้ใน ..\Data\assets\Assets\AddressablesAsset\gallery ภาพในไฟล์นี้ ต้องเป็นรหัส .png โดยขนาดต้องอยู่ที่ 368x140 px

       

จากนั้นในไฟล์ ..\Data\assets\Assets\AddressablesAsset\configs\gallery.yaml ให้ใส่ข้อมูลดังนี้

• name: ให้ใส่ชื่ออัลบั้มที่จะแสดงในเกม
• label: ใส่ชื่อสำหรับอ้างอิงอัลบั้ม ห้ามซ้ำกับอัลบั้มอื่น
• image: ใส่ชื่อภาพปกที่เตรียมเอาไว้
• ในชุดข้อมูล collect ให้ใส่ว่าภาพที่จะเก็บเป็นประเภทอะไร และชื่อไฟล์ว่าอะไร โดยอิงจาก folder ที่ภาพนั้นอยู่

 

 

การเพิ่มภาพตัวละครในวิช่วลโนเวล

ให้เพิ่มภาพตัวละครไว้ใน ..\Data\assets\Assets\AddressablesAsset\character ภาพในไฟล์นี้ต้องเป็นรหัส .png โดยขนาดต้องมีความสูง 1754 px แต่จะกว้างเท่าไหร่ก็ได้ ตามสมควร แต่ต้องเป็นเลขที่หาร 4 ลงตัว (ถ้ากว้างมากก็อาจจะบังตัวอื่น แนะนำความกว้างที่ 1240 px)

วิธีการตั้งชื่อของภาพ จะต้องทำตาม format ที่ถูกต้องเท่านั้น คือ

โดยชื่อตัวละครและชื่อท่าทางนี้ จะต้องถูกนำไปบันทึกในไฟล์ ..\Data\assets\Assets\AddressablesAsset\configs\character.yaml

 

 

การเพิ่มภาพตัวละครในวิช่วลโนเวล

ในไฟล์ ..\Data\assets\Assets\AddressablesAsset\configs\character.yaml จะต้องระบุ ข้อมูลของตัวละครที่จะใช้ในวิช่วลโนเวลให้ถูกต้อง ดังนี้

• character: รหัสที่จะใช้อ้างอิงเมื่อเรียกในบท
• model: ชื่อโมเดลตัวละคร มาจากชื่อไฟล์ส่วนหน้า (ชื่อรหัส)
• name: ชื่อที่ผู้เล่นจะเห็นแสดงในเกม
• action: จะใส่เป็นรายการว่าตัวนี้มีท่าอะไรบ้าง มาจากชื่อไฟล์ ส่วนหลัง (ชื่อท่าทาง) การเรียกใช้ท่าในบท จะกำหนดด้วย act:
• msg_color: สีข้อความ เป็นสีแบบ RGB hex จำนวน 6 อักขระ
• name_bgcolor: สีป้ายชื่อ เป็นสีแบบ RGB hex จำนวน 6 อักขระ RGBA hex หรือ 8 อักขระ (สำหรับใส่ alpha)

 

 

การเพิ่มภาพ Stickers

เพิ่มภาพสติ๊กเกอร์ได้ใน ..\Data\assets\Assets\AddressablesAsset\sticker ภาพควรมีขนาดเล็ก แนะนำที่ขนาด 320x320 px แต่จริงๆ จะเล็กใหญ่ขนาดไหนก็ได้ แต่ต้องเป็นเลขที่หาร 4 ลงตัว

ภาพสติ๊กเกอร์ต้องเป็นไฟล์ .png เท่านั้น

เรียกใช้ภาพในโฟลเดอร์นี้ด้วยคำสั่ง sticker: ในบทของห้องแชท

 

 

การเพิ่มเสียงประกอบและเพลง

เสียงไม่ว่าจะอยู่ใน ..\Data\assets\Assets\AddressablesAsset\bgm หรือ ..\Data\assets\Assets\AddressablesAsset\sound ต้องเป็นไฟล์ .ogg เท่านั้น

ในวิชวลโนเวล สามารถเล่นเสียงเพลงพื้นหลังจากโฟลเดอร์ bgm ให้เรียกด้วยคำสั่ง music: และเสียงประกอบ ในโฟลเดอร์ sound ให้เรียกด้วยคำสั่ง sound:

 

 

การเพิ่มบทเนื้อเรื่อง

นำไฟล์บทที่เป็นนามสกุล .yaml ทั้งหมดมาใส่ไว้ใน ..\Data\story

*ห้ามลบไฟล์ที่ชื่อว่า story.yaml เป็นอันขาด*

ใส่เส้นทางของเนื้อเรื่อง ว่าห้องไหนเล่นก่อนหลัง ไว้ในไฟล์ story.yaml เมื่อทำการรันเกม โปรแกรมจะอ่านไฟล์นี้ก่อน เพื่อจัดอันดับเนื้อเรื่อง