From 8693f3cea7d82722445aec3d4b4c7235beafb20e Mon Sep 17 00:00:00 2001 From: muczc1wek Date: Sun, 3 Sep 2023 10:46:50 +0200 Subject: [PATCH 1/2] First version of zBassMusic article --- docs/zengin/union/plugins/zbassmusic.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/zengin/union/plugins/zbassmusic.md diff --git a/docs/zengin/union/plugins/zbassmusic.md b/docs/zengin/union/plugins/zbassmusic.md new file mode 100644 index 0000000000..9484f06cf8 --- /dev/null +++ b/docs/zengin/union/plugins/zbassmusic.md @@ -0,0 +1,19 @@ +# zBassMusic +zBassMusic is a modern music system for Gothic I and Gothic II NotR based on [BASS Audio Library](https://www.un4seen.com/) made by [Silver Ore Team](https://github.com/Silver-Ore-Team). It replaces the old DirectMusic system to let the modders create music for Gothic as regular audio files instead of DirectMusic format. + +!!! Info + For the plugin documentation, visit the [github site](https://github.com/Silver-Ore-Team/zBassMusic) of a project. The documentation is build into the code. + +| Contacts || +|:---------| :--- | +| Authors | [:material-badge-account-horizontal: Silver Ore Team](https://github.com/Silver-Ore-Team) - [tehe](https://github.com/piotrmacha) | +| GitHub | [:material-github: zBassMusic](https://github.com/Silver-Ore-Team/zBassMusic)| +| Discord | [:simple-discord: Gothic Modding Community server](https://discord.gg/mCpS5b5SUY) | + +## Features + +- Music playback with modern audio formats like WAV, MP3, OGG +- Out-of-the-box support for existing C_MUSICTHEME instances +- Scriptable interface to take full control of music scheduling +- Loading music files from VDFS volumes (excluding .sgt) +- Backwards compatibility with DirectMusic .sgt files From f565b254e26ac4f555260598abf78d52958273ec Mon Sep 17 00:00:00 2001 From: muczc1wek Date: Sun, 3 Sep 2023 11:23:13 +0200 Subject: [PATCH 2/2] Add mention about zBassMusic in main music article --- docs/zengin/music.md | 4 ++++ docs/zengin/music.pl.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/zengin/music.md b/docs/zengin/music.md index 3705bebb97..397edcc02a 100644 --- a/docs/zengin/music.md +++ b/docs/zengin/music.md @@ -18,3 +18,7 @@ The music directory contains these file types: - Patterns - fragments of tracks, that can be later merged, looped and superimposed on each other - `.sgt` - File with properly connected patterns - the final track + +## Alternative Music System + +The [zBassMusic](./union/plugins/zbassmusic.md) plugin replaces Zengin's default music library with the much newer BASS library. This allows, among other things, to play music in such formats as `.mp3` or `.ogg`, and to pack songs into `.vdf` and `.mod` archives. \ No newline at end of file diff --git a/docs/zengin/music.pl.md b/docs/zengin/music.pl.md index 95e4c6fde0..0d45eecc11 100644 --- a/docs/zengin/music.pl.md +++ b/docs/zengin/music.pl.md @@ -21,3 +21,7 @@ Katalog `Music` zawiera następujące typy plików: - Wzory (Patterns) - fragmenty utworów, które można później łączyć, zapętlać i nakładać na siebie. - `.sgt` - Plik z odpowiednio połączonymi wzorami (patternami) - końcowy utwór + +## Alternatywny System Muzyczny + +Plugin [zBassMusic](./union/plugins/zbassmusic.md) zastępuje domyślną bibliotekę muzyczną Zengina, dużo nowszą biblioteką BASS. Umożliwia to między innymi odtwarzanie muzyki w takich formatach jak `.mp3` lub `.ogg`, oraz pakownie utworów do archiwów `.vdf` i `.mod`. \ No newline at end of file