Yume 2kki:Installation Instructions

Introduction

Even though Yume 2kki can be an amazing gaming experience, installing it can be tricky. This guide should be enough for most people to get the game working smoothly.

If you are having problems running or installing the game, feel free to make a post on the Troubleshooting Board after checking the Troubleshooting page, which lists various common problems.

Pitfalls

A few things to keep in mind before setting up the game:

Putting the game in a path with non-ASCII characters (e.g. C:\Users\Amón\Yume 2kki) will most likely result in errors.
If extracting the game files with 7-Zip, make sure to run 7-Zip with Microsoft AppLocale, otherwise some files with Japanese names will be given gibberish names and the game will not be able to locate these files when you go to run Yume 2kki.

Preparation

On Windows XP, some additional setup is required for East-Asian languages.

Go to Control Panel.
Go to Regional and Language Options.
Click the "Install files for East-Asian Languages" checkbox.
Press OK. Windows will install East-Asian language support.

Installing AppLocale for Windows XP through Windows 8

Installing AppLocale and the Japanese RPG Maker 2000 RTP

Download Microsoft AppLocale from here (mediafire mirror)

On Windows XP, open the "apploc.msi" file you downloaded earlier and follow the installation instructions.

On Windows Vista through Windows 8, the process is a bit more complicated.

Open the start menu, type "cmd" in the search box, then right click "cmd.exe" and select “Run as Administrator”.
Type the following command and press enter:

msiexec /i "C:\Users\...\Downloads\apploc.msi"

Make sure to replace the "C:\Users..." path with the full filename of apploc.msi. Also, the quotes are important!

AppLocale will be used to install the RTP and later to run Yume 2kki. To install the RTP using AppLocale:

Download the RTP here (Mirror)
If you downloaded a ZIP file, extract the contents. Otherwise, if you downloaded an EXE file, run it and allow it to extract. In the extracted files will be a file called RPG2000RTP.exe.
Open AppLocale, and when prompted, select RPG2000RTP.exe as the executable file to run.
Select Japanese (日本語) as the language, which is the very last option in the language dropdown menu.
Run the installer. The "next" button should be highlighted by default.

If you have attempted to install the RTP before and failed, or have difficulties installing the RTP, make sure other versions of the RTP have been uninstalled through Add or Remove Programs (Vista and later: Programs and Features) in the Control Panel and try again.

Installing Locale Emulator for Windows 10

Installing Locale Emulator and the Japanese RPG Maker 2000 RTP

Since AppLocale is incompatible with Windows 10, a program called Locale Emulator will be used instead. (Keep scrolling for information on how to run Yume 2kki without using a 3rd party software) Download the latest version of Locale Emulator from here (MEGA mirror) If, when following the instructions, the game does not operate correctly, download Time Zones.zip.

Extract Locale.Emulator.x.x.x.x.zip, and move the extracted files to a permanent location. (because you will NOT be able to move these files after installation).
Open LEInstaller.exe and click on Install / Upgrade. Make sure to save any documents open in Windows File Explorer, as the program will restart them automatically, regardless of which button is pressed.
After LE has installed, run LEGUI.exe, which will provide the information needed to display the game in Japanese.
You should now see "Locale Emulator" in the context menu when right-clicking on files.

Locale Emulator will be used to install the RTP and later to run Yume 2kki. To install the RTP using Locale Emulator:

Download the RTP here (Mirror)
If you downloaded a ZIP file, extract the contents. Otherwise, if you downloaded an EXE file, run it and allow it to extract. In the extracted files will be a file called RPG2000RTP.exe.
Right click on RPG2000RTP.exe, go to the "Locale Emulator" dropdown menu and click "Run in Japanese"
Follow the installer. The "next" button should be highlighted by default.

If you have attempted to install the RTP before and failed, or have difficulties installing the RTP, make sure other versions of the RTP have been uninstalled through Programs and Features in the Control Panel and try again.

The official link for more instructions and FAQs is here.

Note: If the Japanese RTP is stuck at 44%, either download from this English RTP instead, or change the system locale to Japanese, as the issue is related to the use of non-Unicode characters. The steps to changing the system locale are as follows:

Open the Control Panel, and select "Clock, Language and Region".
- You can also access this from Settings, selecting "Time & Language", then "Additional date, time & regional settings".
Click "Region", then select the "Administrative" tab.
Click "Change system locale...", and select "Japanese (Japan)". Do not select the option to set the encoding to UTF-8, assuming that the option is available. Doing so will cause various issues in displaying the game's text, and in installing the RTP.
Click "OK" for both windows, and restart your computer.

Another Note: If it's not working when trying to extract the contents using the ZIP file then try downloading the EXE file and run with the simulator.

Installing Yume 2kki

Yume 2kki download links can be found here on the wiki. You can choose to download from the official source or a mirror. If the mirror is up-to-date, try a mirror download first; then try the downloads from GetUploader; and lastly the downloads from Dropbox.

If downloading from the official links (on GetUploader), make sure to download all of the files in the series (e.g. ゆめ２っきver0.102b.part01.exe, ゆめ２っきver0.102b.part02.rar, etc). GetUploader only allows one download at a time, so be aware of this. If you cannot identify the download button, it has the text 「ダウンロード」 written on it.

If you want to apply any patches to the game (such as an unofficial English patch or an official update patch), download those files too. Make sure the version numbers match before applying a patch!

Windows XP through Windows 8

If you downloaded the game via mirror, you will need to extract the archive with an archive manager. If you don't have an archive manager that can extract 7z files, a free, high-quality choice is 7-Zip.

If you downloaded the game via GetUploader, you will need to run the self-extracting EXE file with AppLocale:

Start AppLocale
When prompted, choose the "...part01.exe" file as the file to run.
Select Japanese (日本語; the very last option) in the language menu that follows.
Start the self-extractor. Keep in mind that all of the downloaded parts must be kept in the same folder for this step to work.

You will now have a new folder (typically named similarly to「ゆめ２っきver0.101」) in the same location as the archive EXE.

If you downloaded the game via Dropbox, or have downloaded official patches using the ZIP archive format, you will most likely run into codepage issues if you extract the game by normal means. There is no easy way to circumvent this issue on Windows. Some suggestions include:

Download an archive manager (if you do not already have one), start it using AppLocale with the Japanese locale, and extract the files from the archive via the archive manager's interface.
- The 64-bit version of 7-Zip seems to have issues with this method; try the 32-bit version if you run into problems.
Use the command-line unar program to extract the archive. The ecoding "Windows-31J" should be specified.

Once the files are extracted, look inside them for another folder (typically「ゆめ2っき」) which contains the actual game data. To apply patches, extract and copy the patch data into this folder and overwrite existing files. (Some patches may differ in installation; check for instructions that come with the patch.) You may now move the 「ゆめ2っき」folder wherever you'd like.

The last step is to create a shortcut to play the game via AppLocale. The process is similar to before:

Start AppLocale
When prompted, choose "RPG_RT.exe" file as the file to run. If you don't want to play the game in fullscreen, input "x x Window" (without quotes) for the program arguments.
Select Japanese (日本語; the very last option) in the language menu that follows.
Check "Create a shortcut to always run this application with AppLocale" and rename it to whatever you wish.
Start the game!

The shortcut that is created from the previous steps will be found in the start menu under Programs -> Microsoft AppLocale, and can be safely moved to another location.

Windows 10

If you downloaded the game via mirror, you will need to extract the archive with an archive manager. If you don't have an archive manager that can extract 7z files, a free, high-quality choice is 7-Zip.

Once the files are extracted, look inside them for another folder (typically「ゆめ2っき」) which contains the actual game data. To apply patches, extract and copy the patch data into this folder and overwrite existing files. (Some patches may differ in installation; check for instructions that come with the patch.) You may now move the 「ゆめ2っき」folder wherever you'd like.

The last step is to right-click either "Start.exe" or "RPG_RT.exe", then go to the Locale Emulator dropdown menu and click "Run in Japanese."
The game should now begin with Japanese characters.

Running Yume 2kki without a 3rd Party Software

This method is verified for Windows 10 only

If you don't wish to use softwares like Locale Emulator or EasyRPG Player, then there is an easy method to setting up your computer to be able to run Yume 2kki, or other Japanese RPG Maker games, without the use of these programs. Just follow the steps below:

Locate your system's language settings and install the Japanese language onto your device. This will allow your system to read Japanese characters.
After installing the Japanese language, locate and change your system locale settings (aka non-Unicode program configuration). Set your system locale to Japanese (Japan). Your system will need to restart after this.
Download the RTP here (Mirror)
Start the game

This should allow the game to run without any problems. Please leave a comment in case there are any issues.

Not installing the Japanese language before switching your system locale to Japanese could potentially break your system, though this isn't guaranteed, so be careful while setting up your system.

Running Yume 2kki using EasyRPG Player

As of EasyRPG Player version 0.6.2.3, the game can be played relatively well, with only minor glitches and inconsistencies. However, setting it up to run correctly requires a certain level of tweaking. The following instructions will guide you through the process.

Setting up Yume 2kki itself:

Download the latest version of the game.
Download the pre-installed RTP package.
- Alternatively, if you have installed the RTP Packages required for the game already, copy their files from C:\Program Files (x86)\ASCII\RPG2000\RTP and C:\Program Files (x86)\Enterbrain\RPG2003\RTP into the game directory (do not overwrite existing files).
Either use an archiver that is unicode-aware, or temporarily set your system locale to Japanese until you unpack the abovementioned packages. Once they are extracted, you can revert to your original locale. If this step was successful, there should be no mojibake filenames present anywhere within the game's directories.
Merge in the contents of your recently extracted RTP into the game's base folder (i.e. where the Backdrop, Battle, CharSet, etc. directories are), making sure not to overwrite anything.
Open RPG_RT.ini (don't worry if you see mojibake in here), and set FullPackageFlag to 1.

Setting up EasyRPG Player:

Download the latest version.
Extract the archive
Copy Player.exe to the game's base folder (it should be alongside RPG_RT.exe and Harmony.dll).
And finally, launch the player. If everything has been set up as above, the game should look (and sound) practically identical to when it is run through RPG_RT.

Running Yume 2kki on non-Windows Operating Systems

Yume 2kki can be run perfectly with Wine on OS X, Linux, and other Unix operating systems with a little setup. RPGHub can be used to simplify the process of playing RPG Maker games on non-Windows platforms.

Linux Installation Instructions

Install Wine
Enable the Japanese locale in the /etc/locale.gen file. If there's a line that looks like #ja_JP.UTF-8 UTF-8, remove the #
If not, append ja_JP.UTF-8 UTF-8 to the end of the file. After that run locale-gen to generate the locale. You have to be root to edit the file and regenerate locales.
Download the RPG2000 RTP
Run the RTP installer with the Japanese locale: LANG=ja_JP.UTF-8 wine RPG2000RTP.exe
Download Yume 2kki, refer to the Installing Yume 2kki section, ignore the AppLocale thing and use LANG=ja_JP.UTF-8 wine instead.
Extract and run Yume 2kki with the Japanese locale

If you don't want to type in a command every time you start Yume 2kki, you can create a shell script for that:

              #!/bin/sh
              export LANG="ja_JP.UTF-8"
              
              cd "path/to/yume/2kki"
              exec wine start.exe

Paste the text above into a file and run chmod +x the_file to make it executable.

Possible Issues

If you get "Invalid Name" error when trying to install the RTP, try renaming the directory the installer is in, make sure the name doesn't contain any mojibake.

If you have troubles unzipping archive without mojibake (all japaneese characters are not displayed correctly) - unzip archive using unzip-iconv. Some distriburions might have it in their repository (ArchLinux have this patch on AUR) or maybe you already have one - just check is you have -I and -O option. And than, run: unzip -O shift-jis *path to archive*. Same applies to archive with the game itself later.

If the game crashes when entering the Factory in GALAXY Town, applying the patch below might help.

            --- a/dlls/quartz/mpegsplit.c
            +++ b/dlls/quartz/mpegsplit.c
            @@ -172,7 +172,14 @@ static HRESULT FillBuffer(MPEGSplitterImpl *This, IMediaSample *pCurrentSample)
             
                 /* Find the next valid header.. it <SHOULD> be right here */
                 hr = parse_header(fbuf, &length, &This->position);
            -    assert(hr == S_OK);
            +
            +    if (hr != S_OK)
            +    {
            +        ERR("couldn't find a valid header\n");
            +        ERR("rip\n");
            +        return S_FALSE;
            +    }
            +
                 IMediaSample_SetActualDataLength(pCurrentSample, length);
             
                 /* Queue the next sample */

To use Wine with the patch:

copy the text above into a file
download a source release of Wine
unpack the source tarball somewhere
open a terminal
navigate into the source directory
apply the patch (patch -p1 < /path/to/the/patch/file should work)
compile Wine

The patch has been tested on Wine 1.7.45 and Wine 1.7.46.

The Factory's BGM file appears to be a bit corrupted, the crash is due to how Wine handles MP3 files with corrupt/missing headers.

Linux Installation Instructions for EasyRPG Player

Install the easyrpg-player package or build from source code.
Copy the "easyrpg-player" executable to the folder which /ゆめ2っき/ is in (e.g. ~/Desktop/ゆめ２っきver0.107a/). One can think of this executable as taking the place of the "start.exe" Windows executable in the same folder.
Run the "easyrpg-player" executable and select ゆめ２っき from the menu.

The executable may be foudn at /usr/bin/easyrpg-player or /usr/local/bin/easyrpg-player, try:

which easyrpg-player

(Optional) Download the RTP from RPG Maker
Extract the files in the RTP folder using wine.

wine rpg2000_rtp_installer.exe

Locate the files and copy the files in the RTP folder to the game's data folder (~/Desktop/ゆめ２っき/) so that EasyRPG Player can use the files. They may be found at ~/.wine/drive_c/users/rosemary/AppData/Roaming/KADOKAWA/Common/RPG Maker 2000 RTP. The files in the "Panorama" and "Chipset" folders might be used occasionally, but it should be fine to skip this step. Be sure to merge the folders so there are no duplicate folders (directories with the same name but different capitalization, such as "GameOver"). When there are duplicate file conflicts, skip instead of replacing.