dungeonclub

Dungeon Club - Tabletop Virtual

Platform online untuk mengumpulkan dan bermain Dungeons & Dragons, Call of Cthulu, Pathfinder dan banyak lagi.

Dungeon Club berusaha untuk menjadi meja virtual yang paling ramah pengguna , menyediakan banyak fitur dan desain yang nyaman. Kunjungi beranda untuk demonstrasi fitur atau coba demo sekarang!

Perkembangan

Untuk menjalankan dan men -debug VTT secara lokal, Anda akan membutuhkan DART SDK. Jika Anda berada di Windows dan tidak ingin kesulitan memasang cokelat, saya sarankan mengikuti panduan ini sebagai gantinya.

Setelah mengunduh SDK dan memastikan itu bagian dari jalur Anda, jalankan baris berikut sebagai pengaturan satu kali :

 # Clone repository and navigate into the directory
git clone https://github.com/doodlezucc/dungeonclub.git
cd dungeonclub

dart pub get                     # Download all required packages
dart pub global activate webdev  # Download Dart->JavaScript transpiler

Stylesheet aplikasi web ditulis dalam sass dan harus ditranspilasi ke CSS. Anda dapat menginstal Sass sebagai mandiri yang dapat dieksekusi atau dengan menggunakan Node.js Package Manager NPM.

npm install -g sass              # Download SCSS->CSS transpiler

^{Info lebih lanjut tentang Sass dan Webdev.}

Diluncurkan melalui VS Code

Jika Anda menggunakan kode Visual Studio IDE, Anda dapat menggunakan konfigurasi peluncuran repositori. Anda dapat memulai backend serta layanan frontend secara bersamaan dengan memilih konfigurasi Launch All (Terminal) debug.

Perhatikan bahwa konfigurasi peluncuran all-in-one ini dimulai di dalam terminal VS Code. Ini memungkinkan Anda untuk memulai ulang server backend dengan keypress R sederhana. Jika Anda lebih suka konsol debug IDE, Anda dapat memulai proses pengembangan secara terpisah:

• Web/Frontend - Jalankan Tasks: Run Build Task (atau tekan Control + Shift + B ).
• Server/Backend - Jalankan Debug: Start Debugging (atau tekan F5 ) dan pilih konfigurasi Launch Backend .

Diluncurkan melalui shell

Atau, Anda dapat memulai server pengembangan dengan menjalankan skrip DART.

 # Launch the webdev server / stylesheet compiler / backend server
dart bin/dev.dart

Setelah menginisialisasi backend dan melayani web, Anda dapat pergi ke localhost:8080 dan melihat versi klub Dungeon yang baru disampaikan dan disampaikan secara langsung.

Perubahan pada kode sumber tercermin pada waktu yang berbeda tergantung pada bagian apa yang sedang Anda kerjakan. Perubahan dapat dilihat ...

• Kode Server - Setelah memulai kembali server. Saat meluncurkan dari terminal, Anda dapat menekan R di dalam terminal Anda untuk memulai kembali proses backend.
• Kode situs web - Setelah menyegarkan situs web (di http://localhost:8080 ).
• Situs Web Stylesheet - Setelah menyegarkan situs web atau dengan menekan Shift + R di situs web (tidak tersedia di Firefox).

Tuan rumah mandiri

Anda dapat menemukan versi publik resmi Dungeon Club di https://dungeonclub.net. Jika Anda ingin meng -host server lokal di mesin Anda, ada dua cara untuk mencapai ini.

Rilis yang telah dikompilasi sebelumnya

Setiap kali pembaruan diluncurkan ke situs web publik, rilis baru ditambahkan ke tab Rilis Repositori. Rilis terdiri dari changelog pendek diikuti oleh daftar build yang telah dikompilasi untuk beberapa platform dan arsitektur.

Setelah mengunduh dan membuka ritsleting build yang Anda pilih, Anda akan menemukan dua file yang relevan di dalamnya:

• Server.exe - server yang dapat dieksekusi. (Bergantung pada platform Anda, ekstensi file mungkin berbeda.)
• Login.YAML - File yang dapat menentukan login akun khusus.

Saat mengeksekusi server.exe , terminal terbuka, memberi tahu Anda bahwa Dungeon Club sekarang bertugas di http://localhost:7070 . Anda dapat menavigasi ke alamat ini dan melihat salinan VTT Anda sendiri dimuat dan siap digunakan.

Coba masuk ke akun mock yang sudah terdaftar dengan mengisi email "admin", kata sandi "admin" di beranda. Tidak ada perbedaan dalam menggunakan akun tiruan vs akun yang diverifikasi email biasa, selain dari cara dibuat. Setelah login yang berhasil, Anda disajikan dengan kemampuan untuk membuat dan mengelola kampanye Anda sendiri.

Jika Anda membuka port server ( 7070 secara default) di jaringan Anda, pemain luar harus dapat berinteraksi dengan situs web yang dihosting secara lokal dengan mengakses alamat IP Anda.

Build khusus

Terlepas dari daftar resmi rilis yang dapat dieksekusi, Anda juga dapat membangun Dungeon Club sendiri. Ikuti pengaturan satu kali yang dijelaskan dalam pengembangan untuk menginstal alat yang diperlukan. Kemudian, jalankan skrip build khusus yang termasuk repositori dengan menjalankan perintah berikut:

 dart bin/build.dart [options]

Untuk daftar argumen yang mungkin, jalankan dart bin/build.dart --help atau lihat bagian berikutnya.

Argumen baris perintah

Opsi berikut dapat dimasukkan sebagai argumen ke server dan/atau pembangun.

Pilihan	Definisi	Default (sajikan)	Default (build)
-h, --help	Cetak daftar bendera dan opsi yang tersedia.
--[no-]mock-account	Apakah akan menerima konten "login.yaml" sebagai daftar akun terdaftar.	false	true
--[no-]music	Apakah akan mengaktifkan pemutar musik terintegrasi. Host server mungkin perlu menginstal YT-DLP dan FFMPEG untuk mengunduh 500 MB musik latar.	true	false
Server saja
-p, --port	Menentukan port server.	7070
--bootstrap	all - Aktifkan file log dan keluar anggun logging - Aktifkan file log none - bypass bootstrapper	all
Bangun saja
--[no-]copy-music	Apakah akan memasukkan musik yang diunduh secara lokal (suasana/trek/*. Mp3) dalam build.		false
--[no-]download-icons	Apakah akan mengunduh dan memasukkan rilis terbaru Font Awesome (ikon yang digunakan di situs web)		true
--part	Bagian mana yang dikompilasi dan dimasukkan dalam build. Bisa server atau all .		all