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 and others
TRANSLATION: kolejarz2009

Contents

  1. Introduction
  2. Health warnings
  3. I've downloaded the Simulator, now what?
    1. First run
    2. Hardware requirements
    3. Uninstalling
  4. Keyboard control
  5. Control
    1. Controlling
    2. Changing cabs
    3. Coupling and uncoupling
    4. How to change the consist in the scenario?
    5. How to change weather, sky?
    6. Turn on and off the platform lamps
  6. Contents of the Pack
    1. Vehicles and sceneries
    2. Textures
  7. Package information
    1. Improvements and new EXE functions
  8. Remarks
    1. Why is ... not included in this pack?
    2. Simulator executable – EXE changes
  9. What next? When is a new version / new add-ons comming out?
  10. The Simulator's Licence
  11. FAQ – Frequently Asked Questions. Most common problems and their solutions
  12. Official adresses and contact
  13. Translator's Note

Introduction

The "MaSzyna" Simulator project is entering into it's seventeenth year of existance in 2018. In the second half of last year, we continued focusing on code refactoring, in order to improve your experience. Clearing the code helped to expand the features, like adding shadow and reflection effects, which squeeze every last drop of horepower out of the old OpenGl, which is ued by our engine, and adding the OpenAL sound library, which fueled the continued sound revolution, and caused us to become independant of DirectX, which allows us to be compiled natively under Linux, and MacOS For a detailed look, we recommend you look in the Simulator executable – EXE changes section.

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

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.

Future versions of MaSzyna will introduce a new renderer, requiring a graphics card supporting at least OpenGL 3+. The current renderer will be available to users with older hardware, but if you ware thinking of buying a new computer, this would be a good time, to enjoy the full effects of the future graphical effects.

Contents

First run

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 information in the middle field of the Select scenery and the right field from the Select trainset (for example scenario calkowo_orlen.scn; screen 5), and also with any possible descriptions, available after pressing the buttons (in the middle field of the Select scenery pane, or in the "inne/[scenario name]" (not all routes have it [for example TD doesn't have one]).

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 olderScreen 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.

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?

With the help of Rainsted.exe Launcher, which allows us to change the sky, along with setting the specially tailored atmo and light parameters. In order to do this , after starting the Launcher, we will need to:

Contents

Turning on and off the platform lamps

Contents

Contents of the Pack

Package information

Current version of MaSzyna is based on previous versions (18.01, 17.07, 16.08, 15.04, 08.13, 01.13, PC2011, 2010, 2009). This version has largely focused on fixes and missing files, as well as any addons published since the publication of Patch 16.08
Teams that have prepared these packs:

Many other users have also contributed, but we have no way of listing every single one ot them. We thank everybody that helped with creating the current version.

Improvements and new EXE functions

Main functions added, in comparison to exe file from 18.01 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, this version contains many new textures of vehicles - carriages and locos - which ware created since the last version was published. Also, many smaller and bigger fixes in models, scenarios and sceneries(maps) are included.

Important notice
When 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 in front of the controls, press right mouse button - RMB.

Additionally, the camera position in it's primary position (after clicking RMB) is set up using the anthropometric data, meaning, the camera is at the eye level of a statisical siting male - which is significantly higher than before. All the vehicles have been checked and corrected in this regard.
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

The Simlator's executable file – EXE

In order to see the full list of changes in the EXE, read the following forum thread (Please use Google Translate or similar, due to forum posts being in Polish!) Aktualizacja EXE C++

Contents

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

We are hobbists, who have to divide our time between families, jobs, learning and only in our spare time we can create things for the Simulator. That is why, when asked "When is the new loco/route/pack comming out?" we can not give a 100% accurate (or binding) answer. We are not a group closed to new people and their ideas. If you want to conribute, we will welcome you :) You can, for example, help the add-on creators by photographing the infrastructure, buildings etc. in order to make the routes in MaSzyna more realistic. More info here: [POLISH ONLY] http://eu07.pl/forum/index.php/topic,17369.0.html.

If you are good at programming, modelling, sound editing, you have a good camera or simply have loads of spare time, then we would be happy to work with you on improving the Simulator.

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: