diff --git a/BallBouncer/docs/id/changelog.md b/BallBouncer/docs/id/changelog.md new file mode 100644 index 0000000..4eab612 --- /dev/null +++ b/BallBouncer/docs/id/changelog.md @@ -0,0 +1,146 @@ +% log perubahan + +## 1.2.1 + +This update fixes several critical bugs for Linux users. + +## 1.2.0 + +This version is aimed at further improving the user experience and existing +content polishing. Now you can reassign keyboard shortcuts as you wish. It is +now possible to record your gameplay and play back the resulting recordings +using the built-in player for such recordings. An object map and several other +improvements and fixes are also in place. + +We have opened the official [github translation +repository](https://github.com/sooslandia/translations). If you want to +translate the game and have the ability, we will be glad to accept your help. + +### New features + +- New translations added. + - Turkish. Translator [fatihyuksek](https://github.com/fatihyuksek1). + - Indonesian. Translator [MuhammadGagah](https://github.com/MuhammadGagah). +- You can now change the default keyboard shortcuts. + - To do that, click the "Customize Keyboard Shortcuts" button located on the +"Keyboard Shortcut Configuration" tab on the Settings screen. + - Your configuration file is located in the user data folder (userData) and is +called keyConfig.json. You can share your configuration with other people. In +order for someone else's configuration to work for you, you need to replace your +configuration file with the one you received from the other person. + - You can find out more about configuration setting in the corresponding section +of the documentation. +- You can now record your gameplay. + - You can check the box that determines whether your gaming session will be +recorded on the updated game mode selection screen. The recording behavior can +be configured in the Recording tab of the Settings screen. + - You can play recordings from the recordings menu, which can be accessed by +activating the corresponding item in the main menu. + - Recordings are saved in the recordings folder, located in the user data folder +(userData) and have a .sgr extension. The recording file can be renamed if +necessary and shared with other people. For someone else's recording to be +detected by the game, it must be placed in the game's recording folder. + - Information about how the recording player works and its control keys can be +found in the corresponding section of the documentation. +- Added object map. + - It can be opened with the m key during a gaming session. + - Navigate the map using the arrow keys. You can also find out how many objects +are on the map by pressing the o key. + - There are two navigation modes, which you can read about in the corresponding +section of the documentation. + - All object map hotkeys can be changed in the keyboard shortcut configuration. +- Training mode is expanded as well. + - You can now instantly zero the cooldown of all skills by pressing f1. + - When you press the f2 key, a screen will open where you can change the levels +of your skills and blow force recovery rate. This screen only displays the +skills you have. You can change their level only in the range from level 1 to +the maximum current level. +- In the settings, on the "Behavior" tab, a checkbox has been added that +determines whether the first-person view state will be saved between game +sessions. +- It is now possible to delete saved game progress and reset settings to default +values. + - This can be done in the settings, on the "General" tab. + - You will not be able to reset settings or delete your progress if you accessed +settings through the pause menu. + +### Perubahan + +- The game mode selection screen has been changed. + - the screen is now represented by a virtual form instead of a menu. Navigation +is similar to the settings or profile screen. + - From the new screen you can determine whether the game session will be recorded. +- Improved profile screen interface. + - Now any item from the statistics list can be copied to the clipboard by +pressing ctrl+c. + - The statistics tab now displays the current number of achievement points. + - Auras now display their bonus as well. +- Slight changes to the game balance. + - Now for every hundred points up to a thousand, one coin will be awarded. For +example, you scored 678 points, in which case you will receive 7 coins, and +not one as before. + - After a thousand points, everything remains as before, but the 10 coins +received remain with you. For example, you scored 1234 points, in which case +you will receive 11 coins. +- The maximum number of objects on the field has been increased. +- Now the sound played by pressing the c key in first person camera mode will +play in the center of the field. +- The file name format with critical error data has been changed to (error +yyyy_MM_dd hh-mm-ss.log) + +### Perbaikan + +- Now, when critical errors are displayed, the sound will be completely muted +instead of looping. +- Improved game stability in some cases. + +## 1.1.1 + +### Perbaikan + +- Memperbaiki bug kritis yang terjadi ketika mode orang pertama dan mode menonton +bola aktif secara bersamaan. +- Memperbaiki beberapa bug kecil lainnya. + +## 1.1.0 + +Versi ini difokuskan pada peningkatan pengalaman pengguna: Suara pukulan tongkat +yang berhasil, tampilan kamera orang pertama, tombol ayunan tongkat alternatif, +dll. + +### New features + +- Game ini sekarang mendukung terjemahan yang kehilangan satu atau lebih string. +Jika string tidak ditemukan, permainan akan kembali ke string lokalisasi +bahasa Inggris. +- Dalam mode menonton bola, suara latar telah dipasang di langit-langit, yang +akan membantu membuat menonton menjadi lebih spektakuler. +- Menambahkan suara yang menunjukkan kapan tongkat pemukul berhasil mengenai +bola. Secara default, notifikasi dinonaktifkan; Dapat diaktifkan di +pengaturan, pada tab "Perilaku". +- Menerapkan mode kamera orang pertama. Untuk beralih antar mode, tekan v saat +bermain. +- Kesalahan selama pembaruan sekarang ditulis ke file yang akan ditempatkan di +folder userData/errorLogs. +- Menambahkan kunci alternatif untuk membuat ayunan tongkat horizontal dan +vertikal. + - Untuk ayunan horizontal gunakan tombol e, untuk ayunan vertikal gunakan tombol +r. + - Solusi ini bersifat sementara dan tetap ada hingga konfigurasi kunci diterapkan. +- Sekarang item dengan hadiah yang tersedia di daftar statistik ada di awal +daftar. + +### Perubahan + +- Peningkatan poin yang diterima untuk pukulan beruntun yang sempurna, bola +memantul ke langit-langit dan bola dengan pantulan objek beruntun. +- Dokumentasi telah diperbarui untuk mempertimbangkan fitur-fitur baru. + +### Perbaikan + +- Meningkatkan volume suara pendaratan setelah melompat. +- Kini aura pemimpin tidak menambah poin yang hilang akibat penalti. + +## 1.0.0 + +Rilis pertama. diff --git a/BallBouncer/docs/id/readme.md b/BallBouncer/docs/id/readme.md new file mode 100644 index 0000000..607b06b --- /dev/null +++ b/BallBouncer/docs/id/readme.md @@ -0,0 +1,366 @@ +% dokumentasi "Ball bouncer". + +File bantuan ini menjelaskan cara menavigasi menu dan layar aplikasi, dan juga +menjelaskan gameplay secara detail dengan sebagian besar nuansanya. Jika Anda +ingin mengetahuinya sendiri, kami sarankan Anda segera membuka dan membiasakan +diri dengan tabel tombol kontrol. + +## About the game + +### Brief description + +BallBouncer is a simple, yet hard to master arcade game which will put your +reflexes and patience to the test. + +Armed with a hefty bat, hit the ball at the right moments to turn it's wild +trajectory into a well thought out tactic of object destruction. + +But can you really think ahead when cups, dishes, closets and tvs crash around +you? + +The ball's unpredictable bounces can create thrilling chain reactions, keeping +you challenged and your playstyle evolving. + +Ball bouncer offers the possibility of creating your own scoring strategy. With a +variety of skills, features and upgrades to unlock and max out in the store, can +you beat your previous score? At the end of the gaming session, points are +converted to coins. Spend them wisely! + +So, are you ready to embark on a path of methodical, but chaotic destruction? +Then go ahead! + +### Persyaratan sistem + +windows 10 64 bit or later. + +ubuntu 22 64 bit or later. + +### Langkah pertama + +When the game runs for the first time you will have to select a language. After +making your selection, a welcome screen will appear. As soon as you make your +selection our logo will start playing. You can skip it by pressing the enter +key. After the logo is skipped or finishes playing you will be taken to the main +menu of the game. We encourage you to familiarize yourself with its contents. If +you want to learn the game sounds, you need to select “Settings” in the main +menu, then on the “General” tab click on the corresponding button. On the +“Sound” tab you can adjust the volume of music and sounds, change the sound +panning mode And disable some alerts. on the "Behavior" tab. You can delete your +progress and reset your settings to default by clicking the corresponding +buttons on the General tab. Resetting the keyboard shortcut configuration to the +default one is done on the corresponding tab as well. + +If you don't like the sound of the ball, you can change it in the settings, on +the "Sound" tab, choosing from five proposed options. This can be done directly +during the game by going to the settings from the pause menu. The ball sound +will change as soon as you unpause the game. + +### Navigasi + +Bergerak melalui menu dilakukan dengan menggunakan panah atas dan bawah. Enter +memilih item, sedangkan tombol home dan end melakukan tugasnya masing-masing +dengan menempatkan Anda pada item menu pertama atau terakhir. + +Navigasi layar (pengaturan, toko, profil, dll.),: tab/shift+tab maju/mundur, +aktifkan kontrol dengan menekan enter atau spasi. Telusuri daftar dengan panah +atas dan bawah, ubah nilai penggeser dengan panah. Pemilihan tab dilakukan +dengan menekan tombol panah kiri/kanan. + +On the shop screen, by pressing enter on the item you have selected, you can open +reference information that describes this item. In your profile, on the +"Statistics" tab, by pressing enter on a list item you can receive a reward, if +available. By pressing ctrl+c you can copy the contents of the item into your +clipboard. On the “Skills” tab, by clicking on an item, you can get detailed +information about the skill. + +Semua menu dan layar, kecuali menu utama dan menu hasil pertandingan terakhir, +dapat ditutup dengan tombol escape. + +## Proses permainan + +### Training mode + +The game has a training mode where you can spend unlimited time and where all +penalties are disabled. In this mode, a sound will be played when you can hit +the ball, which you can listen to in the learn sounds menu. The sound will play +when the ball has bounced at least once off the floor to teach you to sense the +moment for the perfect strike. In training mode, game statistics are not +collected, and points are not scored. During training, you can press f2 in order +to open the training mode screen. There you can set your blow force recovery +rate and skill (if any) levels to your liking. Levels range is from 1 to your +current unlocked level. By pressing f1 you can instantly zero the cooldown of +your skills. + +These keys can be changed using the Shortcut Key Configurator. + +### Cara bermain + +After selecting “Start game” in the main menu, the starting countdown will begin. +You will then be able to control the character. At the beginning of the game the +character is in the center of the field. You can move it using the left and +right arrows. Initially the camera is in the field-centered view, but you can +switch it to first person view and back by pressing v. By pressing the C key, +you will hear a sound positioned at the character's location if in the field +centered view. In the first person view the sound is played in the center of the +field. This will help you better understand your character whereabouts when +trying to hit the ball. With the left or right shift you can set the direction +the character is facing. When moving, the facing direction is set automatically. + +Pertama-tama, Anda perlu melempar bola agar muncul di lapangan permainan. Anda +dapat melakukan ini dengan menekan tombol f. Setelah bola berada di lapangan, +akan terdengar nada yang bergerak ke kiri dan ke kanan, menandakan pergerakan +bola pada bidang horizontal. Volume dan nada juga akan berubah, menandakan +pergerakan bola vertikal. Jika volume terdengar kecil dan nada terdengar +meninggi, berarti bola bergerak ke atas, sedangkan jika terdengar volume lebih +keras dan nada turun, berarti sebaliknya. + +Ada dua jenis lemparan: + ++ Normal. Dilakukan dengan menekan tombol f. Bola mulai terbang membentuk busur +ke arah yang dihadapi karakter. ++ Vertikal. Dilakukan dengan menahan tombol alt dan menekan f. Bola mulai terbang +sepanjang sumbu vertikal, tetapi juga bergerak sedikit sepanjang sumbu +horizontal ke arah yang dihadapi karakter. + +Tujuan permainan ini adalah untuk menghancurkan objek sebanyak mungkin dan +mendapatkan poin di sepanjang permainan. Bola selalu cenderung jatuh, dan Anda +harus memukulnya kembali dengan tongkat pemukul. + +Bola dapat dipukul dengan dua cara: + ++ Tombol spasi. Dalam hal ini, bola akan menerima dorongan horizontal yang kuat +ke arah yang dihadapi karakter. ++ Tahan tombol alt dan tekan spasi. Bola akan menerima dorongan vertikal yang +kuat, mempertahankan arah terbang horizontal terlepas dari arah lawannya. + +Anda hanya bisa memukul bola saat berada di dekat bola. Setelah setiap ayunan +pemukul, karakter memulihkan kekuatan pukulannya. Setelah pulih sepenuhnya, Anda +akan mendengar peringatan, yang suaranya dapat didengar di menu pelajari suara. +Anda juga dapat mengaktifkan suara pukulan tongkat yang berhasil mengenai bola, +pada tab perilaku. + +Anda harus berusaha untuk selalu membuat pukulan sempurna, karena Anda akan +diberikan poin bonus untuk itu. Pukulan sempurna terjadi jika bola hanya +memantul satu kali saja. Untuk pantulan kedua dan selanjutnya, Anda akan +kehilangan poin. Semakin banyak bola memantul ke tanah, semakin banyak poin yang +hilang. Oleh karena itu, usahakan untuk memukul bola ke atas secepat mungkin. +Berdiri di satu tempat dalam waktu lama juga tidak sepadan, karena jika Anda +tidak bergerak selama sepuluh detik atau lebih, Anda juga akan kehilangan poin. +Di awal permainan, jangan terlalu lama memegang bola di tangan, karena setiap +detik memegang bola akan mengakibatkan penalti yang semakin besar. Hal yang sama +berlaku untuk bola yang ditangkap. Untuk kesalahan kelima dan selanjutnya dengan +pemukul, penalti akan diberikan. Untuk membenturkan bola dengan suatu benda, +serta untuk menghancurkan benda tersebut, Anda mendapat poin. Jika bola memantul +ke langit-langit, Anda juga akan mendapatkan poin bonus. Setelah bertabrakan +dengan suatu benda atau menghancurkannya, sebuah pukulan dimulai. Ada +garis-garis terpisah untuk tabrakan dan kehancuran. Setiap tabrakan atau +kehancuran berikutnya menghasilkan lebih banyak poin. Namun jika pukulan +beruntun tidak berlangsung lebih dari enam detik, maka pukulan tersebut akan +diatur ulang. Hal yang sama berlaku untuk bola yang memantul dari langit-langit. +Setelah melakukan pukulan sempurna, pukulan beruntun juga dimulai. Untuk setiap +serangan sempurna baru yang Anda lakukan, Anda mendapatkan poin yang jauh lebih +banyak dibandingkan serangan sebelumnya. Jika bola memantul dari lantai lebih +dari satu kali, pukulannya berakhir dan Anda harus memulai dari awal. Setelah +hancur, objek akan jatuh ke tanah sehingga menimbulkan ketidaknyamanan dengan +suara yang keras dan menambah kekacauan. + +Selama permainan, Anda tidak hanya dapat menonton keseluruhan gambar lapangan +permainan, tetapi juga beralih ke mode menonton bola. Untuk mengaktifkan mode +ini, tahan tombol G. Mode memonton bola akan aktif selama Anda menahan G dan +akan mati segera setelah Anda melepaskannya. Permainan dapat dijeda dengan +menekan tombol escape. Saat diaktifkan, Anda akan dibawa ke menu jeda permainan, +di mana Anda dapat melihat waktu hingga sesi permainan berakhir, jumlah poin +yang dicetak, dan informasi lainnya. Anda juga dapat mengakses pengaturan dari +menu jeda, atau menghentikan permainan. Alternatifnya, tekan t untuk melihat +waktu dan p untuk melihat poin selama permainan berlangsung. + +Jika Anda membiarkan poin Anda turun hingga minus seribu, sesi permainan akan +berakhir lebih awal. Koin tidak akan dikreditkan, tetapi Anda tidak akan +kehilangan apa pun. Sesi permainan berlangsung lima menit. Kali ini dapat +ditingkatkan dengan meningkatkan aura waktu di profil. Setelah sesi permainan +berakhir, animasi suara koin yang ditambahkan akan mulai diputar, yang dapat +dilewati dengan menekan tombol enter. Kemudian menu hasil pertandingan terakhir +akan terbuka, di mana Anda dapat mengetahui berapa banyak poin yang akhirnya +dicetak dan koin yang diterima. Setelah menutup menu dengan menekan enter, Anda +mungkin diperlihatkan pemberitahuan tentang hadiah yang tersedia untuk mencapai +pencapaian statistik. Tampilan menu hasil pertandingan terakhir dan +pemberitahuan tentang hadiah yang tersedia dapat dinonaktifkan di pengaturan, +pada tab “Perilaku”. + +Game ini juga memiliki keterampilan yang dijelaskan secara lengkap di dalam game. +Untuk menggunakan keterampilan selama permainan, Anda perlu menetapkannya ke +salah satu dari sepuluh slot. Penugasan dilakukan di profil Anda, pada tab +“Keterampilan”. Slot diakses menggunakan kunci dari 1 (slot pertama) hingga 0 +(slot kesepuluh). + +Di toko, Anda dapat membuka kunci mekanisme melompat dan menangkap bola. Kedua +mekanisme ini juga dijelaskan secara lengkap di dalam game, termasuk kunci yang +digunakan. Mereka juga ada di tabel kontrol. + +### The object map + +The object map works in any mode. You can open it with the m key. The map +displays all objects that were on the field when it was opened. Using the arrow +keys, you can move the cursor around the map, which will play a short sound of +the object in the place where this object is located, and the type of object +will also be announced. You can turn off the pronunciation of the object type +using the f1 key. Using the f2 key you can switch between movement modes. + +There are two cursor movement modes: + +- Free movement. The cursor can be moved on the map in any direction by one cell. +When moving in free mode, empty cells will also be visible under the cursor, +which are indicated by their own sound. +- Moving through objects. The cursor moves only over objects; moving to the right +or left will move through objects in the same row horizontally. Moving up or +down will move the cursor to the nearest object vertically and skip empty rows. + +In addition to the cursor, the map indicates an observation point, which is +located in the center of the horizontal axis and can be moved vertically. All +object sounds are played relative to this point. You can move the observation +point using the keys w - up, s - down. In this case, a sound will be played that +changes its pitch depending on the position, so that it is easier for you to +understand where the point is located along the axis. + +You can also find out how many objects are on the field at the moment. To do +this, press the o key. + +All of the listed keys can be changed using the keyboard shortcut configurator. + +### Gameplay recording + +You can record your gameplay and then play the resulting recordings in the game's +built-in player. + +Important: recordings are not made during training mode. + +To start recording, make sure the "Record game" checkbox on the game mode +selection screen is checked. Recording begins after the game start countdown. + +In the settings, on the "Recording" tab, you can determine whether a recording +will be saved every 30 seconds, as well as whether to cancel or save the +recording when pausing the game from the pause menu. + +To listen to recordings, select the corresponding item in the main menu of the +game. Then, in the recordings menu, select the one you want and press enter. +After loading the recording, you will be taken to the player. + +Player control keys: + +- To start, pause and unpause playback, press spacebar. +- To adjust the volume, use the up arrow keys to make it louder, down arrow keys +to make it quieter. The recording volume can be increased to a maximum of two +hundred percent. +- to rewind the recording by 5 seconds, use the arrow keys right - forward, +left - backward. Rewinding by 30 seconds is done with the ctrl key held down. +- You can find out how much you listened to, as well as the duration of the +recording, by pressing the t key. +- You can stop playback and return to the recording menu using the escape key. + +Your recordings are located in the recordings folder, which in turn is located in +the user data folder (userData), and have a .sgr extension. You can rename the +recording file if necessary and share it with other people. If you want to play +someone else's recording, place it in your recordings folder. Then it will be +visible in the recordings menu. + +## tombol kontrol + +All keys in this section can be redefined by customizing the keyboard shortcut +configuration. + +### Basic + +| Tindakan | Kunci/tombol | +| :-- | :-- | +| Move the character right/left | Panah Kanan/Kiri atau tombol d/a | +| Mainkan suara pada posisi karakter | c | +| Atur karakter menghadap kanan/kiri | shift kanan/shift kiri | +| Mengayunkan pemukul (memukul bola dengan dorongan mendatar yang kuat) | Spacebar, s or e key | +| Mengayunkan pemukul (memukul bola dengan dorongan vertikal yang kuat) | alt+space, alt+s or r | +| Lemparkan bola secara melengkung | f | +| Lemparkan bola secara vertikal | alt+f | +| Alihkan kamera ke mode menonton bola | Tahan tombol g | +| Alihkan kamera ke mode normal | Lepaskan tombol g | +| Beralih mode kamera antara mode orang pertama dan mode tampilan terpusat di lapangan | v | +| Melompat (jika fitur tidak terkunci) | Panah atas atau tombol w | +| Menangkap bola (jika fitur tidak terkunci) | kontrol kiri atau kanan | +| Pilih slot keterampilan dari 1 hingga 10 (jika keterampilan diatur) | keys 1 to 0/numpad1 to numpad0 | +| Batalkan pemilihan slot keterampilan | Grave / numpad enter | +| Open the object map | m | +| Cari tahu waktu hingga akhir sesi permainan | t | +| Cari tahu jumlah poin yang dihasilkan saat ini | p | +| Jeda permainan | tombol escape | + +### Training mode + +| Tindakan | Kunci/tombol | +| :-- | :-- | +| Zero the cooldown of all skills | f1 | +| Set skill levels | f2 | + +### The object map + +| Tindakan | Kunci/tombol | +| :-- | :-- | +| Move cursor | Arrow keys | +| Move observation point lower | s | +| Move observation point higher | w | +| Toggle object type announcement status | f1 | +| Toggle cursor movement mode | f2 | +| Find out the number of objects on the map | o | + +### Configuring keyboard shortcuts + +In the settings, on the "keyboard shortcuts configuration" tab, by clicking on +the corresponding button, you can customise the controls to your liking. On the +configurator screen there is a tree in which, at the first level, individual +blocks are presented, which in turn contain actions. Each action has a list with +assigned keyboard shortcuts. You can either add or remove them from this list +using the appropriate buttons. After pressing the add button, a new screen will +open, containing four lists, a field assigning the main key, the “Add” and +“Cancel” buttons. Each list is responsible for its own modifier key (alt, +windows, control, shift), and contains 4 options for using the modifier key (do +not use, left, right, any). To set a key, follow the instructions in the key +assigner field immediately following the list for the shift modifier key. If you +want to use only modifier keys in your shortcut, leave the field unassigned. +After all the necessary parameters have been set, click on the “Add” button, but +keep in mind that duplicates within the same shortcuts block are prohibited. + +If required, you can share your keyboard shortcut configuration with other +people. The configuration is located in the user data folder (userData) and is +named "keyConfig.json". The other person will have to replace their +configuration, located in the same location, with the one you passed on. Despite +the fact that the configuration is stored in open form, it is not intended for +manual editing. + +## Translation of the game into other languages + +If you would like to translate ball bouncer into your native language, please +visit [sooslandia-games translation repository on +github](https://github.com/sooslandia/translations) + +Github was chosen because it allows us to centralize all translations in one +place, automatically confirm that the game with a new translation will launch +without errors, convert different translation formats using scripts, and +maintain the structure of the stored data in order. + +If you have any difficulties, contact us for help in the telegram group, discord +or email. Look for links to the above in the “Conclusion” section. + +## Kesimpulan + +Kami senang Anda tertarik dengan proyek ini dan kami berharap Anda menyukainya. +Selamat bermain dan bersenang-senanglah! + +Subscribe to our [channel](https://t.me/sooslandia) on telegram, or join our +[discord server](https://discord.gg/8xcKB7dsDR), to receive the latest news +about updates to this game, as well as about other interesting projects. + +Join the [channel chat](https://t.me/sooslandiadiscussion), where you can share +your opinion about the game, report any bugs, or suggest your idea, just like in +discord. + +If you don't use telegram and discord, you can write to [our +email](mailto://contact@sooslandia.ru), but a quick response is not guaranteed. + +All the best, Sooslandia-games.