Polska wersja
MaSzyna - Railway Vehicle Simulator EP07-424

"MaSzyna" Simulator

The Readme File

AUTHOR: libertyn89

UPDATE: kolejarz2009

CONSULTATIONS, HELP: adsim, Benek, dejotzbych, hunter, matek123, Ra, Sawi, surgeon, szogun, youBy,
sebastian82, EP08_015, Stele, Maciej, matek123 and others
TRANSLATION: kolejarz2009

Contents

  1. Introduction
  2. Information about this release
    1. Contents
    2. New EXE features
    3. New content
  3. Health warnings
  4. I've downloaded the simulator, now what?
    1. Hardware requirements
    2. First run - Rainsted launcher
    3. Uninstalling
  5. Key controls
  6. User info
    1. Controlling
    2. Changing cabs
    3. Coupling and uncoupling the locomotive
    4. How to change the train in the scenario?
    5. How to change the sky, weather?
  7. Remarks
    1. Why is ... not included in this pack?
    2. Simulator executable – EXE changes
  8. What next? When is a new version / new add-ons comming out?
  9. The Simulator's Licence
  10. FAQ – Frequently Asked Questions. Most common problems and their solutions
  11. Official adresses and contact
  12. Translator's Note

Introduction

The "MaSzyna" Simlator project has grown of age, as it's been over 19 years since it's first publication. On the www.eu07.pl/jeszczejedensymulatorek subpage, we present a copy of the orignal thread from the August 2001, where the first version of MaSzyna has been presented.

In the year 2019, authors have concentrated further on the development and modifiaction of the EXE file as well as adjusting more elements of the Simulator to newer features

We highly recommend you to try out the newest version of The "MaSzyna" Simulator.
eu07.pl Administration

Contents

Contents of the Pack

Current version of MaSzyna is based on previous versions of the Simulator. The list of all the previous releases, along with a short description, can be found here: [In Polish - use Google Translate] Zestawienie wydań Symulatora MaSzyna [List of previous releases].

Sceneries and vehicles

Because there is so many people working on MaSzyna, this information was moved to a separate subpage, in order to ease the updating of information.

Improvements and new EXE functions

Main functions added, in comparison to exe file from the last pack

The points above represent only a small fraction of changes, since these are the biggest and most visible to the users. Precise Changelog is in the following forum thread about changes in the EXE [POLISH ONLY!] , the list is still updated as the exe functions are expanded.

New Stuff in the current version

Additionally, many new vehicle textures - carriages, wagons and locos - ware added, as well as many new sounds, smaller and bigger fixes in the models, scenarios and sceneries.

Contents

Health warnings

Warnings for users of computer games

A small fraction of people can experience epileptic attacks because of the observed visual effects, such as blinking lights or multicolour compositions durning the observation of the computer screen. Even people without such symptomps can have undiagnosed diseases that cause epileptic attacks.

Attacks can occur in a variety of different ways: vision disorders/problems, headaches, muscle and/or eye lid twitching, uncontrolled motion of leg and arm muscle.More serious problems that can occur, are: desorientation, loss of balance, headaches, unaware movements, reddening of the eyes, eye tears, tiredness of eyes. There is a risk of a fall and serious injury can occur. The biggest risks affect mainly children and teenagers, and as such, parents should observe the children whilst they play on the computer.

Recommendations: Always play in well lit room, make a 15min pause, for every 60min spent in front of the computer and rest untill the discomfort disappears, don't sit too close to the screen, don't play if you're experiencing feelings of discomfort or tiredness. If you or your family have a history of epileptic attacks, please consult a doctor before playing.

Contents

I've downloaded the Simulator, now what?

Hardware requirements

The software and hardware requirements hare been increased in comparison to the previous versions. Because of the EXE file being supplied in both 32bit (x86) and 64bit (x64), caution should be exercised when picking and running the EXE file and it's dependencies on your computer.

The new renderer (supporting GL3.3+, with loads of new graphical features) has been implemented into the main binary, and as such, you will have to test if the new render works well on your PC - if it does not, edit the eu07.ini file, and change "gfxrenderer full" to "gfxrenderer legacy", for the middle-ground performance PCs, or "gfxrenderer simple" for low-end PCs.

Contents

First run - Rainsted Launcher

In order to begin our adventure in the Simulator, we need to know whenever our system is 32-bit (x86) or 64-bit (x64). In the Simulator's main folder, you will see two archive files - "exe-x86.zip" and "exe-x64.zip". We need to extract the archive that has the same type as the Operating System.

Important Notice

To run the simulator, you might need the Microsoft C++ Runtime Library 2008, 2015 and 2017. Best to install both versions - for 32 bit and 64bit systems.

To launch MaSzyna, use Rainsted launcher, created by Ra. It functions as starter and a train consist editor (but also a realistic scenery editor, more on it further down and more information is on rainsted.com [POLISH ONLY] Enter the main MaSzyna folder. Launch Rainsted.exe (icon like in screen 1 below).

Screen 1: Rainsted launcher icon

You should see the following window (screen 2):

Screen 2: Rainsted (launcher)

Durning first run, Rainsted launcher processes and generates certain configuration files. It can take upto around a minute. It is a one-time process - every other launch of Rainsted will launch much quicker.
Rainsted was succesfully started when the following window appears (screen 3):

Screen 3: Rainsted, Choose Scenery tab

The titlebar says: "Wybierz scenerię :: MaSzyna EU07-424 :: Rainsted 17.5.126.12740". The "17.5.126.12740", is not Simulator version number, but the version of the Rainsted Launcher and changes when Rainsted is updated.
Go to Settings (or Ustawienia if the Launcher started in the Polish language) and in the Select language (or Wybór Języka) and choose your preferred language.
From here on, we assume that the language was set to English.
Settings tab (screen 4) allows for configuring such parameters, like screen resolution.

Screen 4: Rainsted, Settings tab (in Polish)

The important setting in the Settings tab, is the User mode. It can be changed, depending on the knowledge of the user. This setting affects Rainsted ONLY and has no effect on the simulation whatsoever. Let's look at options from the "Settings in EU07.INI" pane. These DO affect the simulation.

The remaining options should be left as they ware.

In the Choose scenery tab, is a list of all the available scenarios. As you can see, we have tens of different scenarios. In the beginning we will choose the simplest route to become aquainted with the Simulator. Choose the TD scenario, in the Select trainset to drive pane, click on EP07-424+BD+BDHPUMN+BDHPUMN and press Run Simulator.

Important Notice
After choosing any scenarios and the trainsets, familiarise yourelf with the additional information in the middle and the lower fields of the launcher. Additionally, you can see additional info, like the timetable, The WOS (Low speed locations), Special orders, and mission descriptions.

Screen 5: Rainsted, Scenario description

A window will appear (screen 6):

Screen 6: Rainsted, Starting Information

Familiarise yourself with the starting information (It's shown only for a couple of the most used vehicles; full description of keys and controlling the trains will be further down in this read me file). Next, press Run simulator.

Time for the most important stage
After a moment (no more than a minute) the startup window should appear (screen 7).

Screen 7: Symulator MaSzyna - startup screen window

It may vary from the one on the screen, since the Launcher chooses one at random before displaying it. In certain cases the "Uruchamianie / Initializing" text may not be visible, however, it does not influence the simulation in any way and should be ignored.

After few seconds, the logo may (but doesn't have to) turn into a white background, or fade slightly (Windows Vista and 7). In this moment most user panic, thinking the Simulator froze. That is not the case. It is still loading all the necessary files (eventhough, the Task Manager [and the Simulator's Titlebar, screen 8 and 9]may show it to be "Not responding").

Screen 8: MaSzyna Simulator- Startup screen, Windows XP and older Screen 9: MaSzyna Simulator - Startup screen, Windows Vista & 7

To find out about that, all you have to do is press Alt + Tab. Then we will see the "Terminal" (on Windows Vista and 7, switching to the terminal durning loading only works if the Fullscreen mode is unchecked; and then, once the simulator has loaded, the Alt + Tab combination works normally, even in fullscreen mode). We will be able to watch the simulator loading process. Sometimes, it can stop for a while on the stage shown on the screen 10 (Sound Init… OK) , however, it won't stay there forever :)

Screen 10: MaSzyna Simulator - loading of the sim in the terminal

You just need to wait untill it finishes loading.

Notice - loading screen

Windows might think, that the application, durning loading, has frozen, by showing a Not responding! message, or overlay a white filter over the window (depending on the syste version) - It's a incorrect notice, which needs to be ignored, since the loading of the simulation, is proceeding correctly.
The scenario has loaded when the following is displayed in the terminal:
Player train init OK

We should be automatically moved to the cab. If not, we switch into the window with the simulation, by using Alt + Tab.

After the cab has loaded, we begin the simulation in the standing position, as if we just entered the cab through the doors. To sit down at the controls, press the Right Mouse Button.

If durning loading ( or after, durning the simulation) a notification is displayed, that the program has carried out a incorrect operation, that it has stopped responding / froze or that there was a fault with the application, it means that, most probably you have very old drivers for your graphics card (In these cases, it is very common that in the first few lines of log.txt the following test is displayed: "OpenGL Version: 1.1.0"). In that case, in order to run the Simulator, download (for example from the graphic card's manufacturer's website) and install newer drivers (in some cases it may be necessary to uninstall previously installed (the older) drivers ; in some cases,"DriverCleaner" app may be of use ).

Contents

Uninstalling

To uninstall, please delete the main Simulator folder, along with all of it's contents from the computer's drives. Sometimes, you might also need to delete it from the Bin folder. Please use the Empty Bin function.

Contents

Keyboard Control

Important notice

The keys and their functions have been altered due to the modernisiations of the EXE. We reqest that you familiarise yourself thoroughly with the description available below.
Go to the site containing Keyboard Contols
Contents

Control

Controlling, or the popular "How to move the loco?" and others.

The start-up procedure is the same, but only the keys have been altered. Go to the site containing the driving and start up procedures.

Contents

Changing Cabs

In order to move to the other cab, press either:

Attention: In between the cabs, is the Engine Room (in some locos, it looks like a green room). If you are in the Engine Room, then press either Home or End (depending on the direction in which you plan on going) for a second time. When changing cabs in Electric Multiple Units (EMUs) and locos that have more than one unit, you will need to press End or Home a couple of times (for example, in EN57 we press End twice, to move from Ra(Driving Trailer A) unit, to unit S (Motor Coach), and then End three times, in order to move to Rb(Driving Trailer B) unit, and then finally press End twice, to enter the cab). Changing cabs means that the Sim need to load it's model, that's why after pressing Home or End it is necessary to wait (for it to load).

ATTENTION!
If we are driving a vehicle in Multiple Working, or it is a double-unit loco, or a EMU, it is important to check if both the Independant and the Loco brake is in the Running position ("brake off"). We also should set the Train Brake to Cut-off position(Ctrl + Num 5).

Contents

Coupling and uncoupling

COUPLING UP A LOCO TO THE CARRIAGES

  1. Drive up to the train (don't leave the cab), when you feel that you buffered up (Drove up to the buffers, and slightly hit them), move the throttle up 2-3 positions, and brake using the Independant Brake (reminder: Num 1).
    WARNING!: If, when buffering up, the carriages "run away", then leave the cab, F4 fly up to two, three carriages and brake them using the Handbrakes, holding Ctrl + Num 1. When you are done with the whole coupling-up precedure, fly up to those same carriages, and hold Ctrl + Num 7 in order to release the handbrakes.
  2. Exit the cab - F4.
  3. Get as close to the coupler as possible - imagine you are coupling them up yourself. It's not enough to come close vertically, you also need to move horizontally. In majority of cases, you should also lower you self a little bit by using PageDown.
  4. Press Insert twice - you will hear the characteristic air leak sound and a model of a coupled-up screw-link coupler will be shown, along with the "red hose".
    If you, additionally, want to connect the Main Reservoir Pipe ("Yellow hose") then press Insert once more.
    WARNING: Sometimes, the coupler and the hoses won't move, it doesn't mean that the loco has not connected up to the carriages.
  5. Go back to the cab - F4.
  6. Unbrake the loco - Num 7 and go to the other cab.

UNCOUPLING A LOCO FROM THE CARRIAGES

  1. Brake the whole train, pressing the Num 3 for around one second, from the Running position.
  2. Unbrake the loco only - Num 6.
  3. Move the Reverser backwards by 2 positions (2 x r) and select the 2nd or 3rd position on the Power Controller, to buffer up to the carriages, and brake using Independant brake (rem.: Num 1).
  4. Exit the cab - F4.
  5. Get as close to the coupling as possible - imagine you are uncoupling them yourself. It's not enough to come close vertically, you also need to move horizontally. In majority of cases, you should also lower you self a little bit by using PageDown.
  6. Press Delete once - you will hear the characteristic air leak sound.
  7. Go back to the cab - F4.
  8. Unbrake the loco - Num 7.

COUPLING UP TO A TRAIN THAT ALREADY HAS A LOCO

To couple up to a train on the same track, drive up to it gently. After you buffer up, brake using the Independant brake. In order to prevent a runaway train, it is vital that you perform a Full Service brake application or at least a Service brake application (Num 8).
WARNING: If your train is to be coupled up to a train driven by AI, (ie. you drive a Banking Engine or the AI hauls your train ), then it is absolutely necessary to set the Train Brake to the Cut-Off position (Ctrl + Num 5)!
If the user is to drive the train, then the Train Brake valve must stay in the braking positions, and the Reverser must be in either the forward or backward position. This deactivates the AI !!. After the above has been completed, one can now start to couple the couplers with Insert. The moment the coupler is connected (after the first Insert key press ) AI "being" in the set is either deactivated (Train brake in the braking positions) or it's activated (Train brake in the Cut-Off position). If you make a mistake (choose wrong action), then decouple, set the Train brake in the correct position, and try to couple up again.

Contents

How to change the consist in the scenario?

Important Notice

Please pay attention to how to place EMUs in the scenarios (including, amongst others; the EN57). Not paying special attention with the information below is the leading cause of having trouble with starting up the EMUs.
Go to site containing two methods of changing trains in the scenarios.
Contents

How to change weather, sky?

Contents

Remarks

Why is ... not included in this pack?

In order to understand why the packs don't contain all the add-ons published from the start of the existance of the Simulator, you need to know that for a couple of years, when it comes to add-on creation, there was simply only chaos. Add-ons often ware not tested before being published (there ware no standards, norms etc), which ment that they had errors, ware incomplete and often, ware incompatible with each other (often adding one scenery, broke all the remaining sceneries). Additionally, addons ware often hosted on external servers, which removed them after some time, which caused the forum to be full of dead links, instead of addons. Only at the end of 2008, thanks to Ra, it was possible to clean up the mess, through gathering everything in "Katalog dodatków" / Addon Catalogue , on the eu07.pl server. But to simply have all the addons in one place wasn't enough. The addon publication process was reorganised (from the end of 2008, every single addon, prior to publication, must be subject to mandatory tests). However, the incomplatability problem remained, since there was a lack of official and up-to-date package, which could create some sort of an reference point for the testers and creators (last, unofficial package was published half-way through 2006, however the last official, in 2004). That is why, at the beginning of 2009, a group was created, who spend a couple of months choosing, from previously published addons, the addons that ware worthy and didn't have too many mistakes, and then worked on the inter-compatability of these addons, by removing significant mistakes, filling in the missing files, etc. That is how Paczka Całościowa 2009, 2010, 2011 along with the Service Packs, MaSzyna 01.13, MaSzyna 08.13 and MaSzyna 15.04 ware created. The newest Package is a continuation of that work, and just like the previous Packs, does not contain any low quality addons, or ones in Beta testing. From the beginning of 2018, the publication method of the Pack was changed to a rolling release model, which means that newer versions, will not have release numbers.

Contents

Simulator's executable file – The EXE

In order to find out about all the latest changes, read the changelog at: [Polish Only] EXE C++ upgrade

Contents

What next? When is a new version / new add-ons comming out?

Authors of the "MaSzyna" Simulator are creating this project as a part of their hobby, and pro-bono, sharing the time between family duties, work and the Simulator. That's why, when asked When is the new version/new add-ons coming out? we cannot give a clear answer. Information of the current work and future versions, will be presented on our Facebook, and the project's website. We can also reply to them by E-Mail, contact is given in the Official addresses and contact.

Simultaneusly, we need to add that the group of creators is not a closed group. Every willing and interested person can help in developing the project. There are so many fields, on which one can flourish. Contrary to popular opinion, to create this kind of a computer software, you don't need to be a computer science graduate.

For example, you simply need to have a digital camera to support the modellers with pictures of many different objects, which could me added to the sceneries. Those who don't have a camera, can record sounds of different equipment. In the project's lifetime, some people have been known to learn computer coding or using graphical modelling tools, and as such, to contribute significantly to the project's development.

We highly encourage you to register on the project's forum. It contains tips on creating models, textures, sceneries and many more. In case of problems, experienced users will help, sharing their knowledge and remarks. You can also become a Betatester, who's job it is to test and find mistakes in the new add-ons, support the creators with their help, and to create themselves.

All in all, we recomment you register on our forum, where you will find more information and tutorials. List of queries regarding helping in the development of the Simulator is in this forum thread [POLISH only].

Contents

The Simulator Licence

See the page containing the Licence
Contents

FAQ – Frequently Asked Questions and their answers. Most occuring problems and their solutions

Questions List

In order to get to the answer, please press on the question.
Contents

Answers:

Official addesses and contact

Web sites

Below is a list of official websites, managed by the "MaSzyna" Simulator Team:

E-Mail adresses