From 035d0037079da97c14c03139fa77e6eb26102ecf Mon Sep 17 00:00:00 2001 From: tc-mods-crowdin <116122648+tc-mods-crowdin@users.noreply.github.com> Date: Wed, 1 Nov 2023 00:22:08 -0700 Subject: [PATCH] New Crowdin updates (#26) * New translations installing-r2modman.md (Spanish) * New translations installing-r2modman.md (German) * New translations installing-r2modman.md (Finnish) * New translations installing-r2modman.md (Italian) * New translations installing-r2modman.md (Japanese) * New translations installing-r2modman.md (Korean) * New translations installing-r2modman.md (Dutch) * New translations installing-r2modman.md (Ukrainian) * New translations installing-r2modman.md (Chinese Simplified) * New translations installing-r2modman.md (Portuguese, Brazilian) * New translations installing-r2modman.md (Thai) * New translations sidebar.md (French) * New translations installing-songs.md (French) * New translations introduction.md (French) * New translations installing-r2modman.md (French) * New translations migration.md (French) * New translations sidebar.md (Spanish) * New translations creating-charts.md (Spanish) * New translations installing-songs.md (Spanish) * New translations introduction.md (Spanish) * New translations migration.md (Spanish) * New translations sidebar.md (German) * New translations creating-charts.md (German) * New translations installing-songs.md (German) * New translations introduction.md (German) * New translations migration.md (German) * New translations sidebar.md (Finnish) * New translations creating-charts.md (Finnish) * New translations installing-songs.md (Finnish) * New translations introduction.md (Finnish) * New translations migration.md (Finnish) * New translations sidebar.md (Italian) * New translations creating-charts.md (Italian) * New translations installing-songs.md (Italian) * New translations introduction.md (Italian) * New translations migration.md (Italian) * New translations sidebar.md (Japanese) * New translations installing-songs.md (Japanese) * New translations introduction.md (Japanese) * New translations migration.md (Japanese) * New translations sidebar.md (Korean) * New translations creating-charts.md (Korean) * New translations installing-songs.md (Korean) * New translations introduction.md (Korean) * New translations migration.md (Korean) * New translations sidebar.md (Dutch) * New translations creating-charts.md (Dutch) * New translations installing-songs.md (Dutch) * New translations introduction.md (Dutch) * New translations migration.md (Dutch) * New translations sidebar.md (Ukrainian) * New translations creating-charts.md (Ukrainian) * New translations installing-songs.md (Ukrainian) * New translations introduction.md (Ukrainian) * New translations migration.md (Ukrainian) * New translations sidebar.md (Chinese Simplified) * New translations installing-songs.md (Chinese Simplified) * New translations introduction.md (Chinese Simplified) * New translations migration.md (Chinese Simplified) * New translations sidebar.md (Portuguese, Brazilian) * New translations creating-charts.md (Portuguese, Brazilian) * New translations installing-songs.md (Portuguese, Brazilian) * New translations introduction.md (Portuguese, Brazilian) * New translations migration.md (Portuguese, Brazilian) * New translations sidebar.md (Thai) * New translations creating-charts.md (Thai) * New translations installing-songs.md (Thai) * New translations introduction.md (Thai) * New translations migration.md (Thai) * New translations installing-r2modman.md (Spanish) * New translations installing-r2modman.md (German) * New translations installing-r2modman.md (Finnish) * New translations installing-r2modman.md (Italian) * New translations installing-r2modman.md (Japanese) * New translations installing-r2modman.md (Korean) * New translations installing-r2modman.md (Dutch) * New translations installing-r2modman.md (Ukrainian) * New translations installing-r2modman.md (Chinese Simplified) * New translations installing-r2modman.md (Portuguese, Brazilian) * New translations installing-r2modman.md (Thai) * New translations installing-r2modman.md (French) * New translations installing-mods.md (French) * New translations installing-mods.md (Spanish) * New translations installing-mods.md (German) * New translations installing-mods.md (Finnish) * New translations installing-mods.md (Italian) * New translations installing-mods.md (Japanese) * New translations installing-mods.md (Korean) * New translations installing-mods.md (Dutch) * New translations installing-mods.md (Chinese Simplified) * New translations installing-mods.md (Portuguese, Brazilian) * New translations installing-mods.md (Thai) * New translations faq.md (Thai) * New translations faq.md (Thai) * New translations faq.md (Thai) * New translations faq.md (Thai) * New translations chart-backgrounds.md (Thai) * New translations charting-guidelines.md (Thai) * New translations charting-guidelines.md (Thai) * New translations charting-guidelines.md (Thai) * New translations installing-r2modman.md (French) * New translations installing-r2modman.md (Spanish) * New translations installing-r2modman.md (German) * New translations installing-r2modman.md (Finnish) * New translations installing-r2modman.md (Italian) * New translations installing-r2modman.md (Japanese) * New translations installing-r2modman.md (Korean) * New translations installing-r2modman.md (Dutch) * New translations installing-r2modman.md (Ukrainian) * New translations installing-r2modman.md (Chinese Simplified) * New translations installing-r2modman.md (Portuguese, Brazilian) * New translations installing-r2modman.md (Thai) * New translations charting-guidelines.md (Thai) * New translations charting-guidelines.md (Thai) * New translations charting-guidelines.md (Thai) * New translations charting-guidelines.md (Thai) * New translations charting-guidelines.md (Thai) * New translations charting-guidelines.md (Thai) * New translations sidebar.md (French) * New translations chart-troubleshooting.md (French) * New translations sidebar.md (Spanish) * New translations chart-troubleshooting.md (Spanish) * New translations sidebar.md (German) * New translations chart-troubleshooting.md (German) * New translations sidebar.md (Finnish) * New translations chart-troubleshooting.md (Finnish) * New translations sidebar.md (Italian) * New translations chart-troubleshooting.md (Italian) * New translations sidebar.md (Japanese) * New translations chart-troubleshooting.md (Japanese) * New translations sidebar.md (Korean) * New translations chart-troubleshooting.md (Korean) * New translations sidebar.md (Dutch) * New translations chart-troubleshooting.md (Dutch) * New translations sidebar.md (Ukrainian) * New translations chart-troubleshooting.md (Ukrainian) * New translations sidebar.md (Chinese Simplified) * New translations chart-troubleshooting.md (Chinese Simplified) * New translations sidebar.md (Portuguese, Brazilian) * New translations chart-troubleshooting.md (Portuguese, Brazilian) * New translations sidebar.md (Thai) * New translations chart-troubleshooting.md (Thai) * New translations installing-songs.md (French) * New translations installing-songs.md (Spanish) * New translations installing-songs.md (German) * New translations installing-songs.md (Finnish) * New translations installing-songs.md (Italian) * New translations installing-songs.md (Japanese) * New translations installing-songs.md (Korean) * New translations installing-songs.md (Dutch) * New translations installing-songs.md (Ukrainian) * New translations installing-songs.md (Chinese Simplified) * New translations installing-songs.md (Portuguese, Brazilian) * New translations installing-songs.md (Thai) * New translations charting-guidelines.md (French) * New translations charting-guidelines.md (Spanish) * New translations charting-guidelines.md (German) * New translations charting-guidelines.md (Finnish) * New translations charting-guidelines.md (Italian) * New translations charting-guidelines.md (Japanese) * New translations charting-guidelines.md (Korean) * New translations charting-guidelines.md (Dutch) * New translations charting-guidelines.md (Ukrainian) * New translations charting-guidelines.md (Chinese Simplified) * New translations charting-guidelines.md (Portuguese, Brazilian) * New translations charting-guidelines.md (Thai) * New translations creating-charts.md (French) * New translations creating-charts.md (Spanish) * New translations creating-charts.md (German) * New translations creating-charts.md (Finnish) * New translations creating-charts.md (Italian) * New translations creating-charts.md (Japanese) * New translations creating-charts.md (Korean) * New translations creating-charts.md (Dutch) * New translations creating-charts.md (Ukrainian) * New translations creating-charts.md (Chinese Simplified) * New translations creating-charts.md (Portuguese, Brazilian) * New translations creating-charts.md (Thai) * New translations creating-charts.md (French) * New translations creating-charts.md (Spanish) * New translations creating-charts.md (German) * New translations creating-charts.md (Finnish) * New translations creating-charts.md (Italian) * New translations creating-charts.md (Japanese) * New translations creating-charts.md (Korean) * New translations creating-charts.md (Dutch) * New translations creating-charts.md (Ukrainian) * New translations creating-charts.md (Chinese Simplified) * New translations creating-charts.md (Portuguese, Brazilian) * New translations creating-charts.md (Thai) * New translations installing-mods.md (Korean) * fix sidebar --------- Co-authored-by: Emmett --- translations/de_DE/docs/sidebar.md | 7 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-mods.md | 84 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../de_DE/docs/user-guide/introduction.md | 2 +- translations/es_ES/docs/sidebar.md | 7 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-mods.md | 86 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../es_ES/docs/user-guide/introduction.md | 2 +- translations/fi_FI/docs/sidebar.md | 7 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-mods.md | 84 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../fi_FI/docs/user-guide/introduction.md | 2 +- translations/fr_FR/docs/sidebar.md | 5 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 26 ++-- .../installation/installing-mods.md | 84 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../fr_FR/docs/user-guide/introduction.md | 2 +- translations/it_IT/docs/sidebar.md | 7 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-mods.md | 86 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../it_IT/docs/user-guide/introduction.md | 2 +- translations/ja_JP/docs/sidebar.md | 5 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 26 ++-- .../installation/installing-mods.md | 86 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../ja_JP/docs/user-guide/introduction.md | 2 +- translations/ko_KR/docs/sidebar.md | 5 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-mods.md | 80 ++++++------ .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../ko_KR/docs/user-guide/introduction.md | 2 +- translations/nl_NL/docs/sidebar.md | 7 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-mods.md | 52 ++++---- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../nl_NL/docs/user-guide/introduction.md | 2 +- translations/pt_BR/docs/sidebar.md | 7 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-mods.md | 86 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../pt_BR/docs/user-guide/introduction.md | 2 +- translations/th_TH/docs/extras/faq.md | 26 ++-- translations/th_TH/docs/sidebar.md | 7 +- .../user-guide/charting/chart-backgrounds.md | 2 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 116 ++++++++++-------- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-mods.md | 86 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../th_TH/docs/user-guide/introduction.md | 2 +- translations/uk_UA/docs/sidebar.md | 7 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 38 +++--- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../uk_UA/docs/user-guide/introduction.md | 2 +- translations/zh_CN/docs/sidebar.md | 7 +- .../charting/chart-troubleshooting.md | 36 ++++++ .../charting/charting-guidelines.md | 60 +++++---- .../user-guide/charting/creating-charts.md | 26 ++-- .../installation/installing-mods.md | 86 ++++++------- .../installation/installing-r2modman.md | 8 +- .../installation/installing-songs.md | 6 +- .../docs/user-guide/installation/migration.md | 46 +++++++ .../zh_CN/docs/user-guide/introduction.md | 2 +- 109 files changed, 2211 insertions(+), 1167 deletions(-) create mode 100644 translations/de_DE/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/de_DE/docs/user-guide/installation/migration.md create mode 100644 translations/es_ES/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/es_ES/docs/user-guide/installation/migration.md create mode 100644 translations/fi_FI/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/fi_FI/docs/user-guide/installation/migration.md create mode 100644 translations/fr_FR/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/fr_FR/docs/user-guide/installation/migration.md create mode 100644 translations/it_IT/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/it_IT/docs/user-guide/installation/migration.md create mode 100644 translations/ja_JP/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/ja_JP/docs/user-guide/installation/migration.md create mode 100644 translations/ko_KR/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/ko_KR/docs/user-guide/installation/migration.md create mode 100644 translations/nl_NL/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/nl_NL/docs/user-guide/installation/migration.md create mode 100644 translations/pt_BR/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/pt_BR/docs/user-guide/installation/migration.md create mode 100644 translations/th_TH/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/th_TH/docs/user-guide/installation/migration.md create mode 100644 translations/uk_UA/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/uk_UA/docs/user-guide/installation/migration.md create mode 100644 translations/zh_CN/docs/user-guide/charting/chart-troubleshooting.md create mode 100644 translations/zh_CN/docs/user-guide/installation/migration.md diff --git a/translations/de_DE/docs/sidebar.md b/translations/de_DE/docs/sidebar.md index f268269427..a3b28b66fa 100644 --- a/translations/de_DE/docs/sidebar.md +++ b/translations/de_DE/docs/sidebar.md @@ -1,14 +1,15 @@ - **Benutzeranleitung** - [Vorstellung](./) - **Modding** -- [Mods installieren](installing-mods) -- [Songs installieren](installing-songs) - [Using r2modman](installing-r2modman) +- [Songs installieren](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Charts** - [Charts erstellen](creating-charts) - [Charting Guidelines](charting-guidelines) - [Chart Hintergründe](chart-backgrounds) - [Sonstige Informationen](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Extras** @@ -16,5 +17,5 @@ - **Links** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![Übersetzen](https://icongr.am/material/translate.svg?color=808080&size=16)Übersetzen](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)Übersetzen](https://crowdin.com/project/trombone-champ-modding-wiki) - [Über uns](about) diff --git a/translations/de_DE/docs/user-guide/charting/chart-troubleshooting.md b/translations/de_DE/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/de_DE/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/de_DE/docs/user-guide/charting/charting-guidelines.md b/translations/de_DE/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..3a53f1bd66 100644 --- a/translations/de_DE/docs/user-guide/charting/charting-guidelines.md +++ b/translations/de_DE/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/de_DE/docs/user-guide/charting/creating-charts.md b/translations/de_DE/docs/user-guide/charting/creating-charts.md index eb3cc5c25e..780fb970cc 100644 --- a/translations/de_DE/docs/user-guide/charting/creating-charts.md +++ b/translations/de_DE/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### Midi Editor/DAW Charts werden erschaffen, wenn man eine midi Datei erstellt und sie mit dem Programm [Midi2TromboneChamp](#converting-midi-to-map-file) konvertiert. -Midi Noten sollten in der Reichweite von 47 bis 73 sein, um mit dem Spiel übereinzustimmen.
**HINWEIS:** Verschiedene Editoren verwenden für diesen Bereich unterschiedliche Werte auf dem Klavier. +Midi notes should be in the range 47 to 73 to match the game.
**NOTE:** Different editors use different values on the piano for this range. Einige kostenlose, überprüfte Midi-Editoren beinhalten: -- [Reaper](https://www.reaper.fm/download.php)* (Reichweite: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (Reichweite: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Reichweite: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Reichweite: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (Reichweite: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ Einige kostenlose, überprüfte Midi-Editoren beinhalten: Midi zum Chart konvertieren -

- ?> Es sind neben Midi2TromboneChamps noch zwei andere Midi Konverter verfügbar!
Der Prozess für diese neuen Konverter ist so ähnlich, dass diese Anleitung trotzdem anwendbar sein sollte.
Wenn du ein aktuelleres Konvertierungsprogramm testen möchtest, probiere einen der neuen Konverter aus:

Midi2TromboneChamp (Unity Version) - ein auf Unity basierender Nachfolger von Midi2TromboneChamp.
Trombone Champ Chart Converter - eine webbasierte Alternative mit neuen Features. -

-

  1. - Gehe zu https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest und klicke Midi2TromboneChamp.exe, um es herunterzuladen. -

    -
    2. - -
  2. -

    - Starte es. In der Datei-Auswahl die sich öffnet, wähle deine Midi-Datei. Klick auf öffnen. + Go to Trombone Champ Chart Converter.

    3. @@ -103,19 +93,19 @@ Einige kostenlose, überprüfte Midi-Editoren beinhalten:

  3. - Drücke OK. In der Dateiauswahl, die sich automatisch öffnet, erstelle einen Ordner mit dem Namen den du im Feld Folder Name eingegeben hast und speichere die Datei als song.tmb in diesem Ordner. + Drücke OK. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

    4. diff --git a/translations/de_DE/docs/user-guide/installation/installing-mods.md b/translations/de_DE/docs/user-guide/installation/installing-mods.md index 31f7e1d323..b207428557 100644 --- a/translations/de_DE/docs/user-guide/installation/installing-mods.md +++ b/translations/de_DE/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# Mods installieren +# Installing Mods --- -?> Wenn du Video-Tutorials bevorzugst, hat VorgunTheBeta [ein Video, das erklärt, wie du Mods und eigene Songs installieren kannst](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> Der Anfang dieser Anleitung funktioniert auch für Linux und Steam Deck! Lies [das Ende](#linuxsteam-deck-specific-tips) des Guides für zusätzliche Details. +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## Installationsort finden -1. Öffne Steam und klicke mit der rechten Maustaste auf Trombone Champ. Gehe dann zu `Verwalten > Lokale Dateien durchsuchen`. +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![Vorschau des Rechtsklick-Menüs](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. Klicke oben auf die Adressleiste, um den Pfad deines Installationsordners auszuwählen. Drücke `STRG`+`C`, um diesen Pfad in die Zwischenablage zu kopieren. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Ordnerpfad kopieren Vorschau](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## BepInEx installieren +## Installing BepInEx -1. Lade [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) in deinen TromboneChamp-Ordner herunter. Du solltest `BepinEx_x64_VERSION.zip` erhalten, mit `VERSION` als Versionsnummer. -2. Extrahiere den Inhalt der BepInEx.zip Datei direkt in den [Installationsordner](##finding-install-location) deiner Trombone Champ Installation. +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![BepInEx extrahieren Vorschau](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -> Bitte stelle sicher, dass die `x64` Version von BepInEx heruntergeladen ist. Die `Unix` und `x86` Versionen führen dazu, dass das Spiel nicht richtig funktioniert. Dies gilt auch für Benutzer auf Linux/Steam Deck. +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **WICHTIG:** Extrahiere BepInEx *direkt* in den Ordner Ihres Spiels, wie im obrigen Bild gezeigt. Wenn Sie alles richtig gemacht haben, sollte der Ordner Ihres Spiels wie das unten stehende Bild aussehen. +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![Abgeschlossene BepInEx Installation](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Starte Trombone Champ, um die Installation abzuschließen. +3. Run Trombone Champ once to complete installation. ## Installation -Wenn BepInEx installiert ist, kannst du mit dem Herunterladen bestimmter Mods beginnen - eine vollständige Liste ist im `#mod-release` Kanal des [Pombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) vorhanden. +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -Da du wahrscheinlich eigene Songs installieren möchtest, wird dieser Abschnitt [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) als Beispiel verwenden. +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. Navigiere zum [Installationsordner des Spiels](###finding-install-location), dann zu dem `BepInEx` Ordner und schlussenldich in den `Plugins` Ordner. +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. Klicke oben auf die Adressleiste, um den Pfad deines Installationsordners auszuwählen. Drücke `STRG`+`C`, um diesen Pfad in die Zwischenablage zu kopieren. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Ordnerpfad kopieren Vorschau](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. Lade die .dll Datei des Mods in den kopierten Ordner herunter. +3. Download the mod's .dll file into the copied folder. -![Vorschau des Plugin-Ordners](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Starte Trombone Champ, um die notwendigen Dateien zu initialisieren. +4. Run Trombone Champ once to initialize necessary files for that mod. -## Linux/Steam Deck Tipps +## Linux/Steam Deck Tips
    -Mehr +Expand -Der Installationsprozess von BepInEx ist weitgehend identisch mit Windows. Es gibt jedoch einige zusätzliche Dinge, die man zuerst beachten sollte: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - Um der Anleitung zu folgen, müssen Steam Deck Benutzer in den Desktop Modus wechseln, in dem sie den An-Knopf gedrückt halten und den `Desktop Mode` aus dem Menü auswählen. + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - Steam Deck Benutzer müssen das Spiel auf dem internen Speicher installieren, da BepInEx nicht von der microSD-Karte aus lädt. + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - Wie bereits erwähnt, müssen Sie weiterhin die `x64` Windows-Version von BepInEx, installieren nicht die `unix` Version, da Trombone Champ immer noch eine Windows-Anwendung, die unter Proton läuft, ist. + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - Speicherdaten und Logs werden im Steam Ordner innerhalb Protons Kompatibilitätsordner gespeichert. + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - Auf dem Steam Deck lässt sich dies hier finden: `~/.local/share/Steam/Steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - Auf anderen Linux Varianten können Sie `locate -r /Holy Wow$<0>locate -r /Holy Wow$` im Terminal ausführen, wenn Sie sich nicht sicher sind, wo sich Ihr Steam Ordner befindet. + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -Sie müssen auch `WINEDLLOVERRIDES="winhttp=n,b" %command%` zu den Startoptionen deines Spiels hinzufügen. Klicken Sie dazu mit der rechten Maustaste auf das Spiel in Steam und klicken Sie auf `Eigenschaften`. Im Gegensatz zu Windows wird Proton BepInEx nicht laden, es sei denn, es wird hier ausdrücklich angewiesen. +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Steam Eigenschaften Vorschau](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -Einmal hinzugefügt, sollte BepInEx jetzt funktionieren! Installieren Sie Mods [wie oben beschrieben](##installation), damit eigene Songs funktionieren. +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### Video-Hintergründe {docsify-ignore} +### Video Backgrounds {docsify-ignore} -Einige benutzerdefinierte Lieder werden Videos für ihre Hintergründe enthalten, und die Standard-Proton-Installation kann diese nicht wiedergeben. Wenn diese funktionieren sollen, können Sie `GE-Proton` mit [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/) installieren. Dies ist eine Version von Proton, die einige zusätzliche Funktionen enthält, einschließlich der Möglichkeit, Videoformate wiederzugeben, die Valve nicht offiziell unterstützen kann. +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -Wir empfehlen [dieser Guide von GamingOnLinux zu folgen](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/), um Anleitungen zur Verwendung von ProtonUp-Qt zu erhalten und `GE-Proton` zu installieren. +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> Auch mit GE-Proton könnten Sie immer noch Probleme mit der Videowiedergabe haben, abhängig von Ihrem Setup.
    +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## Eigene Songs installieren {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> Siehe [**Eigene Songs installieren**](installing-songs) für Informationen zur Installation eigener Songs. \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/de_DE/docs/user-guide/installation/installing-r2modman.md b/translations/de_DE/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/de_DE/docs/user-guide/installation/installing-r2modman.md +++ b/translations/de_DE/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/de_DE/docs/user-guide/installation/installing-songs.md b/translations/de_DE/docs/user-guide/installation/installing-songs.md index 4fced5db06..5903cf1663 100644 --- a/translations/de_DE/docs/user-guide/installation/installing-songs.md +++ b/translations/de_DE/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # Songs installieren --- -?> Wenn du Video-Tutorials bevorzugst, hat VorgunTheBeta [ein Video, das erklärt, wie du Mods und eigene Songs installieren kannst](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **WICHTIG:** Bevor du fortfährst, stelle sicher, dass du der [Anleitung zum Mods installieren](installing-mods) gefolgt bist, um BepInEx und TrombLoader zu installieren! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Songs finden @@ -14,7 +14,7 @@ Wenn du eine kompaktere Liste möchtest, hat TheGlitched64 [eine Tabelle mit Inf 1. Lade den selbstgemachten Song herunter - es wird normalerweise eine Art Archivdatei sein, die normalerweise in `.zip` endet. -2. Extrahiere den Inhalt der Archivdatei direkt in den `BepInEx/CustomSongs` Ordner, der erstellt wurde, als du das Spiel mit installiertem TrombLoader gestartet hast. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![Vorschau der BepInEx Extraktion](../docs/files/customsongextract.png) diff --git a/translations/de_DE/docs/user-guide/installation/migration.md b/translations/de_DE/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/de_DE/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/de_DE/docs/user-guide/introduction.md b/translations/de_DE/docs/user-guide/introduction.md index a4b06fe469..53fcf823e1 100644 --- a/translations/de_DE/docs/user-guide/introduction.md +++ b/translations/de_DE/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Dieses Wiki dient als Quelle von Dokumentationen und Tutorials für verschiedene ?> **Hilfe auf Discord** Für sofortige Unterstützung mit diesen Anleitungen besuche uns bitte in **#modding-support** auf dem [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) und frage nach Hilfe. Bitte lese unsere [Häufig gestellten Fragen](faq) im Voraus, um zu sehen, ob Ihre Frage bereits beantwortet wurde. -> ### [![Steam Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Mods installieren**](installing-mods) +> ### [![Steam Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Apple Music Logo](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Eigene Songs installieren**](installing-songs) > diff --git a/translations/es_ES/docs/sidebar.md b/translations/es_ES/docs/sidebar.md index b1d57a5c67..b62ed6a81e 100644 --- a/translations/es_ES/docs/sidebar.md +++ b/translations/es_ES/docs/sidebar.md @@ -1,14 +1,15 @@ - **Guía de Usuario** - [Introducción](./) - **Modificando** -- [Instalando Mods](installing-mods) -- [Instalando Canciones](installing-songs) - [Using r2modman](installing-r2modman) +- [Instalando Canciones](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Mapear** - [Creando Mapas](creating-charts) - [Charting Guidelines](charting-guidelines) - [Fondo de Mapa](chart-backgrounds) - [Información de Mapear Miscelánea](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Extras** @@ -16,5 +17,5 @@ - **Enlaces** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![Traducir](https://icongr.am/material/translate.svg?color=808080&size=16)Traducir](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)Traducir](https://crowdin.com/project/trombone-champ-modding-wiki) - [Acerca](about) diff --git a/translations/es_ES/docs/user-guide/charting/chart-troubleshooting.md b/translations/es_ES/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/es_ES/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/es_ES/docs/user-guide/charting/charting-guidelines.md b/translations/es_ES/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..3a53f1bd66 100644 --- a/translations/es_ES/docs/user-guide/charting/charting-guidelines.md +++ b/translations/es_ES/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/es_ES/docs/user-guide/charting/creating-charts.md b/translations/es_ES/docs/user-guide/charting/creating-charts.md index 24534b59fc..3bf4c81892 100644 --- a/translations/es_ES/docs/user-guide/charting/creating-charts.md +++ b/translations/es_ES/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### Editor Midi/DAW Los mapas se hacen creando un archivo midi y ejecutándolo en un [convertidor MIDI](#converting-midi-to-map-file). -Notas Midi deben estar en el rango de 47 a 73 para coincidir con el juego.
    **NOTA:** Diferentes editores usan diferentes valores en el piano para este rango. +Midi notes should be in the range 47 to 73 to match the game.
    **NOTE:** Different editors use different values on the piano for this range. Algunos editores midi gratis, verificados que funcionan incluyen: -- [Reaper](https://www.reaper.fm/download.php)* (Rango: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (Rango: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Rango: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Rango: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (Rango: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ Algunos editores midi gratis, verificados que funcionan incluyen: Convirtiendo Midi a Archivo de Mapa -

    - ?> ¡Hay dos convertidores Midi disponibles además de Midi2TromboneChamp!
    El proceso para estos nuevos convertidores es lo bastante similar para que esta guía debería seguir siendo utilizable.
    Si quieres un programa de conversión más actualizado, siéntete libre de probar un nuevo convertidor:

    Midi2TromboneChamp (Versión Unity) una secuela basado - en unity- para Midi2TromboneChamp.
    Trombone Champ Chart Converter - una alternativa basada en la web con nuevas características. -

    -

    1. - Ve a https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest y haz clic en Midi2TromboneChamp.exe para descargarlo. -

      -
      2. - -
    2. -

      - Ejecútalo. En el selector de archivo que abre, selecciona tu archivo midi. Haz clic en Abrir. + Go to Trombone Champ Chart Converter.

      3. @@ -103,19 +93,19 @@ Algunos editores midi gratis, verificados que funcionan incluyen:

    3. - Pulsa OK. En el selector de archivo que abre, crea una carpeta con el mismo nombre al que has puesto en el campo Folder Name, y guarda el archivo como song.tmb en esa carpeta. + Pulsa OK. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

      4. diff --git a/translations/es_ES/docs/user-guide/installation/installing-mods.md b/translations/es_ES/docs/user-guide/installation/installing-mods.md index 90332c2e70..b207428557 100644 --- a/translations/es_ES/docs/user-guide/installation/installing-mods.md +++ b/translations/es_ES/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# Instalando Mods +# Installing Mods --- -?> Si prefieres tutoriales en vídeo, VorgunTheBeta tiene [un vídeo explicando como instalar mods y canciones personalizadas](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> ¡El inicio de esta guía también funciona para Linux y el Steam Deck! Asegúrate de [leer el final](#linuxsteam-deck-specific-tips) para detalles adicionales. +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## Encontrando Ubicación de Instalación -1. Abre Steam y haz clic derecho en Trombone Champ. Luego, ve a `Administrar > Explorar archivos locales`. +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![Vista previa del Menú de Clic Derecho](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. Haz clic en la barra de direcciones en la parte superior para seleccionar la ruta de tu carpeta de instalación. Pulsa `CTRL`+`C` para copiar esto a tu portapapeles. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Vista previa de ruta de carpeta](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## Instalando BepInEx +## Installing BepInEx -1. Descarga [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) en tu carpeta TromboneChamp. Querrás tener `BepinEx_x64_VERSION.zip`, con `VERSION` siendo el número de versión. -2. Extrae los contenidos del archivo BepInEx .zip directamente en la [carpeta de instalación](##finding-install-location) de tu instalación de Trombone Champ. +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![Vista previa de extracción de BepInEx](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -!> Por favor, asegúrate de que has descargado la versión `x64` de BepInEx. Las versiones `unix` y `x86` harán que tu juego no funcione correctamente. Esto también se aplica a los usuarios en Linux/Steam Deck. +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **IMPORTANTE:** Extraer BepInEx *directamente* en la carpeta de tu juego como se muestra en la imagen superior. Si lo has hecho correctamente, tu carpeta del juego debería verse como la imagen de abajo. +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![Instalación BepinEx Terminada](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Ejecuta Trombone Champ una vez para completar la instalación. +3. Run Trombone Champ once to complete installation. -## Instalación +## Installation -Con BepInEx instalado, puedes empezar a descargar mods específicos - una lista completa está disponible en el canal `#mod-releases` en el [Discord de Trombone Champ Modding](https://discord.gg/KVzKRsbetJ). +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -Como probablemente quieres instalar canciones personalizadas, esta sección usará [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) como ejemplo. +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. Vaya a la [carpeta de instalación del juego](###finding-install-location), la carpeta `BepInEx`, luego la carpeta `plugins`. +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. Haz clic en la barra de direcciones en la parte superior para seleccionar la ruta de la carpeta de instalación. Pulsa `CTRL`+`C` para copiar esto a tu portapapeles. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Vista previa de ruta de carpeta](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. Descarga el archivo .dll del mod a la carpeta copiada. +3. Download the mod's .dll file into the copied folder. -![Vista previa de Carpeta de Plugins](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Ejecute Trombone Champ una vez para inicializar archivos necesarios para ese mod. +4. Run Trombone Champ once to initialize necessary files for that mod. -## Consejos de Linux/Steam Deck +## Linux/Steam Deck Tips
      -Ampliar +Expand -El proceso de instalación de BepInEx es en gran medida el mismo que lo de Windows enumerado anteriormente, pero hay que tener en cuenta algunas cosas adicionales antes: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - Para seguir la guía, los usuarios de Steam Deck tendrán que cambiar al modo de escritorio manteniendo presionado el botón de encendido y seleccionando `Modo de escritorio` en el menú. + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - Los usuarios de Steam Deck tendrán que instalar el juego en el almacenamiento interno, ya que BepInEx no se cargará desde la tarjeta microSD. + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - Como se ha dicho anteriormente, usted todavía tendrá que instalar la versión `x64` de Windows de BepInEx y no la versión `unix`, ya que Trombone Champ sigue siendo una aplicación de Windows funcionando con Proton. + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - Los archivos log y de archivos se almacenan en su carpeta Steam dentro de las carpetas de compatibilidad de Proton. + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - En el Steam Deck se puede encontrar en: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - En otras versiones de Linux se puede ejecutar `locate -r /Holy Wow<0>locate -r /Holy Wow$` desde el terminal si usted no está seguro de dónde está su carpeta Steam. + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -También tendrá que añadir `WINEDLLOVERRIDES="winhttp=n,b" %command%` a las opciones de lanzamiento de su juego. Para ello, haga clic derecho en el juego en Steam y haga clic en `Propiedades`. A diferencia de Windows, Proton no cargará los archivos de BepInEx a menos que se indique específicamente aquí. +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Vista previa de propiedades de Steam](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -Una vez añadido, ¡BepInEx debería funcionar! Instale tus mods [como se ha indicado anteriormente](##installation) para conseguir que funcionen las canciones personalizadas. +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### Fondos de video {docsify-ignore} +### Video Backgrounds {docsify-ignore} -Algunas canciones personalizadas incluirán videos para sus fondos y la instalación por defecto de Proton no puede reproducirlos. Si desea que funcionen, puede instalar `GE-Proton` usando [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). Esta es una versión de Proton que incluye algunas características adicionales, incluyendo la capacidad de reproducir formatos de video que Valve no puede soportar oficialmente. +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -Recomendamos seguir [esta guía creada por GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) para instrucciones sobre cómo usar ProtonUp-Qt e instalar `GE-Proton`. +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> Incluso con GE-Proton, es posible que experimente algunos problemas con la reproducción de videos dependiendo de su configuración.
      +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## Instalando Canciones Personalizadas +## Installing Custom Songs {docsify-ignore} -> Echa un vistazo a [**Custom Songs guide**](installing-songs) para obtener información sobre la instalación de canciones personalizadas. \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/es_ES/docs/user-guide/installation/installing-r2modman.md b/translations/es_ES/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/es_ES/docs/user-guide/installation/installing-r2modman.md +++ b/translations/es_ES/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/es_ES/docs/user-guide/installation/installing-songs.md b/translations/es_ES/docs/user-guide/installation/installing-songs.md index 3b7523a87a..e87153760f 100644 --- a/translations/es_ES/docs/user-guide/installation/installing-songs.md +++ b/translations/es_ES/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # Instalando Canciones --- -?> Si prefieres tutoriales en vídeo, VorgunTheBeta tiene [un vídeo explicando como instalar mods y canciones personalizadas](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **IMPORTANTE:** ¡Asegúrate de haber seguido la [guía de instalación de mod](installing-mods) para instalar BepInEx y TrombLoader antes de continuar! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Buscando Canciones @@ -14,7 +14,7 @@ Si quieres una lista más compacta, TheGlitched64 ha creado [una hoja de cálcul 1. Descargua la canción personalizada - generalmente será algún tipo de archivo, que generalmente termina en `.zip`. -2. Extrae el contenido del archivo directamente en la carpeta `BepInEx/CustomSongs` que se creó cuando se ejecutó el juego por primera vez con TrombLoader instalado. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![Vista previa de extracción de BepInEx](../docs/files/customsongextract.png) diff --git a/translations/es_ES/docs/user-guide/installation/migration.md b/translations/es_ES/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/es_ES/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/es_ES/docs/user-guide/introduction.md b/translations/es_ES/docs/user-guide/introduction.md index 0da0ddf696..d5a2ea0a55 100644 --- a/translations/es_ES/docs/user-guide/introduction.md +++ b/translations/es_ES/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Esta wiki sirve como una fuente de documentación y tutoriales para varios mods ?> **Ayuda de Discord** Para soporte en directo con esta guía por favor visítanos en **#modding-support** en el [Discord de Mods de Trombone Champ](https://discord.gg/KVzKRsbetJ) y pregunta por asistencia. Por favor lea nuestra página de [Preguntas Frecuentes](faq) previamente para ver si tu pregunta ya ha sido respondida. -> ### [![Logo de Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Instalando Mods**](installing-mods) +> ### [![Logo de Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Logo de Apple Music](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Instalando Canciones Personalizadas**](installing-songs) > diff --git a/translations/fi_FI/docs/sidebar.md b/translations/fi_FI/docs/sidebar.md index dc9beacbeb..b47393c3b1 100644 --- a/translations/fi_FI/docs/sidebar.md +++ b/translations/fi_FI/docs/sidebar.md @@ -1,14 +1,15 @@ - **Käyttöopas** - [Johdanto](./) - **Modaus** -- [Modien Asentaminen](installing-mods) -- [Kappaleiden Asentaminen](installing-songs) - [Using r2modman](installing-r2modman) +- [Kappaleiden Asentaminen](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Kartoitus** - [Karttojen Luonti](creating-charts) - [Charting Guidelines](charting-guidelines) - [Kartan Taustat](chart-backgrounds) - [Sekalaiset Kartoitustiedot](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Extrat** @@ -16,5 +17,5 @@ - **Linkit** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![Käännä](https://icongr.am/material/translate.svg?color=808080&size=16)Käännä](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)Käännä](https://crowdin.com/project/trombone-champ-modding-wiki) - [Tietoja](about) diff --git a/translations/fi_FI/docs/user-guide/charting/chart-troubleshooting.md b/translations/fi_FI/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/fi_FI/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/fi_FI/docs/user-guide/charting/charting-guidelines.md b/translations/fi_FI/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..3a53f1bd66 100644 --- a/translations/fi_FI/docs/user-guide/charting/charting-guidelines.md +++ b/translations/fi_FI/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/fi_FI/docs/user-guide/charting/creating-charts.md b/translations/fi_FI/docs/user-guide/charting/creating-charts.md index bceeed2ccc..f4e8ca1b8b 100644 --- a/translations/fi_FI/docs/user-guide/charting/creating-charts.md +++ b/translations/fi_FI/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### Midi Editor/DAW Kartat tehdään luomalla midi tiedosto ja viemällä ne [MIDI muuntimen](#converting-midi-to-map-file) läpi. -Midi nuotit tulisi olla 47 - 73 asteikon välillä toimiakseen pelin kanssa.
      **HUOM:** Erilaiset editorit käyttävät pianolle erilaisia arvoja. +Midi notes should be in the range 47 to 73 to match the game.
      **NOTE:** Different editors use different values on the piano for this range. Jotkut ilmaiset, todennettu toimimaan midi editorit ovat: -- [Reaper](https://www.reaper.fm/download.php)* (Asteikko: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (Asteikko: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Asteikko: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Asteikko: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (Asteikko: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ Jotkut ilmaiset, todennettu toimimaan midi editorit ovat: Muunnetaan Midi Karttatiedostoksi -

      - ?> Midi2TromboneChampin lisäksi on saatavilla kaksi Midi -muunninta!
      Prosessi näille uusille muuntimille on tarpeeksi samanlainen, että tämä opas olisi edelleen käyttökelpoinen.
      Jos haluat kokeilla ajan tasalla olevaa muuntoohjelmaa, voit kokeilla vapaasti uutta muunninta:

      Midi2TromboneChamp (Unity Version) - unity-pohjainen jatko-osa Midi2TromboneChampille.
      Trombone Champ Chart Converter - web-pohjainen vaihtoehto, jossa on uusia ominaisuuksia. -

      -

      1. - Mene https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest ja lataa Midi2TromboneChamp.exe. -

        -
        2. - -
      2. -

        - Suorita se. Valitse tiedostonvalitsimessa sinun miditiedosto. Klikkaa Open. + Go to Trombone Champ Chart Converter.

        3. @@ -103,19 +93,19 @@ Jotkut ilmaiset, todennettu toimimaan midi editorit ovat:

        • - Song Name on kartan koko nimi ja sen tiedot näytetään, kun valitset sen pelissä . + Song Name is the full name of the song, shown in the info when you select it in-game.
        • Short Name näytetään kappalevalikossa. Teksti pienenee kun nimi on pitkä, joten en ole varma, onko siinä enimmäispituus.
        • - Folder Name on sen kansion nimi, johon laitat kartta- ja kappaletiedostosi. Esim. Jos asetat Folder Name nimeksi my map, karttasi polku on BepInEx/CustomSongs/my map/song.tmb. + Release Year is the year the song was created.
        • - Year on vuosi, jolloin kappale luotiin. + Artist is the composer of the song.
        • - Author on kappaleen säveltäjä. + Beats per Bar määrittää, kuinka kaukana "iskulinjat" ovat.
        • Difficulty on vaikeustaso eli tähtien määrä, jotka näkyvät kappaleen tiedoissa. @@ -124,17 +114,17 @@ Jotkut ilmaiset, todennettu toimimaan midi editorit ovat: Note Spacing vaikuttaa siihen, kuinka nopeasti taso rullaa yhdessä BPM kanssa.
        • - Song Endpoint on isku, jolla kappale päättyy. Se lasketaan automaattisesti, mutta voit säätää sitä muuttaaksesi, kun tason loppunäyttö näkyy. + Folder Name on sen kansion nimi, johon laitat kartta- ja kappaletiedostosi. Esim. Jos asetat Folder Name nimeksi my map, karttasi polku on BepInEx/CustomSongs/my map/song.tmb.
        • - Beats per Bar määrittää, kuinka kaukana "iskulinjat" ovat. + Song Endpoint on isku, jolla kappale päättyy. Se lasketaan automaattisesti, mutta voit säätää sitä muuttaaksesi, kun tason loppunäyttö näkyy.

      3. - Paina OK. Luo tiedosto valitsimessa kansio jonka nimi on sama kuin kirjoittamasi Folder Name -kenttään. ja tallenna tiedosto song.tmb tuon kansion sisään. + Paina OK. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

        4. diff --git a/translations/fi_FI/docs/user-guide/installation/installing-mods.md b/translations/fi_FI/docs/user-guide/installation/installing-mods.md index e32a0115c6..b207428557 100644 --- a/translations/fi_FI/docs/user-guide/installation/installing-mods.md +++ b/translations/fi_FI/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# Modien Asentaminen +# Installing Mods --- -?> Jos haluat videotutoriaaleja, VorgunTheBeta on [ tehnyt videon, jossa kerrotaan, miten modit ja custom kappaleet asennetaan](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> Tämän oppaan alku toimii myös Linux- ja Steam Deckin kanssa! Varmista, että [luet loppuun](#linuxsteam-deck-specific-tips) saadaksesi lisätietoja. +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## Asennussijainnin Löytäminen -1. Avaa Steam ja paina Trombone Champ peliä hiiren oikealla painikkeella. Sitten mene `Manage > Browse local files`. +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. ![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. Paina osoitepalkkia yläreunassa valitaksesi asennuskansion polun. Paina `CTRL`+`C` kopioidaksesi tämän leikepöydällesi. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Kopioi Kansion Polku Esikatselu](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## BipInEx Asennus +## Installing BepInEx -1. Lataa [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) TromboneChamp kansioon. Haluat saada `BepinEx_x64_VERSION.zip`, jossa `VERSION` on versionumero. -2. Pura BepInEx .zip-tiedoston sisältö suoraan Trombone Champ [asennuskansioon](##finding-install-location). +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![BepInExin Purkamisen Esikatselu](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -!> Varmista, että olet ladannut `x64` version BepInExistä. `unix` ja `x86` versiot aiheuttavat sen, että pelisi ei toimi kunnolla. Tämä koskee myös Linux/Steam Deckin käyttäjiä. +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **TÄRKEÄÄ:** Pura BepInEx *suoraan* pelin kansioon kuten yllä olevassa kuvassa näkyy. Jos olet tehnyt kaiken oikein, pelin kansion pitäisi näyttää kuin alla olevassa kuvassa. +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![BepinExin Asennus Valmis](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Käynnistä Trombone Champ viimeistelläksesi asennuksen. +3. Run Trombone Champ once to complete installation. -## Asennus +## Installation -Kun BepInEx on asennettu, voit aloittaa tiettyjen modien lataamisen - täydellinen lista on saatavilla `#mod-releases` kanavalla [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) palvelimella. +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -Haluat todennäköisesti asentaa custom kappaleita, tämä osio käyttää [TrombLoaderia](https://github.com/NyxTheShield/TrombLoader/releases/latest) esimerkkinä. +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. Mene [pelin asennuskansioon](###finding-install-location), `BepInEx` kansioon, ja sitten `plugins` kansioon. +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. Paina osoitepalkkia yläreunassa valitaksesi asennuskansion polun. Paina `CTRL`+`C` kopioidaksesi tämän leikepöydällesi. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Kopioi Kansion Polku Esikatselu](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. Lataa modin .dll tiedosto kopioituun kansioon. +3. Download the mod's .dll file into the copied folder. -![Lisäosien Kansion Esikatselu](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Käynnistä Trombone Champ tarvittavien tiedostoiden alustamiseksi kyseiseen moodin. +4. Run Trombone Champ once to initialize necessary files for that mod. -## Linux/Steam Deck Vinkit +## Linux/Steam Deck Tips
        -Laajenna +Expand -BepInExin asennus on suurelta osin sama kuin Windowsin edellä lueteltu, mutta on olemassa joitakin ylimääräisiä asioita joista olla tietoisia ensin: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - Jos haluat seurata opasta, Steam Deck käyttäjien on vaihdettava työpöytätilaan pitämällä virtapainike pohjassa ja valitsemalla `Työpöytätila` valikosta. + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - Steam Deck -käyttäjien tulee asentaa peli sisäiseen tallennustilaan, koska BepInEx ei toimi microSD-kortilla. + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - Kuten aiemmin todettiin, sinun täytyy silti asentaa `x64` BepInEx Windows-versio, ei `unix` -versio, sillä Trombone Champ on vielä Protonin alla toimiva Windows-sovellus. + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - Tallennus ja loki tiedostot ovat tallennettu Steam-kansion Proton yhteensopivuuskansioihin. + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - Steam Deckillä tämä löytyy: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - Muilla Linux-asennuksilla voit suorittaa `locate -r /Holy Wow$<0>` terminaalissa, jos et ole varma missä Steam-kansio on. + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -Sinun tulee myös lisätä `WINEDLLOVERRIDES="winhttp=n,b" %command%` pelin käynnistysvalintoihin. Voit tehdä tämän napsauttamalla hiiren oikealla painikkeella peliä Steamissä ja klikkaa `Properties`. Toisin kuin Windowsissa, Proton ei lataa BepInExin tiedostoja, ellei sitä ole erikseen ohjeistettu tässä. +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Steamin Ominaisuudet Esikatselu](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -Kun se on lisätty, BepInExin pitäisi nyt toimia! Asenna modit [yllä olevien ohjeiden mukaisesti](##installation) saadaksesi custom kappaleet toimimaan. +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### Videotaustat {docsify-ignore} +### Video Backgrounds {docsify-ignore} -Jotkin custom kappaleet sisältävät videoita taustalleen, eikä Protonin oletusasennus voi toistaa niitä. Jos haluat näiden toimivan, voit asentaa `GE-Proton` käyttäen [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). Tämä on Protonin versio, joka sisältää joitakin lisäominaisuuksia, mukaan lukien kyky toistaa videoformaatteja, joita Valve ei pysty tukemaan virallisesti. +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -Suosittelemme seuraamaan [tätä GamingOnLinuxin](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) luomaa opasta ProtonUp-Qt käytöstä ja `GE-Proton` asennuksesta. +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> Jopa GE-Protonin kanssa, saatat silti kokea ongelmia videon toiston kanssa asetuksistasi riippuen.
        +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## Custom Kappaleiden Asennus {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> Tutustu [**Custom Kappaleet oppaseen**](installing-songs) saadaksesi lisätietoja asennettaessa custom kappaleita. \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/fi_FI/docs/user-guide/installation/installing-r2modman.md b/translations/fi_FI/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/fi_FI/docs/user-guide/installation/installing-r2modman.md +++ b/translations/fi_FI/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/fi_FI/docs/user-guide/installation/installing-songs.md b/translations/fi_FI/docs/user-guide/installation/installing-songs.md index 94dd0cc5a1..f779857129 100644 --- a/translations/fi_FI/docs/user-guide/installation/installing-songs.md +++ b/translations/fi_FI/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # Kappaleiden Asentaminen --- -?> Jos haluat videotutoriaaleja, VorgunTheBeta on [tehnyt videon, jossa kerrotaan, miten modit ja custom kappaleet asennetaan](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **TÄRKEÄÄ:** Varmista, että olet seurannut [modien asennusopasta](installing-mods) asentaaksesi BepInExin ja TrombLoaderin ennen jatkamista! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Kappaleiden Löytäminen @@ -14,7 +14,7 @@ Jos haluat kompaktimman listan, TheGlitched64 on luonut [taulukon, joka sisält 1. Lataa custom kappale - se on yleensä jonkinlainen arkisto tiedosto, yleensä päättyy `.zip`. -2. Pura arkiston sisältö suoraan `BepInEx/CustomSongs` -kansioon, joka luotiin kun ensin käynnistit pelin TrombLoader asennettuna. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![BepInExin Purkamisen Esikatselu](../docs/files/customsongextract.png) diff --git a/translations/fi_FI/docs/user-guide/installation/migration.md b/translations/fi_FI/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/fi_FI/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/fi_FI/docs/user-guide/introduction.md b/translations/fi_FI/docs/user-guide/introduction.md index 3025448aff..ecfc500e54 100644 --- a/translations/fi_FI/docs/user-guide/introduction.md +++ b/translations/fi_FI/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Tämä wiki toimii dokumentaation ja tutoriaalien lähteenä erilaisille epävir ?> **Discord-ohje** Saadaksesi live-tukea tämän oppaan kanssa, ole hyvä ja tavoita meihin kanavalla **#modding-support** [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) palvelimella ja pyydä apua. Lue meidän [Usein kysyttyjä kysymyksiä](faq) -sivu etukäteen nähdäksesi, onko kysymykseesi jo vastattu. -> ### [![Steamin Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Modien asentaminen**](installing-mods) +> ### [![Steamin Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Apple Musiikin Logo](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Custom kappaleiden asentaminen**](installing-songs) > diff --git a/translations/fr_FR/docs/sidebar.md b/translations/fr_FR/docs/sidebar.md index 598ff81a6d..1ebe1c0fc1 100644 --- a/translations/fr_FR/docs/sidebar.md +++ b/translations/fr_FR/docs/sidebar.md @@ -1,14 +1,15 @@ - **Guide de l'utilisateur** - [Introduction](./) - **Modding** -- [Installer des mods](installing-mods) -- [Installer des chansons](installing-songs) - [Using r2modman](installing-r2modman) +- [Installer des chansons](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Charting** - [Créer des charts](creating-charts) - [Guide de charting](charting-guidelines) - [Arrière-plans de charts](chart-backgrounds) - [Infos diverses de charting](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Extras** diff --git a/translations/fr_FR/docs/user-guide/charting/chart-troubleshooting.md b/translations/fr_FR/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/fr_FR/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/fr_FR/docs/user-guide/charting/charting-guidelines.md b/translations/fr_FR/docs/user-guide/charting/charting-guidelines.md index d9a6c8c01a..40115d0596 100644 --- a/translations/fr_FR/docs/user-guide/charting/charting-guidelines.md +++ b/translations/fr_FR/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ Les directives suivantes ne sont pas des exigences absolues. Le but est de créer une chart amusante à jouer. Si ignorer ces règles rend une chart plus amusante ou engageante (par exemple, Rush E), vous pouvez le faire sans problème. Crédits : tsunderestorm, StaticR. ## Bonne pratiques +- Ne soyez pas faux. Si vous avez une mauvaise oreille, demandez à #charting ou #wip de vous assister. +- Ne soyez pas hors rythme. Vous pouvez ralentir la chanson dans votre éditeur pour permettre de distinguer des rythmes plus rapides. +- Ne commencez pas et ne finissez pas brusquement. + - Donnez au moins une mesure de repos avant la première note et continuez votre chart jusqu'à la fin de la chanson. + - Ajustez la longueur / le point final de la chanson si les rideaux se ferment un peu trop rapidement avant la fin de la piste de fond. Ne définissez pas le point de terminaison de la chanson dans le tmb pour qu'il soit plus long que la longueur du morceau. Sinon, le morceau ne se terminera pas. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintenir l'espacement de notes approprié à la difficulté. - Comme directive générale, la note et l'espace entre celle-ci et la note suivante devraient être de même longueur - **IDÉAL**: @@ -14,11 +24,6 @@ Les directives suivantes ne sont pas des exigences absolues. Le but est de crée - pour mettre l'accent sur [l'articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) comme des glisses, staccato ou legato - pour faciliter le maintien d'un combo dans des sections très rapides - si le tempo de la chanson est lent et un espacement serré est adéquat -- Ne soyez pas faux. Si vous avez une mauvaise oreille, demandez à #charting ou #wip de vous assister. -- Ne soyez pas hors rythme. Vous pouvez ralentir la chanson dans votre éditeur pour permettre de distinguer des rythmes plus rapides. -- Ne commencez pas et ne finissez pas brusquement. - - Donnez au moins une mesure de repos avant la première note et continuez votre chart jusqu'à la fin de la chanson. - - Ajustez la longueur / le point final de la chanson si les rideaux se ferment un peu trop rapidement avant la fin de la piste de fond. Ne définissez pas le point de terminaison de la chanson dans le tmb pour qu'il soit plus long que la longueur du morceau. Sinon, le morceau ne se terminera pas. - Le rythme devrait être visuellement intuitif. Si les notes sont un peu plus longues, elles devraient être un peu plus longues visuellement. Si les notes sont un peu plus courtes, elles devraient être légèrement plus courtes visuellement. - **IDÉAL**: (facile de voir lesquelles sont des triples croches (1/8) et lesquelles sont des triples croches pointées (3/16)) - ![Rythme visuel idéal](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ Les directives suivantes ne sont pas des exigences absolues. Le but est de crée - 120~200, selon la complexité de la chanson. Une bonne ligne directrice est `100/[BPM]*280`. - Cela devrait être assez rapide pour que le rythme soit visuellement intuitif et assez lent pour que le lecteur ait le temps de réagir. - Cette valeur ne doit pas nécessairement être la même que le tempo ! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Pistes en boucle -- Vous pouvez faire quelques répétitions, mais évitez de répéter le même motif de notes trop de fois. - - Vous pouvez chercher une version TV ou l'éditer vous-même si vous voulez une version plus courte de la chanson. - - Généralement, c'est plus naturel si vous arrangez les parties les plus faciles ou attendues dans la première partie et basculez vers des alternatives : - - Souvent, il y a une mélodie primaire et secondaire. - - Suivez les accords ou lignes de basse. - - Jouez-le dans une octave différente. - - Si vous savez ce que vous faites musicalement, utilisez différents accords ou harmonies. - - Vous voudrez peut-être inverser cela si la partie principale sert de point culminant dans la musique. Les points musicaux culminants vont le mieux vers le dernier tiers ou quart de l'ensemble de la chanson, alors structurer une boucle ainsi peut faire en sorte que le tout ait l'air plus complet. -- Les chansons très courtes sont mieux en boucle jusqu'à environ 1:00 à 1:30, à moins qu'elles soient très répétitives. -- Vous pouvez choisir d'ajouter une boucle complète ou partielle s'il y a différentes parties à jouer dans une section. -- Mettre fin à une chanson qui ne cesse de boucler peut être difficile. Suggestions : - - Terminer à la fin sans boucle en arrière. - - Terminer à la première note, au premier accord ou à la première section de la boucle. - - Faire un fondu dégradé à la fin de la phrase musicale. ### Glisses - Éviter les glisses à 90 degrés. @@ -60,14 +47,14 @@ Les directives suivantes ne sont pas des exigences absolues. Le but est de crée - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ Les directives suivantes ne sont pas des exigences absolues. Le but est de crée - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Pistes en boucle +- Vous pouvez faire quelques répétitions, mais évitez de répéter le même motif de notes trop de fois. + - Vous pouvez chercher une version TV ou l'éditer vous-même si vous voulez une version plus courte de la chanson. + - Généralement, c'est plus naturel si vous arrangez les parties les plus faciles ou attendues dans la première partie et basculez vers des alternatives : + - Souvent, il y a une mélodie primaire et secondaire. + - Suivez les accords ou lignes de basse. + - Jouez-le dans une octave différente. + - Si vous savez ce que vous faites musicalement, utilisez différents accords ou harmonies. + - Vous voudrez peut-être inverser cela si la partie principale sert de point culminant dans la musique. Les points musicaux culminants vont le mieux vers le dernier tiers ou quart de l'ensemble de la chanson, alors structurer une boucle ainsi peut faire en sorte que le tout ait l'air plus complet. +- Les chansons très courtes sont mieux en boucle jusqu'à environ 1:00 à 1:30, à moins qu'elles soient très répétitives. +- Vous pouvez choisir d'ajouter une boucle complète ou partielle s'il y a différentes parties à jouer dans une section. +- Mettre fin à une chanson qui ne cesse de boucler peut être difficile. Suggestions : + - Terminer à la fin sans boucle en arrière. + - Terminer à la première note, au premier accord ou à la première section de la boucle. + - Faire un fondu dégradé à la fin de la phrase musicale. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ Les directives suivantes ne sont pas des exigences absolues. Le but est de crée - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. Un fond PNG statique peut suffire. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/fr_FR/docs/user-guide/charting/creating-charts.md b/translations/fr_FR/docs/user-guide/charting/creating-charts.md index 8529d86d75..8e60eac3f9 100644 --- a/translations/fr_FR/docs/user-guide/charting/creating-charts.md +++ b/translations/fr_FR/docs/user-guide/charting/creating-charts.md @@ -80,20 +80,10 @@ Quelques éditeurs MIDI gratuits et fonctionnels incluent : Convertir de MIDI vers fichier map -

        - ?> Il y a deux convertisseurs MIDI disponibles en plus de Midi2TromboneChamp!
        Le processus pour ces nouveaux convertisseurs est assez similaire que ce guide devrait suffire.
        Si vous voulez essayer un convertisseur plus à jour, n'hésitez pas à donner une chance à un des convertisseurs nouveaux

        Midi2TromboneChamp (Version Unity) - un successeur à Midi2TromboneChamp basée sur Unity.
        Convertisseur de partition de Trombone Champ - une application web alternative avec de nouvelles fonctionnalités. -

        -

        1. - Allez à https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest et cliquez sur Midi2TromboneChamp.exe pour le télécharger. -

          -
          2. - -
        2. -

          - Lancez-le. Dans le sélecteur de fichier qu'il ouvre, sélectionnez votre fichier MIDI. Cliquez sur ouvrir. + Go to Trombone Champ Chart Converter.

          3. @@ -103,19 +93,19 @@ Quelques éditeurs MIDI gratuits et fonctionnels incluent :

          • - Nom de chanson est le nom complet de la chanson, affiché dans l'info lorsque vous la sélectionnez en jeu. + Song Name is the full name of the song, shown in the info when you select it in-game.
          • Nom court est affiché en naviguant la liste de chansons. Le texte devient de plus en plus petit lorsque le nom est long, alors je ne sais pas s'il y a une longueur maximale.
          • - Nom de dossier est le nom du dossier dans lequel vous mettrez votre map et votre fichier de chanson. Ex : Si vous définissez « Nom du dossier» comme « ma map», votre chemin de map sera BepInEx/CustomSongs/ma map/song.tmb. + Release Year is the year the song was created.
          • - Année est l'année de création de la chanson. + Artist is the composer of the song.
          • - Auteur est le compositeur de la chanson. + Rythmes par mesure détermine la distance entre les « barres de rythme ».
          • Difficulté est le nombre d'étoiles de difficulté qui apparait dans l'info de la chanson. @@ -124,17 +114,17 @@ Quelques éditeurs MIDI gratuits et fonctionnels incluent : Espacement des notes affecte la vitesse de défilement du niveau, en combinaison avec le BPM (tempo).
          • - Fin de la chanson est le temps où la chanson finit. Elle est calculée automatiquement, mais vous pouvez l'ajuster pour changer quand l'écran de fin de niveau apparait. + Nom de dossier est le nom du dossier dans lequel vous mettrez votre map et votre fichier de chanson. Ex : Si vous définissez « Nom du dossier» comme « ma map», votre chemin de map sera BepInEx/CustomSongs/ma map/song.tmb.
          • - Rythmes par mesure détermine la distance entre les « barres de rythme ». + Fin de la chanson est le temps où la chanson finit. Elle est calculée automatiquement, mais vous pouvez l'ajuster pour changer quand l'écran de fin de niveau apparait.

        3. - Appuyez sur OK. Dans le sélecteur de fichier qui s'ouvre, créez un dossier avec le même nom que vous avez écrit dans le champ Nom de dossier, et sauvegardez-le comme song.tmb à l'intérieur de ce dossier. + Appuyez sur OK. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

          4. diff --git a/translations/fr_FR/docs/user-guide/installation/installing-mods.md b/translations/fr_FR/docs/user-guide/installation/installing-mods.md index 5ca9c9e79f..b207428557 100644 --- a/translations/fr_FR/docs/user-guide/installation/installing-mods.md +++ b/translations/fr_FR/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# Installer des mods +# Installing Mods --- -?> Si vous préférez des tutoriels vidéo, VorgunTheBeta a [une vidéo expliquant comment installer des mods et des chansons personnalisées](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> Le début de ce guide fonctionne également pour Linux et Steam Deck ! Assurez-vous de [lire la fin](#linuxsteam-deck-specific-tips) pour plus de détails. +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## Trouver l'emplacement d'installation -1. Ouvrez Steam et faites un clic droit sur Trombone Champ. Ensuite, allez sur `Gérer > Parcourir les fichiers locaux`. +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![Clic droit sur Aperçu du Menu](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. Cliquez sur la barre d'adresse en haut pour sélectionner le chemin de votre dossier d'installation. Faites` CTRL`+`C` pour copier cela dans votre presse-papiers. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Copier l'aperçu du chemin du dossier](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## Installer BepInEx +## Installing BepInEx -1. Téléchargez [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) dans votre dossier TromboneChamp. Vous voudrez obtenir `BepinEx_x64_VERSION.zip`, avec `VERSION` étant le numéro de version. -2. Extrayez le contenu du fichier BepInEx.zip directement dans le [dossier d'installation](##finding-install-location) de votre installation de Champ Trombone. +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![Aperçu d'extraction de BepInEx](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -!> Veuillez vous assurer que vous avez téléchargé la version `x64` de BepInEx. les versions `unix` et `x86` provoqueront un mauvais fonctionnement de votre jeu. Cela s'applique également aux utilisateurs sur Linux/Steam Deck. +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **IMPORTANT :** Extrayez BepInEx *directement* dans le dossier de votre jeu comme indiqué dans l'image ci-dessus. Si vous avez fait cela correctement, le dossier de votre jeu devrait ressembler à l'image ci-dessous. +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![Installation terminée de BepinEx](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Lancez Trombone Champ une fois pour terminer l'installation. +3. Run Trombone Champ once to complete installation. ## Installation -Avec BepInEx installé, vous pouvez commencer à télécharger des mods spécifiques - une liste complète est disponible dans le canal `#mod-releases` dans le [Serveur de modding de Trombone Champ](https://discord.gg/KVzKRsbetJ). +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -Comme vous voulez probablement installer des chansons personnalisées, cette section utilisera [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) comme exemple. +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. Naviguez vers le dossier d'installation de votre [jeu](###finding-install-location), le dossier `BepInEx` , puis le dossier `plugins`. +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. Cliquez sur la barre d'adresse en haut pour sélectionner le chemin de votre dossier d'installation. Faites` CTRL`+`C` pour copier cela dans votre presse-papiers. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Copier l'aperçu du chemin du dossier](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. Téléchargez le fichier .dll du mod dans le dossier copié. +3. Download the mod's .dll file into the copied folder. -![Aperçu du dossier des plugins](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Lancez Trombone Champ une fois afin d'initialiser les fichiers nécessaires pour ce mod. +4. Run Trombone Champ once to initialize necessary files for that mod. -## Astuces pour Linux/Steam Deck +## Linux/Steam Deck Tips
          -Agrandir +Expand -Le processus d'installation de BepInEx est en grande partie le même que sur Windows listé ci-dessus, cependant il y a quelques choses supplémentaires dont il faut d'abord être informé: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - Pour suivre le guide, les utilisateurs du Steam Deck devront passer en mode Bureau en maintenant enfoncé le bouton d'alimentation et en sélectionnant `Mode Bureau` à partir du menu. + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - Les utilisateurs du Steam Deck devront installer le jeu dans le stockage interne, puisque BepInEx ne chargera pas à partir de la carte microSD. + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - Comme mentionné plus tôt, vous devrez quand même installer la version Windows `x64` de BepInEx, et non la version `unix`, puisque Trombone Champ est toujours une application Windows fonctionnant sous Proton. + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - Les fichiers log et de sauvegarde sont stockés dans votre dossier Steam, dans les dossiers de compatibilité de Proton. + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - Sur le Steam Deck, cela peut être trouvé à : `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - Sur d'autres versions de Linux, vous pouvez exécuter `locate -r /Holy Wow<0>locate -r /Holy Wow$` à partir du terminal si vous êtes incertain de l'emplacement de votre dossier Steam. + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -Vous devrez aussi ajouter `WINEDLLOVERRIDES="winhttp=n,b" %command%` à vos options de lancement du jeu. Pour faire cela, faites un clic droit sur le jeu sur Steam and cliquez sur `Properties`. Contrairement à Windows, Proton ne chargera pas les fichiers de BepInEx à moins que ce soit spécifiquement demandé ici. +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Aperçu des propriétés Steam](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -Une fois ajouté, BepInEx devrait fonctionner ! Installez vos mods [comme spécifié ci-dessus](##installation) pour faire fonctionner vos chansons personnalisées. +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### Arrières-plans vidéo {docsify-ignore} +### Video Backgrounds {docsify-ignore} -Certaines chansons personnalisées incluront des vidéos pour leur arrière-plan et l'installation par défaut de Proton ne peut pas jouer celles-ci. Si vous voulez les faire fonctionner, vous pouvez installer `GE-Proton` en utilisant [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). Ceci est une version de Proton qui inclue quelques fonctionnalités supplémentaires, y compris la possibilité de lire des formats vidéo que Valve ne prend pas officiellement en charge. +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -Nous recommandons de suivre [ce guide créé par GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) pour des instructions sur comment utiliser ProtonUp-Qt et installer `GE-Proton`. +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> Même avec GE-Proton, vous pourriez encore rencontrer quelques problèmes de lecture de vidéos dépendamment de votre configuration.
          +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## Installation des chansons personnalisées {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> Consultez le guide des chansons personnalisées [****](installing-songs) pour plus d'informations sur l'installation de chansons personnalisées. \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/fr_FR/docs/user-guide/installation/installing-r2modman.md b/translations/fr_FR/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/fr_FR/docs/user-guide/installation/installing-r2modman.md +++ b/translations/fr_FR/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/fr_FR/docs/user-guide/installation/installing-songs.md b/translations/fr_FR/docs/user-guide/installation/installing-songs.md index 0c8584173b..9b4b3500c7 100644 --- a/translations/fr_FR/docs/user-guide/installation/installing-songs.md +++ b/translations/fr_FR/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # Installer des chansons personnalisées --- -?> Si vous préférez des tutoriels vidéo, VorgunTheBeta a [une vidéo expliquant comment installer des mods et des chansons personnalisées](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **IMPORTANT :** Assurez-vous d'avoir suivi le [guide d'installation des mods](installing-mods) pour installer BepInEx et TrombLoader avant de continuer ! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Trouver des chansons @@ -14,7 +14,7 @@ Si vous souhaitez une liste plus compacte, TheGlitched64 a créé [un tableau co 1. Télécharger la chanson personnalisée - il s'agira généralement d'une sorte de fichier d'archive, se terminant généralement par `.zip`. -2. Extrayez le contenu du fichier d'archive directement dans le dossier `BepInEx/CustomSongs` qui a été créé lors de la première exécution du jeu avec TrombLoader installé. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![Aperçu d'extraction de BepInEx](../docs/files/customsongextract.png) diff --git a/translations/fr_FR/docs/user-guide/installation/migration.md b/translations/fr_FR/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/fr_FR/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/fr_FR/docs/user-guide/introduction.md b/translations/fr_FR/docs/user-guide/introduction.md index 8976f14f1c..5d6ded7a82 100644 --- a/translations/fr_FR/docs/user-guide/introduction.md +++ b/translations/fr_FR/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Ce wiki sert comme source de documentation et de tutoriels pour divers mods non ?> **Aide Discord** Pour de l'aide en direct avec ce guide, veuillez s'il-vous-plaît nous visiter dans **#modding-support** sur le Discord [Serveur de Modding Trombone Champ](https://discord.gg/KVzKRsbetJ) et demandez de l'aide. Veuillez s'il-vous-plaît lire notre [Foire aux questions](faq) au préalable pour voir si la réponse à votre question y est déjà. -> ### [![Logo Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installer des mods**](installing-mods) +> ### [![Logo Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Logo Apple Music](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installer des chansons personnalisées**](installing-songs) > diff --git a/translations/it_IT/docs/sidebar.md b/translations/it_IT/docs/sidebar.md index fafaaf8ef7..2d452ba232 100644 --- a/translations/it_IT/docs/sidebar.md +++ b/translations/it_IT/docs/sidebar.md @@ -1,14 +1,15 @@ - **Guida per l'utente** - [Introduzione](./) - **Modding** -- [Installare le Mod](installing-mods) -- [Installare i Brani](installing-songs) - [Using r2modman](installing-r2modman) +- [Installare i Brani](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Charting** - [Creare le Charts](creating-charts) - [Charting Guidelines](charting-guidelines) - [Sfondi delle Charts](chart-backgrounds) - [Informazioni Varie sul Charting](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Extra** @@ -16,5 +17,5 @@ - **Collegamenti Utili** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![Traduci](https://icongr.am/material/translate.svg?color=808080&size=16)Traduci](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)Traduci](https://crowdin.com/project/trombone-champ-modding-wiki) - [Su questa Guida](about) diff --git a/translations/it_IT/docs/user-guide/charting/chart-troubleshooting.md b/translations/it_IT/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/it_IT/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/it_IT/docs/user-guide/charting/charting-guidelines.md b/translations/it_IT/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..3a53f1bd66 100644 --- a/translations/it_IT/docs/user-guide/charting/charting-guidelines.md +++ b/translations/it_IT/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/it_IT/docs/user-guide/charting/creating-charts.md b/translations/it_IT/docs/user-guide/charting/creating-charts.md index 30691e0052..7be8ff2a6b 100644 --- a/translations/it_IT/docs/user-guide/charting/creating-charts.md +++ b/translations/it_IT/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### Editor Midi/DAW Le charts vengono realizzate creando un file midi e facendolo processare da un [convertitore MIDI](#converting-midi-to-map-file). -Le note midi dovrebbero essere nell'intervallo da 47 a 73 per abbinarsi al gioco.
          **NOTA BENE:** Editor diversi usano valori diversi per il piano in questo intervallo. +Midi notes should be in the range 47 to 73 to match the game.
          **NOTE:** Different editors use different values on the piano for this range. Alcuni editor midi gratuiti, il cui funzionamento è verificato, sono: -- [Reaper](https://www.reaper.fm/download.php)* (Intervallo: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (Intervallo: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Intervallo: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Intervallo: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (Intervallo: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ Alcuni editor midi gratuiti, il cui funzionamento è verificato, sono: Convertire file Midi in file Map -

          - ?> Sono disponibili due convertitori Midi oltre a Midi2TromboneChamp!
          Le procedure per questi nuovi convertitori sono abbastanza simili, per cui questa guida dovrebbe essere ancora utilizzabile.
          Se vuoi provare un programma più recente, sentiti libero di provare un nuovo convertitore:

          Midi2TromboneChamp (Unity Version) - il successore su base Unity di Midi2TromboneChamp.
          Trombone Champ Chart Converter - alternativa web-based con nuove funzionalità. -

          -

          1. - Vai su https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest e clicca Midi2TromboneChamp.exe per scaricarlo. -

            -
            2. - -
          2. -

            - Esegui il programma. Nella finestra che si apre, seleziona il tuo file midi. Clicca su "Open". + Go to Trombone Champ Chart Converter.

            3. @@ -103,19 +93,19 @@ Alcuni editor midi gratuiti, il cui funzionamento è verificato, sono:

            • - Song Name è il nome completo del brano, mostrato nelle info quando la selezioni all'interno del gioco. + Song Name is the full name of the song, shown in the info when you select it in-game.
            • Short Name è il nome mostrato quando si scorre la lista dei brani. Il testo diventa più piccolo quando il nome è lungo, quindi non è sicuro se esiste una lunghezza massima.
            • - Folder Name è il nome della cartella in cui metterai il file map e il file del brano. Per esempio: Se inserisci "la mia map" in Folder Name, il percorso per il tuo file map sarà BepInEx/CustomSongs/la mia map/song.tmb. + Release Year is the year the song was created.
            • - Year è l'anno in cui è stata scritto il brano. + Artist is the composer of the song.
            • - Author è il compositore del brano. + Beats per Bar determina quanto sono distanti le "linee delle battute".
            • Difficulty è il numero di stellette-difficoltà che compaiono nella sezione info del brano. @@ -124,17 +114,17 @@ Alcuni editor midi gratuiti, il cui funzionamento è verificato, sono: Note Spacing determina la velocità con cui scorre il livello, in combinazione con BPM.
            • - Song Endpoint è la battuta in cui termina la canzone. Viene calcolata automaticamente, ma puoi regolarla per cambiare quando appare la schermata finale del livello. + Folder Name è il nome della cartella in cui metterai il file map e il file del brano. Per esempio: Se inserisci "la mia map" in Folder Name, il percorso per il tuo file map sarà BepInEx/CustomSongs/la mia map/song.tmb.
            • - Beats per Bar determina quanto sono distanti le "linee delle battute". + Song Endpoint è la battuta in cui termina la canzone. Viene calcolata automaticamente, ma puoi regolarla per cambiare quando appare la schermata finale del livello.

          3. - Premi OK. Nella finestra che si apre, crea una cartella con lo stesso nome inserito nel campo Folder Name, e salva il file come song.tmb all'interno della stessa cartella. + Premi OK. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

            4. diff --git a/translations/it_IT/docs/user-guide/installation/installing-mods.md b/translations/it_IT/docs/user-guide/installation/installing-mods.md index a66aa42cfc..b207428557 100644 --- a/translations/it_IT/docs/user-guide/installation/installing-mods.md +++ b/translations/it_IT/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -#Installare le Mod +# Installing Mods --- -?> Se preferisci i video tutorial, VorgunTheBeta ha realizzato [un video che spiega come installare le mod e i brani personalizzati](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> L'inizio di questa guida funziona anche per Linux e Steam Deck! Assicurati di [leggere la fine](#linuxsteam-deck-specific-tips) per ulteriori dettagli. +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## Trovare la cartella di installazione -1. Apri Steam e clicca col destro su Trombone Champ. Quindi, vai su `Gestisci> Sfoglia i file locali`. +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![Anteprima del Menu cliccando col tasto destro del mouse](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. Fare clic sulla barra degli indirizzi in alto per selezionare il percorso della cartella d'installazione. Premi `CTRL`+`C` per copiarlo negli appunti. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Anteprima Copia percorso della cartella](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## Installare BepInEx +## Installing BepInEx -1. Scarica [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) nella cartella TromboneChamp. Vorrai ottenere `BepinEx_x64_VERSION.zip`, dove `VERSION` è il numero della versione. -2. Estrai il contenuto del file .zip BepInEx direttamente nella [cartella d'installazione](##finding-install-location) di Trombone Champ. +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![Anteprima Estrai BepInEx](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -> Assicurati di aver scaricato la versione `x64` di BepInEx. e versioni `unix` e `x86` impediscono al gioco di funzionare correttamente. Questo si applica anche per utenti di Linux/Steam Deck. +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **IMPORTANTE:** Estrarre BepInEx *direttamente* nella cartella del gioco come mostrato nell'immagine qui sopra. Se l'operazione è stata eseguita correttamente, la cartella del gioco dovrebbe apparire come nell'immagine qui sotto. +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![Installazione di BepInEx completata](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Avvia Trombone Champ una volta per completare l'Installazione. +3. Run Trombone Champ once to complete installation. -## Installazione +## Installation -Con BepInEx installato, è possibile iniziare a scaricare mod specifiche - un elenco completo è disponibile nel canale `#mod-releases` del [Discord "Trombone Champ Modding" ](https://discord.gg/KVzKRsbetJ). +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -Siccome probabilmente vorrai installare brani personalizzati, questa sezione userà [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) come un esempio. +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. Vai alla [cartella d'installazione del gioco](###finding-install-location), nella cartella `BepInEx` e poi nella cartella `plugins`. +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. Clicca la barra in alto per selezionare il percorso della tua cartella d'installazione. Premi `CTRL`+`C` per copiare il percorso negli appunti. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Anteprima Copia percorso della cartella](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. Scarica il file .dll della mod nella cartella copiata. +3. Download the mod's .dll file into the copied folder. -![Anteprima Cartella Plugins](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Avvia Trombone Champ una volta per inizializzare i file necessari per la mod. +4. Run Trombone Champ once to initialize necessary files for that mod. -## Consigli per Linux/Steam Deck +## Linux/Steam Deck Tips
            -Espandi +Expand -Il processo per installare BepInEx è in gran parte lo stesso di quello su Windows sopra elencato, tuttavia ci sono alcune cose su cui essere consapevoli: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - Per seguire la guida, gli utenti Steam Deck dovranno passare alla modalità Desktop schiacciando il pulsante di accensione e selezionando `Desktop Mode` dal menu. + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - Gli utenti Steam Deck dovranno installare il gioco nella memoria interna, dato che BepInEx non verrà caricato dalla scheda microSD. + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - Come detto in precedenza, dovrai installare la versione `x64` di BepInEx, non la versione `unix`, dato che Trombone Champ è un'applicazione di Windows che gira con Proton. + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - I files di salvataggio sono conservati nelle cartelle di Steam compatibili con Proton. + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - Su Steam Deck questo può essere trovato in: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - Su altri sistemi di Linux puoi eseguire `localizza -r /Holy Wow<0>localizza -r /Holy Wow$` dal terminale se non sei sicuro di dove si trovi la tua cartella Steam. + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -Dovrai anche aggiungere `WINEDLLOVERRIDES="winhttp=n,b" %command%` alle tue opzioni di avvio del gioco. Per fare questo, schiaccia il tasto destro sul gioco su Steam e schiaccia `Propietà`. Rispetto a Windows, Proton non caricherà i files di BepInEx a meno che non sia specificatamente indicato qui. +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Anteprima delle Proprietà di Steam](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -Una volta aggiunto, BepInEx dovrebbe funzionare! Installa le tue mod [come indicato sopra](##installation)affinché le canzoni funzionino. +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### Video in Background {docsify-ignore} +### Video Backgrounds {docsify-ignore} -Alcune canzoni possono includere video in background, e l'installazione di default di Proton non può riprodurli. Se vuoi che funzioni, puoi installare `GE-Proton` usando [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). Questa versione di Proton include funzionalità aggiuntive, inclusa la possibilità di riprodurre video in formati che Valve non supporta ufficialmente. +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -Ti raccomandiamo la seguente [guida creata da GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) per l'utilizzo di ProtonUp-Qt e per l'installazione di `GE-Proton`. +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> Anche con GE-Proton, potresti ancora avere problemi con i video in background che dipendono dal tuo setup.
            +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## Installare Brani Personalizzati {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> Controlla la [**Guida ai Brani Personalizzati**](installing-songs) per informazioni su come aggiungere brani personalizzati. \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/it_IT/docs/user-guide/installation/installing-r2modman.md b/translations/it_IT/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/it_IT/docs/user-guide/installation/installing-r2modman.md +++ b/translations/it_IT/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/it_IT/docs/user-guide/installation/installing-songs.md b/translations/it_IT/docs/user-guide/installation/installing-songs.md index 04f5d5a194..cf60c1733a 100644 --- a/translations/it_IT/docs/user-guide/installation/installing-songs.md +++ b/translations/it_IT/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ #Installare dei Brani --- -?> Se preferisci i video tutorial, VorgunTheBeta ha [fatto un video che spiega come installare le mod e brani personalizzati](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **IMPORTANTE:** Assicurati di aver seguito la [guida per l'installazione delle mod](installing-mods) per installare BepInEx e TrombLoader prima di continuare! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Trovare i Brani @@ -14,7 +14,7 @@ Se prefirisci una lista più compatta, TheGlitched64 ha creato [un foglio di cal 1. Scaricare il brano personalizzato - normalmente sarà un qualche tipo di file archivio, di solito con estensione `.zip`. -2. Estrai il contenuto dell'archivio direttamente nella cartella `BepInEx/CustomSongs` che viene creata la prima volta che avvii il gioco con TrombLoader installato. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![Ateprima Estrazione BepInEx](../docs/files/customsongextract.png) diff --git a/translations/it_IT/docs/user-guide/installation/migration.md b/translations/it_IT/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/it_IT/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/it_IT/docs/user-guide/introduction.md b/translations/it_IT/docs/user-guide/introduction.md index bb9ed3aaa6..7b0334b4bf 100644 --- a/translations/it_IT/docs/user-guide/introduction.md +++ b/translations/it_IT/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Questa wiki serve come fonte di documentazione e tutorial su svariate mod non uf ?> **Aiuto su Discord** Per un supporto in tempo reale di questa guida visitaci su **#modding-support** nel [Discord "Trombone Champ Modding"](https://discord.gg/KVzKRsbetJ) e chiedi assistenza. Si prega di leggere la pagina delle [Domande frequenti](faq) per verificare se la tua domanda ha già ricevuto una risposta. -> ### [![Logo Di Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installare le Mod**](installing-mods) +> ### [![Logo Di Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Logo Di Apple Music](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installare i Brani Personalizzati**](installing-songs) > diff --git a/translations/ja_JP/docs/sidebar.md b/translations/ja_JP/docs/sidebar.md index 06116e05b2..678f4ffeaf 100644 --- a/translations/ja_JP/docs/sidebar.md +++ b/translations/ja_JP/docs/sidebar.md @@ -1,14 +1,15 @@ - **ユーザーガイド** - [まず初めに](./) - **MOD** -- [MODの導入方法](installing-mods) -- [カスタム音源の導入方法](installing-songs) - [Using r2modman](installing-r2modman) +- [カスタム音源の導入方法](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **創作譜面** - [譜面の作成方法](creating-charts) - [ガイドラインの作成方法](charting-guidelines) - [譜面の背景設定](chart-backgrounds) - [その他の譜面作成に関する情報](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **おまけ** diff --git a/translations/ja_JP/docs/user-guide/charting/chart-troubleshooting.md b/translations/ja_JP/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/ja_JP/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/ja_JP/docs/user-guide/charting/charting-guidelines.md b/translations/ja_JP/docs/user-guide/charting/charting-guidelines.md index a6781e40d1..2859fea893 100644 --- a/translations/ja_JP/docs/user-guide/charting/charting-guidelines.md +++ b/translations/ja_JP/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/ja_JP/docs/user-guide/charting/creating-charts.md b/translations/ja_JP/docs/user-guide/charting/creating-charts.md index 426619f106..9b44984c6c 100644 --- a/translations/ja_JP/docs/user-guide/charting/creating-charts.md +++ b/translations/ja_JP/docs/user-guide/charting/creating-charts.md @@ -80,20 +80,10 @@ MIDIの音符(ノーツ)の高さはゲームに合わせて47～73の範囲で MIDIから譜面データへの変換 -

            - ?> Midi2TromboneChamp以外に2つのMIDIコンバーターが用意されています！
            これらのMIDIコンバーターの使用方法は似たような感じなのでこのガイドをそのまま参考にすることができます。
            もし最新の変換プログラムを試したい場合は、新しいコンバーターを気軽に試してみてください:

            Midi2TromboneChamp (Unity Version) - Unityをベースに作成されたブラウザ版Midi2TromboneChamp
            Trombone Champ Chart Converter - 新機能を搭載したウェブベースのコンバーター -

            -

            1. - https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest に移動し、 Midi2TromboneChamp.exe をクリックしてダウンロードしてください。 -

              -
              2. - -
            2. -

              - それを起動してください。 ファイル選択画面が開くのでMIDIファイル(.mid)を選択します。 「開く」をクリックする。 + Go to Trombone Champ Chart Converter.

              3. @@ -103,19 +93,19 @@ MIDIの音符(ノーツ)の高さはゲームに合わせて47～73の範囲で

              • - Song Name 楽曲のフルネームで、ゲーム内の選曲画面で選択すると楽曲情報に表示される。 + Song Name is the full name of the song, shown in the info when you select it in-game.
              • Short Name 楽曲リストをスクロールするときに表示される名前で、 文字数が長いと表示テキストが縮小されます。文字数制限があるかは不明
              • - Folder Name 作成した譜面と音源のデータを格納するフォルダの名前です。 例: Folder Nameを「my map」に設定すると譜面データのファイルパスはBepInEx/CustomSongs/my map/song.tmbになります。 + Release Year is the year the song was created.
              • - Year 使用した楽曲が作成された年 + Artist is the composer of the song.
              • - Author 使用した楽曲の作曲者名 + Beats per Bar 拍子の線の間隔を決める。
              • Difficulty 楽曲情報に表示される譜面の難易度を表す星マークの数です。 @@ -124,17 +114,17 @@ MIDIの音符(ノーツ)の高さはゲームに合わせて47～73の範囲で Note Spacing BPMと組み合わせて、演奏時のノーツの移動速度に影響します。
              • - Song Endpoint 楽曲の終わりを示す拍子。 通常これは自動的に計算されますが、演奏終了画面が表示されたときに変更することが可能です。 + Folder Name 作成した譜面と音源のデータを格納するフォルダの名前です。 例: Folder Nameを「my map」に設定すると譜面データのファイルパスはBepInEx/CustomSongs/my map/song.tmbになります。
              • - Beats per Bar 拍子の線の間隔を決める。 + Song Endpoint 楽曲の終わりを示す拍子。 通常これは自動的に計算されますが、演奏終了画面が表示されたときに変更することが可能です。

            3. - OKを押す。 ファイル選択画面でFolder Nameで入力した同じ名前のフォルダを作成し、その中にsong.tmbという名前で保存 + OKを押す。 Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

              4. diff --git a/translations/ja_JP/docs/user-guide/installation/installing-mods.md b/translations/ja_JP/docs/user-guide/installation/installing-mods.md index 095f38d78f..b207428557 100644 --- a/translations/ja_JP/docs/user-guide/installation/installing-mods.md +++ b/translations/ja_JP/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# MODの導入方法 +# Installing Mods --- -?> もし動画による解説をご希望でしたら、VorgunTheBeta氏が投稿した[MODとカスタム音源の導入方法を説明している動画](https://youtu.be/pSwNSGx-P5c)をご覧ください。(※英語) +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> このガイドの冒頭部分はLinuxとSteam Deckにも対応しています！ 詳しい内容については [このガイドの末尾](#linuxsteam-deck-specific-tips)をご確認ください。 +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## MODを導入するフォルダーを確認する -1. Steamのライブラリを開き、Trombone Champを右クリックする。 次に、`管理 > ローカルファイルを閲覧`を選択する。 +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![右クリックしたメニューのプレビュー](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. 上部にあるアドレスバー左側のフォルダマークをクリックして、フォルダパスを選択した状態にする。 `CTRLキー`+`Cキー`を押してクリップボードにコピーする。 +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![コピーしたフォルダパスのプレビュ](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## BepInEx(前提MOD)を導入する +## Installing BepInEx -1. まず初めにTromboneChampのフォルダに[BepInEx](https://github.com/BepInEx/BepInEx/releases/latest)をダウンロードする。 BepinEx_x64_VERSION.zip (※VERSIONはBepinExのバージョン番号) が置かれているはずです。 -2. ダウンロードしたzipファイルの内容をTromboneChamp.exeと同じフォルダに直接解凍してください。 +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![BepInExの解凍 プレビュー](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -BepInExの `x64` (64bit版)をダウンロードしたことをご確認ください。 `unix版` および `x86` (32bit版)の場合、ゲームが正常に動作しない可能性があります。 これはLinuxとSteam Deckのユーザーにも当てはまります。 +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **重要:** 上記の画像のように、BepInExをTromboneChampのゲームフォルダに*"直接"*解凍してください。 正しく解凍できた場合、下記の画像のようになっているはずです。 +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![BepinExのインストール完了](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Trombone Champを一度起動するとBepInExのインストールが完了します。 +3. Run Trombone Champ once to complete installation. -## MODを導入する +## Installation -BepInExがインストールされたら、特定のMODを入れることができるようになります。[Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ)の`#mod-releases`チャンネルから配布されているMODのリストが確認できます。 +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -カスタム音源を導入することを想定して、まずここでは[TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest)を例に出して説明します。 +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. [TromboneChampのゲームフォルダ](###finding-install-location) / `BepInEx`フォルダ / `plugins`フォルダの順に移動してください。 +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. 上部にあるアドレスバー左側のフォルダマークをクリックして、フォルダパスを選択した状態にする。 `CTRLキー`+`Cキー`を押してクリップボードにコピーする。 +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![コピーしたフォルダパスのプレビュー](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. 拡張子が".dll"になっているMODファイルをpluginsフォルダにダウンロードしてください。 +3. Download the mod's .dll file into the copied folder. -![プラグインフォルダのプレビュー](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Trombone Champを一度起動するとMODのインストールが完了し、そのMODに必要なファイルが初期化されます。 +4. Run Trombone Champ once to initialize necessary files for that mod. -## Linux/Steam Deckの場合 +## Linux/Steam Deck Tips
              -詳細を表示 +Expand -BepInExの導入方法は上記のWindowsでのやり方とほぼ同じですが最初に注意すべき点がいくつかあります: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - まずSteam Deckのユーザーはこのガイドに従うにあたって、Steam Deckの電源ボタンを長押し、電源メニューも表示させ、「デスクトップに切り替え」の項目を選択して `デスクトップモード` を立ち上げる必要があります。 + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - Steam DeckのユーザーはmicroSDカードからBepInExが読み込まれないため、ゲームを内部ストレージにインストールする必要があります。 + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - 前述の通り、Trombone ChampはProton環境下において動作するWindowsアプリケーションであるため、`unix版`ではなく`x64`のWindows版BepInExをインストールする必要があります。 + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - セーブファイルやログファイルはProtonの互換フォルダ内のSteamフォルダに保存されます。 + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - Steam Deckでは以下のようになります: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - 他のLinuxフレーバーではSteamフォルダの場所がわからない場合、ターミナルから `locate -r /Holy Wow` を実行してください。 + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -また、ゲームの起動オプションに `WINEDLLOVERRIDES="winhttp=n,b" %command%` を追加する必要があります。 起動オプションに書き込みを行うには、SteamのライブラリにてTrombone Champを右クリックし、`プロパティ`をクリックして表示させます。 Windowsとは異なり、Steam Protonは起動オプションにて特に指示がない限り、BepInExのファイルを読み込むことはありません。 +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Steam プロパティのプレビュー](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -書き込むとBepInExが動作するようになります。 カスタム音源を動作させるには、[「MODを導入する」の説明に従って](##installation)Modをインストールしてください。 +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### もし譜面の背景が動画だった場合 {docsify-ignore} +### Video Backgrounds {docsify-ignore} -カスタム音源の中には背景に動画を含むものがあり、Protonへの通常インストールでは正常に再生することができません。 もし動画を再生させたい場合は[ProtonUp-Qt](https://davidotek.github.io/protonup-qt/)を使用し、`GE-Proton`をインストールすることで可能になります。 これはいくつかの追加機能を含むProtonのバージョンです。 Valveが公式にサポートしていないビデオフォーマットを再生する機能が含まれています。 +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -ProtonUp-Qtの使用方法と`GE-Proton`のインストール方法については、[GamingOnLinuxが作成したこちらのガイド](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/)を参照することをお勧めします。 +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> 仮にGE-Protonを使用しても設定の仕方によっては動画の再生に問題が発生する場合があります。
              +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## カスタム音源を導入する {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> カスタム音源の導入に関しては[**カスタム音源のガイド**](installing-songs)をご参照ください。 \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/ja_JP/docs/user-guide/installation/installing-r2modman.md b/translations/ja_JP/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/ja_JP/docs/user-guide/installation/installing-r2modman.md +++ b/translations/ja_JP/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/ja_JP/docs/user-guide/installation/installing-songs.md b/translations/ja_JP/docs/user-guide/installation/installing-songs.md index ac09a96e0f..2e0dee9030 100644 --- a/translations/ja_JP/docs/user-guide/installation/installing-songs.md +++ b/translations/ja_JP/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # カスタム音源の導入方法 --- -?> もし動画による解説をご希望でしたら、VorgunTheBeta氏が投稿した[MODとカスタム音源の導入方法を説明している動画](https://youtu.be/pSwNSGx-P5c)をご覧ください。(※英語) +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **重要:** BepInExとTrombLoaderをインストールしていなければ[MODの導入方法](installing-mods)のページをご参照ください！ +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## カスタム音源を見つけよう @@ -14,7 +14,7 @@ 1. カスタム音源をダウンロードする。(大体は `.zip` の拡張子が付いているアーカイブファイル) -2. TrombLoaderをインストールした際に生成された`BepInEx内のCustomSongs`フォルダにアーカイブファイル(zip等)を直接解凍する。 +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![BepInExの解凍 プレビュー](../docs/files/customsongextract.png) diff --git a/translations/ja_JP/docs/user-guide/installation/migration.md b/translations/ja_JP/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/ja_JP/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/ja_JP/docs/user-guide/introduction.md b/translations/ja_JP/docs/user-guide/introduction.md index 2c21a6715c..4fba932a5c 100644 --- a/translations/ja_JP/docs/user-guide/introduction.md +++ b/translations/ja_JP/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Trombone Champとは、Holy Wow Studiosが開発、販売している音ゲー ?> **Discordヘルプ** このガイドに関するお問い合わせは[Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ)内の**#modding-support**チャンネルへお越しくださいませ。(※英語) まず事前に[よくある質問 (FAQ)](faq)をお読みいただき、すでに回答がないかご確認ください。 -> ### [![Steam ロゴ](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**MODの導入方法**](installing-mods) +> ### [![Steam ロゴ](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Apple Music ロゴ](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**カスタム音源の導入方法**](installing-songs) > diff --git a/translations/ko_KR/docs/sidebar.md b/translations/ko_KR/docs/sidebar.md index 16bb629530..ab31168852 100644 --- a/translations/ko_KR/docs/sidebar.md +++ b/translations/ko_KR/docs/sidebar.md @@ -1,14 +1,15 @@ - **User Guide** - [Introduction](./) - **Modding** -- [Installing Mods](installing-mods) -- [Installing Songs](installing-songs) - [Using r2modman](installing-r2modman) +- [Installing Songs](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Charting** - [Creating Charts](creating-charts) - [Charting Guidelines](charting-guidelines) - [Chart Backgrounds](chart-backgrounds) - [Misc Charting Info](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Extras** diff --git a/translations/ko_KR/docs/user-guide/charting/chart-troubleshooting.md b/translations/ko_KR/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/ko_KR/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/ko_KR/docs/user-guide/charting/charting-guidelines.md b/translations/ko_KR/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..3a53f1bd66 100644 --- a/translations/ko_KR/docs/user-guide/charting/charting-guidelines.md +++ b/translations/ko_KR/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/ko_KR/docs/user-guide/charting/creating-charts.md b/translations/ko_KR/docs/user-guide/charting/creating-charts.md index b5761a0a06..500bdaeebd 100644 --- a/translations/ko_KR/docs/user-guide/charting/creating-charts.md +++ b/translations/ko_KR/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### Midi 에디터/DAW 채보는 Midi 파일을 만들고 [MIDI 컨버터](#converting-midi-to-map-file)를 사용하여 만들 수 있습니다. -Midi의 음표(노트)는 게임에 맞추어 47에서 73의 범위여야 합니다.
              **참고:** Midi 에디터에 따라 이 범위는 달라질 수 있습니다. +Midi notes should be in the range 47 to 73 to match the game.
              **NOTE:** Different editors use different values on the piano for this range. 일부 무료로 사용 가능한 Midi 에디터는 다음과 같습니다: -- [Reaper](https://www.reaper.fm/download.php)* (범위: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (범위: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (범위: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (범위: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (범위: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ Midi의 음표(노트)는 게임에 맞추어 47에서 73의 범위여야 합니 Midi에서 채보 파일로 변환 -

              - ?> Midi2TromboneChamp 외에도 Midi 컨버터가 두 개 있습니다!
              이러한 Midi 컨버터의 사용 방법은 비슷한 느낌이므로 이 가이드를 그대로 참고할 수 있습니다.
              만약 최신 변환 프로그램을 사용하고 싶다면, 새로운 컨버터도 자유롭게 사용해보세요:

              Midi2TromboneChamp (Unity Version) - Unity 기반 브라우저 버전 Midi2TromboneChamp
              Trombone Champ Chart Converter - 새로운 기능이 추가된 브라우저 기반 컨버터 -

              -

              1. - https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest로 이동하여 Midi2TromboneChamp.exe를 클릭하고 다운로드하세요. -

                -
                2. - -
              2. -

                - 실행하고 파일 선택 화면이 열리면 Midi 파일을 선택합니다. "열기"를 클릭합니다. + Go to Trombone Champ Chart Converter.

                3. @@ -103,19 +93,19 @@ Midi의 음표(노트)는 게임에 맞추어 47에서 73의 범위여야 합니

                • - Song Name: 악곡의 풀네임으로 게임 내 선곡 화면에서 선택했을 때 악곡 정보에 표시됩니다. + Song Name is the full name of the song, shown in the info when you select it in-game.
                • Short Name: 악곡 목록을 스크롤할 때 표시되는 이름입니다. 글자 수가 길면 텍스트 크기가 작아집니다. 글자 수 제한이 있는지는 명확하지 않습니다.
                • - Folder Name: 작성한 채보와 악곡을 저장하는 폴더의 이름입니다. 예시: Folder Name을 "my map"으로 설정하면 채보 데이터의 파일 경로는 BepInEx/CustomSongs/my map/song.tmb가 됩니다. + Release Year is the year the song was created.
                • - Year: 곡이 제작된 년도를 입력합니다. + Artist is the composer of the song.
                • - Author: 곡의 작곡가를 입력합니다. + Beats per Bar: 박자 선의 간격을 정합니다.
                • Difficulty: 악곡 정보에 표시되는 채보의 난이도를 나타내는 별의 개수입니다. @@ -124,17 +114,17 @@ Midi의 음표(노트)는 게임에 맞추어 47에서 73의 범위여야 합니 Note Spacing: BPM과 조합하여 연주 시 노트의 이동 속도에 영향을 줍니다.
                • - Song Endpoint: 악곡의 끝을 나타내는 박자입니다. 보통 이것은 자동으로 계산되지만 연주 종료 화면이 표시되었을 때 변경할 수 있습니다. + Folder Name: 작성한 채보와 악곡을 저장하는 폴더의 이름입니다. 예시: Folder Name을 "my map"으로 설정하면 채보 데이터의 파일 경로는 BepInEx/CustomSongs/my map/song.tmb가 됩니다.
                • - Beats per Bar: 박자 선의 간격을 정합니다. + Song Endpoint: 악곡의 끝을 나타내는 박자입니다. 보통 이것은 자동으로 계산되지만 연주 종료 화면이 표시되었을 때 변경할 수 있습니다.

              3. - OK를 누릅니다. 파일 선택 화면에서 Folder Name에 입력한 동일한 이름의 폴더를 생성하고 그 안에 song.tmb라는 이름으로 저장합니다. + OK를 누릅니다. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

                4. diff --git a/translations/ko_KR/docs/user-guide/installation/installing-mods.md b/translations/ko_KR/docs/user-guide/installation/installing-mods.md index 29b1e36c72..9bba0f90ae 100644 --- a/translations/ko_KR/docs/user-guide/installation/installing-mods.md +++ b/translations/ko_KR/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# 모드 설치 +모드 설치 --- ?> 동영상 튜토리얼을 선호하는 경우 VorgunTheBeta의 [모드 및 커스텀 곡 설치 방법](https://youtu.be/pSwNSGx-P5c)에 대한 동영상을 참고하세요. ?> 이 가이드의 첫 부분은 Linux와 Steam Deck에서도 작동합니다! 자세한 내용은 [끝 부분](#linuxsteam-deck-specific-tips)을 반드시 읽어보세요. -## 설치 위치 찾기 +## 설치 위치 1. Steam 라이브러리에서 Trombone Champ를 우클릭합니다. 그 다음 `관리 > 로컬 파일 보기`를 클릭합니다. -![우클릭 메뉴 미리 보기](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. 상단의 주소 표시줄을 클릭하여 설치 폴더의 경로를 선택합니다. `CTRL`+`C`를 눌러 클립보드에 복사합니다. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![폴더 경로 복사 미리 보기](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## BepInEx 설치 +## Installing BepInEx -1. [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest)를 TrombonChamp 폴더에 다운로드합니다. `BepinEx_x64_VERSION.zip`라는 파일이 있습니다. -2. 다운로드한 .zip 파일을 Trombone Champ의 설치 폴더에 압축을 해제합니다. +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![BepInEx 압축 해제 미리 보기](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -!> BepInEx의 `x64` 버전을 다운로드했는지 확인하세요. `unix`와 `x86` 버전은 게임이 제대로 작동하지 않게 됩니다. 이는 Linux/Steam Deck 사용자에게도 적용됩니다. +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **중요:** 위의 이미지와 같이 BepInEx를 게임 폴더에 *직접* 압축을 풉니다. 제대로 했다면 게임 폴더는 아래 이미지와 같아야 합니다. +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![BepinEx 설치 완료](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Trombone Champ를 한 번 실행하여 설치를 완료합니다. +3. Run Trombone Champ once to complete installation. -## 모드 설치 +## Installation -BepInEx가 설치되면 각종 모드를 설치할 수 있게 됩니다. [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ)의 `#mod-releases` 채널에서 배포되고 있는 모드 목록을 확인할 수 있습니다. +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -커스텀 곡을 추가하려는 경우 이 섹션에서는 [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest)를 예시로 설명합니다. +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. [게임 설치 폴더](###finding-install-location), `BepInEx` 폴더, `plugins` 폴더 순서로 이동합니다. +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. 상단의 주소 표시줄을 클릭하여 설치 폴더의 경로를 선택합니다. `CTRL`+`C`를 눌러 클립보드에 복사합니다. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![폴더 경로 복사 미리 보기](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. 모드의 .dll 파일을 복사한 폴더 위치에 다운로드합니다. +3. Download the mod's .dll file into the copied folder. -![플러그인 폴더 미리 보기](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Trombone Champ를 한 번 실행하여 해당 모드에 필요한 파일을 초기화합니다. +4. Run Trombone Champ once to initialize necessary files for that mod. -## Linux/Steam Deck의 경우 +## Linux/Steam Deck Tips
                -펼치기 +Expand -BepInEx 설치 과정은 위에 서술된 Windows와 대체로 동일하지만 먼저 주의해야 할 추가 사항이 있습니다: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - 가이드를 따르려면 Steam Deck 사용자는 전원 버튼을 누른 상태에서 메뉴에서 `데스크톱 모드`를 선택하여 데스크톱 모드로 전환해야 합니다. + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - Steam Deck 사용자는 microSD 카드에서 BepInEx가 읽히지 않기 때문에 게임을 내부 저장소에 설치해야 합니다. + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - 앞서 언급한 바와 같이 Trombone Champ는 Proton 환경에서 동작하는 Windows 어플리케이션이기 때문에 `unix`가 아닌 `x64`의 Windows용 BepInEx를 설치해야 합니다. + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - 세이브 파일이나 로그 파일은 Proton 호환 폴더 내의 Steam 폴더에 저장됩니다. + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - Steam Deck의 경우 다음 위치에서 확인할 수 있습니다: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - 다른 Linux 플레이버에서는 Steam 폴더의 위치를 모르는 경우 터미널에서 `locate -r /Holy Wow$`을 실행해 주세요. + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -또한 게임 시작 옵션에 `WINEDLLOVERRIDES="winhttp=n,b" %command%`를 추가해야 합니다. 입력하려면, Steam 라이브러리에서 게임을 우클릭하고 `속성`을 클릭합니다. Windows와 달리 Steam Proton은 시작 옵션에서 별다른 지시가 없는 한 BepInEx의 파일을 가져오지 않습니다. +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Steam 속성 미리 보기](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -추가되면 BepInEx가 작동합니다! [위의 지침](##installation)에 따라 모드를 설치하여 커스텀 곡을 설치합니다. +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### 동영상 배경 {docsify-ignore} +### Video Backgrounds {docsify-ignore} -일부 커스텀 곡에는 배경에 대한 동영상이 포함되며, 기본 Proton 설치에서는 이러한 동영상을 재생할 수 없습니다. 이러한 기능을 사용하려면 [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/)을 사용하여 `GE-Proton`을 설치하면 됩니다. 이것은 Valve가 공식적으로 지원할 수 없는 비디오 포맷을 재생하는 기능을 포함한 몇 가지 추가 기능을 포함하는 Proton 버전입니다. +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -Proton Up-Qt 사용 및 `GE-Proton` 설치 방법에 대해서는 [Gaming On Linux에서 작성한 이 가이드](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/)를 참조하는 것이 좋습니다. +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> 만일 GE-Proton을 사용해도 설정의 방법에 따라서는 동영상의 재생에 문제가 발생하는 경우가 있습니다.
                +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## 커스텀 곡 설치 {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> 커스텀 곡의 설치에 관해서는 [**커스텀 곡 가이드**](installing-songs)를 참조해 주세요. \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/ko_KR/docs/user-guide/installation/installing-r2modman.md b/translations/ko_KR/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/ko_KR/docs/user-guide/installation/installing-r2modman.md +++ b/translations/ko_KR/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/ko_KR/docs/user-guide/installation/installing-songs.md b/translations/ko_KR/docs/user-guide/installation/installing-songs.md index e765781a58..4c4e4205ba 100644 --- a/translations/ko_KR/docs/user-guide/installation/installing-songs.md +++ b/translations/ko_KR/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # Installing Songs --- -?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-mods) to install BepInEx and TrombLoader before continuing! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Finding Songs @@ -14,7 +14,7 @@ If you'd like a more compact list, TheGlitched64 has created [a spreadsheet cont 1. Download the custom song - it will generally be some kind of archive file, usually ending in `.zip`. -2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder that got created when you first ran the game with TrombLoader installed. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![BepInEx Extraction Preview](../docs/files/customsongextract.png) diff --git a/translations/ko_KR/docs/user-guide/installation/migration.md b/translations/ko_KR/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/ko_KR/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/ko_KR/docs/user-guide/introduction.md b/translations/ko_KR/docs/user-guide/introduction.md index bc4f8a1e16..1a5387a8b6 100644 --- a/translations/ko_KR/docs/user-guide/introduction.md +++ b/translations/ko_KR/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ This wiki serves as a source of documentation and tutorials for various unoffici ?> **Discord Help** For live support with this guide please visit us in **#modding-support** on the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) and ask for assistance. Please read our [Frequently Asked Questions](faq) page beforehand to see if your question has already been answered. -> ### [![Steam Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-mods) +> ### [![Steam Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Apple Music Logo](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Custom Songs**](installing-songs) > diff --git a/translations/nl_NL/docs/sidebar.md b/translations/nl_NL/docs/sidebar.md index c7c9c71a6a..d55b152153 100644 --- a/translations/nl_NL/docs/sidebar.md +++ b/translations/nl_NL/docs/sidebar.md @@ -1,14 +1,15 @@ - **Gebruikershandleiding** - [Introductie](./) - **Modding** -- [Mods Installeren](installing-mods) -- [Liedjes Installeren](installing-songs) - [Using r2modman](installing-r2modman) +- [Liedjes Installeren](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Maps** - [Map Maken](creating-charts) - [Charting Guidelines](charting-guidelines) - [Map Achtergrond](chart-backgrounds) - [Diversen Map Informatie](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Extras** @@ -16,5 +17,5 @@ - **Koppelingen** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![Vertaal](https://icongr.am/material/translate.svg?color=808080&size=16)Vertaal](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)Vertaal](https://crowdin.com/project/trombone-champ-modding-wiki) - [Info](about) diff --git a/translations/nl_NL/docs/user-guide/charting/chart-troubleshooting.md b/translations/nl_NL/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/nl_NL/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/nl_NL/docs/user-guide/charting/charting-guidelines.md b/translations/nl_NL/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..3a53f1bd66 100644 --- a/translations/nl_NL/docs/user-guide/charting/charting-guidelines.md +++ b/translations/nl_NL/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/nl_NL/docs/user-guide/charting/creating-charts.md b/translations/nl_NL/docs/user-guide/charting/creating-charts.md index ef1789c598..a78a9d3437 100644 --- a/translations/nl_NL/docs/user-guide/charting/creating-charts.md +++ b/translations/nl_NL/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### MIDI Editor/DAW Maps zijn gemaakt door een MIDI bestand te maken en deze door [Midi2TromboneChamp](#converting-midi-to-map-file) te voeren. -De MIDI-noten moeten in het bereik 47 tot 73 liggen, anders werkt het niet in het spel.
                **LET OP:** Verschillende editors gebruiken verschillende waarden op de piano voor dit bereik. +Midi notes should be in the range 47 to 73 to match the game.
                **NOTE:** Different editors use different values on the piano for this range. Enkele gratis en geverifieerd werkende MIDI-editors zijn: -- [Reaper](https://www.reaper.fm/download.php)* (Bereik: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (Bereik: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Bereik: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Bereik: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (Bereik: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ Enkele gratis en geverifieerd werkende MIDI-editors zijn: MIDI omzetten naar een map bestand -

                - ?> Er zijn naast Midi2TromboneChamp nog twee MIDI-converters beschikbaar!
                Het proces voor deze andere converters zijn dermate gelijk dat deze handleiding nog steeds bruikbaar zal zijn.
                Als je een recenter conversieprogramma wil proberen, voel je vrij om deze nieuwe converter een poging te geven:

                Midi2TromboneChamp (Unity Version) - een in Unity gemaakte opvolger van Midi2TromboneChamp.
                Trombone Champ Converter - een webgebaseerd alternatief met nieuwe functies. -

                -

                1. - Ga naar https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest en klik op Midi2TromboneChamp.exe om het te downloaden. -

                  -
                  2. - -
                2. -

                  - Start het programma. Er opent een bestandskiezer. Selecteer hier je MIDI-bestand. Klik op Openen. + Go to Trombone Champ Chart Converter.

                  3. @@ -103,19 +93,19 @@ Enkele gratis en geverifieerd werkende MIDI-editors zijn:

                  • - Song Name is de volledige naam van het liedje, deze wordt weergegeven in de info wanneer je het in het spel selecteert. + Song Name is the full name of the song, shown in the info when you select it in-game.
                  • Short Name wordt weergeven tijdens het scrollen door de songlijst. Deze text wordt kleiner te langer de naam is, dus ik weet niet of er een maximale lengte is.
                  • - Folder Name is de naam van de map waarin je de map en audiobestand wil plaatsen. Bijv. Als je de mapnaam op mijn map zet, zal het pad van de map BepInEx/CustomSongs/mijn map/song.tmb zijn. + Release Year is the year the song was created.
                  • - Year is het jaar dat het nummer is gemaakt. + Artist is the composer of the song.
                  • - Author is de artiest van het nummer. + Beats per Bar bepaalt hoe ver de "beat lines" uit elkaar staan.
                  • Difficulty is het aantal moeilijkheidssterren dat op de info van de map verschijnt. @@ -124,17 +114,17 @@ Enkele gratis en geverifieerd werkende MIDI-editors zijn: Note Spacing beïnvloedt in combinatie met de BPM hoe snel het level scrollt.
                  • - Song Endpoint is de beat waarop het nummer eindigt. Het wordt automatisch berekend, maar je kan het aanpassen om het moment dat het eindscherm in beeld komt te veranderen. + Folder Name is de naam van de map waarin je de map en audiobestand wil plaatsen. Bijv. Als je de mapnaam op mijn map zet, zal het pad van de map BepInEx/CustomSongs/mijn map/song.tmb zijn.
                  • - Beats per Bar bepaalt hoe ver de "beat lines" uit elkaar staan. + Song Endpoint is de beat waarop het nummer eindigt. Het wordt automatisch berekend, maar je kan het aanpassen om het moment dat het eindscherm in beeld komt te veranderen.

                3. - Klik op OK. In de bestandskiezer die wordt geopend maak je een map aan met dezelfde naam die je in het Folder Name veld hebt opgegeven. Hierna sla je het bestand op als song.tmb binnen deze map. + Klik op OK. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

                  4. diff --git a/translations/nl_NL/docs/user-guide/installation/installing-mods.md b/translations/nl_NL/docs/user-guide/installation/installing-mods.md index cb0582aa9a..b207428557 100644 --- a/translations/nl_NL/docs/user-guide/installation/installing-mods.md +++ b/translations/nl_NL/docs/user-guide/installation/installing-mods.md @@ -1,51 +1,51 @@ -# Mods Installeren +# Installing Mods --- -?> Als je liever en videotutorial wil hebben, heeft VorgunTheBeta een [video](https://youtu.be/pSwNSGx-P5c) waarin wordt uitgelegd hoe je mods en liedjes installeert. Opmerking: de video is in het Engels. +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). ?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## Installatiemap vinden -1. Open Steam en klik met de rechtermuisknop op Trombone Champ. Ga daarna naar `Beheren > Door lokale bestanden bladeren`. +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![Rechtermuisknop Klik Menu Voorbeeld](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. Klik bovenaan op de adresbalk om het pad van de installatiemap te selecteren. Klik op `CTRL`+`C` om dit te kopiëren naar je klembord. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Kopieer mappad voorbeeld](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## BepInEx Installeren +## Installing BepInEx -1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) in de installatiemap van Trombone Champ. Je wil `BepinEx_x64_VERSION.zip` downloaden, waar `VERSION` het versienummer is. -2. Pak de inhoud van het BepInEx .zip-bestand direct uit in de [installatiemap](##finding-install-location) van Trombone Champ. +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![BepInEx Extractie Voorbeeld](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -!> Zorg ervoor dat je de `x64` versie van BepInEx hebt gedownload. De `unix` en `x86` versies zullen ervoor zorgen dat het spel niet goed werkt. This also applies to users on Linux/Steam Deck. +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **LET OP:** Pak BepInEx uit *in* de installatiemap zoals weergegeven in de afbeelding hierboven. Als je het goed hebt gedaan, zou de map van je spel eruit moeten zien als de onderstaande afbeelding. +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![Voltooide Installatie van BepInEx](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Start Trombone Champ één keer om de installatie te voltooien. +3. Run Trombone Champ once to complete installation. -## Mods Installeren +## Installation -Met BepInEx geïnstalleerd, kan je beginnen met het downloaden van specifieke mods. Er is een volledige lijst met mods beschikbaar in het `#mod-releases` kanaal in de [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -Omdat je waarschijnlijk zelfgemaakte liedjes wil installeren, gebruiken we [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) als het voorbeeld. +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. Navigeer naar de [installatiemap](###finding-install-location) van het spel, daarna naar de `BepInEx` map, en vervolgens naar de `plugins` map. +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. Klik bovenaan op de adresbalk om het pad van de plugin-map te selecteren. Klik op `CTRL`+`C` om dit te kopiëren naar je klembord. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Kopieer mappad voorbeeld](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. Download het .dll bestand van de mod naar het net gekopieerde pad. +3. Download the mod's .dll file into the copied folder. -![Plugins Map Voorbeeld](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Start Trombone Champ één keer op om de noodzakelijke bestanden voor de mod te initialiseren. +4. Run Trombone Champ once to initialize necessary files for that mod. ## Linux/Steam Deck Tips
                  @@ -78,6 +78,6 @@ We recommend following [this guide created by GamingOnLinux](https://www.gamingo !> Even with GE-Proton, you may still experience some issues with video playback depending on your setup.
                  -## Installeren van zelfgemaakte liedjes {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> Bekijk de [**Liedjes Installeren gids**](installing-songs) voor info over het installeren van zelfgemaakte liedjes. \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/nl_NL/docs/user-guide/installation/installing-r2modman.md b/translations/nl_NL/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/nl_NL/docs/user-guide/installation/installing-r2modman.md +++ b/translations/nl_NL/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/nl_NL/docs/user-guide/installation/installing-songs.md b/translations/nl_NL/docs/user-guide/installation/installing-songs.md index 0de7ada97e..0060ccefaf 100644 --- a/translations/nl_NL/docs/user-guide/installation/installing-songs.md +++ b/translations/nl_NL/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # Liedjes Installeren --- -?> Als je liever en videotutorial wil hebben, heeft VorgunTheBeta een [video](https://youtu.be/pSwNSGx-P5c) waarin wordt uitgelegd hoe je mods en liedjes installeert. Opmerking: de video is in het Engels. +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **LET OP:** Zorg ervoor dat je de [installatiehandleiding voor mods](installing-mods) hebt gevolgd om BepInEx en TrombLoader te installeren voordat je doorgaat! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Liedjes Vinden @@ -14,7 +14,7 @@ Voor het geval dat je liever een wat compactere lijst wil gebruiken heeft TheGli 1. Download het liedje - dit zal meestal een soort archiefbestand zijn, meestal eindigend in `.zip`. -2. Pak de inhoud van het archiefbestand uit in de `BepInEx/CustomSongs` map die automatisch aangemaakt is nadat je TrombLoader hebt geïnstalleerd. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![BepInEx Extractie Voorbeeld](../docs/files/customsongextract.png) diff --git a/translations/nl_NL/docs/user-guide/installation/migration.md b/translations/nl_NL/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/nl_NL/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/nl_NL/docs/user-guide/introduction.md b/translations/nl_NL/docs/user-guide/introduction.md index 60001e8472..b38f87e409 100644 --- a/translations/nl_NL/docs/user-guide/introduction.md +++ b/translations/nl_NL/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Deze wiki dient als een bron van documentatie en tutorials voor verschillende on ?> **Discord Help** Voor snelle ondersteuning met deze gids, bezoek ons in **#modding-support** op de [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) en vraag om hulp. Lees onze [veelgestelde vragen](faq) pagina vooraf om te zien of je vraag al is beantwoord. -> ### [![Steam Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Mods Installeren**](installing-mods) +> ### [![Steam Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Apple Music Logo](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Zelfgemaakte Maps Installeren**](installing-songs) > diff --git a/translations/pt_BR/docs/sidebar.md b/translations/pt_BR/docs/sidebar.md index 8c2f2ba417..00e21e6635 100644 --- a/translations/pt_BR/docs/sidebar.md +++ b/translations/pt_BR/docs/sidebar.md @@ -1,14 +1,15 @@ - **Guia do usuário** - [Introdução](./) - **Modding** -- [Instalando mods](installing-mods) -- [Instalando músicas](installing-songs) - [Using r2modman](installing-r2modman) +- [Instalando músicas](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Charts** - [Criando charts](creating-charts) - [Charting Guidelines](charting-guidelines) - [Plano de fundo para charts](chart-backgrounds) - [Informações diversas sobre charts](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Extras** @@ -16,5 +17,5 @@ - **Links** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![Traduzir](https://icongr.am/material/translate.svg?color=808080&size=16)Traduzir](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)Traduzir](https://crowdin.com/project/trombone-champ-modding-wiki) - [Sobre](about) diff --git a/translations/pt_BR/docs/user-guide/charting/chart-troubleshooting.md b/translations/pt_BR/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/pt_BR/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/pt_BR/docs/user-guide/charting/charting-guidelines.md b/translations/pt_BR/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..3a53f1bd66 100644 --- a/translations/pt_BR/docs/user-guide/charting/charting-guidelines.md +++ b/translations/pt_BR/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/pt_BR/docs/user-guide/charting/creating-charts.md b/translations/pt_BR/docs/user-guide/charting/creating-charts.md index bda7501df5..3cff84d4e2 100644 --- a/translations/pt_BR/docs/user-guide/charting/creating-charts.md +++ b/translations/pt_BR/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### Editores MIDI/DAW Charts são feitos a partir de um arquivo midi, que em sequência passam por um [conversor MIDI](#converting-midi-to-map-file). -As nots midi devem estar na região 47 a 73 para se igualarem as possíveis no jogo.
                  **NOTA:** Nem todos os editores usam as mesmas oitavas para essa região. +Midi notes should be in the range 47 to 73 to match the game.
                  **NOTE:** Different editors use different values on the piano for this range. Alguns editores midi gratuitos que devem funcionar incluem: -- [Reaper](https://www.reaper.fm/download.php)* (Oitavas: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (Oitavas: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Oitavas: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Oitavas: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (Oitavas: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ Alguns editores midi gratuitos que devem funcionar incluem: Convertendo Midi ao arquivo de mapa -

                  - ?> Existem dois conversores Midi disponíveis além do Midi2TromboneChamp!
                  O processo para esses novos conversores é semelhante o suficiente, então este guia ainda é utilizável.
                  Se quiser um conversor mais atualizado, sinta-se à vontade para utilizar os seguintes:

                  Midi2TromboneChamp (Versão Unity) — Uma versão nova em Unity do Midi2TromboneChamp.
                  Trombone Champ Chart Converter — Uma versão alternativa na web com novos recursos. -

                  -

                  1. - Vá para https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest e clique em Midi2TromboneChamp.exe para baixar o arquivo. -

                    -
                    2. - -
                  2. -

                    - Execute-o. No seletor de arquivos que foi aberto, selecione seu arquivo midi. Clique em Abrir. + Go to Trombone Champ Chart Converter.

                    3. @@ -103,19 +93,19 @@ Alguns editores midi gratuitos que devem funcionar incluem:

                    • - Song Name é o nome completo da música, mostrado nas informações da música quando selecionada. + Song Name is the full name of the song, shown in the info when you select it in-game.
                    • Short Name é mostrado enquanto navega pela çista de músicas. O texto fica menor dependendo do tamanho do nome, mas não se sabe se tem um limite para tal.
                    • - Folder Name é o nome da pasta em que foi colocado a música e o chart. Ex. Se você definiu o nome da pasta como banana, seu chart vai estar localizado em BepInEx/CustomSongs/banana/song.tmb. + Release Year is the year the song was created.
                    • - Year é o ano em que a música foi criada. + Artist is the composer of the song.
                    • - Author é o compositor da música. + Beats per Bar determina o quão distantes estão as "linhas de batida".
                    • Difficulty é o número de estrelas que aparece na informação de dificuldade. @@ -124,17 +114,17 @@ Alguns editores midi gratuitos que devem funcionar incluem: Note Spacing afeta a velocidade de rolagem, em combinação com o BPM.
                    • - Song Endpoint é a batida em que a música termina. Ela é calculada automaticamente, mas você pode ajustá-la manualmente para mudar quando o nível acaba. + Folder Name é o nome da pasta em que foi colocado a música e o chart. Ex. Se você definiu o nome da pasta como banana, seu chart vai estar localizado em BepInEx/CustomSongs/banana/song.tmb.
                    • - Beats per Bar determina o quão distantes estão as "linhas de batida". + Song Endpoint é a batida em que a música termina. Ela é calculada automaticamente, mas você pode ajustá-la manualmente para mudar quando o nível acaba.

                  3. - Aperte em OK. No seletor de arquivos que será aberto, crie uma pasta de mesmo nome do Folder Name, e salve o arquivo como song.tmb na pasta. + Aperte em OK. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

                    4. diff --git a/translations/pt_BR/docs/user-guide/installation/installing-mods.md b/translations/pt_BR/docs/user-guide/installation/installing-mods.md index f0ac05ef36..b207428557 100644 --- a/translations/pt_BR/docs/user-guide/installation/installing-mods.md +++ b/translations/pt_BR/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# Instalando mods +# Installing Mods --- -?> Se preferir, VorgunTheBeta tem [um vídeo explicando como instalar mods e músicas personalizadas](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> O início deste guia também funciona para Linux e Steam Deck! Certifique-se de que [leia o final](#linuxsteam-deck-specific-tips) para obter detalhes adicionais. +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## Encontrando o local de instalação -1. Abra a Steam e dê um clique direito em Trombone Champ. Após isso, vá para `Gerenciar > Navegar pelos arquivos locais`. +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![Preview do menu de clique direito](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. Clique na barra de endereço no topo para selecionar a sua pasta de instalação. Aperte `CTRL`+`C` para copiar isso a sua área de transferência. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Preview do diretório da pasta](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## Instalando o BepInEx +## Installing BepInEx -1. Baixe o [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) e ponha o arquivo na pasta do Trombone Champ. Queremos ter o arquivo `BepinEx_x64_VERSÃO.zip`, sendo `VERSÃO` o número da versão do arquivo. -2. Extraia o conteúdo do BepInEx.zip diretamente para a [pasta de instalação](##finding-install-location) do Trombone Champ. +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![Preview da extração do BepInEx](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -!> Tenha certeza de que você baixou a versão `x64` do BepInEx. As versões em `unix` e `x86` farão com que o jogo não funcione devidamente. Isso também se aplica aos usuários que usam Linux/Steam Deck. +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **IMPORTANTE:** Extraia o BepInEx *diretamente* a pasta de instalação como mostrado na imagem acima. Se feito corretamente, a pasta de instalação do jogo deve se parecer com a imagem mostrada abaixo. +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![Instalação finalizada do BepInEx](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. Abra o Trombone Champ uma vez só para completar a instalação. +3. Run Trombone Champ once to complete installation. -## Instalação +## Installation -Com o BepInEx instalado, você pode começar a baixar mods específicos — uma lista completa está disponível no canal `#mod-releases` no [Discord de modding para Trombone Champ](https://discord.gg/KVzKRsbetJ). +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -Como você provavelmente quer instalar músicas personalizadas, esta seção irá usar o [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) como um exemplo. +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. Navegue até a [pasta de instalação](###finding-install-location), a pasta `BepInEx`, terminando na pasta `plugins`. +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. Clique na barra de endereço no topo para selecionar a sua pasta de instalação. Aperte `CTRL`+`C` para copiar isso a sua área de transferência. +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![Preview do diretório da pasta](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. Baixe e insira o arquivo .dll na pasta mencionada. +3. Download the mod's .dll file into the copied folder. -![Preview da pasta de plugins](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. Abra o Trombone Champ uma vez só, assim inicializando os arquivos necessários para o mod funcionar. +4. Run Trombone Champ once to initialize necessary files for that mod. -## Dicas para Linux/Steam Deck +## Linux/Steam Deck Tips
                    -Expandir +Expand -O processo de instalação do BepInEx é quase igual ao do Windows mostrado acima, mas tem algumas coisas extras que precisamos estar cientes: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - Para seguir esse guia, o Steam Deck precisa estar no modo desktop. Isso pode ser feito segurando o botão liga/desliga e selecionando o `Desktop Mode` no menu. + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - O jogo deve estar instalado no armazenamento interno do Steam Deck, já que o BepInEx não é carregado em cartões MicroSD. + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - Como mencionado anteriormente, A versão instalada do BepInEx deve ser a versão Windows `x64`, e não a em `unix`, já que o Trombone Champ é um aplicativo Windows rodando em Proton. + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - Os arquivos save e log são armazenados na sua pasta Steam, nas pastas de compatibilidade Proton. + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - Dentro do Steam Deck, isso pode ser encontrado no diretório: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - Em outras versões Linux você pode executar o comando `locate -r /Holy Wow<0>locate -r /Holy Wow$` no terminal se não tiver certeza de onde estão suas pastas da Steam. + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -Você também precisará adicionar `WINEDLLOVERRIDES="winhttp=n,b" %command%` às opções de Inicialização do seu jogo. Para fazer isso, clique com o botão direito no seu jogo na Steam e entre nas `Properties`. Ao contrário do Windows, o Proton não vai carregar os arquivos do BepInEx, a menos que seja instruído para o mesmo. +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Preview das propriedades da Steam](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -Uma vez adicionado, o BepInEx deve funcionar agora! Instale seus mods [como instruído acima](##installation) para obter suas músicas personalizadas. +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### Vídeos como plano de fundo {docsify-ignore} +### Video Backgrounds {docsify-ignore} -Algumas músicas personalizadas tem vídeos como plano de fundo, e a instalação padrão do Proton não vai os reproduzir. Se quiser que eles funcionem, você pode instalar o `GE-Proton` usando [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). Essa é uma versão personalizada do Proton que possuí algumas ferramentas adicionais, incluindo a reprdução de vídeos em formatos que o Proton da Valve não suporta naturalmente. +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -Recomendamos seguir [este guia criado pelo GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) para obter instruções sobre como usar o ProtonUp-Qt e instalar o `GE-Proton`. +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> Mesmo com o GE-Proton, ainda pode acontecer engasgos na reprodução do vídeo, dependendo das suas configurações.
                    +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## Instalando músicas personalizadas {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> Dê uma olhada na nossa [**guia de músicas personalizadas**](installing-songs) para descobrir como instalar músicas personalizadas. \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/pt_BR/docs/user-guide/installation/installing-r2modman.md b/translations/pt_BR/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/pt_BR/docs/user-guide/installation/installing-r2modman.md +++ b/translations/pt_BR/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/pt_BR/docs/user-guide/installation/installing-songs.md b/translations/pt_BR/docs/user-guide/installation/installing-songs.md index 571028ce8c..f0b08bbce4 100644 --- a/translations/pt_BR/docs/user-guide/installation/installing-songs.md +++ b/translations/pt_BR/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # Instalando músicas --- -?> Se preferir, VorgunTheBeta tem [um vídeo explicando como instalar mods e músicas personalizadas](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **IMPORTANTE:** Tenha certeza de que seguiu o [guia de instalação de mods](installing-mods) e tem o BepInEx e TrombLoader instalados antes de continuar! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Encontrando músicas @@ -14,7 +14,7 @@ Se quiser uma lista mais curta, TheGlitched64 criou uma [planilha contendo infor 1. Baixe o chart personalizado — geralmente são arquivos compactados, como a extensão `.zip`. -2. Extraia o conteúdo do arquivo diretamente para a pasta `BepInEx/CustomSongs` que é criada quando se inicia o jogo pela primeira vez com o TrombLoader instalado. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![Preview de extração do BepInEx](../docs/files/customsongextract.png) diff --git a/translations/pt_BR/docs/user-guide/installation/migration.md b/translations/pt_BR/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/pt_BR/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/pt_BR/docs/user-guide/introduction.md b/translations/pt_BR/docs/user-guide/introduction.md index e49984dc26..6210c219ca 100644 --- a/translations/pt_BR/docs/user-guide/introduction.md +++ b/translations/pt_BR/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Esta Wiki serve como fonte de documentação e tutoriais para vários mods não ?> **Ajuda no Discord** Para suporte direito com esta guia, por favor visite-nos no **#modding-support** do [Discord de modding para Trombone Champ](https://discord.gg/KVzKRsbetJ) e peça ajuda. Favor ler as [Perguntas Frequentes (FAQ's)](faq) antes para ter certeza de que sua pergunta não foi respondida anteriormente. -> ### [![Logo da Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Instalando mods**](installing-mods) +> ### [![Logo da Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Logo da Apple Music](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Instalando músicas**](installing-songs) > diff --git a/translations/th_TH/docs/extras/faq.md b/translations/th_TH/docs/extras/faq.md index b97547519e..1170a8e63c 100644 --- a/translations/th_TH/docs/extras/faq.md +++ b/translations/th_TH/docs/extras/faq.md @@ -1,31 +1,31 @@ # คำถามที่พบบ่อย --- -## Why is there a black screen with a music note? +## ทำไมมันจอดำกับโน็ตเพลง? -Update [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest). Replace the old dll in `BepInEx/plugins` with the new dll. +อัปเดต [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) เปลี่ยน DLL ของเก่าใน `BepInEx/plugins` เป็น DLL ของใหม่ -## Do custom songs work with a pirated version of the game? +## เพลงที่ทำเองสามารถใช้กับเกมส์ที่โหลดเถื่อนได้ไหม? -The latest TrombLoader will work on the latest version of Trombone Champ. Buy the game. +TrombLoader เวอร์ชั่นล่าสุดจะใช้งานได้กับเกมส์ Trombone Champ เวอร์ชั่นล่าสุด ซื้อเกมส์เถอะอย่าเป็นคนแบบนี้ -## Where can I find custom songs? +## ฉันจะหาเพลงที่ทำเองได้ที่ไหน? -Go to `#custom-charts` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). +ไปที่ช่อง `#custom-charts` ใน [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) -TheGlitched64 has also created [a spreadsheet containing information on every custom chart](https://docs.google.com/spreadsheets/d/1xpoUnHdSJFqOQEK_637-HCECYtJsgK91oY4dRuDMtik/edit?usp=sharing). +TheGlitched64 ก็ยังได้ได้สร้าง [สเปรดชีตที่มีข้อมูลของเพลงสร้างเองทุกตัว](https://docs.google.com/spreadsheets/d/1xpoUnHdSJFqOQEK_637-HCECYtJsgK91oY4dRuDMtik/edit?usp=sharing) -## Why isn't BepInEx creating folders? +## ทำไม BepInEx ไม่สร้างโฟลเดอร์? -Make sure that you downloaded the x64 BepInEx. Also make sure your folder looks like this: ![Finished BepinEx Install](../docs/files/finishedbepinex.png) +ให้แน่ใจว่าได้ดาวน์โหลด BepInEx รุ่น x64 และให้แน่ใจว่าโฟลเดอร์ดูเหมือนอย่างนี้: ![ติดตั้ง BepinEx เสร็จสิ้น](../docs/files/finishedbepinex.png) -## Why aren't my songs appearing in the game? +## ทำไมเพลงของฉันไม่แสดงในเกมส์? -Make sure you've unzipped the file. It should look like this: ![Correct Extraction Preview](../docs/files/customsongcorrect.png) +ให้แน่ใจว่าคุณได้แตกไฟล์แล้ว มันควรที่จะเป็นแบบนี้: ![ตัวอย่างการแตกไฟล์ที่ถูกต้อง](../docs/files/customsongcorrect.png) -## What do I do with .7zip or .rar files? +## ฉันควรจะทำอะไรกับไฟล์ .7z หรือ .rar ? -You can unzip them with [7-zip](https://www.7-zip.org/download.html). +คุณสามารถแตกไฟล์ด้วย [7-zip](https://www.7-zip.org/download.html) ## ลิงบาบูน? diff --git a/translations/th_TH/docs/sidebar.md b/translations/th_TH/docs/sidebar.md index 3044755149..63e86da2ea 100644 --- a/translations/th_TH/docs/sidebar.md +++ b/translations/th_TH/docs/sidebar.md @@ -1,14 +1,15 @@ - **คู่มือผู้ใช้** - [บทนำ](./) - **Modding** -- [การลง Mods](installing-mods) -- [การลงเพลง](installing-songs) - [Using r2modman](installing-r2modman) +- [การลงเพลง](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **การทำผัง** - [การสร้างผัง](creating-charts) - [Charting Guidelines](charting-guidelines) - [พื้นหลังของผัง](chart-backgrounds) - [ข้อมูลผังอย่างอื่น](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **เพิ่มเติม** @@ -16,5 +17,5 @@ - **ลิงค์** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![แปลภาษา](https://icongr.am/material/translate.svg?color=808080&size=16)แปลภาษา](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)แปลภาษา](https://crowdin.com/project/trombone-champ-modding-wiki) - [เกี่ยวกับ](about) diff --git a/translations/th_TH/docs/user-guide/charting/chart-backgrounds.md b/translations/th_TH/docs/user-guide/charting/chart-backgrounds.md index 9316686092..fa1698b418 100644 --- a/translations/th_TH/docs/user-guide/charting/chart-backgrounds.md +++ b/translations/th_TH/docs/user-guide/charting/chart-backgrounds.md @@ -1,4 +1,4 @@ -# พื้นหลังของผัง +# พื้นหลังของเพลง --- พื้นหลังเป็นฟีเจอร์ที่สำคัญของผังและมีความแตกต่างบางประการ (ตามลำดับความซับซ้อน) diff --git a/translations/th_TH/docs/user-guide/charting/chart-troubleshooting.md b/translations/th_TH/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/th_TH/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/th_TH/docs/user-guide/charting/charting-guidelines.md b/translations/th_TH/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..a8f84faeb5 100644 --- a/translations/th_TH/docs/user-guide/charting/charting-guidelines.md +++ b/translations/th_TH/docs/user-guide/charting/charting-guidelines.md @@ -1,73 +1,60 @@ -# Charting Guidelines +# ข้อแนะนำการทำเพลง --- -The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. +ข้อแนะนำพวกนี้ไม่จำเป็นที่จะต้องทำตามก็ได้ จุดประสงค์ก็คือเพลงนั้นสนุกที่จะเล่น ถ้าเลือกที่จะไม่สนใจกฎก็ทำเพลงให้เล่นให้หรือน่าสนใจ (เช่น Rush E) ก็ยินดีที่จะให้ทำ เครดิต: tsunderestorm, StaticR. -## Best Practices +## แบบอย่างที่ดี +- อย่าทำให้โน็ตเพี้ยน ถ้าคุณได้ยินระดับเสียงไม่ดี ถาม #charting หรือ #wip ให้มาช่วยดู +- อย่าทำให้ผิดจังหวะ คุณสามารถชะลอเพลงในตัวตัดต่อของคุณเพื่อช่วยแยกแยะจังหวะที่เร็วของเพลง +- อย่าเริ่มหรือหยุดเพลงกะทันหัน + - ให้อย่างน้อยช่องว่างช่องหนึ่งก่อนโน็ตตัวแรกและทำเพลงต่อไปไปจนจบเพลง + - ปรับ ความยาว/จุดจบของเพลง ถ้าผ้าม่านกำลังปิดก่อนที่เพลงจะหยุด อย่าตั้งจุดจบของเพลงใน tmb ยาวกว่าความยาวของเพลงไม่อย่างนั้นเพลงจะไม่หยุด +- โน็ตสามารถยาวได้ถึง 4.5 วินาทีกอนที่จะหมดลมหายใจ ถ้าคุณมีโน็ตหรือสไลด์ที่ยาวกว่านั้น แนะนำว่าให้แยกมันเพื่อให้ผู้เล่นมีเวลาหายใจ +- คอร์ดโดยทั่วไปประกอบด้วยโน็ต 3-4 ตัว โน็ตสูงสุดหรือต่ำสุดโดยปกติให้เสียงที่สะอาดที่สุดสำหรับเพลง +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. -- Maintain note spacing appropriate for the difficulty. - - As a very general guideline, the note and space between it and the next note should be of equal length - - **IDEAL**: +### Note Spacing +- รักษาระยะห่างของโน็ตให้เหมาะสมกับความยาก + - นี่เป็นข้อแนะนำทั่วไป โน็ตและระยะห่างระหว่างโน็ตตัวต่อไปควรที่จะมีความยาวเท่ากัน + - **ควร**: - ![Ideal Note Spacing](../docs/files/charting/ideal-note-spacing.png) - - **NOT IDEAL**: (this might sound good in preview or autotoot but does not provide much time for a player to release and hit the next note) + - **ไม่ควร**: (นี่อาจจะให้เสียงดีสำหรับการดูตัวอย่างหรือใช้ autotoot แต่มันไม่ให้เวลาพอที่จะปล่อยและกฎโน็ตต่อไปสำหรับคนเล่น) - ![Bad Note Spacing](../docs/files/charting/bad-note-spacing.png) - - You may make exceptions: - - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - - to make it easier to maintain combo on very fast sections - - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. -- The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) + - คุณสามารถใช้ข้อยกเว้นได้เมื่อ: + - เพื่อเน้น[การประกบ](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) เช่น การทอดเสียง การขาดตอน หรือ การเล่นค่อยๆโดยไม่ขาดเสียง + - เพื่อทำให้การทำคอมโบง่ายขึ้นในส่วนเร็ว + - ถ้าเกิดจังหวะเพลงนั้นช้าและช่องว่างที่แน่นเพียงพอ +- จังหวะเพลงควรที่จะมองเห็นได้ง่าย ถ้าโน็ตยาวกว่านิดหน่อยมันก็ควรที่จะเห็นยาวกว่านิดหน่อย ถ้าโน็ตสั้นกว่านิดหน่อยมันก็ควรที่จะเห็นสั้นกว่านิดหน่อย + - **ควร**: (เห็นได้ง่ายว่าตัวไหนเป็นโน็ตตัวสั่นและตัวไหนเป็นโน้ตประจุด (3/16)) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) - - **NOT IDEAL**: (all notes read as eighth notes) + - **ไม่ควร**: (โน็ตทุกตัวเป็นโน็ตตัวสั่น) - ![Bad Visual Rhythm](../docs/files/charting/bad-visual-rhythm.png) -- Use a reasonable `savednotespacing` (scroll speed) value - - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. +- ใช้ค่า `savednotespacing` (ความเร็วของการเลื่อน) ให้เหมาะสม + - 120~200 ขึ้นอยู่กับความซับซ้อนของเพลง แนวทางที่ดีคือ `100/[BPM]*280` + - นี่ควรเร็วพอที่ทำให้จังหวะเห็นได้ง่ายและช้าพอที่ให้ผู้เล่นมีเวลาที่จะตอบสนอง + - ค่านี้ไม่จำเป็นที่จะต้องเหมือนกับจังหวะ! -### Slides -- Avoid 90 degree slide angles. - - **IDEAL**: (player has adequate time to change pitches. Depending on latency, you might want to adjust the position of the connecting points.) +### สไลด์ +- หลีกเลี่ยงสไลด์ที่ 90 องศา + - **ควร**: (ผู้เล่นมีเวลาเพียงพอในการเปลี่ยนความสูงต่ำ ขึ้นอยู่กับความหน่วง คุณอาจต้องการที่จะปรับที่อยู่ของจุดเชื่อมต่อ) - ![Ideal Slide 1](../docs/files/charting/ideal-slide1.png) - - **MAYBE IDEAL**: (only if a quick transition is absolutely necessary) + - **อาจจะได้**: (เฉพาะการเปลี่ยนอย่างรวดเร็วนั้นจำเป็นอย่างมาก) - ![Ideal Slide 2](../docs/files/charting/ideal-slide2.png) - - **NOT IDEAL**: (this is not humanly playable) + - **ไม่ควร**: (มนุษย์ไม่สามารถเล่นสิ่งนี้ได้) - ![Bad Slide](../docs/files/charting/bad-slide.png) -- A slide approaches the target pitch before the slide end. - - Make the end of the slide ~1-2 32nd notes late, depending on the length of the slide. - - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. -- For 8th note slides or shorter, you don't need to include a held note in the middle. - - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- สไลด์เข้าใกล้ระดับเสียงเป้าหมายก่อนที่จะจบสไลด์ + - ทำจุดจบของสไลด์ที่ 1-2 เป็นโน้ตสามสิบวินาทีล่าช้าขึ้้นอยู่กับความยาวของสไลด์ + - เริ่มสไลด์ที่โน้ตตัวที่สิบหกก่อนที่จะถึงจังหวะ มันจะยังโอเคอยู่ถ้าครึ่งของโน็ตเป็นสไลด์ +- สำหรับโน็ตตัวที่แปดหรือสั้นกว่าคุณไม่จำเป็นที่จะต้องใส่โน็ตกั้กตรงกลาง + - โดยส่วนมากคุณไม่จำเป็นที่จะต้องใช้โน็ตกั้กที่จุดเริ่ม, ตรงกลาง, หรือจุดจบเว้นแต่ว่าคุณอยากได้โน็ตกั้กที่เห็นชัดเจนสำหรับโน็ตตัวที่แปดหรือยาวกว่า +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### แทร็กวนซ้ำ +- วนซ้ำนิดหน่อยไม่เป็นไรแต่หลีกเลี่ยงวนซ้ำโน็ตไปเรื่อยๆ + - คุณสามารถหาเวอร์ชั่นทีวีหรือตัดต่อด้วยตัวเองถ้าคุณยากได้เพลงที่สั้นลง + - โดยทั่วไป มันไปได้ดีถ้าคุณทำเพลงที่ง่ายหรือส่วนที่คาดไว้มากในการเล่นครั้งแรก และเลี่ยนไปเป็นอย่างอื่น + - มันมีทำนองหลักและทำนองรองบ่อยครั้ง + - ไปตามกับคอร์ดหรือเบสไลน์ + - เล่นอ็อกเทฟที่ต่างกัน + - ถ้าคุณรู้ว่ากำลังกำลังทำอะไรในทางดนตรี ใช้คอร์ดหรือฮาร์โมนีอย่างอื่น + - คุณอาจอยากที่จะห้วนกลับถ้าส่วนหลักเป็นจุดสูงสุดของเพลง จุดสูงสุดทางดนตรีส่วนใหญ่เหมาะสมที่สุดที่ส่วนที่สามหรือสี่ของเพลง เพราะอย่างนั้นสร้างจุดซ้ำที่ทำให้ดูสมบรูณ์มากขึ้น +- เพลงที่สั้นมากจะวนซ้ำได้ดีจนกระทั่ง 1 ถึง 1:30 นาที เว้นแต่ว่ามันซ้ำซากจริงๆ +- คุณสามารถที่จะเลือกที่จะเพิ่มจุดซ้ำแบบเต็มหรือบางส่วน ถ้ามันเล่นต่างกันของส่วนในแต่ละส่วน +- จบเพลงที่วนซ้ำไปเรื่อยๆอาจจะยาก คำแนะนำ: + - จบที่จุดจบโดยไม่มีการซ้ำ + - จบที่จังหวะ, คอร์ด, หรือส่วนแรกของการซ้ำ + - ทำให้เพลงเลือนหายไปที่ตอนท้ายของดนตรี + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/th_TH/docs/user-guide/charting/creating-charts.md b/translations/th_TH/docs/user-guide/charting/creating-charts.md index 3b051a74ce..84147f76bb 100644 --- a/translations/th_TH/docs/user-guide/charting/creating-charts.md +++ b/translations/th_TH/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### ตัวตัดต่อ Midi/DAW ผังสร้างได้จากการสร้างไฟล์ MIDI และรันผ่าน [MIDI converter](#converting-midi-to-map-file) -โน็ตของ MIDI ควรที่จะอยู่ระหว่างแนวที่ 47 ถึง 73 เพื่อที่จะตรงกับเกม
                    **โน็ต:** ตัวตัดต่อแต่ละตัวจะใช้ค่าของเปียนโนต่างกันกับแนวนี้ +Midi notes should be in the range 47 to 73 to match the game.
                    **NOTE:** Different editors use different values on the piano for this range. ตัวตัดต่อ Midi ที่ฟรีและทดสอบว่าใช้ได้มี: -- [Reaper](https://www.reaper.fm/download.php)* (แนวที่: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (แนวที่: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (แนวที่: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (แนวที่: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (แนวที่: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ การแปลง Midi เป็นไฟล์ผัง -

                    - ?> มันมีตัวแปลง Midi นอกจาก Midi2TromboneChamp!
                    กระบวนการสำหรับตัวแปลงตัวใหม่จะคลายๆกันที่คู่มือนี้สามารถใช้ได้ด้วยกัน
                    ถ้าคุณอยากจะลองตัวแปลงตัวใหม่คุณสามารถลองได้:

                    Midi2TromboneChamp (เวอร์ชั่น Unity) - โปรแกรมที่ใช้ฐาน unity ต่อมาจาก Midi2TromboneChamp.
                    Trombone Champ Chart Converter เว็บไซต์ทาเลือกพร้อมกับฟีเจอร์ใหม่ -

                    -

                    1. - ไปที่ https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest และคลิกที่ Midi2TromboneChamp.exe เพื่อดาวน์โลดมัน -

                      -
                      2. - -
                    2. -

                      - เริ่มโปรแกรม ในที่เลือกไฟล์ ให้เลือกไฟล์ Midi ของคุณ คลิกเปิด + Go to Trombone Champ Chart Converter.

                      3. @@ -103,19 +93,19 @@

                      • - Song Name ชื่อเต็มของเพลง แสดงข้อมูลในเกม + Song Name is the full name of the song, shown in the info when you select it in-game.
                      • Short Name แสดงชื่อในขณะที่เลือ่นผ่านรายการเพลง ตัวอักษรจะเล็กลงเพราะฉะนั้นเราไม่แน่ใจว่ามันมีลิมิตสูงสุดเท่าไร
                      • - Folder Name ชื่อโฟล์เดอร์ที่สุดจะใส่เพลงเข้าไป ตัวอย่างเช่น ถ้าคุณตั้งชื่อโฟล์เดอร์เป็น "My Map" ที่อยู่ของผังคุณจะอยู่ที่ "BepInEx/CustomSongs/My Map/song.tmb." + Release Year is the year the song was created.
                      • - Year ปีที่เพลงได้สร้างขึ้น + Artist is the composer of the song.
                      • - Author คนสร้างเพลง + Beats per Bar กำหนดความกว้างของ "เส้นโน็ต"
                      • Difficulty เลขดาวระดับความยากที่แสดงในข้อมูลเพลง @@ -124,17 +114,17 @@ Note Spacing ความเร็วที่เลเวลจะเลื่อน จะรวมกับ BPM
                      • - Song Endpoint จังหวะที่เพลงจบ มันคำนวณอัตโนมัติแต่คุณสามารถเปลี่ยนได้ว่าเลเวลจะจบตอนไหน + Folder Name ชื่อโฟล์เดอร์ที่สุดจะใส่เพลงเข้าไป ตัวอย่างเช่น ถ้าคุณตั้งชื่อโฟล์เดอร์เป็น "My Map" ที่อยู่ของผังคุณจะอยู่ที่ "BepInEx/CustomSongs/My Map/song.tmb."
                      • - Beats per Bar กำหนดความกว้างของ "เส้นโน็ต" + Song Endpoint จังหวะที่เพลงจบ มันคำนวณอัตโนมัติแต่คุณสามารถเปลี่ยนได้ว่าเลเวลจะจบตอนไหน

                    3. - กด OK ในตัวเลือกไฟล์ที่เปิดขึ้นมา สร้างโฟล์เดอร์ที่มีชื่อเดียวกันกับช่อง Folder Name และบันทึกไฟล์ song.tmb ข้างในโฟล์เดอร์นั้น + กด OK Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

                      4. diff --git a/translations/th_TH/docs/user-guide/installation/installing-mods.md b/translations/th_TH/docs/user-guide/installation/installing-mods.md index 11661e1227..b207428557 100644 --- a/translations/th_TH/docs/user-guide/installation/installing-mods.md +++ b/translations/th_TH/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# การลง Mods +# Installing Mods --- -?> ถ้าคุณอยากได้วิธีแบบวีดีโอ VorgunTheBeta มี [วีดีโออธิบายวิธีการลง mods และ การลงเพลงกำหนดเอง](https://youtu.be/pSwNSGx-P5c) +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> จุดเริ่มของคู่มือนี้ใช้ได้กับ Linux และ Steam Deck! เอาให้แน่ใจว่า [อ่านจนจบ](#linuxsteam-deck-specific-tips) สำหรับรายละเอียดอื่นๆ +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## การหาที่ลง -1. เปิด Steam และคลิกขวาที่ Trombone Champ จากนั้นไปที่ `Manage > Browse local files` +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![ตัวอย่างเมนูคลิกขวา](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. กดไปที่ช่องที่อยู่ข้างบนเพื่อที่จะเลือกเส้นทางโฟล์เดอร์สำหรับการลง กด `CTRL`+`C` เพื่อคัดลอกนี้ไปที่คลิปบอรด์ +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![ตัวอย่างการก็อปปี้โฟล์เดอร์เป็นเส้นทาง](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## การลง BepInEx +## Installing BepInEx -1. ดาวน์โหลด [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest)ใส่ในโฟล์เดอร์ TromboneChamp ของคุณ คุณจะต้องเอา `BepinEx_x64_VERSION.zip` โดย `VERSION` จะเป็นเลขของเวอร์ชั่น -2. แตกไฟล์ BepInEx .zip ไปที่ [โฟล์เดอร์ทีลง](##finding-install-location) Trombone Champ ของคุณ +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![ตัวอย่างการแตกไฟล์ BepInEx](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -!> ใฟ้แน่ใจว่าคุณได้ดาวน์โหลด BepInEx เวอร์ชั่น `x64` เวอร์ชั่น `unix` และ `x86` จะทำให้เกมของคุณทำงานไม่ถูกต้อง นี่รวมถึงผู้ที่ใช้ Linux และ Steam Deck +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **สำคัญ:** แตกไฟล์ BepInEx ไปที่โฟล์เดอร์เกมของคุณ *โดยตรง* อย่างที่ภาพแสดงข้างบน ถ้าคุณทำมันถูกต้องโฟล์เดอร์เกมของคุณจะดูเหมือนภาพข้างล่าง +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![การลง BepinEx เสร็จสิ้น](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. เปิด Trombone Champ เพื่อเสร็จสินการลง +3. Run Trombone Champ once to complete installation. -## การติดตั้ง +## Installation -และเมื่อ BepInEx ติดตั้ง คุณสามารถดาวน์โหลด Mods ได้ - รายการทั้งหมดมีอยู่ที่ช่อง `#mod-releases` ใน [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -ส่วนนี้จะใช้ [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) เป็นตัวอย่าง ตามที่คุณต้องการที่จะลงเพลงที่กำหนดเอง +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. ไปที่ [โฟล์เดอร์ที่คุณลงเกม](###finding-install-location) แล้วไปที่โฟล์เอดร์ `BepInEx` จากนั้นโฟล์เดอร์ `plugins` +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. กดไปที่ช่องที่อยู่ข้างบนเพื่อที่จะเลือกเส้นทางโฟล์เดอร์สำหรับการลง กด `CTRL`+`C` เพื่อคัดลอกนี้ไปที่คลิปบอรด์ +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![ตัวอย่างการก็อปปี้โฟล์เดอร์เป็นเส้นทาง](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. ดาวน์โหลดไฟล์ .dll ของ Mod ไปที่โฟล์เดอร์ที่สุดกอปปี้ไว้ +3. Download the mod's .dll file into the copied folder. -![ตัวอย่างโฟล์เดอร์ Plugins](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. เปิด Trombone Champ เพื่อที่จะให้ Mod เริ่มต้นไฟล์ที่ต้องการ +4. Run Trombone Champ once to initialize necessary files for that mod. -## เคล็ดลับ สำหรับ Linux และ Steam Deck +## Linux/Steam Deck Tips
                      -ขยาย +Expand -ขั้นตอนการลง BepInEx ส่วนใหญ่จะเหมือนกับ Windows ข้างบน แต่ยังไงก็ตามจะมีบางสิ่งที่ต้องรู้ไว้ก่อน: +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - ผู้ใช้ Steam Deck จะต้องเปลี่ยนเป็น Desktop Mode เพื่อที่จะทำตามคู่มือนี้ โดย กดปุ่ม Power ค้างไว้และเลือก `Desktop Mode` จากเมนู + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - ผู้ใช้ Steam Deck จะต้องติดตั้งเกมไปที่จัดเก็บภายใน เพราะว่า BepInEx จะไม่โหลดจาก microSD card + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - อย่างที่บอกไว้ คุณจะต้องลง BepInEx เวอร์ชั่น `x64` ของ Windows ไม่ใช่เวอร์ชั่น `unix` เพราะว่า Trombone Champ ยังเป็นโปรแกรมของ Windows วิ่งด้วย Proton + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - ไฟล์ เซฟเกม และ บันทึกข้อมูล เก็บอยู่ที่โฟล์เดอร์ Steam ข้างในโฟล์เดอร์ความเข้ากันได้ของ Proton + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - บน Steam Deck หาได้ที่: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - ใน Linux ชนิดอื่นคุณสามารถใช้คำสั่ง `locate -r /Holy Wow$` บนเทอร์มินัลถ้าคุณไม่แน่ใจว่าโฟล์เดอร์ Steam อยู่ที่ไหน + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -คุณจะยังต้องการเพิ่ม `WINEDLLOVERRIDES="winhttp=n,b" %command%` ที่ตัวเลือการเริ่มเกมของคุณ ทำอันนี้โดยการ คลิกขวาที่เกมใน Steam และคลิก `Properties` Proton จะไม่โหลดไฟล์ BepInEx เว้นแต่ว่าจะบอกให้มันโหลด ไม่เหมือนกับ Windows +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![ตัวอย่าง Steam Properties](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -และเมื่อเพิ่ม BepInEx ควรที่จะใช้งานได้ตอนนี้ ลง mods ของคุณ [ตามที่ขั้นตอนข้างบน](##installation) เพื่อที่จะได้เพลงที่กำหนดเองใช้งานได้ +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### วีดีโอพื้นหลัง {docsify-ignore} +### Video Backgrounds {docsify-ignore} -เพลงที่กำหนดเองบางเพลงจะมีพื้นหลังที่เป็นวีดีโอ และ Proton พื้นฐานไม่สารมารถเล่นได้ ถ้าคุณอยากให้มันใช้งานได้คุณสามารถลง `GE-Proton` โดยใช้ [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/) Proton เวอร์ชั่นนี้ได้รวมฟีเจอร์เพิ่มเติมรวมถึงการเล่นรูปแบบวีดีโอที่ Valve ไม่สามารถที่สนันสนุนอยากเป็นทางการได้ +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -เราแนะนำให้ทำตาม [คู่มือนี้สร้างโดย GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) สำหรับการใช้งาน ProtonUp-Qt และติดตั้ง `GE-Proton` +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -!> แม้กระทั่งมี GE-Proton คุณอาจจะยังมีปัญหากับการเล่นวีดีโอขึ้นอยู่กับคอมพิวเตอร์ของคุณ
                      +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## การลงเพลงที่กำหนดเอง {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> ดูที่ [**คู่มือเพลงที่กำหนดเอง**](installing-songs) สำหรับข้อมูลการลงเพลงที่กำหนดเอง \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/th_TH/docs/user-guide/installation/installing-r2modman.md b/translations/th_TH/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/th_TH/docs/user-guide/installation/installing-r2modman.md +++ b/translations/th_TH/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/th_TH/docs/user-guide/installation/installing-songs.md b/translations/th_TH/docs/user-guide/installation/installing-songs.md index 860c1f1a7f..0e62cc8294 100644 --- a/translations/th_TH/docs/user-guide/installation/installing-songs.md +++ b/translations/th_TH/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # การลงเพลงที่กำหนดเอง --- -?> ถ้าคุณอยากได้วิธีแบบวีดีโอ VorgunTheBeta มี [วีดีโออธิบายวิธีการลง mods และ การลงเพลงกำหนดเอง](https://youtu.be/pSwNSGx-P5c) +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **สำคัญ:** ให้คุณแน่ใจว่าคุณทำตาม [คู่มือการลง Mod](installing-mods) เพื่อที่จะลง BepInEx และ TrombLoader ก่อนที่จะดำเนินการต่อไป! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## การหาเพลง @@ -14,7 +14,7 @@ 1. ดาวน์โหลดเพลงกำหนดเอง มันจะเป็นไฟล์บีบอัดโดยทั่วไป ส่วนใหญ่ลงท้ายด้วย `.zip` -2. แตกไฟล์บีบอัดไปที่ข้างในโฟล์เดอร์ที่ได้มาจากการเริ่มเกมครั้งแรกด้วย TrombLoader ที่ `BepInEx/CustomSongs` โดยตรง +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![ตัวอย่างการแตกไฟล์ BepInEx](../docs/files/customsongextract.png) diff --git a/translations/th_TH/docs/user-guide/installation/migration.md b/translations/th_TH/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/th_TH/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/th_TH/docs/user-guide/introduction.md b/translations/th_TH/docs/user-guide/introduction.md index 750f8102b2..40b553db4d 100644 --- a/translations/th_TH/docs/user-guide/introduction.md +++ b/translations/th_TH/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ Trombone Champ เป็นเกมเพลงโง่ๆ จาก Holy Wow ?> **การช่วยเหลือใน Discord** สำหรับการสนันสนุนแบบสดๆกับคู่มือนี้ได้โปรดไปที่ช่อง **#modding-support** ใน [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) และถามสำหรับการช่วยเหลือ ได้โปรดอ่านหน้า [คำถามที่พบบ่อย](faq) ของเราและดูว่าคำถามนั้นได้มีคำตอบหรือยัง -> ### [![โลโก้ Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**การลง Mods**](installing-mods) +> ### [![โลโก้ Steam](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![โลโก้ Apple Music](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**การลงเพลงที่กำหนดเอง**](installing-songs) > diff --git a/translations/uk_UA/docs/sidebar.md b/translations/uk_UA/docs/sidebar.md index b963184eeb..71385f357d 100644 --- a/translations/uk_UA/docs/sidebar.md +++ b/translations/uk_UA/docs/sidebar.md @@ -1,14 +1,15 @@ - **Посібник користувача** - [Введення](./) - **Модування** -- [Встановлення модів](installing-mods) -- [Встановлення пісень](installing-songs) - [Using r2modman](installing-r2modman) +- [Встановлення пісень](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **Чартинг** - [Створення чартів](creating-charts) - [Charting Guidelines](charting-guidelines) - [Фон чартів](chart-backgrounds) - [Додаткова інформація по чартингу](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **Додатково** @@ -16,5 +17,5 @@ - **Посилання** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![Переклад](https://icongr.am/material/translate.svg?color=808080&size=16)Переклад](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)Переклад](https://crowdin.com/project/trombone-champ-modding-wiki) - [Про](about) diff --git a/translations/uk_UA/docs/user-guide/charting/chart-troubleshooting.md b/translations/uk_UA/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/uk_UA/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/uk_UA/docs/user-guide/charting/charting-guidelines.md b/translations/uk_UA/docs/user-guide/charting/charting-guidelines.md index 58072b78cb..3a53f1bd66 100644 --- a/translations/uk_UA/docs/user-guide/charting/charting-guidelines.md +++ b/translations/uk_UA/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ The following guidelines are not absolute requirements. The goal is to make a chart that's fun to play. If ignoring these rules make a chart more enjoyable or engaging (e.g. Rush E), you are welcome to do so. Credits: tsunderestorm, StaticR. ## Best Practices +- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. +- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. +- Do not start nor end abruptly. + - Give at least one bar of rest before the first note, and continue your chart until the end of the song. + - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. +- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. +- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- Avoid excessively long rest sections. +### Note Spacing - Maintain note spacing appropriate for the difficulty. - As a very general guideline, the note and space between it and the next note should be of equal length - **IDEAL**: @@ -14,11 +24,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - to emphasize [articulation](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html) like slurs, staccato, or legato - to make it easier to maintain combo on very fast sections - if the song tempo is very slow and a tight spacing is adequate -- Do not be off-key. If you have a poor sense of tone, ask #charting or #wip to take a look. -- Do not be off-beat. You can slow the song down in your editor to help distinguish faster rhythms. -- Do not start nor end abruptly. - - Give at least one bar of rest before the first note, and continue your chart until the end of the song. - - Adjust the length / song endpoint if the curtains are closing slightly before the background track ends. Do not to set the song endpoint in the tmb to be longer than the song length, or the song won't end. - The rhythm should be visually intuitive. If notes are slightly longer, they should be slightly longer visually. If notes are slightly shorter, they should be slightly shorter visually. - **IDEAL**: (easy to see which are eighth notes and which are dotted eighth (3/16) notes) - ![Ideal Visual Rhythm](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 120~200, depending on song complexity. A good guideline is `100/[BPM]*280`. - This should be fast enough for the rhythm to be visually intuitive and slow enough that the player has time to react. - This value does not have to be the same as the tempo! -- A note can be held for 4.5 seconds before running out of breath. If you have a note or slide longer than that, it's recommended to break it up so the player can catch their breath. -- Chords typically consist of 3-4 notes. The highest or lowest note usually sounds the cleanest to chart. - -### Looping Tracks -- A few repetitions are fine, but avoid repeating the same note pattern over and over. - - You can look for a TV version or edit it yourself if you want a shorter version of the song. - - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: - - Often, there's a primary and secondary melody. - - Follow the chords or bassline. - - Play it in a different octave. - - If you know what you're doing musically, use different chords or harmonies. - - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. -- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. -- You may choose to add a full or partial loop if there are different parts to play in a section. -- Ending a track that endlessly loops can be hard. Suggestions: - - End at the end without any loop back. - - End at the first beat, chord, or section of the loop. - - Fade the music out at the end of a musical phrase. ### Slides - Avoid 90 degree slide angles. @@ -60,14 +47,14 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Start the slide about one 16th note before the target beat. It'll still be fine if half the note is a slide. - For 8th note slides or shorter, you don't need to include a held note in the middle. - You often don't need a held note at the slide start, middle or end at all, unless you want the note to be clearly held for an 8th note or longer. -- Simplify slides for a consistent stream of notes going up or down. +- When charting runs, simplify slides for a consistent stream of notes going up or down. - Instead, you can just do one single slide and pull back the end point until the slide curve matches the notes. - Making each individual note part of the slide will make the slide very wobbly. You can make an exception if you specifically want the slide to look like this or the note shape is too complex to estimate with one slide. - Vibrato or trill type slides work great if they connect in the middle of the note. - Generally, slides are cleaner with fewer connecting points. - In a very slide heavy track, setting the color to a solid color instead of a 2 color gradient could look way cleaner. - If you want clean slides with a midi converter, use [TCCC](https://rshieldsprojects.github.io/projects/tccc/)'s custom slide method. -- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen +- Slides can only go 1 octave both up and down from the starting note. If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - You can connect multiple notes at the same pitch as a slide. This plays as one continuous held note. This boosts combo count and champ meter extremely quickly, which may be useful for certain effects and gimmicks, but you wouldn't want to use it outside of that. - Good slide timings seem to be about 2:1 to 5:1 (slide end late by about half to one 5th of the length of the slide) - 1:1 works too for things like trills or vibrato. @@ -75,6 +62,28 @@ The following guidelines are not absolute requirements. The goal is to make a ch - 2 16th notes or shorter connected work completely fine with only one slide, there doesn't need to be any held for it to sound ok, unless it is a very large jump. - Slide ends don't need a held part, they're fine just ending a bit early (if the slide end is already delayed by the appropriate amount) +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### Looping Tracks +- A few repetitions are fine, but avoid repeating the same note pattern over and over. + - You can look for a TV version or edit it yourself if you want a shorter version of the song. + - Generally, it flows best if you chart the easier or more expected parts in the first play, and switch to alternatives: + - Often, there's a primary and secondary melody. + - Follow the chords or bassline. + - Play it in a different octave. + - If you know what you're doing musically, use different chords or harmonies. + - You may want to reverse this if the main part serves as a high point in the music. Musical high points typically fit best at around the last third or quarter of the entire track, so structuring a loop like that can make it feel more complete. +- Really short tracks are best looped until about 1 to 1:30 minutes, unless they are really repetitive. +- You may choose to add a full or partial loop if there are different parts to play in a section. +- Ending a track that endlessly loops can be hard. Suggestions: + - End at the end without any loop back. + - End at the first beat, chord, or section of the loop. + - Fade the music out at the end of a musical phrase. + ## Technical Requirements - Don't just convert the .mp3 to .mid. This converts all the instruments, but we can only play one note at a time. Finding a MIDI online would also likely not work without a lot of editing. - Have [beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers that line up with the background audio (unless the song has a varying tempo). @@ -82,7 +91,6 @@ The following guidelines are not absolute requirements. The goal is to make a ch - Ensure that the chart is perfectly synced with the background audio. - Use [AutoToot](https://github.com/TomDotBat/AutoToot) or [Boner Viewer](https://paturages.github.io/boner-viewer/) and listen if the notes are consistently early or late. - Set a difficulty rating consistent with [TootTally](https://toottally.com/upload/). -- Avoid excessively long rest sections. - Have a relevant background. A static PNG background is OK. - Have good visual contrast between the notes and the background. - If necessary, reduce the loudness of the song (via Audacity, etc.) so that the trombone sound can be clearly heard over the background track. diff --git a/translations/uk_UA/docs/user-guide/charting/creating-charts.md b/translations/uk_UA/docs/user-guide/charting/creating-charts.md index 19bdb546a5..fab5cd918e 100644 --- a/translations/uk_UA/docs/user-guide/charting/creating-charts.md +++ b/translations/uk_UA/docs/user-guide/charting/creating-charts.md @@ -7,14 +7,14 @@ ### Midi-редактор/DAW Чарти зроблені шляхом створення midi файлу та їх конвертування через [MIDI конвертор](#converting-midi-to-map-file). -Ноти у Midi файлі мають бути в діапазоні від 47 до 73 для сходження з грою.
                      **ПРИМІТКА:** Різні редактори використовують різні значення на фортепіано для цього діапазону. +Midi notes should be in the range 47 to 73 to match the game.
                      **NOTE:** Different editors use different values on the piano for this range. Деякі безкоштовні та перевірені Midi-редактори: -- [Reaper](https://www.reaper.fm/download.php)* (Діапазон: B2-C#5) -- [LMMS](https://lmms.io/download#windows) (Діапазон: B2-C#5) -- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Діапазон: B3-C#6) -- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Діапазон: B3-C#6) -- [Ableton](https://www.ableton.com/en/trial/)* (Діапазон: B1-C#4) +- [Reaper](https://www.reaper.fm/download.php)* (Range: B2-C#5) +- [LMMS](https://lmms.io/download#windows) (Range: B2-C#5) +- [FL Studio](https://www.image-line.com/fl-studio-download/)*† (Range: B3-C#6) +- [Cakewalk](https://www.bandlab.com/products/cakewalk)** (Range: B3-C#6) +- [Ableton](https://www.ableton.com/en/trial/)* (Range: B1-C#4) - [Sekaiju](http://openmidiproject.osdn.jp/Sekaiju_en.html) - [Trombone Charter](https://github.com/towai/TromboneCharter/releases/latest) @@ -80,20 +80,10 @@ Converting Midi to Map File -

                      - ?> There are two Midi converters available besides Midi2TromboneChamp!
                      The process for these new converters is similar enough that this guide should still be usable.
                      If you want to try a more up-to-date conversion program, feel free to give a new converter a try:

                      Midi2TromboneChamp (Unity Version) - a unity-based sequel to Midi2TromboneChamp.
                      Trombone Champ Chart Converter - a web-based alternative with new features. -

                      -

                      1. - Go to https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest and click Midi2TromboneChamp.exe to download it. -

                        -
                        2. - -
                      2. -

                        - Run it. In the file selector it opens, select your midi file. Click Open. + Go to Trombone Champ Chart Converter.

                        3. @@ -103,19 +93,19 @@

                        • - Song Name is the full name of the song, shown in the info when you select it in-game . + Song Name is the full name of the song, shown in the info when you select it in-game.
                        • Short Name is shown while scrolling through the song list. Text gets smaller when the name is long so I'm not sure if there's a maximum length.
                        • - Folder Name is the name of the folder you will put your map and song file in. E.g. If you set Folder Name to my map, your map path will be BepInEx/CustomSongs/my map/song.tmb. + Release Year is the year the song was created.
                        • - Year is the year the song was created. + Artist is the composer of the song.
                        • - Author is the composer of the song. + Beats per Bar determines how far apart the "beat lines" are.
                        • Difficulty is the number of difficulty stars that appear on the song's info. @@ -124,17 +114,17 @@ Note Spacing affects how fast the level scrolls, in combination with BPM.
                        • - Song Endpoint is the beat on which the song ends. It is automatically calculated, but you can adjust it to change when the level end screen appears. + Folder Name is the name of the folder you will put your map and song file in. E.g. If you set Folder Name to my map, your map path will be BepInEx/CustomSongs/my map/song.tmb.
                        • - Beats per Bar determines how far apart the "beat lines" are. + Song Endpoint is the beat on which the song ends. It is automatically calculated, but you can adjust it to change when the level end screen appears.

                      3. - Hit OK. In the file selector it opens, create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder. + Hit OK. Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

                        4. diff --git a/translations/uk_UA/docs/user-guide/installation/installing-r2modman.md b/translations/uk_UA/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/uk_UA/docs/user-guide/installation/installing-r2modman.md +++ b/translations/uk_UA/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/uk_UA/docs/user-guide/installation/installing-songs.md b/translations/uk_UA/docs/user-guide/installation/installing-songs.md index e765781a58..4c4e4205ba 100644 --- a/translations/uk_UA/docs/user-guide/installation/installing-songs.md +++ b/translations/uk_UA/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # Installing Songs --- -?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-mods) to install BepInEx and TrombLoader before continuing! +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## Finding Songs @@ -14,7 +14,7 @@ If you'd like a more compact list, TheGlitched64 has created [a spreadsheet cont 1. Download the custom song - it will generally be some kind of archive file, usually ending in `.zip`. -2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder that got created when you first ran the game with TrombLoader installed. +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![BepInEx Extraction Preview](../docs/files/customsongextract.png) diff --git a/translations/uk_UA/docs/user-guide/installation/migration.md b/translations/uk_UA/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/uk_UA/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/uk_UA/docs/user-guide/introduction.md b/translations/uk_UA/docs/user-guide/introduction.md index bc4f8a1e16..1a5387a8b6 100644 --- a/translations/uk_UA/docs/user-guide/introduction.md +++ b/translations/uk_UA/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ This wiki serves as a source of documentation and tutorials for various unoffici ?> **Discord Help** For live support with this guide please visit us in **#modding-support** on the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ) and ask for assistance. Please read our [Frequently Asked Questions](faq) page beforehand to see if your question has already been answered. -> ### [![Steam Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-mods) +> ### [![Steam Logo](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Apple Music Logo](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Custom Songs**](installing-songs) > diff --git a/translations/zh_CN/docs/sidebar.md b/translations/zh_CN/docs/sidebar.md index 41a60c304f..b9497eefff 100644 --- a/translations/zh_CN/docs/sidebar.md +++ b/translations/zh_CN/docs/sidebar.md @@ -1,14 +1,15 @@ - **用户指南** - [首页](./) - **模组板块** -- [安装模组](installing-mods) -- [安装自制谱](installing-songs) - [Using r2modman](installing-r2modman) +- [安装自制谱](installing-songs) +- [Upgrading to TrombLoader 2](migrating-to-v2) - **自制谱板块** - [创作自制谱](creating-charts) - [谱面制作指导](charting-guidelines) - [自制谱背景](chart-backgrounds) - [其他自制谱信息](misc-charting-info) +- [Chart Troubleshooting](chart-troubleshooting) - **Developers** - [Writing Mods](writing-mods) - **其他** @@ -16,5 +17,5 @@ - **链接** - [![Discord](https://icongr.am/simple/discord.svg?colored&size=16)Discord](https://discord.gg/KVzKRsbetJ) - [![GitHub](https://icongr.am/simple/github.svg?color=808080&size=16)GitHub](https://github.com/tc-mods/TromboneChampModdingWiki) -- [![翻译](https://icongr.am/material/translate.svg?color=808080&size=16)翻译](https://crowdin.com/project/trombone-champ-modding-wiki) +- [![Translate](https://icongr.am/material/translate.svg?color=808080&size=16)翻译](https://crowdin.com/project/trombone-champ-modding-wiki) - [关于我们](about) diff --git a/translations/zh_CN/docs/user-guide/charting/chart-troubleshooting.md b/translations/zh_CN/docs/user-guide/charting/chart-troubleshooting.md new file mode 100644 index 0000000000..b592993ee6 --- /dev/null +++ b/translations/zh_CN/docs/user-guide/charting/chart-troubleshooting.md @@ -0,0 +1,36 @@ +# Chart Troubleshooting +--- + +Trying to make a chart but something's going wrong? Check if your problem is solved here. + +### My chart won't start in Trombone Champ! I can control the Tromboner but I can't pause + +Issues like this are usually related to your `song.ogg` file. Ensure that you have a `song.ogg`, and that it is longer than your chart file. Add a few seconds of silence to the end of `song.ogg` if necessary. + +### My chart freezes at the end or part way through and I can't pause, but I can still control the tromboner + +See above (My chart won't start in Trombone Champ!) + +### I hit a certain note, Trombone Champ lagged or froze, the song ended and now I have -3 billion toots?? (or Autotoot got an F/score of 0) + +This is likely due to a small ghost note hiding in the spot where the game froze. Check your MIDI file for a note hiding under the note you want in the chart, or check that spot for something funky in Trombone Charter/BonerViewer. Sometimes it will show up in one program but not another. Play the broken chart again and you can get your toots back. In old versions of Trombone Champ, this was similar to an issue with tap notes. Check if you're up to date! + +### Certain spots in my chart always break combo, even when Autotoot plays it + +Check for ghost notes hiding under your main notes in those spots! Check your MIDI, Trombone Charter, and/or BonerViewer. They may show up with one program but not another. Remember that autotoot isn't perfect. You can change some of the settings in its config file to try to make it more accurate, but sometimes it just can't keep up with very fast notes. + +### My chart doesn't show up in the track list + +Ensure that your chart has a unique `trackref`. Open the tmb file with notepad, press Ctrl+F, and search for `trackref`. If the `trackref` value is something not unique (e.g. `trombonecharter_x64` or a common song name), change it to something that won't be confused with another chart. If you are concerned that you may have multiple charts installed with duplicate trackrefs, you can try running [Guardie's trackref duplicate finder](https://github.com/Guarde/TrackRef-Checker/releases/latest) in your customsongs folder. + +### My chart background is small and has a gray border around it + +Ensure that your background has dimensions of 1920 x 1080. + +### My chart background doesn't show up at all + +Ensure that your background is named `bg.png` (if it's an image), `bg.mp4` (if it's a video), or `bg.trombackground` (if it's a TromBackground) + +### I'm still having problems + +If you are still having problems, you may want to consider asking for help in the Trombone Champ Modding Discord server. Be prepared to send the `LogOutput.log` file from your BepInEx folder so we can take a look at what happened when the game broke. diff --git a/translations/zh_CN/docs/user-guide/charting/charting-guidelines.md b/translations/zh_CN/docs/user-guide/charting/charting-guidelines.md index add074600c..eec9f2e6c0 100644 --- a/translations/zh_CN/docs/user-guide/charting/charting-guidelines.md +++ b/translations/zh_CN/docs/user-guide/charting/charting-guidelines.md @@ -3,7 +3,17 @@ 以下内容仅为指导意见，并非绝对的硬性要求。 一切指导意见的最终目的都是制作一个游玩体验足够优秀的自制谱面。 如果忽略这些意见能够使你的谱面更有趣或者更具有吸引力（例如 Rush E），那么按照您自己的方式去制作即可。 编写者: tsunderestorm, StaticR. （译者：Bilibili@银狐V933 Discord@SilverFoxV933，以下内容较为抽象，看不懂不要太在意，实在想了解可以来b站直接与我交流。译者从未系统学过乐理相关知识。对于部分用词不准确或混乱的情况，还望海涵。） ## 游玩体验最佳化 +- 请勿跑调。 如果您音感不佳，可以向#charting或#wip请求协助。 +- 请注意节奏。 您可以在编辑谱面时适当减慢乐曲的速度以应对较快的节奏。 +- 开始与结束应尽可能自然。 + - 在第一个note之前留出至少一个小节的空白距离，并保证你的谱面能持续到乐曲结束。 + - 在谱面的.tmb文件中调整谱面的结束点（endpoint）以确保结算画面不会过早出现。 结束点推荐设置在乐曲最后一个音结束到乐曲文件结束之间。不要设置在乐曲文件结束之后，会导致无法结算。 +- 一个长note的极限长度为4.5秒，超过这个时间会触发强制的换气惩罚。 推荐对超过这个时间的长note进行拆分以便玩家有时间换气。 +- 和弦通常包含3到4个note。 选择最高或最低的note写入谱面，效果最好。 +- Trombone Champ DOES support decimal BPMs. Trombone Charter, however, does not, so you will need to edit a decimal BPM into the .tmb another way. +- 避免出现过长的休息段。 +### Note Spacing - 保证note间距与难度相匹配 - 通常情况下，note与note之间的间隔应该与note本身同长。 - **正面示例**: @@ -14,11 +24,6 @@ - 突出表达音调的[连续性](https://people.carleton.edu/~jellinge/m101s12/Pages/04/04Articulation.html)。比如连奏，断奏和延长音 - 在较快速的段落简化谱面以保持Combo。 - 曲目的节奏较慢，以至于可以使用较紧凑的note排布。 -- 请勿跑调。 如果您音感不佳，可以向#charting或#wip请求协助。 -- 请注意节奏。 您可以在编辑谱面时适当减慢乐曲的速度以应对较快的节奏。 -- 开始与结束应尽可能自然。 - - 在第一个note之前留出至少一个小节的空白距离，并保证你的谱面能持续到乐曲结束。 - - 在谱面的.tmb文件中调整谱面的结束点（endpoint）以确保结算画面不会过早出现。 结束点推荐设置在乐曲最后一个音结束到乐曲文件结束之间。不要设置在乐曲文件结束之后，会导致无法结算。 - 谱面节奏应足够直观。 如果一个note略微更长，这种长度区别在实际游玩时应该能被明显地辨认出。 短note同理。 - **正面示例**: （可以直观的分辨note的长短） - ![理想的节奏视觉表现](../docs/files/charting/ideal-visual-rhythm.png) @@ -28,24 +33,6 @@ - 通常在120~200的区间内，取决于谱面的复杂程度。 推荐使用 `100/[BPM]*280`. - 理想的谱面流速，应该是能让谱面的节奏得以直观展现的同时，足以让玩家有时间对谱面作出反应。 - 这个值不必与BPM相同！ -- 一个长note的极限长度为4.5秒，超过这个时间会触发强制的换气惩罚。 推荐对超过这个时间的长note进行拆分以便玩家有时间换气。 -- 和弦通常包含3到4个note。 选择最高或最低的note写入谱面，效果最好。 - -### 乐曲结构 -- 允许存在一定的重复。但要避免同一个note排布过度反复地出现。 - - 选曲时，可以考虑选择TV版（如果有的话），或亲手编辑以获得较短版本的乐曲。 - - 通常情况下，在两个重复的段落中，首段采用较为简单或较为明显的部分来作谱，复段则采用其他部分，这类分配效果最好。 - - 一个乐曲段落通常由主副两段旋律（或多段）合成。 - - 尝试采用和弦或低音声部。 - - 高（或低）一个八度来演奏。 - - 如果您对您的乐感比较有自信，可以尝试自己编写合适的和声。 - - 应尽可能避免乐曲的高潮桥段出现的过早。 音乐高点通常最适合出现在整个曲目的最后三分之一或四分之一左右，照此调整整个乐曲的结构可以让乐曲显得更加完整。 -- 较短的乐曲应该循环至1:00到1:30之间，除非重复性过高。 -- 如果您对某个段落打算编写多个不同的排布，您可以选择对其添加一个完整或部分的循环。 -- 对于一个无限循环的乐曲来说，可能会较难寻找结束点。 建议您： - - 在单次循环结束时直接结束，不做任何循环。 - - 在循环的第一个节奏点，第一个和弦或第一个小节结束循环。 - - 在乐曲末尾添加淡出效果。 ### 滑动（slide）note - 避免出现接近90度的滑动操作。 @@ -60,14 +47,14 @@ - 滑动部分的起始点提前1/16音符。 适合滑动note中滑动部分占比超过一半的情况。 - 对于等于或短于1/8音符的滑动note，不建议滑动部分中间分段。 - 一个滑动note可以不在开始，中途或结束保留任何非滑动部分。 -- 简化滑动note，减少多余的波动。 +- When charting runs, simplify slides for a consistent stream of notes going up or down. - 同方向的多段滑动可以合并为单个滑动，通过调整滑动部分结束点来与实际的音调匹配。 - 一段滑动中每一个note都保留会使得滑动部分过于波动。 尽量避免这种情况，除非您有意为之或原曲音调过于复杂无法用单个滑动来表现。 - 抖动音或颤音建议从每个音的中间进行连接。 - 通常情况下，分段越少的滑动效果越好。 - 如果谱面中滑动轨道较多，建议设置note颜色时头尾选择相同的颜色，可增强谱面观感。 - 除了旧有的滑动note编写方式，还可以尝试 [TCCC](https://rshieldsprojects.github.io/projects/tccc/)转换器采用的新的编写方式，对于编写滑动note有一定的帮助。 -- 滑动note滑动的最大范围为一个八度。 如果需要更大的滑动范围，可以考虑从中间断开并/或找到一个合适的起始位置可以向屏幕中线滑动。 +- 滑动note滑动的最大范围为一个八度。 If you want a chart a slide that spans a greater range, you can break it up in between and/or find a place where you can start the slide towards the middle of the screen. - 您无法将同音高的note连接成滑动note。 这种情况下游玩起来与普通长note相同。 与普通长note不同的是它可以以极快的速度累积Combo数，在某些特殊场合可能会比较有用，但也仅此而已，不应滥用。 - 适宜的滑动note时间比例通常为2:1到5:1（滑动部分的结束点延后一般到五分之一的整个滑动note长度）。 - 1:1 通常适用于抖动音或颤音。 @@ -75,6 +62,28 @@ - 1/8或更短音符仅需单个滑动部分即可，不需要额外在中间放置note分段就可以有不错的听感，除非是大范围的跳跃。 - 滑动note的结尾不必保留停顿的部分，在滑动部分的结束点已经按照前文所说提前了的情况下已经不在需要额外保留停顿。（译者注：以上内容看不懂也没关系，多写写就懂了。其实我很多也不懂……） +### Tap Notes +- Tap notes or dot notes are notes that show up as a single dot on screen. +- You can create tap notes by setting the note duration to be 0.06 or below. + - The exact value you choose affects how many points the note will give and how wide of a time window the user has to hit the note. For this reason, it is recommended to always set tap note values to 0.06 for maximum ease of playability. +- Note that for most users, tap notes tend to be very difficult to accurately hit. Ideally, tap notes should only be used in places where the spacing does not allow for short held notes to be used instead. + +### 乐曲结构 +- 允许存在一定的重复。但要避免同一个note排布过度反复地出现。 + - 选曲时，可以考虑选择TV版（如果有的话），或亲手编辑以获得较短版本的乐曲。 + - 通常情况下，在两个重复的段落中，首段采用较为简单或较为明显的部分来作谱，复段则采用其他部分，这类分配效果最好。 + - 一个乐曲段落通常由主副两段旋律（或多段）合成。 + - 尝试采用和弦或低音声部。 + - 高（或低）一个八度来演奏。 + - 如果您对您的乐感比较有自信，可以尝试自己编写合适的和声。 + - 应尽可能避免乐曲的高潮桥段出现的过早。 音乐高点通常最适合出现在整个曲目的最后三分之一或四分之一左右，照此调整整个乐曲的结构可以让乐曲显得更加完整。 +- 较短的乐曲应该循环至1:00到1:30之间，除非重复性过高。 +- 如果您对某个段落打算编写多个不同的排布，您可以选择对其添加一个完整或部分的循环。 +- 对于一个无限循环的乐曲来说，可能会较难寻找结束点。 建议您： + - 在单次循环结束时直接结束，不做任何循环。 + - 在循环的第一个节奏点，第一个和弦或第一个小节结束循环。 + - 在乐曲末尾添加淡出效果。 + ## 技术性要求 - 请勿直接将.mp3转换为.mid（译者注：即自动扒谱）。 这类转换通常无法提取出单独的某一种乐曲或声部，而我们在游戏中一次只能弹奏一个note。 即便寻找现成的midi文件，在放入转换器转换为可玩的谱面之前通常也免不了大量的编辑。 - 在转换谱面时记得设定小节线（[beat](https://en.wikipedia.org/wiki/Beat_(music)#On-beat_and_off-beat) markers）并与音乐对齐，除非乐曲的bpm有变化。 @@ -82,7 +91,6 @@ - 保证谱面与乐曲的同步性。 - 使用 [AutoToot](https://github.com/TomDotBat/AutoToot) 或[Boner Viewer](https://paturages.github.io/boner-viewer/) 检验谱面中的note是否有持续性的提前或延后现象。 - 使用[TootTally](https://toottally.com/upload/)来给你的谱面进行难度定级。 -- 避免出现过长的休息段。 - 记得添加一个合适的背景。 一个静态PNG图片就足够了。 - 谱面上的note在背景上应有足够的辨识度，可以考虑调整note颜色或将背景略微调暗。 - 如有必要，减小乐曲的音量（使用Audacity或其他）以保证长号的声音能被清晰地听到。 diff --git a/translations/zh_CN/docs/user-guide/charting/creating-charts.md b/translations/zh_CN/docs/user-guide/charting/creating-charts.md index 8c6bc22c27..d6cb6cc9ec 100644 --- a/translations/zh_CN/docs/user-guide/charting/creating-charts.md +++ b/translations/zh_CN/docs/user-guide/charting/creating-charts.md @@ -80,20 +80,10 @@ Midi文件中的音符应该在47到73的范围内以匹配游戏内的音高范 转换Midi文件为谱面文件 -

                        - ?> 除了Midi2TromboneChamp以外，还有两个Midi转换器可用！
                        这些新转换器的使用流程足够相似，本指南仍然可以使用。
                        如果您想尝试这些更新的转换程序，请看这里：

                        Midi2TromboneChamp(Unity 版本) - 一个使用Unity编写的Midi2TromboneChamp。
                        Trombone Champ Chapt Converter - 一个有新功能的网页版转换器。 -

                        -

                        1. - 前往 https://github.com/SockHungryClutz/Midi2TromboneChamp/releases/latest并点击 Midi2TromboneChamp.exe 进行下载。 -

                          -
                          2. - -
                        2. -

                          - 运行它。 在打开的文件选择其中选择你的Midi文件。 点击Open。 + Go to Trombone Champ Chart Converter.

                          3. @@ -103,19 +93,19 @@ Midi文件中的音符应该在47到73的范围内以匹配游戏内的音高范

                          • - Song Name 是歌曲的全名，当您在游戏中选择这个谱面时，这一条会显示在左上角。 + Song Name is the full name of the song, shown in the info when you select it in-game.
                          • Short Name 该内容会显示在曲目滚动列表中. 名称过长时文本字号会相应变小，所以无法确定是否存在长度上限。
                          • - Folder Name 是您用来存储谱面和歌曲文件的文件夹的名称。 举例： 如果您将文件夹名称设置为“我的自制谱”，您的自制谱路径将是 BepInEx/CustomSongs/我的自制谱/song.tmb。 + Release Year is the year the song was created.
                          • - Year是曲目的创作年份。 + Artist is the composer of the song.
                          • - Author 是乐曲的作者。 + Beats per Bar 决定游玩谱面时屏幕上显示的节拍线之间的距离。
                          • Difficulty 是歌曲信息上出现的难度星级。 @@ -124,17 +114,17 @@ Midi文件中的音符应该在47到73的范围内以匹配游戏内的音高范 Note Spacing 影响游戏内note的移动速度，通常与BPM对应.
                          • - Song Endpoint 是曲目结束时的节奏点。 这个值通常由软件自动计算，但是你可以调整这个数值来改变结算界面的出现时机。 + Folder Name 是您用来存储谱面和歌曲文件的文件夹的名称。 举例： 如果您将文件夹名称设置为“我的自制谱”，您的自制谱路径将是 BepInEx/CustomSongs/我的自制谱/song.tmb。
                          • - Beats per Bar 决定游玩谱面时屏幕上显示的节拍线之间的距离。 + Song Endpoint 是曲目结束时的节奏点。 这个值通常由软件自动计算，但是你可以调整这个数值来改变结算界面的出现时机。

                        3. - 点击OK。 在出现的文件选择器中，创建一个与您输入的 Folder Name 字段相同的文件夹，并将文件命名为 song.tmb后放入文件夹中 。 + 点击OK。 Create a folder with the same name as you entered in the Folder Name field, and save the file as song.tmb inside that folder.

                          4. diff --git a/translations/zh_CN/docs/user-guide/installation/installing-mods.md b/translations/zh_CN/docs/user-guide/installation/installing-mods.md index 5f871f684c..b207428557 100644 --- a/translations/zh_CN/docs/user-guide/installation/installing-mods.md +++ b/translations/zh_CN/docs/user-guide/installation/installing-mods.md @@ -1,83 +1,83 @@ -# 安装mod +# Installing Mods --- -?> 如果需要视频教学, 可参考VorgunTheBeta 的[mod安装与自制曲目导入指南](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, VorgunTheBeta has [a video explaining how to install mods and custom songs](https://youtu.be/pSwNSGx-P5c). -?> 本指南的前半部分也适用于Linux和Steam Deck！ 请务必查看 [结尾](#linuxsteam-deck-specific-tips)以确认关于这两个运行环境的更多信息。 +?> The start of this guide also works for Linux and Steam Deck! Make sure to [read the end](#linuxsteam-deck-specific-tips) for additional details. -## 寻找安装位置 -1. 打开Steam并右键点击Trombone Champ。 在右键菜单中选择 `管理 > 浏览本地文件`。 +## Finding Install Location +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. -![右键菜单预览](../docs/files/localfilescontext.png) +![Right-click Menu Preview](../docs/files/localfilescontext.png) -2. 在弹出的文件浏览界面中点击顶部地址栏并选中文件夹路径。 点击`CTRL`+`C`将这个路径复制到剪贴板。 +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![复制文件夹路径预览](../docs/files/copyfolderpath.png) +![Copy Folder Path Preview](../docs/files/copyfolderpath.png) -## 安装BepInEx +## Installing BepInEx -1. 下载[BepInEx](https://github.com/BepInEx/BepInEx/releases/latest)到你的TromboneChamp文件夹。 选择 `BepinEx_x64_VERSION.zip`，其中`VERSION`为版本号。 -2. 直接解压压缩包内的文件并放入Trombone Champ的 [文件夹](##finding-install-location)。 +1. Download [BepInEx](https://github.com/BepInEx/BepInEx/releases/latest) into your TromboneChamp folder. You will want to get `BepinEx_x64_VERSION.zip`, with `VERSION` being the version number. +2. Extract the contents of the BepInEx .zip file directly into the [install folder](##finding-install-location) of your Trombone Champ installation. -![BepInEx 解压缩预览](../docs/files/bepinexextract.png) +![BepInEx Extraction Preview](../docs/files/bepinexextract.png) -!> 请确认你下载的BepInEx为 `x64`版本， `unix` 与`x86`版本会导致你的游戏无法正常运行。 这也适用于Linux/Steam Deck的用户。 +!> Please ensure that you've downloaded the `x64` version of BepInEx. the `unix` and `x86` versions will cause your game to not function properly. This also applies to users on Linux/Steam Deck. -!> **注意:** 如上图所示将 BepInEx *直接*解压 到你的游戏安装文件夹， 如果操作正确，你的游戏安装文件夹会与下图相同。 +!> **IMPORTANT:** Extract BepInEx *directly* into your game's folder as shown in the image above. If you've done it correctly, your game's folder should look like the below image. -![BepinEx 安装完成](../docs/files/finishedbepinex.png) +![Finished BepinEx Install](../docs/files/finishedbepinex.png) -3. 运行一次Trombone Champ来完成安装。 +3. Run Trombone Champ once to complete installation. -## 安装mod +## Installation -BepInEx安装完成之后，你就可以开始下载一些特定的mod了。[Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ)的`#mod-releases`频道有一份mod清单可供参考。 +With BepInEx installed, you can start downloading specific mods - a full list is available in the `#mod-releases` channel in the [Trombone Champ Modding Discord](https://discord.gg/KVzKRsbetJ). -考虑到你大概率想要安装自制谱面，本节将以 [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest)作为例子。 +As you likely want to install custom songs, this section will use [TrombLoader](https://github.com/NyxTheShield/TrombLoader/releases/latest) as an example. -1. 打开你的[游戏安装文件夹](###finding-install-location)，再打开 `BepInEx`文件夹，然后进入`plugins` 文件夹。 +1. Navigate to your [game's install folder](###finding-install-location), the `BepInEx` folder, then the `plugins` folder. -2. 点击顶部地址栏并选中文件夹路径， 点击`CTRL`+`C` 将这个路径复制到剪贴板。 +2. Click the address bar at the top to select your installation folder's path. Hit `CTRL`+`C` to copy this to your clipboard. -![复制文件夹路径预览](../docs/files/copyfolderpathplugins.png) +![Copy Folder Path Preview](../docs/files/copyfolderpathplugins.png) -3. 下载mod的 .dll 文件到复制的文件夹。 +3. Download the mod's .dll file into the copied folder. -![Plugins文件夹预览](../docs/files/pluginswithtrombloader.png) +![Plugins Folder Preview](../docs/files/pluginswithtrombloader.png) -4. 运行一次Trombone Champ 来初始化该模组的必要文件。 +4. Run Trombone Champ once to initialize necessary files for that mod. -## Linux/Steam Deck 相关 +## Linux/Steam Deck Tips
                          -展开... +Expand -安装BepInEx 的过程与上面列出的 Windows 版本基本相同，但还有一些额外的东西需要首先了解： +The process of installing BepInEx is largely the same as on Windows listed above, however there are some extra things to be aware of first: - - 在按照指南进行操作之前Steam Deck用户需要按住电源按钮，并从菜单中选择`Desktop Mode/桌面模式`来切换到桌面模式。 + - To follow the guide, Steam Deck users will need to switch to Desktop Mode by holding down the power button and selecting `Desktop Mode` from the menu. - - Steam Deck用户将需要将游戏安装到内部存储，因为BepInEx无法从microSD卡中加载。 + - Steam Deck users will need to install the game to the internal storage, as BepInEx will not load from the microSD card. - - 如前所述，您仍然需要安装 `x64` Windows 版本的 BepInEx，而不是 `unix` 版本，因为Trombone Champ仍然是一个在 Proton环境下运行的Windows应用程序。 + - As stated earlier, you will still need to install the `x64` Windows version of BepInEx, not the `unix` version, as Trombone Champ is still a Windows application running under Proton. - - 存档与日志文件存储在您的Proton兼容文件夹内的Steam文件夹中。 + - Save and log files are stored in your Steam folder within Proton's compatibility folders. - - 在Steam Deck上的位置如下： `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` - - 在其他基于Linux的系统上，如果您不确定您Steam 文件夹的位置，您可以从终端中运行`locate -r /Holy Wow$` + - On Steam Deck this can be found at: `~/.local/share/Steam/steamapps/compatdata/1059990/pfx/drive_c/users/steamuser/AppData/LocalLow/Holy Wow/TromboneChamp` + - On other Linux flavors you can run `locate -r /Holy Wow$` from the terminal if you're unsure of where your Steam folder is. -您还需要将 `WINEDLLOVERRIDES="winhttp=n,b" %command%` 添加到您的游戏启动项中。 右键单击Steam中的游戏，然后单击 `Properties/属性`。 与Windows不同的是，除非有明确的命令，Proton不会加载BepInEx的相关文件。 +You will also need to add `WINEDLLOVERRIDES="winhttp=n,b" %command%` to your game's launch options. To do this, right click the game in Steam and click `Properties`. Unlike on Windows, Proton won't load BepInEx's files unless specifically instructed to here. -![Steam属性预览](../docs/files/linuxsteamproperties.png) +![Steam Properties Preview](../docs/files/linuxsteamproperties.png) -到这一步，BepInEx应该已经可以正常工作了！ 按照[上方的教程](##installation)安装您的mod，以使自制谱面能正常运行。 +Once added, BepInEx should now work! Install your mods [as instructed above](##installation) to get custom songs working. -### 视频背景 {docsify-ignore} +### Video Backgrounds {docsify-ignore} -一些自制谱面可能包含视频文件，默认的Proton设置无法播放。 如果您想要这些视频文件正常播放，可以使用[ProtonUp-Qt](https://davidotek.github.io/protonup-qt/)安装`GE-Proton`。 这是一个包含一些额外功能的Proton版本，包括能够播放Valve官方无法支持的视频格式。 +Some custom songs will include videos for their backgrounds, and the default Proton install cannot play these back. If you want these to work, you can install `GE-Proton` using [ProtonUp-Qt](https://davidotek.github.io/protonup-qt/). This is a version of Proton that includes some additional features, including the ability to play back video formats that Valve are unable to support officially. -我们建议参考[由GamingOnLinux编写的指南](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) ，用于说明如何使用ProtonUp-Qt安装 `GE-Proton`。 +We recommend following [this guide created by GamingOnLinux](https://www.gamingonlinux.com/2022/03/protonup-qt-got-upgraded-heres-how-to-use-it-on-steam-deck-and-linux/) for instructions on how to use ProtonUp-Qt and install `GE-Proton`. -！> 即便使用GE-Proton, 您仍然可能会遇到一些视频播放方面的问题，这取决于您的设置。
                          +!> Even with GE-Proton, you may still experience some issues with video playback depending on your setup. -## 安装自制谱面 {docsify-ignore} +## Installing Custom Songs {docsify-ignore} -> 参考[**Custom Songs guide**](installing-songs) 以获取安装自制谱面的信息。 \ No newline at end of file +> Check out the [**Custom Songs guide**](installing-songs) for info on installing custom songs. \ No newline at end of file diff --git a/translations/zh_CN/docs/user-guide/installation/installing-r2modman.md b/translations/zh_CN/docs/user-guide/installation/installing-r2modman.md index ba4747d0d3..58e05bb545 100644 --- a/translations/zh_CN/docs/user-guide/installation/installing-r2modman.md +++ b/translations/zh_CN/docs/user-guide/installation/installing-r2modman.md @@ -1,6 +1,8 @@ # Using r2modman --- +!> IMPORTANT: If you've previously modded Trombone Champ before the switch to r2modman, make sure to follow the [Migration Guide](migrating-to-v2) after setting up r2modman! + ?> For Linux and Steam Deck users, please follow the [Linux instructions](installing-r2modman-linux). ?> For Mac users, you may try looking at Candygoblen123's [Trombone Champ Mod Manager for Mac](https://github.com/Candygoblen123/TromboneChampModManager/) @@ -15,7 +17,11 @@ This guide will run you through installing and using [r2modman](https://github.c First things first, download [**r2modman from its GitHub page**](https://github.com/ebkr/r2modmanPlus/releases/latest/). -For **Windows**, you would want to get `r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe` or `r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`. The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. +For **Windows**, you would want to get [`r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-Setup-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe) or [`r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b}.exe`](https://github.com/ebkr/r2modmanPlus/releases/download/v%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}/r2modman-%{thunderstore:f21c391c-0bc5-431d-a233-95323b95e01b:raw}.exe). The former installs the mod manager to your system, while the latter simply runs r2modman without any sort of installation. Simply run the installer or the program in order to open r2modman. + +In order to download, simply click the links as shown below and run the program you just downloaded. + +![r2modman GitHub Download (v3.1.39)](../docs/files/r2modman-install/r2modmandownload.png) ## Installing Mods on r2modman diff --git a/translations/zh_CN/docs/user-guide/installation/installing-songs.md b/translations/zh_CN/docs/user-guide/installation/installing-songs.md index b4e32bc989..c468a559e1 100644 --- a/translations/zh_CN/docs/user-guide/installation/installing-songs.md +++ b/translations/zh_CN/docs/user-guide/installation/installing-songs.md @@ -1,8 +1,8 @@ # 安装自制谱面 --- -?> 如果需要视频教学, 可参考VorgunTheBeta 的[mod安装与自制曲目导入指南](https://youtu.be/pSwNSGx-P5c). +?> If you prefer video tutorials, Rayanne has [a video explaining how to install mods and custom songs](https://youtu.be/6msFI8Sz1UQ). -！> **注意：** 请确保您已经按照 [mod安装指南](installing-mods) 安装BepInEx 和 TrombLoader，然后再继续！ +!> **IMPORTANT:** Make sure you've followed the [mod installation guide](installing-r2modman) to install BepInEx and TrombLoader before continuing! ## 搜索自制谱面 @@ -14,7 +14,7 @@ 1. 下载自制谱面。通常情况下是一个压缩包，以`.zip`等压缩包格式作为文件名结尾。 -2. 解压压缩包的内容并直接放入`BepInEx/CustomSongs` 文件夹中。这个文件夹会在你安装了TrombLoader并第一次运行游戏之后自动创建。 +2. Extract the contents of the archive file directly into the `BepInEx/CustomSongs` folder in the r2modman profile directory. ![BeepInEx 解压缩预览](../docs/files/customsongextract.png) diff --git a/translations/zh_CN/docs/user-guide/installation/migration.md b/translations/zh_CN/docs/user-guide/installation/migration.md new file mode 100644 index 0000000000..bae88c8898 --- /dev/null +++ b/translations/zh_CN/docs/user-guide/installation/migration.md @@ -0,0 +1,46 @@ +# Upgrading to TrombLoader 2 + +This guide shows you how to upgrade from a manually modded game to r2modman! + +!> Make sure to follow this guide fully - otherwise you could end up with missing save data! + +## Uninstalling TrombLoader 1 + +TrombLoader 2 changes the way save data is handled in a way that's incompatible with TrombLoader 1. Data is automatically migrated when upgrading, but switching back and forth between the two can result in scores going missing from saves. + +So we'll walk you through uninstalling TrombLoader 1. + +1. Open Steam and right-click on Trombone Champ. Then, go to `Manage > Browse local files`. + +![Right-click Menu Preview](../docs/files/localfilescontext.png) + +2. Navigate to the BepInEx folder. +3. Delete the `Plugins` folder. You'll reinstall all your mods with r2modman in the next step. + +![Plugins folder](../docs/files/r2modman-install/deleteplugins.png) + +Keep this folder window open, you'll want to move your CustomSongs folder below! + +!> Make sure you're **not** deleting `TromboneChamp_Data/Plugins`! This will break your game! You can fix it by verifying files, though. + +## Installing TrombLoader 2 + +Follow the guide for [installing r2modman](installing-r2modman), then come back here! + +If you had any other mods, use r2modman to reinstall them too! + +## Migrating songs + +r2modman stores mod files in a "profile" directory outside of the game folder. This means it won't load your existing custom songs until we move them! + +1. You can get to the profile folder by clicking on r2modman's "Settings" -> "Browse profile folder" + +![Browse profile folder](../docs/files/r2modman-install/browseprofile.png) + +2. Navigate into the BepInEx folder. + +![Profile Folder](../docs/files/r2modman-install/profilefolder.png) + +3. Move your old CustomSongs folder to this directory. + +![BepInEx Folder](../docs/files/r2modman-install/bepinexfolder.png) diff --git a/translations/zh_CN/docs/user-guide/introduction.md b/translations/zh_CN/docs/user-guide/introduction.md index b2eefb8c6a..c8aa02f8b9 100644 --- a/translations/zh_CN/docs/user-guide/introduction.md +++ b/translations/zh_CN/docs/user-guide/introduction.md @@ -6,7 +6,7 @@ ?> **Discord客服** 如果你需要任何帮助，请去 discord上的[长号冠军模组群](https://discord.gg/KVzKRsbetJ) ，在 **#modding-support**里寻求帮助 请事先阅读我们的 [常见问题](faq) 页，以查看您的问题是否已经得到答复。 -> ### [![Steam标志](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**安装模组**](installing-mods) +> ### [![Steam标志](https://icongr.am/simple/steam.svg?color=A9A9A9&size=18.72)](pc-guide) [**Installing Mods**](installing-r2modman) > > ### [![Apple Music 标志](https://icongr.am/simple/applemusic.svg?color=A9A9A9&size=18.72)](pc-guide) [**安装自制谱**](installing-songs) >