Share add-on openBVE

Saat anda membuat rute, kereta, atau plugin, banyak yang perlu diperhatikan. Seperti, memastikan bahwa add-on anda harus bisa dipakai di OpenBVE pada semua Sistem Operasi.

■ File teks dan enkoding

Apapun teks yang akan anda tulis dalam add-on, termasuk readme, pastikan file ini bisa dibuka di semua OS secara internasional. Enkoding default untuk semua file yang diproses di OpenBVE adalah UTF-8. Tenang saja, karena Bahasa Indonesia sudah menggunakan format ini, maka biasanya tidak perlu khawatir filenya tidak dapat terbaca di komputer lain di seluruh dunia. Hanya saja, jika ingin menambahkan bahasa yang membutuhkan karakter khusus, seperti bahasa cina, jepang, india, atau bahasa daerah yang tidak ada di 26 Alfabet standar, maka pastikan gunakan enkode UTF-8.

Yang diperbolehkan dan tidak:

Simpan file anda dengan format UTF-8.
Menyimpan teks anda dengan format Unicode dan byte order mark.
Menyimpan teks anda dengan format selain Unicode.
Menggunakan enkoding yang berbeda di berbagai file dalam 1 add-on

■ Archive x Installer

Saat membuat archive add-on, buat 1 file archive saja daripada membuat banyak file archive yang lebih kecil, kecuali jika sizenya terlalu besar. Jangan gunakan installer yang hanya bisa digunakan oleh 1 OS saja (kecuali jika anda ingin menyediakan installer untuk semua OS). Misalnya format EXE untuk Windows, RPM untuk Linux, dan DMG untuk Mac.

Yang diperbolehkan dan tidak:

Menggunakan format 7Z, ZIP, TAR.GZ, dll.
Menggunakan file EXE, RPM, DMG, dsb.

■ Nama file dan archive

Biasanya, anda bebas membuat nama file dalam karakter apapun seperti huruf latin, mandarin, jepang, dsb. Tapi pastikan format nama yang dipakai bisa dibaca oleh software. Jika tidak, mungkin pengguna konten anda akan kesulitan menggunakannya. Sayangnya, format ZIP tidak support Unicode sedangkan format lain seperti 7Z bisa. Mungkin anda bisa menggunakan format ASCII seperti huruf A-Z, a-z, 0-9.

Yang dibolehkan dan tidak:

Menggunakan archive yang berformat Unicode (misal 7Z)
Menggunakan archive format yang tidak didukung oleh Unicode dan memakai format bahasa anda sendiri.
Menggunakan archive yang tidak memakai Unicode tetapi memakai nama Unicode.

■ Archive dan susunan folder

Anda harus selalu menyertakan struktur folder lengkap, yaitu Railway dan Train, saat mendistribusikan rute atau kereta. Ini akan memudahkan orang untuk memahami dimana mereka perlu mengekstrak konten. Jangan pernah memasukkan subdirektori seperti NamaAndaDisini yang seharusnya diekstrak ke folder Railway\Sound, misalnya. Hanya pengguna yang lebih berpengalaman yang dapat mengetahui di mana harus meletakkan konten tersebut dengan memeriksa file atau ekstensinya.

Yang dibolehkan dan tidak:

Menambahkan folder Railway atau Train, lebih baik tambahkan keduanya.
Hanya memasukkan folder atau file dan membiarkan user mencari tau sendiri cara menggunakannya.

■ Error dan peringatan

Umumnya, rute anda harus bebas dari kesalahan. Harap dicatat bahwa openBVE membedakan antara Kesalahan/Error dan Peringatan/Warning. Kesalahan adalah sesuatu yang pasti salah dengan pengkodean anda yang harus segera diperbaiki. Peringatan biasanya hanya dimunculkan untuk pemeriksaan kode yang berpotensi ambigu atau kode yang mungkin tidak bekerja seperti yang tertulis. Untuk memeriksa kesalahan dan peringatan pada rute dan kereta anda, buka menu pengaturan di openBVE dan aktifkan pelaporannya. RouteViewer dan ObjectViewer selalu melaporkan pesan seperti itu. Harap dicatat bahwa berbagai alat dan openBVE itu sendiri mungkin melaporkan kumpulan pesan yang berbeda karena tidak memiliki semua fungsi yang sama. Mendistribusikan add-on yang mengandung kesalahan mungkin memberi kesan kepada pengguna lain bahwa ada sesuatu yang tidak diunduh secara lengkap atau ada yang salah.

Yang dibolehkan dan tidak:

Mengaktifkan laporkan error dan peringatan pada menu Pengaturan dan cek add-ons anda.
Menyebarkan add-on yang tidak ada errornya (warning tidak apa-apa).
Jangan mengecek error pada add-on dengan mematikan laporan error atau abaikan pesan.
Membagikan add-on yang masih mempunyai error.

■ Rute dan kereta yang menggunakan plugin khusus.

Jika anda ingin menambahkan plugin, pastikan hanya berformat .NET. Plugin jadul yang hanya bisa dipakai di OS Windows sudah tidak bisa dipakai lagi, dan harusnya sudah tidak dipakai. Jika anda masih sangat membutuhkan plugin jadul, setidaknya pastikan add-on anda bisa dipakai tanpa menggunakan plugin itu. Silakan tes dengan menghapus file ats.cfg (atau rename aja file ats ini sementara).

■ Panduan operasional

Penjelasan tentang persinyalan dan semboyan, dan juga cara menggunakan kereta, sebaiknya ditambahkan sebagai file readme, atau file tutorial. Jangan sampai pengguna menebak-nebak apa yang harus dilakukan saat mengoperaskan kereta anda. Lebih baik lagi cantumkan tutorial bahasa inggris supaya lebih banyak orang yang mengerti.